About AdvancedPerks
AdvancedPerks
Turn every item into a legend.
AdvancedPerks introduces collectible Perk Tokens you can Gamble, Apply, Clear, Trade on the Market, or even find in Loot.
All wrapped in a clean UI with full server-side configuration config.
What Players Get
Gamble – roll for a random perk token with transparent drop odds
Apply – attach tokens to compatible items (Weapons / Armor / Tools)
Clear – remove perks from items (cost & workbench rules configurable)
Market – list, buy, cancel, and claim Scrap payouts (even offline)
Loot Drops – perk tokens can appear in configured crates & barrels
StatTrack – live kill counter for weapons
Hunter’s Instinct – highlights nearby animals
Aquaman & Fall Resist – underwater breathing & fall-damage reduction
Fun Perks – comic hit texts, laser beams, and blood fountains
How It Works
Tokens are real items (e.g., notes) bound to a secure server-side Perk ID (unspoofable)
/perks UI – choose category → select token → target item → apply
Balancing system – stack caps, category caps, item blacklist/whitelist, and workbench requirements
Item Names & Info – compact perk tags
Perk Catalog
Weapons
• Bullet Damage I–IV – Increases bullet damage dealt.
• Explosion Damage I–IV – Increases explosive damage dealt.
• Accuracy I–IV – Reduces weapon spread (tighter aimcone).
• Magazine Size I–IV – Increases magazine capacity.
• StatTrack – Tracks lifetime kills (players / animals / NPCs).
• Hunter’s Instinct – Highlights nearby animals with markers.
🛡 Armor
• Projectile Resist I–IV – Reduces incoming projectile damage.
• Melee Resist I–IV – Reduces incoming melee damage.
• Explosion Resist I–IV – Reduces incoming explosive damage.
• Max Health I–IV – Increases maximum health (respects server caps).
• Durability I–IV – Slows condition loss on the item.
• Aquaman – Enables underwater breathing.
• Fall-damage Resist – Reduces fall damage taken.
⛏ Tools
• Wood Yield I–IV – Increases wood gathered.
• Ore Yield I–IV – Increases ore/stone gathered.
• Animal Yield I–IV – Increases animal resources gathered.
• Plant Yield I–IV – Increases plant/cloth/crop yield.
• Lucky Strike I–IV – Chance to double gathered resources.
Fun
Comic Hit – classic BAM/POW/WHACK text bursts
Laser Beam – colorful laser lines
Blood Fountain – juicy blood FX
🖥 User Interface
Three-column layout (Perk Tokens / Targets / Context)
Category filters: Weapons, Armor, Tools, Fun
Gamble panel with drop chances & costs
Held item panel with active perks + clear cost
Perk Info window – rarity colors, pages, readable descriptions
Market UI – browse all listings, manage yours, and claim payouts
Commands
/perks → Open main UI
/pmarket → Open market
/marketclaim → Claim pending payouts
/ap → Shortcut to /perks
Admin Only: /perks give <player> <perkId> [amount]
Balance & Config Highlights
Costs: Scrap / Tech Trash / Wood / Stones, plus Economics or ServerRewards
Workbench Rules: configurable tiers & radius for Apply / Clear
Rarity Weights: fully adjustable odds for Common → Epic + Fun
Loot Spawns: per-container filters with min/max token count
Market System: min/max price, listing cap per player, duration, safe payouts
Max Perks per Item: configurable caps for Weapons / Armor / Tools
Item Rules: blacklist (e.g., C4) & whitelist (e.g., rocketlauncher → Magazine Size only)
Health Caps: server-wide % cap, HP cap, or unique-per-player
Hunter’s Instinct: tick rate, radius, marker count & color
🛡 Safety & Compatibility
• 
Tokens securely bound to Perk IDs (server-mapped, unspoofable)
Wipe Reminder (Important)
After each server wipe, delete this plugin’s data file to prevent old item GUID/perk mappings or market records from carrying over.
Default path (Oxide): oxide/data/AdvancedPerks.json
Default path (Carbon): carbon/data/AdvancedPerks.json
The file will be recreated fresh on next load.
With AdvancedPerks, every item becomes unique—whether it’s a Weapon, Armor, Tool, or just for Fun.
