Vinni_TV_'s Wishlist

📘 About Battle Pass Reborn
A modern battle pass system for Rust that adds progression, missions, and rewards to your server. Players complete a wide variety of tasks — from PvP and farming to building and crafting — and earn experience (XP) to unlock unique rewards at each level. The plugin is fully customizable and integrates seamlessly with your server’s economy and other popular plugins.
The plugin also supports a Premium Battle Pass, giving players access to exclusive rewards and accelerated progression. This not only increases player engagement but can also generate additional revenue for server owners through premium access sales.
 
⭐ Key Features
Fully customizable progression system — levels, XP, and rewards for completing missions. Configurable mission types — PvP, events, farming, crafting, and many other activities. Premium Battle Pass — exclusive rewards and faster progression for premium users. Flexible integration — works with server economy and other popular plugins. Increased player engagement — encourages activity and retention between wipes. Modern and polished UI/UX — intuitive interface for viewing levels, missions, and rewards.  
🧭 Commands
/bp — opens the Battle Pass interface for the player (can be changed in the plugin config). /giveexp {steamid} {quantity} - adds the specified amount of XP to a player.  /removeexp {steamid} {quantity} - removes the specified amount of XP from a player. /resetprogressall - resets the progress of all players on the server. /resetprogress {steamid} - resets the progress of a specific player.  
🎯 Mission Types
Missions are loaded from a preset file (e.g., DefaultMissions.json) and can be customized with event types, conditions (e.g., item shortnames), target counts, and difficulties. XP rewards scale by difficulty (configurable: Easy=10, Medium=25, Hard=50).
 
extract: Gather/extract a resource (e.g., wood, stone). craft: Craft specific items. pickup: Pick up items (e.g., from ground or collectibles). loot: Loot a container (e.g., crates, barrels). kill: Kill entities (players, animals, scientists, helicopters, bradleys). build: Build structures. quest: Complete quests (from other plugins). growup: Grow and harvest plants. upgrade: Upgrade building blocks (e.g., wood to stone). fishcatch: Catch fish. heal: Use healing items (e.g., syringes). mlrsrocketfire: Fire MLRS rockets. itemuse: Use/consume items (e.g., food, medical). cardswipe: Swipe keycards. purchasing: Purchase items from NPCs/vending machines. hit_area (Head, Chest, Stomach, Arm, Hand, Leg, Foot): Hit specific body parts on players. kill_with_weapon: Kill using a specific weapon. recycling: Recycle items. gambling: Win in gambling (e.g., slots, wheels, cards; tracks deposits, wins, profits). enter_zone: Enter specific zones (via ZoneManager or similar). events: The plugin awards progress/XP in supported events. In mission presets you can specify conditions like "RaidableBase_Easy", "SpaceEvent", "ArmoredTrainEvent" etc.  
🎪 Event Points Integration
Supported events:
 
Air Event Arctic Base Event Armored Train Event Boss Monster Caravan Event Convoy Event Dungeon Event Ferry Terminal Event (FerryEvent) Flying Cargo Event Gas Station Event GunGame Event Harbor Event Junkyard Event Paintball Event Plant Event (PowerPlantEvent) Raidable Bases Event (with difficulty modes: Easy, Medium, Hard, Expert, Nightmare) Satellite Dish Event (SatDishEvent) Shipwreck Event Space Event Sputnik Event Supermarket Event (MarketEvent) Survival Arena Event Triangulation Event Tugboat Pirates Event (Tugboat) Water Event Abandoned Base Event Airfield Event  
 
🎁 Reward Types
Item Commands  
⚙️ Configuration
Main settings — BattlePassReborn.json Mission settings — DefaultMissions.json Level and reward settings — LevelsList.json UI Settings — UI.json

Bring your Rust server to life with Roaming NPCs — AI bots that act just like real players. They gather, loot, and fight, making your server feel active and alive.
 
Features:
⚒️ Realistic AI Behavior
• NPCs roam the map and simulate player-like behavior.
• Customizable behaviour: friendly, aggressive, defensive
• Spawn bots on beaches or random points around the map.
• Random or custom names and appearances.

🌲 Resource Farming
• Bots harvest wood, stone, metal, and sulfur using tools like rocks, hatchets, or pickaxes.
• Automatically pick up nearby dropped resources, food, and more.
• Loot crates and barrels found across the map.
• Automatically equip better gear found during looting.
  
⚔️ Dynamic Combat
• Bots attack wild animals like wolves, bears, and boars.
• Uses ranged and melee weapons – from bows to rifle ak.

🎒 Spawn Loadouts
• Configure bot spawn kits – tools, weapons, clothes, and other.
• Choose whether bots spawn with kit or start with rock and torch.
  
