Code Raid
Duff
1 / 3
CodeRaid
A configurable code lock raiding system with items, ranks, protection mechanics, and economy support.
CodeRaid introduces a new gameplay mechanic that allows players to attempt to crack code locks instead of relying solely on traditional explosives. Players must stay within range of a lock during a timed raid attempt while success is determined by configurable chances, items, or rank settings.
The system is designed to be highly configurable, allowing server owners to control balance, progression, and gameplay style while adding a unique PvP element to Rust.
Core Features:
Code Lock Raiding System:
Players can attempt to raid code locks using the command /coderaid.
When a raid begins:
- A timer starts
- The player must stay within range of the lock
- Moving too far cancels the raid
- A success roll determines the result
- Failure can trigger damage and effects
- Success reveals the lock code and can optionally unlock it
Only one raid attempt per lock can occur at a time (configurable).
Item-Based Raid Attempts:
CodeRaid supports custom raid items which determine how powerful a raid attempt is.
Each item can define:
- Duration of raid attempt
- Success chance
- Cooldown
- Whether the item is consumed
- Failure damage chance
- Failure damage amount
- Custom display name
- Skin ID
- Custom note text
- Permission requirements
This allows servers to create a variety of raid tools such as:
- Common low-chance raid attempts
- Rare high-success raid items
- Risky items with failure damage
- Free low-success attempts
Rank System:
Ranks can be configured using Permissions.
Ranks allow server owners to control:
- Raid success chance
- Raid duration
- Maximum raid distance
- Cooldowns
- Optional raid cost
- Stealth raid capabilities
- Owner alert behavior
- Protection access
- Whether items are required
This makes it easy to create VIP Ranks.
Lock Protection System:
Players can protect their locks using /coderaidprotect.
Protection can be applied through:
- Protection items
- Rank permissions
- Configurable duration
- Configurable cooldowns
When protection is active:
- Players cannot CodeRaid the owner's locks
- Raiders receive a denial message
- Protection time is tracked and displayed
This creates a defensive mechanic to counter raiders.
Stealth Raid Options:
Certain ranks can perform stealth CodeRaids.
Stealth features include:
- Hidden raider identity in owner alerts
- No raid noise
- Hidden world panel timer
This allows special ranks tiers to raid more discreetly.
Owner Raid Alerts:
Lock owners can receive alerts when someone attempts to CodeRaid their lock.
Alerts can include:
- The locked entity type
- Map grid location
- Raider name (optional depending on rank)
- Stealth raid handling
This helps defenders react to raid attempts.
Economy Integration:
CodeRaid supports multiple payment systems.
Supported economy types:
- Economics
- ServerRewards
- Item currency
If economy plugins are unavailable, the plugin automatically falls back to item currency.
Custom Item Purchase System:
Servers can allow players to buy raid items or protection items.
Commands:
- /coderaidbuy <Name> [amount]
- /coderaidbuylist
Buy rules support:
- Price
- Rank restrictions
- Max purchase amount
- Optional item permission requirements
Loot Container Integration:
CodeRaid items can spawn naturally in the world.
Supported sources:
- Loot containers
- NPC corpses
The plugin automatically generates editable data files so server owners can configure where CodeRaid items appear.
This allows servers to integrate CodeRaid into natural gameplay progression.
UI System:
Optional UI feedback can be enabled for raid attempts.
Available UI elements:
- Raid timer progress bar
- World panel timer above locks
- Distance-based world panel visibility
These UI elements help players track raid progress clearly.
Commands:
Player Commands:
- /coderaidStart a CodeRaid on the code lock you are looking at
- /coderaidprotectApply protection to your locks
- /coderaidbuy <Name> [amount]Buy a configured CodeRaid item
- /coderaidbuylistList all available purchasable items
- /coderaidinfoView rank information and cooldowns
- /coderaidhelpShow help information
Admin Commands:
- /coderaidcreate <Name>Give yourself a configured raid/protection item
- /coderaidforgetForget your remembered code on a lock
- cr.loot.dumpList all loot containers
- cr.corpse.dumpList NPC corpse types
- cr.corpse.listconfigList configured corpse rules
Permissions:
Admin Permission:
- coderaid.admin
Example Rank Permissions:
- coderaid.use
- coderaid.vip
- coderaid.vipgold
These can be customized or expanded within the configuration.
Configuration:
The plugin includes an extensive configuration allowing full control over gameplay behavior.
Major configurable systems include:
- Raid duration
- Success rates
- Raid distance limits
- Raid cooldowns
- Rank settings
- Item definitions
- Protection items
- Economy settings
- Buy rules
- Loot injection
- UI settings
- Effects and raid noise
- Fail damage behavior
The default configuration provides a ready-to-use setup while remaining easy to customize.
Plugins By Duff
CodeRaid.json
{
"General": {
"Debug Enabled": false
},
"Chat": {
"Use Prefix": true,
"Prefix": "<color=#a0d8ff>[CodeRaid]</color> ",
"Channel": 2,
"Icon SteamId": 76561198888888888
},
"Raid": {
"Respect Building Blocked": false,
"Deny While Wounded": true,
"Global Max Raid Distance": 10.0,
"Check Interval Seconds": 1,
"One Active Per Lock": true,
"Unlock Lock On Success": true,
"Require Rank To Use Raid Items": false
},
"Effects": {
"Play Fail Effects": true,
"Play Success Effects": true,
"Use Raid Noise": true,
"Raid Noise Interval Seconds": 5.0,
"Default Fail Damage Enabled": true,
"Default Fail Damage Chance": 100,
"Default Fail Damage Amount": 20.0
},
"UI": {
"Use CUI Timer": true,
"Use World Panel": true,
"World Panel Height Offset": 0.2,
"World Panel Max Distance": 30.0
},
"Economy": {
"Currency Type": "Economics",
"Currency Display": "$",
"Currency Item Shortname": "scrap",
"Currency Item Skin": 0
},
"Buy": {
"Enable Buy Command": false
},
"Ranks": [
{
"Name": "Default",
"Permission": "coderaid.use",
"Require Raid Item": true,
"Raid Cooldown Minutes": 60,
"Raid Duration Minutes": 30,
"Raid Success Rate": 0,
"Max Raid Distance": 0.0,
"Require Protection Item": true,
"Protection Cooldown Minutes": 60,
"Protection Duration Minutes": 0,
"Enable Fail Damage": true,
"Fail Damage Chance": 100,
"Fail Damage Amount": 20.0,
"Notify Getting Code Raided": false,
"Notify Getting Code Raided Name": false,
"Can Stealth Raid": false,
"Can Stealth Raid No Noise": false,
"Can Stealth Raid No World Panel": false,
"Enable Cost": false,
"Amount": 0
},
{
"Name": "VIP",
"Permission": "coderaid.vip",
"Require Raid Item": false,
"Raid Cooldown Minutes": 60,
"Raid Duration Minutes": 45,
"Raid Success Rate": 25,
"Max Raid Distance": 20.0,
"Require Protection Item": false,
"Protection Cooldown Minutes": 60,
"Protection Duration Minutes": 60,
"Enable Fail Damage": true,
"Fail Damage Chance": 50,
"Fail Damage Amount": 20.0,
"Notify Getting Code Raided": true,
"Notify Getting Code Raided Name": true,
"Can Stealth Raid": false,
"Can Stealth Raid No Noise": false,
"Can Stealth Raid No World Panel": false,
"Enable Cost": false,
"Amount": 0
},
{
"Name": "VIPGold",
"Permission": "coderaid.vipgold",
"Require Raid Item": false,
"Raid Cooldown Minutes": 60,
"Raid Duration Minutes": 30,
"Raid Success Rate": 50,
"Max Raid Distance": 20.0,
"Require Protection Item": false,
"Protection Cooldown Minutes": 60,
"Protection Duration Minutes": 60,
"Enable Fail Damage": true,
"Fail Damage Chance": 25,
"Fail Damage Amount": 20.0,
"Notify Getting Code Raided": true,
"Notify Getting Code Raided Name": true,
"Can Stealth Raid": true,
"Can Stealth Raid No Noise": true,
"Can Stealth Raid No World Panel": true,
"Enable Cost": false,
"Amount": 0
}
],
"Raid Items": [
{
"Name": "CodeRaid25",
"Permission": "",
"Shortname": "note",
"SkinID": 3559747523,
"Duration Minutes": 10,
"Success Rate": 25,
"Cooldown Minutes": 60,
"Consume Item": true,
"Print To Chat": true,
"Enable Damage": true,
"Damage Chance": 25,
"Damage Amount": 25.0,
"Note Text": "Use this to attempt a CodeRaid (10m, 25% success)."
},
{
"Name": "CodeRaid50",
"Permission": "",
"Shortname": "note",
"SkinID": 3559748195,
"Duration Minutes": 20,
"Success Rate": 50,
"Cooldown Minutes": 60,
"Consume Item": true,
"Print To Chat": true,
"Enable Damage": false,
"Damage Chance": 0,
"Damage Amount": 0.0,
"Note Text": "Use this to attempt a CodeRaid (20m, 50% success)."
},
{
"Name": "CodeRaidFree10%",
"Permission": "",
"Shortname": "note",
"SkinID": 3559748391,
"Duration Minutes": 60,
"Success Rate": 10,
"Cooldown Minutes": 0,
"Consume Item": true,
"Print To Chat": true,
"Enable Damage": true,
"Damage Chance": 100,
"Damage Amount": 25.0,
"Note Text": "Free CodeRaid attempt (60m, 10% success)."
}
],
"Protection Items": [
{
"Name": "CodeRaidProtect60",
"Permission": "",
"Shortname": "note",
"SkinID": 3559749316,
"Duration Minutes": 60,
"Cooldown Minutes": 60,
"Note Text": "Protects your locks from CodeRaids for 60 minutes."
},
{
"Name": "CodeRaidProtectFree20",
"Permission": "",
"Shortname": "note",
"SkinID": 3559749449,
"Duration Minutes": 20,
"Cooldown Minutes": 0,
"Note Text": "Protects your locks from CodeRaids for 20 minutes."
}
],
"Buy Rules": [
{
"Name": "CodeRaid25",
"Price": 100,
"Allowed Rank Permissions": [
"coderaid.use"
],
"Max Per Purchase": 1,
"Require Item Permission To Buy": false
},
{
"Name": "CodeRaid50",
"Price": 250,
"Allowed Rank Permissions": [
"coderaid.vip"
],
"Max Per Purchase": 1,
"Require Item Permission To Buy": false
},
{
"Name": "CodeRaidProtect60",
"Price": 200,
"Allowed Rank Permissions": [
"coderaid.use",
"coderaid.vip"
],
"Max Per Purchase": 1,
"Require Item Permission To Buy": false
}
]
}
Trusted hosting partner. Affordable game servers with solid support and panels.
Visit site ↗