igraes's Wishlist

Bank System adds a bank to your server. Players get a card and a balance, transfer money to each other and use ATMs that other players own and profit from. Every deposit, withdrawal and transfer lands in a history the player opens from the bank window. The interface ships in seven templates, so it works as a fullscreen menu or inside any ServerPanel version, and the balance can be the plugin's own or come from Economics, ServerRewards or another economy plugin.
 
  
 
💰 Features
Bank card with balance, transaction history and gather history in one window. Cards can be created automatically on first open and expire after a set number of days. Transfers between players: pick someone from the list or type a card number. The list can show everyone or only players who are online. Player-owned ATMs. A player buys an ATM, places it and earns the deposit and withdrawal fees other players pay at it. ATMs break during operations and are repaired with items you choose, priced per 1% of condition. A permission can lower the breakage chance for a group. Two fee modes: take the fee out of the amount the player entered, or charge it on top. ATMs at monuments through the built-in spawn settings or MonumentAddons. Pay players for gathering, picking up collectibles, looting crates and kills. Set a price per shortname or prefab; the money goes to the balance or into the player's hands as banknotes. Banknotes as an item, with a configurable drop from crates. Seven UI templates: fullscreen Old Style and New Rust, ServerPanel V1, V2 and V4, and both ATM styles. Each template is a JSON file in the data folder, so the look is editable without touching the code. Your own balance or a third-party one: Economics, ServerRewards and any plugin with add, remove and show hooks. Balances convert from Economics and ServerRewards with one command. Works with HumanNPC, Notify/UINotify and LangAPI. Offline image mode for when image hosts rate-limit you. Auto wipe for players, logs and ATMs, each on its own switch.  
🎮 Commands
bank: open the bank. The command names come from Commands in the config. ATM command: opens the ATM window from chat. The list Commands to open ATM menu is empty by default; add a name such as atm to enable it. Permission to open ATM menu via command gates it. bank.givenote [targetId] [amount]: give banknotes to a player. bank.giveatm [targetId] [amount]: give ATMs to a player. bank.setbalance [targetId] [amount]: set a player's balance. bank.deposit [targetId] [amount]: add money to a player's balance. bank.withdraw [targetId] [amount]: take money from a player's balance. bank.transfer [playerId] [targetId] [amount]: move money from one player to another. bank.wipe: remove every ATM from the plugin data. Wiping players and logs on a new save is set in Wipe Settings. bank.convert.economics: import balances from Economics. bank.convert.serverrewards: import balances from ServerRewards. bank.template <interface_type> <template>: switch the UI template. Server console only. Without arguments it prints the list below. The choice is saved to the config (Fullscreen style (OldStyle/NewRust) and Template) and applied at once.
Parameters: <interface_type>: fullscreen for the standalone window, inmenu for the ServerPanel page. <template> for fullscreen: old or new. <template> for inmenu: v1, v2, v4 or auto. With auto the plugin reads the template version from the ServerPanel category it is placed in. Examples: bank.template fullscreen old: sets the fullscreen UI to the old style template. bank.template fullscreen new: sets the fullscreen UI to the new Rust template. bank.template inmenu v1: sets the in-menu UI to the ServerPanel V1 template. bank.template inmenu v2: sets the in-menu UI to the ServerPanel V2 template. bank.template inmenu v4: sets the in-menu UI to the ServerPanel V4 template. bank.template inmenu auto: picks the in-menu template from the ServerPanel category. The admin commands above (bank.givenote through bank.convert.serverrewards) run from the server console or from a player with admin rights.
 
🛡️ Permissions
banksystem.use: access to the bank. The name is whatever you put in Permission (example: banksystem.use); leave it empty and the bank is open to everyone. ATM command permission: the value of Permission to open ATM menu via command. Players without it can still use a placed ATM; only the chat command is gated. Breakage permissions: Breakage percentage during operation maps a permission to a breakage percent. Give a group its own permission and a lower percent to make their ATMs break less often.  
🖼️ Showcase
Fullscreen templates
Template OLD STYLE
Template NEW RUST
 