⚙️ Customization
• Setup health, damage rates, respawn timers and other.
• Record your own voice phrases that bot will replay on some actions using voice chat.
• Define bot's behavior:
- Friendly (doesn't attack, runs away)
- Defensive (defends if attacked)
- Aggressive (attacks first)
 
📺 See It in Action! Watch the Video
⚠️ Don't forget to download data files that include default voice phrases for bots. You can find them here (put this folder in oxide/data)
 
📋 Commands (roamingnpcs.admin permission):
/rnpc vis - shows all RoamingNPC's bots /rnpc stashvis - shows all RoamingNPC's stashes /rnpc killall - kills all RoamingNPC's bots /rnpc tp - teleports all RoamingNPC's bots to you /rnpc totp - teleports you to closest RoamingNPC bot /rnpc init - clears all data and respawns bot (needs to be done after editing config)
  /rnpc recvoice start - start recording /rnpc recvoice stop - stop recording /rnpc recvoice replay - listen to current recording (recording will be stopped) /rnpc recvoice save <file name> - save current recording /rnpc recvoice replay <file name> - listen to the recording from file /rnpc recvoice clear - clear current recording  
📃 Configuration:
{ "Specify the ID of the bot generator (8 - 15)": 9, "Bots settings": { "bob_resources_farmer": { "Enable bot?": true, "Bot appearance (Use the id in the range of the specified number of digits for the bot ID generator or leave 0 for random appearance)": 100000000, "Bot name (leave empty for random)": "Bob", "Respawn timer (3 - 60 seconds)": 300.0, "Use for respawn a random place on the map? (false - will respawn on the beach)": false, "Maximum health": 100.0, "What spawns on death (PlayerCorpse, NpcCorpse, Backpack)": "PlayerCorpse", "How many items will be destroyed when Backpack is selected (0 - 100%)": 50.0, "Bot behaviour - Aggressive, Friendly, Defensive": "Friendly", "Controller setup": { "Brain timer tick (0.01 - 1)": 0.1, "Controls timer tick (0.01 - 1)": 0.5, "Accuracy of fire (lower is better)": 10.0, "Find entities radius": 30.0, "Movement speed (1 - 4)": 4, "Movement speed in water (1 - 4)": 2, "Suicide timer if the bot does not reach the destination point (0 - disables the timer)": 600.0, "Timer attempt to avoid obstacle if the bot does not reach the target route": 3.0, "Damage rate from water": 1.0, "Allowed distance to teleport if the bot does not reach the destination point within this distance (-1 - allowed for any distance)": 0.0, "Damage rate to NPC targets": 2.0, "Damage rate to animals": 2.0, "Damage rate to players": 0.8, "Damage rate from NPCs": 0.2, "Damage rate from animals": 0.2, "Damage rate from players": 0.8 }, "Wear items (on respawn)": { "Lock container? (true - after death loot won't drop)": true, "Allow bot to wear found clothes?": false, "List of items": [ { "Item shortname or ID": "hazmatsuit.lumberjack", "Item skin": 0 } ] }, "Resource collection": { "Allow to gather wood?": true, "Allow to use fuel for chainsaw?": false, "Allow to mine ore?": true, "Allow to loot barrels?": false, "Allow to loot road signs?": false, "Allow to pickup resources?": true, "Allow to pickup dropped items?": false, "Allow to loot containers?": false, "Allow to loot corpses?": false, "Allow to harvest corpses?": false, "List of prefabs of corpses to harvest": [ "assets/rust.ai/agents/boar/boar.corpse.prefab", "polarbear.corpse", "bear.corpse", "stag.corpse", "wolf.corpse", "crocodile.corpse", "panther.corpse", "tiger.corpse", "chicken.corpse" ], "List of prefabs blocked for mining": [ "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree03.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtreeprefab.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree02.prefab" ] }, "Fights with NPCs and players": { "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 1.0 }, "Animal hunting": { "Allow to hunt? (true - will attack animals even if they are not attacking)": false, "Make melee weapons preferred for hunting?": true, "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 2.0, "List of prefabs of animals to block hunting them": [] }, "Inventory overflow": { "Stash setup (bot will put items in the stash)": { "Enable?": true, "Hide stash?": true, "Life time (0 - will exist until restart)": 3600.0, "Maximum amount to use (0 - without limit)": 10 }, "Box setup (bot will put items in the box)": { "Enable?": true, "Use small box?": true, "Box skin": 0, "Life time (0 - will exist until restart or until it dies)": 3600.0, "Maximum amount to use (0 - without limit)": 5, "Another container prefab (you can leave it empty)": "" } }, "Monuments visit setup": { "Amount of random positions to visit on monument": 5, "List of monument prefabs blocked for visiting": [] }, "Items for ore mining": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "jackhammer", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "diverpickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stone.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for tree gathering": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "chainsaw", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "frontier_hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stonehatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for fights": { "Use ammo?": false, "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "bow.hunting", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "1965232394", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "salvaged.cleaver", "Item skin": 0 } } ], "Amount of ammo to give for weapon if respawning is allowed": 128 }, "Items for harvesting animals": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "knife.skinning", "Item skin": 0 } } ] }, "Items for healing": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "syringe.medical", "Item skin": 0 }, "Amount of items to give when respawning": 5 }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "bandage", "Item skin": 0 }, "Amount of items to give when respawning": 1 } ] }, "Voice phrases for different actions": { "Use voice phrases?": true, "Phrases for the Miner state": { "Phrases when picking up resources": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when picking up items": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when gathering trees": { "Phrases": [ "uinston/miner/mining_tree/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when mining ore": { "Phrases": [ "uinston/miner/mining_ore/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting containers": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when breaking containers (barrels, signs and etc.)": { "Phrases": [ "uinston/miner/breaking/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting corpses": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when harvesting corpses": { "Phrases": [ "uinston/miner/butcher_corpse/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Hunter state": { "Phrases before starting to attack": { "Phrases": [ "uinston/hunter/start_attack/1", "uinston/hunter/start_attack/2" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Fight state": { "Phrases before starting to attack": { "Phrases": [ "uinston/attacker/start_attack/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot does not see the target": { "Phrases": [ "uinston/attacker/not_visible/1", "uinston/attacker/not_visible/2", "uinston/attacker/not_visible/3" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot runs away from the attacker": { "Phrases": [ "uinston/attacker/run_away/1", "uinston/attacker/run_away/2", "uinston/attacker/run_away/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Researcher state": { "Phrases before starting to move to the monument point": { "Phrases": [ "uinston/researcher/before_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when reaching the destination": { "Phrases": [ "uinston/researcher/after_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases when creating a container with resources": { "Phrases": [ "uinston/full_state/1", "uinston/full_state/2" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when healing": { "Phrases": [ "uinston/medical_state/1", "uinston/medical_state/2", "uinston/medical_state/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } } }, "john_looter": { "Enable bot?": true, "Bot appearance (Use the id in the range of the specified number of digits for the bot ID generator or leave 0 for random appearance)": 0, "Bot name (leave empty for random)": "John", "Respawn timer (3 - 60 seconds)": 300.0, "Use for respawn a random place on the map? (false - will respawn on the beach)": false, "Maximum health": 120.0, "What spawns on death (PlayerCorpse, NpcCorpse, Backpack)": "PlayerCorpse", "How many items will be destroyed when Backpack is selected (0 - 100%)": 50.0, "Bot behaviour - Aggressive, Friendly, Defensive": "Defensive", "Controller setup": { "Brain timer tick (0.01 - 1)": 0.1, "Controls timer tick (0.01 - 1)": 0.5, "Accuracy of fire (lower is better)": 10.0, "Find entities radius": 30.0, "Movement speed (1 - 4)": 4, "Movement speed in water (1 - 4)": 2, "Suicide timer if the bot does not reach the destination point (0 - disables the timer)": 600.0, "Timer attempt to avoid obstacle if the bot does not reach the target route": 3.0, "Damage rate from water": 1.0, "Allowed distance to teleport if the bot does not reach the destination point within this distance (-1 - allowed for any distance)": 0.0, "Damage rate to NPC targets": 2.0, "Damage rate to animals": 2.0, "Damage rate to players": 0.8, "Damage rate from NPCs": 0.2, "Damage rate from animals": 0.2, "Damage rate from players": 0.8 }, "Wear items (on respawn)": { "Lock container? (true - after death loot won't drop)": true, "Allow bot to wear found clothes?": false, "List of items": [ { "Item shortname or ID": "hazmatsuit.nomadsuit", "Item skin": 0 } ] }, "Resource collection": { "Allow to gather wood?": false, "Allow to use fuel for chainsaw?": false, "Allow to mine ore?": false, "Allow to loot barrels?": true, "Allow to loot road signs?": true, "Allow to pickup resources?": true, "Allow to pickup dropped items?": true, "Allow to loot containers?": true, "Allow to loot corpses?": true, "Allow to harvest corpses?": false, "List of prefabs of corpses to harvest": [ "assets/rust.ai/agents/boar/boar.corpse.prefab", "polarbear.corpse", "bear.corpse", "stag.corpse", "wolf.corpse", "crocodile.corpse", "panther.corpse", "tiger.corpse", "chicken.corpse" ], "List of prefabs blocked for mining": [ "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree03.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtreeprefab.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree02.prefab" ] }, "Fights with NPCs and players": { "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 1.0 }, "Animal hunting": { "Allow to hunt? (true - will attack animals even if they are not attacking)": false, "Make melee weapons preferred for hunting?": true, "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 2.0, "List of prefabs of animals to block hunting them": [] }, "Inventory overflow": { "Stash setup (bot will put items in the stash)": { "Enable?": true, "Hide stash?": true, "Life time (0 - will exist until restart)": 3600.0, "Maximum amount to use (0 - without limit)": 10 }, "Box setup (bot will put items in the box)": { "Enable?": true, "Use small box?": true, "Box skin": 0, "Life time (0 - will exist until restart or until it dies)": 3600.0, "Maximum amount to use (0 - without limit)": 5, "Another container prefab (you can leave it empty)": "" } }, "Monuments visit setup": { "Amount of random positions to visit on monument": 5, "List of monument prefabs blocked for visiting": [] }, "Items for ore mining": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "jackhammer", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "diverpickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stone.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for tree gathering": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "chainsaw", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "frontier_hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stonehatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for fights": { "Use ammo?": true, "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "rifle.ak.diver", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "bow.hunting", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "1965232394", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "salvaged.cleaver", "Item skin": 0 } } ], "Amount of ammo to give for weapon if respawning is allowed": 300 }, "Items for harvesting animals": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "knife.skinning", "Item skin": 0 } } ] }, "Items for healing": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "syringe.medical", "Item skin": 0 }, "Amount of items to give when respawning": 5 }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "bandage", "Item skin": 0 }, "Amount of items to give when respawning": 1 } ] }, "Voice phrases for different actions": { "Use voice phrases?": true, "Phrases for the Miner state": { "Phrases when picking up resources": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when picking up items": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when gathering trees": { "Phrases": [ "uinston/miner/mining_tree/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when mining ore": { "Phrases": [ "uinston/miner/mining_ore/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting containers": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when breaking containers (barrels, signs and etc.)": { "Phrases": [ "uinston/miner/breaking/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting corpses": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when harvesting corpses": { "Phrases": [ "uinston/miner/butcher_corpse/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Hunter state": { "Phrases before starting to attack": { "Phrases": [ "uinston/hunter/start_attack/1", "uinston/hunter/start_attack/2" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Fight state": { "Phrases before starting to attack": { "Phrases": [ "uinston/attacker/start_attack/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot does not see the target": { "Phrases": [ "uinston/attacker/not_visible/1", "uinston/attacker/not_visible/2", "uinston/attacker/not_visible/3" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot runs away from the attacker": { "Phrases": [ "uinston/attacker/run_away/1", "uinston/attacker/run_away/2", "uinston/attacker/run_away/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Researcher state": { "Phrases before starting to move to the monument point": { "Phrases": [ "uinston/researcher/before_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when reaching the destination": { "Phrases": [ "uinston/researcher/after_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases when creating a container with resources": { "Phrases": [ "uinston/full_state/1", "uinston/full_state/2" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when healing": { "Phrases": [ "uinston/medical_state/1", "uinston/medical_state/2", "uinston/medical_state/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } } }, "alfred_hunter": { "Enable bot?": true, "Bot appearance (Use the id in the range of the specified number of digits for the bot ID generator or leave 0 for random appearance)": 0, "Bot name (leave empty for random)": "Alfred", "Respawn timer (3 - 60 seconds)": 300.0, "Use for respawn a random place on the map? (false - will respawn on the beach)": false, "Maximum health": 100.0, "What spawns on death (PlayerCorpse, NpcCorpse, Backpack)": "PlayerCorpse", "How many items will be destroyed when Backpack is selected (0 - 100%)": 50.0, "Bot behaviour - Aggressive, Friendly, Defensive": "Defensive", "Controller setup": { "Brain timer tick (0.01 - 1)": 0.1, "Controls timer tick (0.01 - 1)": 0.5, "Accuracy of fire (lower is better)": 10.0, "Find entities radius": 30.0, "Movement speed (1 - 4)": 4, "Movement speed in water (1 - 4)": 2, "Suicide timer if the bot does not reach the destination point (0 - disables the timer)": 600.0, "Timer attempt to avoid obstacle if the bot does not reach the target route": 3.0, "Damage rate from water": 1.0, "Allowed distance to teleport if the bot does not reach the destination point within this distance (-1 - allowed for any distance)": 0.0, "Damage rate to NPC targets": 2.0, "Damage rate to animals": 2.0, "Damage rate to players": 0.8, "Damage rate from NPCs": 0.2, "Damage rate from animals": 0.2, "Damage rate from players": 0.8 }, "Wear items (on respawn)": { "Lock container? (true - after death loot won't drop)": true, "Allow bot to wear found clothes?": false, "List of items": [ { "Item shortname or ID": "hazmatsuit.frontier", "Item skin": 0 } ] }, "Resource collection": { "Allow to gather wood?": false, "Allow to use fuel for chainsaw?": false, "Allow to mine ore?": false, "Allow to loot barrels?": false, "Allow to loot road signs?": false, "Allow to pickup resources?": false, "Allow to pickup dropped items?": true, "Allow to loot containers?": false, "Allow to loot corpses?": false, "Allow to harvest corpses?": true, "List of prefabs of corpses to harvest": [ "assets/rust.ai/agents/boar/boar.corpse.prefab", "polarbear.corpse", "bear.corpse", "stag.corpse", "wolf.corpse", "crocodile.corpse", "panther.corpse", "tiger.corpse", "chicken.corpse" ], "List of prefabs blocked for mining": [ "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree03.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtreeprefab.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree02.prefab" ] }, "Fights with NPCs and players": { "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 1.0 }, "Animal hunting": { "Allow to hunt? (true - will attack animals even if they are not attacking)": true, "Make melee weapons preferred for hunting?": false, "Maximum distance for attack from weapon": 25.0, "Maximum distance for attack from melee": 2.0, "List of prefabs of animals to block hunting them": [] }, "Inventory overflow": { "Stash setup (bot will put items in the stash)": { "Enable?": true, "Hide stash?": true, "Life time (0 - will exist until restart)": 3600.0, "Maximum amount to use (0 - without limit)": 10 }, "Box setup (bot will put items in the box)": { "Enable?": true, "Use small box?": true, "Box skin": 0, "Life time (0 - will exist until restart or until it dies)": 3600.0, "Maximum amount to use (0 - without limit)": 5, "Another container prefab (you can leave it empty)": "" } }, "Monuments visit setup": { "Amount of random positions to visit on monument": 5, "List of monument prefabs blocked for visiting": [] }, "Items for ore mining": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "jackhammer", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "diverpickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stone.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for tree gathering": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "chainsaw", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "frontier_hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stonehatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for fights": { "Use ammo?": false, "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "shotgun.spas12", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "bow.hunting", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "1965232394", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "salvaged.cleaver", "Item skin": 0 } } ], "Amount of ammo to give for weapon if respawning is allowed": 300 }, "Items for harvesting animals": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "knife.skinning", "Item skin": 0 } } ] }, "Items for healing": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "syringe.medical", "Item skin": 0 }, "Amount of items to give when respawning": 5 }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "bandage", "Item skin": 0 }, "Amount of items to give when respawning": 1 } ] }, "Voice phrases for different actions": { "Use voice phrases?": true, "Phrases for the Miner state": { "Phrases when picking up resources": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when picking up items": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when gathering trees": { "Phrases": [ "uinston/miner/mining_tree/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when mining ore": { "Phrases": [ "uinston/miner/mining_ore/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting containers": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when breaking containers (barrels, signs and etc.)": { "Phrases": [ "uinston/miner/breaking/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting corpses": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when harvesting corpses": { "Phrases": [ "uinston/miner/butcher_corpse/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Hunter state": { "Phrases before starting to attack": { "Phrases": [ "uinston/hunter/start_attack/1", "uinston/hunter/start_attack/2" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Fight state": { "Phrases before starting to attack": { "Phrases": [ "uinston/attacker/start_attack/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot does not see the target": { "Phrases": [ "uinston/attacker/not_visible/1", "uinston/attacker/not_visible/2", "uinston/attacker/not_visible/3" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot runs away from the attacker": { "Phrases": [ "uinston/attacker/run_away/1", "uinston/attacker/run_away/2", "uinston/attacker/run_away/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Researcher state": { "Phrases before starting to move to the monument point": { "Phrases": [ "uinston/researcher/before_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when reaching the destination": { "Phrases": [ "uinston/researcher/after_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases when creating a container with resources": { "Phrases": [ "uinston/full_state/1", "uinston/full_state/2" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when healing": { "Phrases": [ "uinston/medical_state/1", "uinston/medical_state/2", "uinston/medical_state/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } } }, "austin_fighter": { "Enable bot?": true, "Bot appearance (Use the id in the range of the specified number of digits for the bot ID generator or leave 0 for random appearance)": 0, "Bot name (leave empty for random)": "Austin", "Respawn timer (3 - 60 seconds)": 300.0, "Use for respawn a random place on the map? (false - will respawn on the beach)": false, "Maximum health": 120.0, "What spawns on death (PlayerCorpse, NpcCorpse, Backpack)": "PlayerCorpse", "How many items will be destroyed when Backpack is selected (0 - 100%)": 0.0, "Bot behaviour - Aggressive, Friendly, Defensive": "Aggressive", "Controller setup": { "Brain timer tick (0.01 - 1)": 0.1, "Controls timer tick (0.01 - 1)": 0.5, "Accuracy of fire (lower is better)": 3.0, "Find entities radius": 30.0, "Movement speed (1 - 4)": 4, "Movement speed in water (1 - 4)": 2, "Suicide timer if the bot does not reach the destination point (0 - disables the timer)": 600.0, "Timer attempt to avoid obstacle if the bot does not reach the target route": 3.0, "Damage rate from water": 0.0, "Allowed distance to teleport if the bot does not reach the destination point within this distance (-1 - allowed for any distance)": 0.0, "Damage rate to NPC targets": 2.0, "Damage rate to animals": 2.0, "Damage rate to players": 0.8, "Damage rate from NPCs": 0.2, "Damage rate from animals": 0.2, "Damage rate from players": 0.8 }, "Wear items (on respawn)": { "Lock container? (true - after death loot won't drop)": true, "Allow bot to wear found clothes?": false, "List of items": [ { "Item shortname or ID": "hazmat.krieg", "Item skin": 0 } ] }, "Resource collection": { "Allow to gather wood?": false, "Allow to use fuel for chainsaw?": false, "Allow to mine ore?": false, "Allow to loot barrels?": true, "Allow to loot road signs?": false, "Allow to pickup resources?": false, "Allow to pickup dropped items?": true, "Allow to loot containers?": true, "Allow to loot corpses?": true, "Allow to harvest corpses?": false, "List of prefabs of corpses to harvest": [ "assets/rust.ai/agents/boar/boar.corpse.prefab", "polarbear.corpse", "bear.corpse", "stag.corpse", "wolf.corpse", "crocodile.corpse", "panther.corpse", "tiger.corpse", "chicken.corpse" ], "List of prefabs blocked for mining": [ "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree03.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtreeprefab.prefab", "assets/bundled/prefabs/autospawn/resource/vine_swinging/vineswingingtree02.prefab" ] }, "Fights with NPCs and players": { "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 1.0 }, "Animal hunting": { "Allow to hunt? (true - will attack animals even if they are not attacking)": false, "Make melee weapons preferred for hunting?": false, "Maximum distance for attack from weapon": 30.0, "Maximum distance for attack from melee": 2.0, "List of prefabs of animals to block hunting them": [] }, "Inventory overflow": { "Stash setup (bot will put items in the stash)": { "Enable?": true, "Hide stash?": true, "Life time (0 - will exist until restart)": 3600.0, "Maximum amount to use (0 - without limit)": 10 }, "Box setup (bot will put items in the box)": { "Enable?": true, "Use small box?": true, "Box skin": 0, "Life time (0 - will exist until restart or until it dies)": 3600.0, "Maximum amount to use (0 - without limit)": 5, "Another container prefab (you can leave it empty)": "" } }, "Monuments visit setup": { "Amount of random positions to visit on monument": 5, "List of monument prefabs blocked for visiting": [] }, "Items for ore mining": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "jackhammer", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "diverpickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stone.pickaxe", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for tree gathering": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "chainsaw", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "lumberjack.hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "frontier_hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "hatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "stonehatchet", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "rock", "Item skin": 0 } } ] }, "Items for fights": { "Use ammo?": false, "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": false, "Allow to give item when respawning?": true, "Item": { "Item shortname or ID": "krieg.shotgun", "Item skin": 0 } }, { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "krieg.chainsword", "Item skin": 0 } } ], "Amount of ammo to give for weapon if respawning is allowed": 300 }, "Items for harvesting animals": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "knife.skinning", "Item skin": 0 } } ] }, "Items for healing": { "List of items (in priority order)": [ { "Allow to create item if it is not in inventory?": true, "Allow to give item when respawning?": false, "Item": { "Item shortname or ID": "syringe.medical", "Item skin": 0 }, "Amount of items to give when respawning": 5 } ] }, "Voice phrases for different actions": { "Use voice phrases?": true, "Phrases for the Miner state": { "Phrases when picking up resources": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when picking up items": { "Phrases": [ "uinston/miner/pickup_collectable/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when gathering trees": { "Phrases": [ "uinston/miner/mining_tree/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when mining ore": { "Phrases": [ "uinston/miner/mining_ore/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting containers": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when breaking containers (barrels, signs and etc.)": { "Phrases": [ "uinston/miner/breaking/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when looting corpses": { "Phrases": [ "uinston/miner/looting/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when harvesting corpses": { "Phrases": [ "uinston/miner/butcher_corpse/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Hunter state": { "Phrases before starting to attack": { "Phrases": [ "uinston/hunter/start_attack/1", "uinston/hunter/start_attack/2" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Fight state": { "Phrases before starting to attack": { "Phrases": [ "uinston/attacker/start_attack/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot does not see the target": { "Phrases": [ "uinston/attacker/not_visible/1", "uinston/attacker/not_visible/2", "uinston/attacker/not_visible/3" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when the bot runs away from the attacker": { "Phrases": [ "uinston/attacker/run_away/1", "uinston/attacker/run_away/2", "uinston/attacker/run_away/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases for the Researcher state": { "Phrases before starting to move to the monument point": { "Phrases": [ "uinston/researcher/before_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when reaching the destination": { "Phrases": [ "uinston/researcher/after_move/1" ], "Chance of using phrases (% 0 - 100)": 30.0 } }, "Phrases when creating a container with resources": { "Phrases": [ "uinston/full_state/1", "uinston/full_state/2" ], "Chance of using phrases (% 0 - 100)": 30.0 }, "Phrases when healing": { "Phrases": [ "uinston/medical_state/1", "uinston/medical_state/2", "uinston/medical_state/3" ], "Chance of using phrases (% 0 - 100)": 30.0 } } } } }  

The Firework Shows plugin lets you trigger full fireworks displays using a single item. It includes 40 pre-made shows, with support for custom and admin created shows loaded from data files. Designed for server events, rewards, or general atmosphere, it’s easy to set up and flexible to use. The plugin also supports kits and item shops, making it a clean fit for most Rust servers.

Join my Discord community to stay informed on new plugins and updates. Click here to get started.


Instantly create full-blown fireworks shows with a single item. 40 unique shows are included. You can add more or edit them as you like! Supports kits and item shops. Perfect for server events or as a reward.  
40 unique shows included out of the box!



fireworkshows.give "Player steam64 ID" "Firework config ID" – Gives a firework show to the player. Useful for web shops or Tebex.


/fws – Spawns all of the firework show boxes.


fireworkshows.admin – Grants access to fireworkshows.give and /fws

═══════════════════════════════════════════════════
                          TITLE SELECTOR v1.6.0
               Customize Chat Titles Without Losing Permission Groups
                              by romzar.games
═══════════════════════════════════════════════════
 
DESCRIPTION
-----------
TitleSelector provides an intuitive UI for players to select, hide, or show their
chat titles from BetterChat. It also integrates seamlessly with SkillTree, giving
players independent control over their Level and Prestige indicators. Players can
customize which titles appear in chat without losing their permission groups.
 
═══════════════════════════════════════════════════
                    WHAT'S NEW IN v1.5.0
═══════════════════════════════════════════════════
✓ Emoji Toggle
  - New toggle to hide emoji-only titles (:coffeecan:, :medal:, etc.)
  - Removes emojis from mixed titles (e.g., "Admin :star:" → "Admin")
  - Works with selected titles and Hide All mode
  - "Emoji: ON/OFF" button in the Filters row
✓ BetterChatGradients Support
  - Full native support for gradient colors in titles
  - Gradients render correctly when selecting custom titles
  - Supports both hex colors (#ff0000) and named colors (red, blue, yellow)
  - Multi-color gradients: red,orange,yellow,green
✓ Extra Patterns (Config Only)
  - Advanced regex patterns for complex title formats
  - Handles uMod gradient tags: [#red,blue]text[/#]
  - Handles HTML color tags: <color=#fff>:emoji:</color>
  - No UI toggle - applied automatically with Emoji toggle
✓ Named Color Support
  - Gradients support color names: red, green, blue, yellow, orange,
    purple, pink, cyan, white, black, gray, gold, silver
  - Mix hex and named: #ff0000,orange,yellow
═══════════════════════════════════════════════════

 
KEY FEATURES
------------
✓ Visual Title Selection
  - Clean modal UI where players can enable/disable their owned titles
  - Green checkbox for active titles, gray for available, locked icon for unowned
  - Intuitive interface for easy title management
 
✓ Collectible Display
  - Shows locked titles players can work towards obtaining
  - Motivates players to unlock new titles
  - Clear visual distinction between owned and locked titles
 
✓ SkillTree Integration
  - Independent toggle controls for Level [Lv.X] indicators
  - Independent toggle controls for Prestige [Pr.X] indicators
  - Mix and match visibility settings
 
✓ Hide All Option
  - Quickly hide all BetterChat titles with one click
  - Keep SkillTree indicators visible while hiding rank titles
  - Perfect for players who want minimal chat clutter
 
✓ Pagination System
  - Handles large title collections with page navigation
  - Configurable items per page
  - Smooth browsing experience
 
✓ Multi-language Support
  - Fully translatable via Oxide lang system
  - All UI text customizable
  - Easy localization for any language
 
✓ Permission Based Access
  - Control who can access the title selector
  - Simple permission system
  - Grant to specific groups or players
 
✓ Persistent Data
  - Player preferences saved automatically
  - Settings persist across sessions and restarts
  - No data loss on plugin reload

 
INSTALLATION
------------
1. Upload TitleSelector.cs to oxide/plugins/ or carbon/plugins/
2. Ensure BetterChat is installed and configured
3. Grant permission: o.grant group default titleselector.use
4. Reload the plugin if needed: o.reload TitleSelector
5. (Optional) Customize the config and lang files

 
DEPENDENCIES
------------
Required:
  - BetterChat - This plugin hooks into BetterChat to modify title display
 
Optional:
  - SkillTree - If installed, players can toggle Level/Prestige visibility
  - BetterChatGradients - If installed, gradient colors render natively

 
PERMISSIONS
-----------
titleselector.use
  - Allows access to the title selector UI
  - Required for players to open the /title menu
  - Grant to groups or individual players

 
PERMISSION EXAMPLES
-------------------
Grant to all players:
  o.grant group default titleselector.use
 
Grant to VIP group only:
  o.grant group vip titleselector.use
 
Grant to specific player:
  o.grant user PlayerName titleselector.use
  o.grant user 76561198000000000 titleselector.use

 
COMMANDS
--------
/title (Chat)
  - Opens the Title Selector UI
  - Requires: titleselector.use permission
  - Main command for accessing the interface
 
/titulo (Chat)
  - Alternative command (configurable)
  - Same functionality as /title
 
/titulos (Chat)
  - Alternative command (configurable)
  - Same functionality as /title

 
CONFIGURATION
-------------
File Location: oxide/config/TitleSelector.json
 
Default Configuration:
{   "Allow hide all titles": true,   "Allow toggle SkillTree level": true,   "Allow toggle SkillTree prestige": true,   "Allow toggle emoji titles": true,   "Level patterns (regex)": [     "\\s*<color=[^>]*>\\[Lv\\.\\d+\\]</color>\\s*",     "\\s*<color=[^>]*>\\[Level\\s*\\d+\\]</color>\\s*",     "\\s*\\[Lv\\.\\d+\\]\\s*",     "\\s*\\[Level\\s*\\d+\\]\\s*"   ],   "Prestige patterns (regex)": [     "\\s*<color=[^>]*>\\[Pr\\.\\d+\\]</color>\\s*",     "\\s*<color=[^>]*>\\[Prestige\\s*\\d+\\]</color>\\s*",     "\\s*\\[Pr\\.\\d+\\]\\s*",     "\\s*\\[Prestige\\s*\\d+\\]\\s*"   ],   "Emoji patterns (regex)": [     "\\s*:\\w+:\\s*"   ],   "Extra patterns (regex) - applied with emoji toggle": [     "\\s*\\[#[\\w,\\s#]+\\]\\[\\+\\d+\\]\\s*:\\w+:\\s*\\[/\\+\\]\\[/#\\]\\s*",     "\\s*\\[#[\\w,\\s#]+\\]\\s*:\\w+:\\s*\\[/#\\]\\s*",     "\\s*<color=[^>]*>:\\w+:</color>\\s*"   ],   "Max selectable titles": 3,   "Main command": "title",   "Alternative commands": ["titulo", "titulos"],   "Ignored groups (hidden from UI)": ["default", "player", "guest"],   "Items per page": 7,   "UI - Background color": "0.1 0.1 0.1 0.95",   "UI - Header color": "0.15 0.15 0.15 1",   "UI - Available item color": "0.2 0.2 0.2 0.9",   "UI - Locked item color": "0.12 0.12 0.12 0.7",   "UI - Selected item color": "0.1 0.4 0.1 0.9",   "UI - Close button color": "0.8 0.2 0.2 1",   "UI - Active checkbox color": "0.3 0.8 0.3 1",   "UI - Inactive checkbox color": "0.3 0.3 0.3 1" }  
Configuration Options:
- Allow hide all titles: Enable/disable the "Hide All" button
- Allow toggle SkillTree level: Enable/disable Level toggle for players
- Allow toggle SkillTree prestige: Enable/disable Prestige toggle for players
- Allow toggle emoji titles: Enable/disable Emoji toggle for players
- Level patterns: Regex patterns to detect Level indicators from SkillTree
- Prestige patterns: Regex patterns to detect Prestige indicators from SkillTree
- Emoji patterns: Regex patterns to detect emoji-only titles
- Extra patterns: Advanced regex patterns for complex formats (applied with emoji toggle)
- Max selectable titles: Maximum number of titles a player can display at once
- Main command: Primary chat command to open the UI
- Alternative commands: Additional commands that open the UI
- Ignored groups: BetterChat groups to hide from the UI (e.g., default groups)
- Items per page: Number of titles shown per page in the UI
- UI colors: Customize the appearance of the interface

 
HOW IT WORKS
------------
1. Player with 'use' permission types /title in chat
2. Title Selector UI opens showing all available titles
3. Player sees their titles organized by status:
   - Green checkbox = Title is active and will show in chat
   - Gray checkbox = Title is available but not selected
   - Locked icon = Title the player doesn't own yet (collectible)
4. Player clicks titles to enable/disable them
5. When no titles are selected, BetterChat displays titles based on priority
6. Player preferences are saved automatically

 
TITLE SELECTION SYSTEM
----------------------
AVAILABLE (Player owns the title):
- Displayed with interactive checkbox
- Click to toggle on/off
- Limited by Max selectable titles setting
 
SELECTED (Currently active):
- Green checkbox indicator
- Will display in chat messages
- Can be deselected by clicking
 
LOCKED (Player doesn't own):
- Shown as collectible/goal
- Locked icon displayed
- Cannot be selected until unlocked

 
SKILLTREE INTEGRATION
---------------------
The bottom row of the UI shows toggle buttons for SkillTree indicators:
 
Level Toggle:
- Controls visibility of [Lv.109] style indicators
- "Level: ON" = Level shown in chat
- "Level: OFF" = Level hidden from chat
 
Prestige Toggle:
- Controls visibility of [Pr.1] style indicators
- "Prestige: ON" = Prestige shown in chat
- "Prestige: OFF" = Prestige hidden from chat
 
These work independently - players can show Level but hide Prestige, or vice versa.

 
EMOJI TOGGLE
------------
The Filters row includes a toggle for emoji visibility:
 
Emoji Toggle:
- Controls visibility of emoji-only titles (:coffeecan:, :medal:, etc.)
- Removes emojis from mixed titles (e.g., "Admin :star:" → "Admin")
- "Emoji: ON" = Emojis shown in chat
- "Emoji: OFF" = Emojis hidden from chat
- Works with both selected titles and Hide All mode
- Extra patterns are applied automatically when emoji toggle is OFF

 
BETTERCHATGRADIENTS SUPPORT
---------------------------
TitleSelector natively supports BetterChatGradients:
 
Features:
- Gradient colors render correctly when selecting custom titles
- Supports hex colors: #ff0000, #00ff00, #0000ff
- Supports named colors: red, green, blue, yellow, orange, purple,
  pink, cyan, white, black, gray, gold, silver
- Multi-color gradients: red,orange,yellow,green
- Mix hex and named colors: #ff0000,orange,yellow
 
No additional configuration required - gradients work automatically.

 
HIDE ALL FEATURE
----------------
The "Hide All" button provides quick title management:
- Hides all BetterChat titles with one click
- Respects SkillTree toggle settings
- Respects Emoji toggle settings
- Players can hide rank titles while showing Level/Prestige
- "Show All" button reverses the action

 
PLAYER WORKFLOW
---------------
1. Type /title to open the Title Selector UI
2. Browse available titles using pagination if needed
3. Click checkboxes to select desired titles (up to max limit)
4. Toggle SkillTree Level/Prestige visibility as desired
5. Toggle Emoji visibility as desired
6. Use "Hide All" for quick hiding of all BetterChat titles
7. Close the UI - preferences are saved automatically
8. Chat messages now display only selected titles

 
ADMIN WORKFLOW
--------------
1. Install the plugin with BetterChat dependency
2. Configure ignored groups to hide default/system groups
3. Set max selectable titles based on server preference
4. Customize UI colors to match server theme
5. Grant 'titleselector.use' permission to appropriate groups
6. Translate lang file if needed for non-English servers

 
API METHODS
-----------
For developers who want to integrate with TitleSelector:
 
API_GetSelectedTitles(string odId)
  - Returns: List<string> of player's selected titles
  - Use to check what titles a player has enabled
 
API_IsHidingTitles(string odId)
  - Returns: bool indicating if player is hiding all titles
  - Use to check player's hide status
 
API_SetSelectedTitles(string odId, List<string> titles)
  - Sets player's selected titles programmatically
  - Use to modify player preferences via code
 
API_RefreshTitles()
  - Refreshes the title cache
  - Call after BetterChat config changes

 
API USAGE EXAMPLE
-----------------
[PluginReference] private Plugin TitleSelector; void Example(BasePlayer player) {     // Get selected titles     var titles = TitleSelector?.Call<List<string>>(         "API_GetSelectedTitles", player.UserIDString);     // Check if hiding     var isHiding = TitleSelector?.Call<bool>(         "API_IsHidingTitles", player.UserIDString) ?? false;     // Set titles     TitleSelector?.Call("API_SetSelectedTitles",         player.UserIDString, new List<string> { "vip", "donator" });     // Refresh cache     TitleSelector?.Call("API_RefreshTitles"); }  
LOCALIZATION
------------
All UI text is customizable via the lang file.
 
File Location: oxide/lang/en/TitleSelector.json
 
Default Messages:
{   "NoPermission": "<color=#ff5555>You don't have permission to use this command.</color>",   "BetterChatNotLoaded": "<color=#ff5555>BetterChat is not loaded!</color>",   "TitleLocked": "<color=#ff5555>You don't own this title!</color>",   "MaxTitlesReached": "<color=#ff5555>Maximum of {max} titles reached!</color>",   "HideNotAllowed": "<color=#ff5555>Hiding titles is not enabled.</color>",   "ToggleLevelNotAllowed": "<color=#ff5555>Toggle level is not enabled.</color>",   "TogglePrestigeNotAllowed": "<color=#ff5555>Toggle prestige is not enabled.</color>",   "ToggleEmojiNotAllowed": "<color=#ff5555>Toggle emoji is not enabled.</color>",   "UITitle": "TITLE SELECTOR",   "UIStatusHidden": "All titles are hidden",   "UIStatusDefault": "Showing default titles (based on priority)",   "UIStatusSelected": "{count}/{max} titles selected",   "UILocked": "Locked",   "UISelected": "Active",   "UIAvailable": "Available",   "UIClear": "Clear",   "UIHideAll": "Hide All",   "UIShowAll": "Show All",   "UIClose": "Close",   "UISkillTreeLabel": "Filters:",   "UILevelVisible": "Level: ON",   "UILevelHidden": "Level: OFF",   "UIPrestigeVisible": "Prestige: ON",   "UIPrestigeHidden": "Prestige: OFF",   "UIEmojiVisible": "Emoji: ON",   "UIEmojiHidden": "Emoji: OFF" }  
USE CASES
---------
• VIP Customization: Let VIP players customize their chat appearance
• Roleplay Servers: Players choose titles that fit their character
• Rank Management: Players hide unwanted default titles
• Clean Chat: Minimalist players can hide all titles
• SkillTree Control: Show progress without cluttering chat
• Emoji Control: Hide emoji titles for cleaner chat
• Collectibles: Motivate players to unlock new titles
• Multi-Title Servers: Let players display multiple earned titles
• Gradient Titles: Beautiful color gradients in player titles

 
TROUBLESHOOTING
---------------
Q: UI not opening when typing /title
A: Check that player has the 'titleselector.use' permission
 
Q: Titles not showing in chat after selection
A: Ensure BetterChat is loaded and properly configured
 
Q: SkillTree toggles not appearing
A: SkillTree must be installed for these options to show
 
Q: Some titles not appearing in the UI
A: Check the "Ignored groups" config - groups listed there are hidden
 
Q: Player can't select more titles
A: They've reached the "Max selectable titles" limit in config
 
Q: Changes not saving
A: Check oxide/data folder permissions and console for errors
 
Q: Emoji toggle not working
A: Check "Allow toggle emoji titles" is true in config
 
Q: Gradients not rendering
A: Ensure BetterChatGradients is installed and working

 
PERFORMANCE
-----------
• Lightweight and optimized
• Data saved per-player efficiently
• UI rendered on-demand only
• No performance impact when UI is closed
• Safe to use on high-population servers

 
COMPATIBILITY
-------------
• Requires BetterChat (mandatory dependency)
• Optional SkillTree integration
• Optional BetterChatGradients integration
  - Gradients work natively when selecting titles
  - No conflicts - TitleSelector applies gradients directly
• Works with Oxide and Carbon
• No conflicts with other chat plugins
• Compatible with permission plugins

 
SUPPORT
-------
For support, bug reports, or feature requests, please use the discussion
tab or contact the author.

 
VERSION HISTORY
---------------
v1.5.0 - Emoji & Gradient Update
       - New Emoji toggle to hide emoji-only titles
       - Full BetterChatGradients native support
       - Extra patterns for complex title formats
       - Named color support in gradients
       - UI label changed from "SkillTree:" to "Filters:"
 
v1.4.0 - Initial public release
       - Full BetterChat integration
       - SkillTree Level/Prestige toggle support
       - Pagination for large title collections
       - Hide All feature with SkillTree independence
       - Comprehensive API for developers

 
LICENSE
-------
This plugin is provided for use on Rust game servers.
Redistribution or resale of this plugin is prohibited.
© 2025 romzar.games - All rights reserved.

 
══════════════════════════════════════════════════
                     Thank you for using Title Selector!
                 Give your players control over their chat identity!
══════════════════════════════════════════════════
 

This plugin creates a party in the lighthouse where one of the dancers has had too much to drink and feels sick.If you help him and find him a bottle of mineral water in a foodbox in the lighthouse area, he will give you the key to the door.

Chat and Consolecommand  available to admins only.:
lpstart lpstop givekey givewater Contact:
Additional free plugins created by me are available  on Discord: https://discord.gg/C5CehdJMdK 
If you want to try out this plugin, you can do so on the test server. IP:  212.73.137.3:27195 
My public Rust server IP: 136.243.135.46:28050 
 
 
Video:
FoodBox position:

Config:
{ "Version": { "Major": 1, "Minor": 0, "Patch": 2 }, "Automatic event start": false, "Minimum time for event start": 3600.0, "Maximum time for event start": 7200.0, "Duration of the event": 2800.0, "Warning messages before event start": 120.0, "Warning messages before event end": 120.0, "The event starts at night only?": true, "Use mapmarker?": true, "Chat icon": 0, "RadioLink": "https://stream.techno.fm/radio1-192k.mp3", "List of lootable crates": [ { "Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Position": "(1.572, 27.500, -1.136)", "Rotation": "(0, 54.606, 0)", "Use custom loot?": false, "CustomLoot": { "Minimum items": 1, "Maximum items": 1, "Use minimum - maxium?": false, "List of items": [ { "ShortName": "xmas.present.small", "Minimum": 3, "Maximum": 6, "Chance": 100.0, "Give blueprint?": false, "SkinID": 0, "Displayname": "" } ] } }, { "Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Position": "(0.282, 29.517, -2.851)", "Rotation": "(0, 90, 0)", "Use custom loot?": false, "CustomLoot": { "Minimum items": 1, "Maximum items": 1, "Use minimum - maxium?": false, "List of items": [ { "ShortName": "xmas.present.small", "Minimum": 3, "Maximum": 6, "Chance": 100.0, "Give blueprint?": false, "SkinID": 0, "Displayname": "" } ] } }, { "Prefab": "assets/bundled/prefabs/radtown/crate_elite.prefab", "Position": "(1.783, 27.500, -2.563)", "Rotation": "(0, 327.260, 0)", "Use custom loot?": false, "CustomLoot": { "Minimum items": 1, "Maximum items": 1, "Use minimum - maxium?": false, "List of items": [ { "ShortName": "xmas.present.small", "Minimum": 3, "Maximum": 6, "Chance": 100.0, "Give blueprint?": false, "SkinID": 0, "Displayname": "" } ] } }, { "Prefab": "assets/bundled/prefabs/radtown/underwater_labs/crate_food_2.prefab", "Position": "(0.428, 28.211, -1.426)", "Rotation": "(0, 327.621, 0)", "Use custom loot?": false, "CustomLoot": { "Minimum items": 1, "Maximum items": 1, "Use minimum - maxium?": false, "List of items": [ { "ShortName": "xmas.present.small", "Minimum": 3, "Maximum": 6, "Chance": 100.0, "Give blueprint?": false, "SkinID": 0, "Displayname": "" } ] } } ], "Key item setting": { "Key item shortname": "door.key", "Key skinID (0 - default)": 3370208540, "Key item displayname": "LIGHTHOUSE PARTY KEY" }, "Mineral water item setting": { "Mineral water item shortname": "smallwaterbottle", "Mineral water skinID (0 - default)": 3371773425, "Mineral water item displayname": "MINERAL WATER" }, "Dancing Npcs name and outfit": { "Name": "Party Face", "Wear items": [ { "ShortName": "shirt.collared", "SkinID (0 - default)": 3035466202 }, { "ShortName": "pants", "SkinID (0 - default)": 2357992772 }, { "ShortName": "shoes.boots", "SkinID (0 - default)": 2673890130 }, { "ShortName": "partyhat", "SkinID (0 - default)": 0 } ] } }