Crime Module¶
The Crime Module tracks Organised Crimes (OC1, and OC2) for your faction, sending alerts for new crimes, planning milestones, slot issues, and results - and providing commands to review payout history and member participation.
Faction Module
This module requires a registered faction and a Faction API Key.
Overview¶
The Crime Module covers the legacy Organised Crimes (OC1) and the newer OC2 system. For OC1, it sends an alert when all participants are ready to initiate. For OC, it provides a full suite of configurable alerts across the crime lifecycle - from spawn through to success, failure, or expiry - with per-alert and per-ping granularity.
Beyond automated alerts, the module provides commands for viewing OC payout history with auto-calculated payment links, checking which faction members are currently in crimes, and reviewing OC profitability over time.
Key Features¶
- OC1 ready-to-initiate alerts (fires when all members are in Torn and okay)
- Full OC2 alert suite: new spawns, planning begun, pausing soon, items missing, success/fail, expired
- Per-slot success rate monitoring with configurable minimum thresholds
- Difficulty filter to suppress alerts for low-difficulty crimes
- Per-alert ping configuration - choose exactly which events ping your role
- OC payout calculator with payment links for fair distribution
- Faction member crime participation viewer
- OC history and profit tracking
Commands¶
| Command | Description | Permission Required |
|---|---|---|
/crime alerts |
View and configure crime world event pings | Faction Member |
/oc payouts |
View completed OCs with auto payment calculations and links | Faction Member |
/oc players |
View faction members currently in Organised Crimes | Faction Member |
/oc history |
View OC history, results, and profit breakdown | Faction Member |
Prerequisites¶
- Faction API Key must be set.
- OC Channel must be configured to receive alerts.
Configuration¶
This module is configured via the Faction Config - Crime Module page.
| Setting | Default | Summary |
|---|---|---|
| OC Channel | null |
The text channel where organised crime alerts are sent |
| OC Ping Role | null |
The role pinged for ready-to-initiate (OC1) or selected OC2 pings |
| Minimum Difficulty | 3 |
Minimum OC difficulty required before a spawn alert is sent |
| Minimum Success Chance | 60 |
Minimum checkpoint pass rate before a slot alert fires |
| Selected OC 2.0 Alerts | All |
Which OC2 alert types are sent to the channel |
| Selected OC 2.0 Pings | All |
Which OC2 alert types include a role ping |
OC2 Alert Types¶
| Alert | Description |
|---|---|
| New Crime Spawn | A new OC2 has appeared and is available to plan |
| Slot Below Min Success Chance | A participant's checkpoint pass rate has dropped below the minimum |
| Crime Planning Begun | Planning has started for an OC2 |
| Crime Planning Pausing Soon | Planning will pause soon if not initiated |
| Items Missing Near End of Planning | Required items are not in the armoury near the planning deadline |
| Crime Successes and Fails | An OC2 was completed successfully or failed |
| Crime Expired | An OC2 expired without being initiated |