In-menu templates (ServerPanel)
Template V1
Template V2
Template V4
 
ATM
Template OLD STYLE
Template NEW RUST
The ATM follows the fullscreen style: Fullscreen style (OldStyle/NewRust) in the config picks both the bank window and the ATM look.
 
🧪 TEST SERVER
Join our test server and try the features yourself.
Copy the IP address below to connect.
connect 155.103.86.38:28015  
⚙️ Web Config Editor
Manage the BankSystem settings in our web config editor. You change the config in a browser form instead of editing files on the server by hand.

P.S. The web config editor is open to members of the "BankSystem" group in our Discord server. Join at https://discord.gg/mevent and ask for the group.
 
📚 FAQ
Q: Where can I see an example of a config?
A: Config
Q: How do I switch the template?
A: From the server console: bank.template fullscreen old, bank.template fullscreen new, bank.template inmenu v1, v2, v4 or auto. Run bank.template with no arguments to print the list. The Showcase above shows what each one looks like.
Q: Where are the templates and how do I change the look?
A: Each template is a JSON file in oxide/data/BankSystem/Templates/ (carbon/data/BankSystem/Templates/ on Carbon): OldStyle.json, NewRust.json, V1.json, V2.json, V4.json, AtmOldStyle.json and AtmNewRust.json. Edit colors, sizes, fonts and positions there and reload the plugin. Delete a file and the plugin writes the default one back on the next load.
Q: I updated from 1.4.x. Where did my interface settings go?
A: Version 2.0.0 moved every interface setting out of the config and into the template files above. Your old config is saved to data/BankSystem/Backups/; open it next to the new template file and carry your colors and sizes over by hand.
Q: How do I add Bank System to ServerPanel?
A: Create a new category in ServerPanel with these settings:
"Type": "Plugin", "Plugin Name": "BankSystem", "Plugin Hook": "API_OpenPlugin" Then run bank.template inmenu auto and the bank page takes the template version of that category.
Q: How do ATM fees work?
A: ATM Settings sets the minimum, maximum, default and step for the deposit and withdrawal fees; the ATM owner picks the exact percent with a slider in the Manage screen. Deduct the fee from the entered amount? chooses between two modes: with true a player who enters 100 gets 100 minus the fee, with false the player pays 100 plus the fee.
Q: How do I use Economics or ServerRewards as the balance?
A: In Economy Settings set Use own economic system? to false and fill in the plugin name and its hooks. Economics:
"Economy Settings": {   "Use own economic system?": false,   "Plugin name": "Economics",   "Balance add hook": "Deposit",   "Balance remove hook": "Withdraw",   "Balance show hook": "Balance" } ServerRewards:
"Economy Settings": {   "Use own economic system?": false,   "Plugin name": "ServerRewards",   "Balance add hook": "AddPoints",   "Balance remove hook": "TakePoints",   "Balance show hook": "CheckPoints" } Q: How do I spawn an ATM at a monument using BankSystem and MonumentAddons?
A: Follow these steps to auto-spawn an ATM at your monuments:
Go to a Monument:
Position yourself at a monument where you want the ATM to appear (e.g., near a vending machine location). Spawn a Vending Machine:
Run the following command to spawn a vending machine using MonumentAddons:
/maspawn vendingmachine.deployed Convert It to an ATM:
Immediately change the vending machine's skin to the ATM design by running:
/maskin 2551771822
Confirm that 2551771822 matches the ATM skin ID configured in your BankSystem settings. Your ATM is now installed at the monument and will automatically respawn during wipes or map changes.
Q: I see black images with Rust logo or get error 429 when loading images. What should I do?
A: These issues come from failed image downloads. The plugin passes images to ImageLibrary but does not download them itself. Error 429 usually means an image host such as Imgur is rate-limiting you (see HTTP 429 documentation for details). To fix it, enable Offline Image Mode, which uses local images instead:
Enable the mode in config: Open "oxide/config/BankSystem.json" (or "carbon/config/BankSystem.json" for Carbon) Set "Enable Offline Image Mode": true Set up the images: Create folder "TheMevent" in "oxide/data" (or "carbon/data" for Carbon) Download PluginsStorage (click "CODE" → "Download ZIP") Extract the ZIP and copy all contents to the "TheMevent" folder Reload the plugin: Type o.reload BankSystem (Oxide) or c.reload BankSystem (Carbon) Note: If you want to add your own custom images, place them in the "TheMevent" folder and reference them with the "TheMevent/" prefix. For example: "TheMevent/Icon1.png", "TheMevent/MyCustomIcon.jpg", etc.
Q: How do I fix RUSTNote stack splitting issues?
A: Find "Enable item split control? (if there are errors with stack plugins - it is worth turning off)" in the config and set it to false.
 
