Vinni_TV_'s Wishlist
-
Heli Pilots
Want more intense air combat and dynamic patrols on your Rust server?
HeliPilots introduces AI helicopter pilots ready to dominate the skies and attack players from the air. Customize everything - from helicopter type and pilot behavior to flight routes!
Features:
🚁 Helicopter Setup
• Supports Scrap Transport Helicopter, Minicopter and Attack Helicopter.
• Customizable AI pilots with adjustable health, clothes, weapons, and combat behaviour.
• Define specific flight behavior, speed, altitude, and route paths — random or pre-defined.
🔥 Combat & AI Behavior
• Pilots dynamically engage or avoid player attacks.
• Setup rockets and turret for Attack Helicopter.
• Customize aggression level — determine whether AI attacks immediately or must be provoked.
• Customize damage, accuracy, and targeting behavior.
⚙ Advanced Heli Customization
• Modify flight speed, fuel consumption, durability, and damage rate.
• Customize helicopter loot tables and drop rates.
• Configure crash behavior, detonator and other.
🎯 Pilot Customization
• Set health, clothes, weapon loadouts, and equipment.
• Custom damage multipliers.
• Customize pilot loot, including weapons, items and resources.
🛠 Event & Path System
• Record custom flight paths or let the plugin auto-generate patrol routes.
• Control event triggers, spawn rates, patrol frequency, and respawn timers.
🖥 Admin Commands (permission drivercontroller.admin)
• spawnhelitest – Spawn a test helicopter with AI pilot.
• removehelitest – Delete spawned test helicopters.
• visibleheli – Toggle admin visibility of AI helicopters.
• recordhelipath – Record a custom helicopter patrol path.
📺 See It in Action! Watch the Video
⚠️ After downloading you’ll also get plugin called DriverController. It’s a single plugin to setup presets of bots and loot between all of my plugins.
📃 Configuration:
{ "Event settings": { "Allowed events (vehicle) count": { "Min": 3.0, "Max": 6.0 }, "Event restart delay": { "Min": 60.0, "Max": 120.0 }, "Prevent NPC from attacking drivers and companions?": true, "Block damage to transport from not players?": true, "Block damage to driver and companion from not players?": true, "Destroy events of this plugin when pause is enabled?": true, "Delete the event if ran out of fuel?": true, "Marker text color": { "Color (for HEX, put # at the beginning)": "0.4 0.5 0.6 1" }, "Event name for the marker": "EVENT HELI", "Route recording settings": { "Enable recorded routes usage?": true, "Clear saved routes after wipe?": true, "Minimum distance between points to record in route (used when recording route)": 40.0, "Minimum number of points to save (used when recording route)": 30.0, "Recorder route height": 50.0 }, "Route generation": { "Enable route generation": true, "Maximum number of monuments for a flight, when generating a route": 5, "Names of monuments, prefabs or their part, for the blacklist (will be excluded when generating a route)": [ "Outpost" ] }, "Controller settings": { "Controller update timer (0 - 0.2)": 0.0 } }, "Loot container position settings": { "Minicopter": { "Container position offset on the vehicle": { "x": 0.0, "y": 0.95, "z": -0.8 }, "Container rotation offset on the vehicle": { "x": 0.0, "y": 0.0, "z": 0.0 } }, "TransportHeli": { "Container position offset on the vehicle": { "x": 0.0, "y": 0.95, "z": -0.8 }, "Container rotation offset on the vehicle": { "x": 0.0, "y": 0.0, "z": 0.0 } } }, "Heli settings": [ { "Activate this event?": true, "Transport type for event(Minicopter, TransportHeli)": "Minicopter", "Driver name (key) from driver settings in DriverController plugin": "PilotHeli", "Companion name (key) from companion settings in DriverController plugin (list to occupy free seats in the vehicle)": [ "Companion1" ], "Loot container settings": { "Enable loot in vehicle container?": true, "Drop the loot when destroying the transport?": false, "Amount of slots": 1, "Name of loot set from loot settings in DriverController plugin (list loot sets for random selection)": [ "ResourcesHeli" ] }, "Сontroller settings": { "Max speed (km/h)": 40.0, "Maximum speed when obstacles detected (km/h)": 15.0, "Height for flying along the route": { "Min": 30.0, "Max": 60.0 }, "Chase mode settings": { "Chase attacking players?": true, "Max chase distance": 250.0, "Chase timer": 120.0, "Maximum speed during chase (km/h)": 60.0, "Height for flying during chase": { "Min": 10.0, "Max": 30.0 } } }, "Damage receive rate": 0.5, "Fuel settings": { "Enable automatic fuel refueling?": true, "Remove fuel when unlocking vehicle?": true, "Maximum fuel in vehicle": 500 }, "Vehicle headlight settings": { "Enable vehicle headlights?": true, "Use headlights only at night?": true }, "Detonator settings": { "Add C4 to the vehicle after the death of the driver (used to despawn vehicles)": true, "After how many seconds explosives will be blown up": 60.0, "Explosives position offset": { "x": 0.0, "y": 0.1, "z": 0.0 } } }, { "Activate this event?": true, "Transport type for event(Minicopter, TransportHeli)": "TransportHeli", "Driver name (key) from driver settings in DriverController plugin": "PilotHeli", "Companion name (key) from companion settings in DriverController plugin (list to occupy free seats in the vehicle)": [ "Companion1" ], "Loot container settings": { "Enable loot in vehicle container?": true, "Drop the loot when destroying the transport?": false, "Amount of slots": 1, "Name of loot set from loot settings in DriverController plugin (list loot sets for random selection)": [ "ResourcesHeli" ] }, "Сontroller settings": { "Max speed (km/h)": 40.0, "Maximum speed when obstacles detected (km/h)": 15.0, "Height for flying along the route": { "Min": 40.0, "Max": 70.0 }, "Chase mode settings": { "Chase attacking players?": true, "Max chase distance": 250.0, "Chase timer": 120.0, "Maximum speed during chase (km/h)": 60.0, "Height for flying during chase": { "Min": 5.0, "Max": 20.0 } } }, "Damage receive rate": 0.5, "Fuel settings": { "Enable automatic fuel refueling?": true, "Remove fuel when unlocking vehicle?": true, "Maximum fuel in vehicle": 500 }, "Vehicle headlight settings": { "Enable vehicle headlights?": true, "Use headlights only at night?": true }, "Detonator settings": { "Add C4 to the vehicle after the death of the driver (used to despawn vehicles)": true, "After how many seconds explosives will be blown up": 60.0, "Explosives position offset": { "x": 0.0, "y": 0.8, "z": 0.0 } } } ] } 📑 DriverController Configuration:
{ "Drivers settings": { "DriverBike": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "shoes.boots", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 }, { "Item": { "Item shortname or ID": "wood.armor.pants", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 }, { "Item": { "Item shortname or ID": "pants", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 }, { "Item": { "Item shortname or ID": "wood.armor.jacket", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 }, { "Item": { "Item shortname or ID": "hoodie", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 }, { "Item": { "Item shortname or ID": "riot.helmet", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "pistol.revolver", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesDriver" ] } }, "DriverCar": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "hazmatsuit", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesDriver" ] } }, "DriverBoat": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "hazmatsuit", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "t1_smg", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesDriver" ] } }, "PilotHeli": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "jumpsuit.suit.blue", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesDriver" ] } } }, "Companion settings": { "Companion1": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "hazmatsuit_scientist_nvgm", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesCompanion", "WeaponsCompanion" ] } }, "Companion2": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "hazmatsuit.arcticsuit", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesCompanion", "WeaponsCompanion" ] } }, "Companion3": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "hazmatsuit.lumberjack", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesCompanion", "WeaponsCompanion" ] } }, "Companion4": { "Bot health": { "Min": 100.0, "Max": 150.0 }, "Prevent attacking players first?": true, "Damage receive rate": 2.0, "Damage rate": 2.0, "Spawn bag with items instead of corpse on death?": true, "In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0, "Clothes": [ { "Item": { "Item shortname or ID": "hazmatsuit.spacesuit", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Weapons": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Amount": 1 } ], "Bot loot": { "Enable loot after bot's death?": true, "Amount of slots": 5, "Loot set name (key) from loot settings (you can enter many sets for random selection)": [ "ResourcesCompanion", "WeaponsCompanion" ] } } }, "Loot settings": { "ResourcesBike": [ { "Item": { "Item shortname or ID": "wood", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 5000.0, "Max": 50000.0 } }, { "Item": { "Item shortname or ID": "stones", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 1000.0, "Max": 10000.0 } } ], "ResourcesCar": [ { "Item": { "Item shortname or ID": "wood", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 5000.0, "Max": 50000.0 } }, { "Item": { "Item shortname or ID": "stones", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 1000.0, "Max": 10000.0 } } ], "ResourcesBoat": [ { "Item": { "Item shortname or ID": "wood", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 5000.0, "Max": 50000.0 } }, { "Item": { "Item shortname or ID": "stones", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 1000.0, "Max": 10000.0 } } ], "ResourcesHeli": [ { "Item": { "Item shortname or ID": "wood", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 5000.0, "Max": 50000.0 } }, { "Item": { "Item shortname or ID": "stones", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 1000.0, "Max": 10000.0 } } ], "ResourcesDriver": [ { "Item": { "Item shortname or ID": "wood", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 1000.0, "Max": 10000.0 } }, { "Item": { "Item shortname or ID": "stones", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 100.0, "Max": 1000.0 } } ], "ResourcesCompanion": [ { "Item": { "Item shortname or ID": "wood", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 100.0, "Max": 1000.0 } }, { "Item": { "Item shortname or ID": "stones", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 100.0, "Max": 100.0 }, "Amount": { "Min": 10.0, "Max": 100.0 } } ], "WeaponsCompanion": [ { "Item": { "Item shortname or ID": "rifle.ak", "Item skin": 0 }, "Item custom name (if not needed leave empty)": null, "Spawn chance (0-100%)": { "Min": 40.0, "Max": 80.0 }, "Amount": { "Min": 1.0, "Max": 1.0 } } ] } }
-
TC Stack Limiter
TC Stack Limiter lets you set custom stack limits for items inside the Tool Cupboard (TC).
It’s a great way to control how much stuff players can store in the TC and help keep the game balanced.
Can this plugin do that?
Server operators can manage game balance by adjusting the number of items that can be stored in a TC.
Key Future
* Change the global stack size of items: by setting a global stack multiplier, you can change the stack size of a particular item.
* Item Stack Limit in Tool Cabinet: Apply a specific maximum stack number to wood, stone, Metal Fragments, and HQMs set in the Cabinet Stack Override. (e.g. if wood: 1000 is set, only a maximum of 1000 pieces of wood can be stacked in the tool cabinet).
* Notification: If enable notification is set to true, items that exceed the stack limit will be automatically returned to the player's inventory and the player will be notified.
* Handling of items exceeding stack limit: If a player attempts to place an item in the tool cabinet that exceeds the limit, the excess will be returned to the player's inventory. If the player's inventory is full, the item will be dropped to the floor.
Compatibility
* StackSizeController
* Loot Table & Stacksize GUI
Although this plugin is compatible with StackSizeController, an error is triggered every time an item is placed into a Tool Cupboard due to an issue on StackSizeController's side. For this reason, we recommend using Loot Table & Stacksize GUI instead.
Admin Commands
/tcstack list - Displays the current configuration.
/tcstack set <item shortname> <amount> - Sets the TC stack limit for the specified item to <amount>.
/tcstack remove <item shortname> - Removes the stack limit (reverts to the normal stack size in the TC).
/tcstack reload - Reloads the configuration.
Config
{ "Cupboard Stack Overrides": { "wood": 1000, "stones": 1000, "metal.ore": 1000, "metal.fragments": 1000, "hq.metal.ore": 100, "metal.refined": 100, "lowgradefuel": 500, "crude.oil": 500 "fat.animal": 1000, "cloth": 1000, "bone.fragments": 1000, "charcoal": 1000, "horsedung": 500, "fertilizer": 1000, "scrap": 1000 }, "Enable Notifications": true, // Toggle whether players receive a message when an item exceeds the stack limit. "Priority Mode (TCFirst or InventoryFirst)": "TCFirst", // "TCFirst": Try placing excess items in other TC slots first, then. "InventoryFirst": Try returning to player's inventory first, then TC. "Enforce TC Limits": true, // Whether to actually apply stack limits in the TC. If disabled, limits are only visual. "Split Excess Stacks": true, // If enabled, automatically split items into valid stack sizes when inserting into the TC. "Override Other Plugins for TC": true // "true": Prioritize TCStackLimiter values inside the TC. "false": Use the minimum stack size between TCStackLimiter and other plugins. }- #toolcupboard
- #tc
-
(and 2 more)
Tagged with:
-
Zombie Infection
By imthenewguy in Plugins
Zombie Infection is an arena style plugin that creates an arena high in the sky.
It pits 2 teams against each other: Survivors and Zombies.
All players spawn as Survivors when the game begins. The survivors must find weapons and ammunition to defend themselves from the oncoming Horde.
After 45 seconds (configurable), a random player is selected to become the leader of the Zombies, otherwise known as Zombie Prime. They are re-equipped and are allocated a large amount of health
When a zombie hits a survivor with a melee weapon, that player is infected and is re-spawned as a zombie.
Regular zombies do not have as much health as Zombie Prime, but they will re-spawn an infinite amount of times when killed.
The survivors win by surviving for the entire round (default 10 minutes), or by eliminating Zombie Prime.
The Zombies win by infecting all of the survivors.
It is worth mentioning that only Zombie Prime is rewarded for the zombie team win.
Regular zombies are instead rewarded based on the number of survivors they infect.
Each prize type can be changed via the config.
zistart <arena name> - Manually starts the Zombie Infection game [requires zombieinfection.admin] ziend - Manually ends the game [requires zombieinfection.admin] zisetcentrepoint - Changes the spawn location of the arena [requires zombieinfection.admin] ziwipeoldarena - Manually wipes old arena data [requires zombieinfection.admin] zijoin - Joins an active lobby zileave - Leaves the game and returns the player to their last location with all of their equipment ziprize - Redeems outstanding prizes to the players inventory
-
Discord Link
Discord Link is a very simple, performant, and feature-rich Discord and Rust linking system. 2 Simple steps and a player can link to Discord!
NO DISCORD.DLL!!
FEATURES
- NO DISCORD.DLL REQUIRED!!! - Link Rust and Discord accounts - Grant a role in discord and group in game for linked players - Soft unlinking (All past data on a user's account links will be forever stored) - 2 Way role syncing between rust to discord and discord to rust - Supports multi server linking - Booster perks for linked players boosting your discord - Steam to discord name syncing (Auto renames users in discord to their steam name) - Admin perms to unlink players - Search link commands in discord and in game to get who a player is linked to - Logs to discord when players link and unlink - Auto remove players from being linked when they leave the Discord - Syncing your old database files from steamcord, discord auth, or discord core PERMISSIONS
discordlinkbot.search - ability to search players and use the UI
The Plugin and Discord Bot both have very simple installations.
We have included a readme.md file to make it even easier to setup!
Need support or want updates about what is coming to the bot? Join the support discord here https://discord.gg/ZsRgCUNv2x
This will require bot hosting to run the bot 24/7 since we do not use the Discord DLL therefore the server cannot host the bot.
Thanks to @shady14u for co-developing!!
-
Clans
Clans gives your players one menu for everything a clan does: create it, invite people, hand out roles, make alliances, set gather quotas and clan skins, and check where the clan sits in the top. If you run ServerPanel, the menu opens inside it as its own category and matches your template, V1, V2 or V4. Without ServerPanel it opens fullscreen, in the Old Style or the New Rust look.
Clans also takes over Rust's own clan system. The F1 clan menu, the clan chat tab, clan names on the map and Rust+ all show Clans data, and in-game clan score events count toward your clan rating. Players get one clan, not two that disagree with each other.
Clan leaders build their own ranks. A role has a name, a color and twelve rights, from inviting and kicking to changing the avatar or toggling ally friendly fire, so a big clan can run itself without handing everyone leader rights. Data lives in JSON, Protobuf or MySQL, and one console command moves it between them. Updating from 1.x keeps your settings: old moderators become roles and the page settings move into the new menu.
🌟 Features of Clans
Five menu layouts: ServerPanel V1, V2 and V4, picked from your ServerPanel template on its own, plus two fullscreen styles, Old Style and New Rust. Every layout is a template file in data/Clans/Templates, where positions, colors and sizes can be changed Clan roles: leaders create roles with their own name and color and pick the rights: invite, kick, promote, demote, alliances, avatar, description, tag color, gather rates, skins, friendly fire and ally friendly fire Rust's clan system runs on Clans: the F1 clan menu, the clan chat tab, clan names on the map and Rust+, with in-game clan score events counting toward the rating Alliances: send, accept, cancel and revoke alliances, with a separate friendly fire switch for allies Friendly fire: per clan, with turret protection for clan mates as an option Gather rates: the clan sets how much of each resource every member has to bring in, and the menu shows how far each member got Clan skins: one set of skins for the whole clan, so you can tell your own people from the enemy at a glance Clan identity: avatar, tag color and a description, each behind its own role right Clan and player tops: pages with a page number field; the columns and the stat tiles on the About Clan page and in profiles are set in the config, each can be turned off or put behind a permission Player and clan profiles: open them from the member lists and the top tables Your menu, your pages: reorder, rename, hide or lock menu categories and pages behind permissions Paid actions: charge for creating, joining, leaving, kicking, disbanding, setting skins or the avatar, and for invites, through any economy plugin or with items Tag rules: minimum and maximum length, a blocked words list and an allowed characters filter. Errors show right in the Create a clan window Clan and alliance chat, with BetterChat support Clans Discord companion plugin: clan events and clan chat go to Discord through webhooks, and clan leaders can set their own webhook Storage: JSON, Protobuf or MySQL, and clans.convertstorage moves everything to another type Cleanup: purge inactive clans, and wipe clans, players or invites on a new map, each on its own switch Built for big servers: the top is rebuilt in small steps, data is written only when something changed, and the menu template is prepared in the background at startup
⚡ Performance
Clans is built for big servers. Statistics, friendly fire checks and turret targeting run without allocating memory on every call, the clan and player top is rebuilt in small steps instead of one long freeze, and data is written to storage only when something changed.
🖼️ Showcase
Fullscreen: Old Style
Fullscreen: New Rust
ServerPanel V1
ServerPanel V2
ServerPanel V4
✨ What makes it different
Clan roles: a name, a color and twelve rights per role
Rust's own clan menu shows the same clan
Clan events and chat in Discord
🎮 Commands
Players (the /clan and /clans names can be changed in the config):
/clan: open the clan menu /clan create <tag>: create a clan /clan disband: disband your clan /clan leave: leave your clan /clan join: open your invites /clan invite <name/steamid>, /clan withdraw <name/steamid>: invite a player, cancel an invite /clan kick <name/steamid>: kick a member /clan promote <name/steamid>, /clan demote <name/steamid>: move a member up or down a role /clan allyinvite <tag>, allywithdraw, allyaccept, allycancel, allyrevoke <tag>: manage alliances /clan ff, /clan allyff (also /cff, /aff😞 toggle friendly fire for the clan and for allies /clan description <text>, /clan tagcolor <hex>: set the description and the tag color /clan discord: set the clan's Discord webhook (Clans Discord) /cinfo <tag>: information about a clan /c, /cchat: clan chat; /a, /achat: alliance chat Admins: clans.manage (needs clans.admin)
list, listex: all clans, with members and online status in listex show [name/userId]: one clan and its members msg [clanTag] [message]: send a message to a clan create [name/userId] [clanTag], rename [oldTag] [newTag], disband [clanTag] invite, join, kick, owner, promote, demote [clanTag] [name/userId] Console:
clans.convertstorage <JSON|Protobuf|MySQL>: move all player and clan data to another storage type clans.refreshtop: rebuild the clan and player top now clans.refreshskins: reload the skins players can pick for clan skins clans.reborn.convert (Clans Converter) reads the data file of Clans Reborn (data/Clans.json) and makes clans from it clans.umod.convert (Clans Converter) does the same for the uMod Clans plugin (data/clan_data.json) clans.convert.olddata (Clans Converter) moves player settings from the data of Clans 1.x, such as friendly fire and clan skins clans.import.playerdatabase [field] (Clans Converter) brings player data over from the PlayerDatabase plugin. The field name defaults to Clans, and PlayerDatabase has to be loaded
🛡️ Permissions
clans.admin: the clans.manage command clans.cancreate, clans.canjoin, clans.canleave, clans.candisband, clans.cankick, clans.canskins: each is checked only when its switch is on in the "Permission Settings" section of the config Menu categories, pages, top columns, stat tiles, clan skins and the avatar change can each take a permission name of your own. The plugin registers it on load.
⚙️ Web Config Editor
Manage the Clans settings in our web config editor. Every section of the config has its own form, so you set up roles, pages, top columns, paid actions and storage in the browser instead of editing the JSON file by hand.
P.S. The web config editor is open to members of the "Clans" group in our Discord server. Join at https://discord.gg/mevent and ask for the group.
🎥 Video
🧪 TEST SERVER
Join our test server and try all the features yourself!
Copy the IP address below to start playing.
connect 155.103.86.38:28015
📚 FAQ
Q: What are the files in the download, and which ones do I need?
A: The archive has three plugin files, and only Clans.cs is required. It is the plugin itself, with the menu, roles, alliances, gather rates, skins, tops and storage, and it runs fine without the other two. ClansDiscord.cs is optional: it posts clan events and clan chat to Discord webhooks, so skip it if you do not use Discord. To use it, put your server webhook into "Admin webhook URL". Every event has its own switch and color, and team chat is off by default. Clan leaders can add their own webhook with the DISCORD button or /clan discord, and you can limit that to a permission and to the hosts you allow. ClansConverter.cs is optional and needed once, only when you move clan data from another plugin: install it, run the matching command from the server console or RCON (they do not work from the in-game F1 console), check that your clans came over, then delete the file. The commands are listed under Console above. If you start from scratch, you do not need it.
Q: How do I add Clans to ServerPanel?
A: In ServerPanel, create a category with Type: Plugin, Plugin Name: Clans, Plugin Hook: API_OpenPlugin. Clans reads your ServerPanel template and picks the matching layout: t1 and t1_1 give V1, t2 and t3 give V2, t4 gives V4. While that category exists, /clan opens it. To force a layout, set "UI Pattern" in the config to V1, V2, V4 or Fullscreen instead of Auto.
Q: Which storage type should I pick?
A: JSON is the default and works out of the box. Protobuf is faster and smaller on disk for big servers. MySQL lets several servers share clan data. You can switch any time with clans.convertstorage.
Q: I am updating from Clans 1.x. What happens to my data?
A: Clans and settings carry over. Old moderator settings and member colors become clan roles, and the page settings move into the new menu categories. The interface settings moved from the config to the template files in data/Clans/Templates. If you used PlayerDatabase, run clans.import.playerdatabase from Clans Converter once.
Q: Does Clans work with my other plugins?
A: Clans has the same API as other popular clans plugins, so plugins that support clans work with it too.
Q: How do I show the clan top on the screen?
A: Install Clans Top.
Q: Which other plugins do I need?
A: ImageLibrary on Oxide, for avatars and icons. Carbon has the image module built in.
Q: Where do I edit the text, or add my own language?
A: oxide/lang/en/Clans.json (or carbon/lang/en/). Copy it to lang/<code>/Clans.json and translate the values. English and Russian are included.
Q: Where can I see an example of the config?
A: Config
🔧 Hooks
void OnClanCreate(string tag) void OnClanCreated(IClan clan, ulong leaderId) void OnClanUpdate(string tag) void OnClanDestroy(string tag) void OnClanDisbanded(string tag, List<ulong> memberUserIDs) void OnClanRenamed(string oldTag, string newTag) void OnClanLeaderChanged(ulong newLeader, ulong oldLeader, string tag) void OnClanMemberJoined(ulong userId, string tag) void OnClanMemberLeft(ulong userId, string tag) void OnClanMemberGone(ulong userId, string tag) void OnClanMemberKicked(ulong userId, ulong actorId, string tag) void OnClanMemberPromoted(ulong userId, ulong actorId, string tag, string role) void OnClanMemberDemoted(ulong userId, ulong actorId, string tag, string role) void OnClanInvite(ulong inviterId, ulong targetId, string tag) void OnClanInviteRejected(ulong userId, string tag) void OnClanInviteWithdrawn(ulong inviterId, ulong targetId, string tag) void OnClanAllianceInvite(string tag, string targetTag, ulong actorId) void OnClanAllianceAccepted(string tag, string targetTag, ulong actorId) void OnClanAllianceInviteRejected(string tag, string targetTag, ulong actorId) void OnClanAllianceInviteWithdrawn(string tag, string targetTag, ulong actorId) void OnClanAllianceRevoked(string tag, string targetTag, ulong actorId) void OnClanChat(BasePlayer player, string message, string tag) void OnClanTopUpdated()
Questions, ideas and bug reports go to our Discord.