Code Raid 1.0.0

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

https://discord.gg/2KBPH7hXb7