📑 Hooks and API
Hooks:
private object CanPlayerCreateCard(BasePlayer player) private void OnPlayerCreatedCard(BasePlayer player) private void OnBalanceChanged(ulong member, int amount) API methods:
private string API_OpenPlugin(BasePlayer player) private bool HasCard(BasePlayer player) private bool HasCard(ulong member) private int Balance(BasePlayer player) private int Balance(string member) private int Balance(ulong member) private bool Deposit(BasePlayer player, int amount) private bool Deposit(string member, int amount) private bool Deposit(ulong member, int amount) private bool Withdraw(BasePlayer player, int amount) private bool Withdraw(string member, int amount) private bool Withdraw(ulong member, int amount) private bool Transfer(BasePlayer member, BasePlayer target, int amount) private bool Transfer(string member, string target, int amount) private bool Transfer(ulong member, ulong target, int amount) private int API_BankSystemBalance(BasePlayer player) private int API_BankSystemBalance(string member) private int API_BankSystemBalance(ulong member) private bool API_BankSystemDeposit(BasePlayer player, int amount) private bool API_BankSystemDeposit(string member, int amount) private bool API_BankSystemDeposit(ulong member, int amount) private bool API_BankSystemWithdraw(BasePlayer player, int amount) private bool API_BankSystemWithdraw(string member, int amount) private bool API_BankSystemWithdraw(ulong member, int amount) private bool API_BankSystemTransfer(BasePlayer member, BasePlayer target, int amount) private bool API_BankSystemTransfer(string member, string target, int amount) private bool API_BankSystemTransfer(ulong member, ulong target, int amount)

VehicleBoxes is a plugin that expands the vehicle storage system in the game. It allows players to attach and remove storage boxes from vehicles to create additional storage space and improve the overall utility of the vehicle.
The plugin aims to improve the game experience in Rust by providing more flexibility in vehicle usage. It adds an extra layer of customization and practicality to vehicles, making them even more valuable objects in the game.
Features:
- Add Boxes: Players can add storage boxes to supported vehicles.
- From version 1.2.0: you have the option to store a standard skinid
- Remove Boxes: Players can remove added boxes from vehicles.
- Vehicle Support: Currently supports Minicopter and Scrap Transport Helicopter.
- Permission System: Ensures that only authorized players can add or remove boxes.
- Configurable: Customizable box prefab and positioning for different vehicle types.
Commands:
/addbox Adds a storage box to the vehicle the player is looking at.
/removebox Removes the storage box from the vehicle the player is looking at.
Permissions:
vehicleboxes.addbox Allows players to add boxes to vehicles.
vehicleboxes.removebox Allows players to remove boxes from vehicles.
Configuration:
The plugin settings can be adjusted in the VehicleBoxes.json file in the config folder. Here you can change properties like the box prefab and the position/rotation for different vehicle types.
{ "BoxPrefab": "assets/prefabs/deployable/woodenbox/woodbox_deployed.prefab", "BoxSkinId": 3107710831, "VehiclePositions": { "assets/content/vehicles/minicopter/minicopter.entity.prefab": { "Position": { "x": 0.0, "y": 0.31, "z": -0.57 }, "Rotation": { "x": 0.0, "y": 90.0, "z": 0.0 } }, "assets/content/vehicles/scrap heli carrier/scraptransporthelicopter.prefab": { "Position": { "x": -0.5, "y": 0.85, "z": 1.75 }, "Rotation": { "x": 0.0, "y": 0.0, "z": 0.0 } } } } Multilingual Support:
The plugin supports multiple languages. Language files are located in the lang folder and can be edited or expanded as needed. Currently supported languages:
default: EN
DE | FR | ES | IT | TR | RU | UK
Please note that the language files were translated using the DeepL Language Tool
load, run, enjoy 💝

