Chaining Module¶
The Chaining Module monitors your faction's active chain and sends automated alerts to help your members maintain it - covering timer warnings, upcoming bonuses, and chain breaks.
Faction Module
This module requires a registered faction and a Faction API Key.
Overview¶
The Chaining Module polls Torn's API continuously while a chain is active. When key thresholds are crossed - such as the timer dropping below your configured minimum, or a bonus milestone approaching - alerts are sent to your configured channel with an optional role ping.
The module also provides commands for reviewing historical chain data and generating personalised target lists to help faction members find suitable attack targets during a chain.
Key Features¶
- Real-time chain timer warnings with configurable time threshold
- Alerts when a chain bonus milestone is imminent (configurable hit threshold)
- Alert when a chain bonus is achieved
- Alert when a chain breaks, showing hit count and total respect earned
- Historical chain report viewer (chains of 50+ hits)
- Personal chaining target list generator based on your own battle stats
Commands¶
| Command | Description | Permission Required |
|---|---|---|
/chain reports |
View your faction's past chain reports | Faction Member |
/chain list |
Generate a personalised list of chaining targets | Faction Member |
Prerequisites¶
- Faction API Key must be set.
- Alert Channel must be configured to receive alerts.
- For
/chain list, a Paired API Key at Limited Access or higher is required.
Configuration¶
This module is configured via the Faction Config - Chaining Module page.
| Setting | Default | Summary |
|---|---|---|
| Alert Channel | null |
The text channel where chain alerts are sent |
| Ping Role | null |
The role pinged for chain alerts |
| Selected Pings | All |
Which alert types should include a role ping |
| Minimum Hits | 100 |
Minimum hits in chain before timer alerts fire |
| Minimum Time Left | 90 |
Seconds remaining before chain timer warnings begin |
| Bonus Warning Threshold | 10 |
Hits before a bonus milestone to send the upcoming bonus alert |
Alert Types¶
| Alert | Description |
|---|---|
| Chain Bonus | Fires when a chain bonus milestone is achieved |
| Chain Bonus Near | Fires when a bonus is within the configured hit threshold |
| Chain Broke | Fires when the chain breaks, showing total hits and respect |
| Chain Time Warning | Fires every 30 seconds when the timer is below the minimum |