Bring these intelligent animal companions to your server! They can fight, gather resources, carry supplies, and even be ridden. Choose from various customizable animals: bear, boar, chicken, deer, wolf, crocodile, panther, tiger, cow, bull, calf, sheep, lamb, rabbit, squirrel or frog! 
 
Features:
✔️ Resource Gathering & Looting
• Collect essential resources like wood, stone, and ore.
• Automatically gather resources within 50 meters using auto-pickup.
• Loot crates and boxes for valuable items.
✔️ A True Companion
• Command your animal to attack enemies, structures, or objects.
• Ride your animal for faster travel.
• Store items in the animal’s inventory (configurable up to 36 slots).
• Keep your companion healthy with a nutrition system that restores health.

Total Customization & Control
🎯 Animal Settings
• Select your preferred animal: Bear, Boar, Chicken, Deer, Wolf, Crocodile, Panther, tiger, cow, bull, calf, sheep, lamb, rabbit, squirrel, or frog.
• Configure max health, respawn time, and combat abilities.
• Adjust damage rates, player interactions, and looting permissions.
🛠️ User-Friendly Controls & UI
• Assign commands with a customizable buttons.
• Display 3D arrows over targets for better visibility.
• Fully customize the GUI layout, colors, and refresh rate.
• Blacklist specific items from your animal’s inventory bag.
🍖 Feeding System
• Enable nutrition settings to maintain your animal’s health.
• Configure health restoration values for different food items.
   
Useful Commands:
✅ /panimal – Spawn or despawn your animal.
✅ /panimal follow – Have your animal follow you.
✅ /panimal health – Check your animal’s current health.
✅ /panimal auto-pickup enable/disable – Turn resource auto-collection on or off.
✅ /panimal where – Locate your animal on the map.
📸 See It in Action! Watch the Video
📃 Configuration:
{   "Controls setup": {     "Which button will assign tasks to the animal, attack / collect, etc. (MIDDLE_MOUSE, SECOND_MOUSE, E, RELOAD, SPRINT)": "MIDDLE_MOUSE",     "Range of action of the assignment button": 25.0,     "Display 3D arrows over a target?": true,     "Arrow display duration": 2   },   "GUI setup": {     "How many seconds to update the GUI?": 6,     "Panel layer (Hud, Overlay, Overall, Hud.Menu, Under)": "Overlay",     "Panel position": {       "type": "RectTransform",       "anchormin": "1 1",       "anchormax": "1 1",       "offsetmin": "-170 -104",       "offsetmax": "-10 -10"     },     "Second position of the panel (used if the player has a personal bot)": {       "type": "RectTransform",       "anchormin": "0.0 0.0",       "anchormax": "1.0 1.0",       "offsetmin": "0.0 0.0",       "offsetmax": "0.0 0.0"     },     "1 panel color": "#7f8c8d",     "2 panel color": "#bdc3c7",     "Health bar color": "#2ecc71",     "Shortcut buttons": []   },   "Setting up personal animals by permission": {     "personalanimal.wolf": {       "The name of the animal to be selected through the command when spawning": "wolf",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "wolf",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.bear": {       "The name of the animal to be selected through the command when spawning": "bear",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "bear",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.boar": {       "The name of the animal to be selected through the command when spawning": "boar",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "boar",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.chicken": {       "The name of the animal to be selected through the command when spawning": "chicken",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "chicken",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.stag": {       "The name of the animal to be selected through the command when spawning": "stag",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "stag",       "Maximum health": 200,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     },     "personalanimal.polarbear": {       "The name of the animal to be selected through the command when spawning": "polarbear",       "Animal type (bear, boar, chicken, stag, wolf, polar-bear)": "polar-bear",       "Maximum health": 400,       "Animal spawn cooldown": 10.0,       "Addons setup": {         "Enable the ability to ride an animal?": true,         "Add a bag to an animal to store resources?": true,         "Number of available slots in the bag (maximum 36)": 12       },       "Functions setup": {         "Can the animal attack objects?": true,         "Can an animal loot boxes?": true,         "Can the animal pick up resources?": true,         "Does the animal have to defend itself?": true,         "Should the animal protect the owner?": true,         "Can an animal collect resources within a radius of 50 meters? (/panimal auto-collect)": true       },       "Damage, interactions and loot setup": {         "Animal damage rate": 2.0,         "Damage rate receive for an animal": 1.0,         "Can the animal damage players?": true,         "Can players damage the animal?": true,         "Despawn animal corpse after death?": false,         "Setting up resource pickup rates": {           "stones": 5.0         },         "Black list of items that cannot be put in the bag": [           "rocket.launcher"         ]       },       "Nutrition setup": {         "Turn on the animal feeding system?": true,         "Setting health for food eaten": {           "corn": 5.0         }       }     }   },   "List of prefabs that the animal can loot (useful if the animal attacks loot instead of looting it)": [     "foodbox",     "vehicle_parts"   ] }  

The NpcDetective plugin adds a detective named Stewie, standing in the outpost and bandit camp.
Detective for a specified fee through time will send information about the location of the player, but there is a chance that the detective will not be able to find him, as well as that the target will feel the gaze of the detective directed at him.
The plugin is aimed at PVP content and will definitely be of interest to your players who love battles, because they will be able to find out the whereabouts of the obitchik or if they are lucky to find out where his house is, which will allow them to raid him.
Some details of the default plugin settings:
There are 2 spawn points on the monuments, in the outpost and the bandit camp. Default mission completion time is 5 to 10 minutes. Chance of mission failure - 30% Chance that the target will feel the detective's gaze - 10%. Kulldown 10 minutes Price for the service is 200 scrap Features:
The plugin supports 4 types of economics namely Economics, ServerRewards, IQEconomics, Items Has completely identical UI that Rust uses for conversations as well as for player selection. The UIs have been replicated from scratch and do not require extra dependencies. It has dialogs already ready to use. Provides the ability to translate each of the plugin texts, including the name of the bot above. A wide range of mission settings, including the chances of a variety of events, which greatly fuels interest. The plugin is immediately ready to use without further customization. Permissions:
npcdetective.allow - allows you to use the services of NPCs Commands:
getnpcpos - allows you to get a spawn point for an NPC, relative to a monument or world (in this case specified as "custom”)
  Video:

Default Config:
{ "Spawn Points": { "assets/bundled/prefabs/autospawn/monument/medium/compound.prefab": "-26.38629 0.2249966 -20.25003 -6.138487 245.2638 7.046678", "assets/bundled/prefabs/autospawn/monument/medium/bandit_town.prefab": "42.65682 7.059561 -31.20314 8.198808 329.3285 7.740015" }, "Payment Settings": { "Provider (Economics | ServerRewards | IQEconomics | Item)": "Item", "Provider Currency Name": "scrap", "[Item Provider] Short Name": "scrap", "[Item Provider] Skin ID": 0, "Price of search service": 200 }, "Mission Properties": { "Information Accuracy Type (Mark | Grid)": "Mark", "Lead Time Range Min (in seconds)": 300.0, "Lead Time Range Max (in seconds)": 600.0, "Cooldown in seconds": 600.0, "Chance of mission failure (0-100%)": 30.0, "Сhance that the target will sense the presence (0-100%)": 10.0 } }  

Item Perks is a plugin that enhances everyday weapons, tools and armour with over 50 different types of perks.
Items with perks can be obtained a variety of ways, including:
Finding them randomly in crates or barrels during your morning scrap farm. Randomly crafting an enhanced version of your equipment while you roof camp noobs from your base. Recycling enhanced equipment and finding enhancement kits stuck in the teeth of the recycler. Using a console or chat command that can be ran through seedy plugin traders like GUIShop.  
The plugin gives a large amount of control to server owners when it comes to implementation. You can:
Enable/disable perks, or modify the minimum and maximum values that they roll when applied to gear. Blacklist or whitelist items to each perk, so they will be exclusively excluded or included (based on the list you choose). Adjust the weight of each perk, so it is more or less likely to be seen on gear., or adjust the chances amount of perks that items can potentially have. Fully adjust or disable the chance for item drops to be found, or enable the enhancement kit system so players can recycle gear. So much more (watch the configuration section of the video below to see the full extent).  
 
 

There are over 50 perks included with the plugin. The following list will describe briefly what each perk does.
Name: Prospector Description: This perk increases your mining yield when mining stone, metal and sulfur nodes. Name: Lumberjack Description: This perk increases your woodcutting yield when chopping living or dead trees. Name: Butcher Description: This perk increases the resources gained from skinning humans and animals. Name: Horticulture Description: This perk increases the amount of resources gained when harvesting grown plants. Name: Forager Description: This perk increases the amount of resources gained when picking up map generated collectibles. Name: Angler Description: This perk increases the amount of fish you receive upon a successful catch. Name: BeastBane Description: This perk increases the damage dealt to animals. Name: ScientistBane Description: This perk increases the damage dealt to scientists. Name: FlakJacket Description: This perk reduces the damage received from explosions. Name: Elemental Description: This perk reduces damage from received from cold and heat sources. Name: Scavenger Description: This perk provides you with a chance to find additional scrap from crates and barrels. Name: Manufacture Description: This perk increases the speed of your crafting. Name: Durable Description: This peark reduces the durability damage of all equipped items. Name: BeastWard Description: This perk reduces the damage received from animals. Name: ScientistWard Description: This perk reduces the damage received from scientists. Name: Builder Description: This perk provides you with a chance for your building upgrades to be free. Name: Thrifty Description: This perk provides you with a chance for your crafting components to be refunded upon a successful craft. Name: Fabricate Description: This perk provides you with a chance to duplicate an item upon a successful craft. Name: Pharmaceutical Description: This perk increases the amount of healing received from all sources. Name: MeleeWard Description: This perk reduces the damage received from melee weapons. Name: Academic Description: This perk provides you with a chance to receive a scrap refund when researching an item at the research bench. Name: FallDamage Description: This perk reduces the impact damage received from falling. Name: Lead Description: This perk reduces the damage from radiation. Name: Smasher Description: This perk will provide you with a chance to instantly destroy barrels with any amount of damage. Name: Environmentalist Description: This perk will increase the speed of recyclers that you activate. Name: Smelter Description: This perk will increase the smelting speed of furnaces you activate. Name: Paramedic Description: This perk provides players that you revive with additional health. Name: Prepper Description: This perk provides you with a chance to not consume food when eating. Name: Regeneration Description: This perk will passively regenerate you. Name: SharkWard Description: This perk will reduce the amount of damage received from sharks. Name: SharkBane Description: This perk will increase the amount of damage dealt to sharks. Name: Deforest Description: This perk provides you with a chance to cut down nearby trees when successfully cutting a tree down. Name: BlastMine Description: This perk provides you with a chance to mine out nearby nodes when successfully mining out a node. Name: Tanner Description: This perk provides you with a chance to skin nearby corpses when successfully skinning out a corpse. Name: Vampiric Description: This perk will heal you for a percentage of the damage dealt to certain enemies. Name: Reinforced Description: This perk will reduce the the amount of damage that your vehicles receive when mounted. Name: ComponentLuck Description: This perk will provide you with a chance to receive additional components when looting barrels and crates. Name: ElectronicsLuck Description: This perk will provide you with a chance to receive additional electronics when looting barrels and crates. Name: UncannyDodge Description: This perk provides you with a chance to dodge incoming damage, reducing it to 0. Name: LineStrength Description: This perk increases the tensile strength of your fishing line. Name: HealShare Description: This perk will share healing effects with nearby players. Name: Attractive Description: This perk will provide you with a chance to automatically pick up components when destroying barrels. Name: WoodcuttingLuck Description: This perk provides you with a chance to find a random item when you cut down a tree. Name: MiningLuck Description: This perk provides you with a chance to find a random item when you mine out a node. Name: SkinningLuck Description: This perk provides you with a chance to find a random item when you skin out a corpse. Name: FishingLuck Description: This perk provides you with a chance to find a random item when you catch a fish. Name: Sated Description: This perk will increase the amount of calories and hydration you receive from food and water sources. Name: IronStomach Description: This perk provides you with a chance to negate negative effects when consuming food. Name: TreePlanter Description: This perk will provide a chance for a tree to instantly regrow when cut down. Name: RockCycler Description: This perk will provide a chance for a node to instantly respawn when mined out. Name: BradleyDamage Description: This perk increases the damage dealt to Bradley Tanks. Name: HeliDamage Description: This perk increases the damage dealt to Patrol Helicopters. Name: Thorns Description: This perk reflects a % of the damage done back to the attacker Name: TurretDamage Description: This perk increases the damage dealt to Auto Turrets. Name: Rancher Description: This perk increases the amount of milk and wool you receive when milking cows and shearing sheep. Name: Wrangler Description: This perk increases the speed at which livestock become familiar with you while you handle them. Name: Herder Description: This perk reduces the time it takes for cows to produce milk and sheep to regrow wool after you milk or shear them.  

Command: ipgive
Type: console/chat
Parameters: <target ID/Name> <optional: shortname> <optional: perks>
Description: Gives the target player an enhanced item. If shortname is specified, it will base the enhancement off of that item. If perks are specified, it will add only those perks to the item.
Command: ipgivekit
Type:  console/chat
Parameters:  <target ID/Name> <perk>
Description:  Gives an enhancement kit to the target.
 

itemperks.use - Required to receive any benefit from enhanced items. itemperks.loot - Required to loot enhanced items from crates and barrels. itemperks.craft - Required for a chance to received enhanced versions of crafted gear. itemperks.admin - Required to use admin commands. itemperks.enhance - Required to add enhancement kits to items via the workbench. itemperks.recycle - Required to receive enhancement kits from recycling enhanced items.  

IPAPI_CreateItem - creates and returns an enhanced item using the details fed into the method. If shortname is left blank, it will pick a random valid item. If api_perks is null it will pick random perk(s) and add them.
Returns Item
[HookMethod("IPAPI_CreateItem")] public object IPAPI_CreateItem(string shortname = null, ulong skin = 0, Dictionary<string, float> api_perks = null) { List<KeyValuePair<Perk, float>> perks = Pool.GetList<KeyValuePair<Perk, float>>(); foreach (var perk in api_perks) { Perk _perk; if (parsedEnums.TryGetValue(perk.Key, out _perk)) perks.Add(new KeyValuePair<Perk, float>(_perk, perk.Value)); } var result = CreateItem(shortname, skin, perks); Pool.FreeList(ref perks); // Returns an Item class return result; } Example usage:
[ChatCommand("testipapi")] void TestIPAPI(BasePlayer player) { Dictionary<string, float> perks = new Dictionary<string, float>() { ["Prospector"] = 1f, ["Lumberjack"] = 1f, ["Butcher"] = 1f, ["Horticulture"] = 0.5f }; var item = (Item)ItemPerks.Call("IPAPI_CreateItem", "hammer.salvaged", (ulong)2830083288, perks); if (item == null) { Puts("Failed"); return; } item.name = "tool of the trade"; player.GiveItem(item); }