Search the Community

The Ultimate Expansion for Skill Tree Progression Skill Tree Items: Pro is a powerful DLC plugin for the Skill Tree system that breathes new life into your server's loot tables. Instead of players just earning XP through grinding, they can now discover unique, consumable items that boost their progression, provide instant rewards, or grant temporary buffs directly from Skill Tree. Whether it’s a rare XP injection found on a Scientist or a biome-specific gathering boost hidden in an Arctic crate, this plugin adds a layer of excitement and strategy to every lootable object on your map. Advanced Consumable Types This plugin introduces four distinct item categories, each fully customizable to fit your server's economy: XP Boosters: Provide temporary XP multipliers. Go granular with filters for specific gather types, time-of-day restrictions (e.g., "Night Owl" boosts), or biome-specific requirements. XP Injections: Instant gratification. Set up various "vials" or "manuals" that grant a flat or randomized range of XP upon consumption. SP Injections: Extremely rare rewards that grant Skill Points directly, bypass the grind, and give players a reason to hunt for high-tier loot. Temporary Buffs: Grant any buff from the Skill Tree—including Ultimates—for a limited time. These stack with existing skills, allowing players to feel the power of high-level perks early on. Dynamic Loot Distribution The core of Skill Tree Items: Pro is its highly sophisticated loot engine. You aren't limited to just crates and barrels; you can inject these items into almost every interaction in Rust. See a comprehensive list of supported LootSources below. Granular Configuration For the power users, the LootProfile system allows for surgical precision. You don't just set "Crates"; you can target specific prefab names, specific NPC profiles, or even the tier of a Raidable Base. Key Profile Features: Identifier System: Target specific entities (e.g., only "Elite" crates or a specific Boss from BossMonster). Skin ID Filtering: Require specific skin IDs for the source to trigger. Blacklisting: Exclude specific items or entities from dropping loot. Modifier Integration: Toggle whether player "ItemPerk" modifiers should influence the drop rates. Weight-Based Tables: Use a weighted dictionary system to determine exactly which items drop and how often. Command: stip.give <target> <profile> Tyoe: Console Permission required: skilltreeitemspro.admin Action: Gives the target player the specified item. Command: stip.giveall Tyoe: Chat Permission required: skilltreeitemspro.admin Action: Gives the user all items in the config. Command: stip.moveicon Tyoe: Chat Permission required: skilltreeitemspro.admin Action: Moves the active boost icon for all players. This is a comprehensive list of loot sources that can be used to setup loot profiles. Crate: Triggered when a player opens a crate for the first time. Barrel: Triggered when a player breaks a barrel. BossMonster: Triggered when a boss monster is killed by a player. Event: Triggered when an event is completed (Convoy, SurvivalArena, Armored train, Powerplant etc). ScientistNPC: Triggered when a scientist NPC is killed. HumanNPC: Triggered when a human npc, such as a tunner dweller, is killed. BetterNPC: Triggered when a NpcSpawn npc is killed. Woodcutting: Triggered when a tree is fully cut down. Mining: Triggered when a node is fully mined out. Skinning: Triggered when an animal is fully skinned. Foraging: Triggered when the player collects a map collectible (hemp, pumpkins, diesel barrels etc). Farming: Triggered when the player collects a player-grown collectible. Fishing: Triggered when the player catches a fish. Crafting: Triggered when an item is successfully crated. BotReSpawn: Triggered when an BotReSpawn npc is killed. NpcRaider: Triggered when an npc from NpcRaider is killed. RaidableBase: Triggered when a Raidable Base is spawned. The effect types dictate how the item will behave. You can have any number of effect types attached to an item. For example, you can create an item that gives the player 1000xp with the XPInjection type, gives them a temporary boost with the XPBoost type, and gives them access to the Raiding Ultimate from Skill Tree with the TemporaryBuff type. XPInjection: Provides the player with an injection of xp when consumed. SPInjection: Provides the player with an injection of skill points when consumed. TemporaryBuff: Provides the player with temporary access to any Skill Tree buff (including ultimates). XPBoost: Provides the player with a temporary xp boost when consumed. XP Source can be set so only the specified xp source provides the bonus. Timeframe can be set, so the player can only get xp during the specified time of day (ie 6pm to 6pm etc). Multiple Biomes can be added to restrict the xp bonus to sources inside of those biome types (ie a player can only gain xp while in the Arctic or Jungle). Biomes: Any, Arid, Temperate, Tundra, Arctic, Jungle. Here is a list of Skill Tree XP Sources that can be used with the XPBoost effect. All NodeHit NodeHitFinal TreeHit TreeHitFinal SkinHit SkinHitFinal CollectWildPlant CollectGrownPlant BuildingBlockDeployed FishCaught CatchOrangeRoughy CatchSalmon CatchSmallShark CatchSmallTrout CatchYellowPerch CatchAnchovy CatchHerring CatchSardine CatchTrash Crafting ScientistNormal TunnelDweller UnderwaterDweller ScientistHeavy SmallAnimal MediumAnimal LargeAnimal RoadSign Barrel Scarecrow Mission BradleyAPC LootHackedCrate LootHeliCrate LootBradleyCrate CookingMealXP RaidableBaseCompletion_Easy RaidableBaseCompletion_Medium RaidableBaseCompletion_Hard RaidableBaseCompletion_Expert RaidableBaseCompletion_Nightmare Win_HungerGames Win_ScubaArena Win_Skirmish Gut_Fish default_botrespawn crate_basic crate_elite crate_mine crate_normal crate_normal_2 crate_normal_2_food crate_normal_2_medical crate_tools crate_underwater_advanced crate_underwater_basic crate_ammunition crate_food_1 crate_food_2 crate_fuel crate_medical supply_drop detect_diggable Harbor_Event_Winner Junkyard_Event_Winner PowerPlant_Event_Winner Satellite_Event_Winner Water_Event_Winner Air_Event_Winner Armored_Train_Winner Convoy_Winner SurvivalArena_Winner swipe_card_level_1 swipe_card_level_2 swipe_card_level_3 boss_monster Zombie Raider JetPilot ArcticBaseEvent_Winner GasStationEvent_Winner SputnikEvent_Winner ShipWreckEvent_Winner Triangulation_Winner Caravan_Winner SupermarketEvent_Winner GingerbreadNPC PVP AutoTurret You can get a list of Skill Tree Buffs from the Skill Tree plugin page.

Item Perks is a plugin that enhances everyday weapons, tools and armour with over 50 different types of perks. Items with perks can be obtained a variety of ways, including: Finding them randomly in crates or barrels during your morning scrap farm. Randomly crafting an enhanced version of your equipment while you roof camp noobs from your base. Recycling enhanced equipment and finding enhancement kits stuck in the teeth of the recycler. Using a console or chat command that can be ran through seedy plugin traders like GUIShop. The plugin gives a large amount of control to server owners when it comes to implementation. You can: Enable/disable perks, or modify the minimum and maximum values that they roll when applied to gear. Blacklist or whitelist items to each perk, so they will be exclusively excluded or included (based on the list you choose). Adjust the weight of each perk, so it is more or less likely to be seen on gear., or adjust the chances amount of perks that items can potentially have. Fully adjust or disable the chance for item drops to be found, or enable the enhancement kit system so players can recycle gear. So much more (watch the configuration section of the video below to see the full extent). There are over 50 perks included with the plugin. The following list will describe briefly what each perk does. Name: Prospector Description: This perk increases your mining yield when mining stone, metal and sulfur nodes. Name: Lumberjack Description: This perk increases your woodcutting yield when chopping living or dead trees. Name: Butcher Description: This perk increases the resources gained from skinning humans and animals. Name: Horticulture Description: This perk increases the amount of resources gained when harvesting grown plants. Name: Forager Description: This perk increases the amount of resources gained when picking up map generated collectibles. Name: Angler Description: This perk increases the amount of fish you receive upon a successful catch. Name: BeastBane Description: This perk increases the damage dealt to animals. Name: ScientistBane Description: This perk increases the damage dealt to scientists. Name: FlakJacket Description: This perk reduces the damage received from explosions. Name: Elemental Description: This perk reduces damage from received from cold and heat sources. Name: Scavenger Description: This perk provides you with a chance to find additional scrap from crates and barrels. Name: Manufacture Description: This perk increases the speed of your crafting. Name: Durable Description: This peark reduces the durability damage of all equipped items. Name: BeastWard Description: This perk reduces the damage received from animals. Name: ScientistWard Description: This perk reduces the damage received from scientists. Name: Builder Description: This perk provides you with a chance for your building upgrades to be free. Name: Thrifty Description: This perk provides you with a chance for your crafting components to be refunded upon a successful craft. Name: Fabricate Description: This perk provides you with a chance to duplicate an item upon a successful craft. Name: Pharmaceutical Description: This perk increases the amount of healing received from all sources. Name: MeleeWard Description: This perk reduces the damage received from melee weapons. Name: Academic Description: This perk provides you with a chance to receive a scrap refund when researching an item at the research bench. Name: FallDamage Description: This perk reduces the impact damage received from falling. Name: Lead Description: This perk reduces the damage from radiation. Name: Smasher Description: This perk will provide you with a chance to instantly destroy barrels with any amount of damage. Name: Environmentalist Description: This perk will increase the speed of recyclers that you activate. Name: Smelter Description: This perk will increase the smelting speed of furnaces you activate. Name: Paramedic Description: This perk provides players that you revive with additional health. Name: Prepper Description: This perk provides you with a chance to not consume food when eating. Name: Regeneration Description: This perk will passively regenerate you. Name: SharkWard Description: This perk will reduce the amount of damage received from sharks. Name: SharkBane Description: This perk will increase the amount of damage dealt to sharks. Name: Deforest Description: This perk provides you with a chance to cut down nearby trees when successfully cutting a tree down. Name: BlastMine Description: This perk provides you with a chance to mine out nearby nodes when successfully mining out a node. Name: Tanner Description: This perk provides you with a chance to skin nearby corpses when successfully skinning out a corpse. Name: Vampiric Description: This perk will heal you for a percentage of the damage dealt to certain enemies. Name: Reinforced Description: This perk will reduce the the amount of damage that your vehicles receive when mounted. Name: ComponentLuck Description: This perk will provide you with a chance to receive additional components when looting barrels and crates. Name: ElectronicsLuck Description: This perk will provide you with a chance to receive additional electronics when looting barrels and crates. Name: UncannyDodge Description: This perk provides you with a chance to dodge incoming damage, reducing it to 0. Name: LineStrength Description: This perk increases the tensile strength of your fishing line. Name: HealShare Description: This perk will share healing effects with nearby players. Name: Attractive Description: This perk will provide you with a chance to automatically pick up components when destroying barrels. Name: WoodcuttingLuck Description: This perk provides you with a chance to find a random item when you cut down a tree. Name: MiningLuck Description: This perk provides you with a chance to find a random item when you mine out a node. Name: SkinningLuck Description: This perk provides you with a chance to find a random item when you skin out a corpse. Name: FishingLuck Description: This perk provides you with a chance to find a random item when you catch a fish. Name: Sated Description: This perk will increase the amount of calories and hydration you receive from food and water sources. Name: IronStomach Description: This perk provides you with a chance to negate negative effects when consuming food. Name: TreePlanter Description: This perk will provide a chance for a tree to instantly regrow when cut down. Name: RockCycler Description: This perk will provide a chance for a node to instantly respawn when mined out. Name: BradleyDamage Description: This perk increases the damage dealt to Bradley Tanks. Name: HeliDamage Description: This perk increases the damage dealt to Patrol Helicopters. Name: Thorns Description: This perk reflects a % of the damage done back to the attacker Command: ipgive Type: console/chat Parameters: <target ID/Name> <optional: shortname> <optional: perks> Description: Gives the target player an enhanced item. If shortname is specified, it will base the enhancement off of that item. If perks are specified, it will add only those perks to the item. Command: ipgivekit Type: console/chat Parameters: <target ID/Name> <perk> Description: Gives an enhancement kit to the target. itemperks.use - Required to receive any benefit from enhanced items. itemperks.loot - Required to loot enhanced items from crates and barrels. itemperks.craft - Required for a chance to received enhanced versions of crafted gear. itemperks.admin - Required to use admin commands. itemperks.enhance - Required to add enhancement kits to items via the workbench. itemperks.recycle - Required to receive enhancement kits from recycling enhanced items. IPAPI_CreateItem - creates and returns an enhanced item using the details fed into the method. If shortname is left blank, it will pick a random valid item. If api_perks is null it will pick random perk(s) and add them. Returns Item [HookMethod("IPAPI_CreateItem")] public object IPAPI_CreateItem(string shortname = null, ulong skin = 0, Dictionary<string, float> api_perks = null) { List<KeyValuePair<Perk, float>> perks = Pool.GetList<KeyValuePair<Perk, float>>(); foreach (var perk in api_perks) { Perk _perk; if (parsedEnums.TryGetValue(perk.Key, out _perk)) perks.Add(new KeyValuePair<Perk, float>(_perk, perk.Value)); } var result = CreateItem(shortname, skin, perks); Pool.FreeList(ref perks); // Returns an Item class return result; } Example usage: [ChatCommand("testipapi")] void TestIPAPI(BasePlayer player) { Dictionary<string, float> perks = new Dictionary<string, float>() { ["Prospector"] = 1f, ["Lumberjack"] = 1f, ["Butcher"] = 1f, ["Horticulture"] = 0.5f }; var item = (Item)ItemPerks.Call("IPAPI_CreateItem", "hammer.salvaged", (ulong)2830083288, perks); if (item == null) { Puts("Failed"); return; } item.name = "tool of the trade"; player.GiveItem(item); }

Scaled Collectables dynamically adjusts the size and yield of map-generated collectable entities—such as mushrooms, hemp, and pumpkin patches—to create a more immersive and varied gathering experience. Each collectable spawns with a random scale within a configurable range (default: 0.6x to 2.0x). The size directly affects the yield — for instance, harvesting a hemp plant that’s twice as large as normal will reward twice the usual amount of cloth. You can configure scaling values for each collectable type individually, allowing fine-tuned control over balance and gameplay on your server. Note: Collectable scales are reset when the plugin is unloaded, and are adjusted again when it is reloaded. Config example: https://pastebin.com/BEMsVHHZ

World Buffs is a plugin that allows for the creation of server-wide quests, allowing for players to work together to complete a common goal. Quests are comprised of any number of tasks, and will reward the entire server upon completion with a mixture of built-in buffs such as increased gather yields, bonus damage to NPCs etc, as well as the option for permissions and server commands. All players, regardless of their online status, will receive the built-in and permission based rewards. Tasks can be set based on the task type, along with a list of identifying features. For example, you can have a task that requires players to kill npcs using the KillNpc task type. If you only wanted certain npcs to count, you could then add further restrictions by listing the short prefab names of the npc, such as npc_tunneldweller & npc_underwaterdweller, if you only wanted Tunnel & Underwater dwellers to be considered towards the goal. The plugin supports the use of a quest queue (disabled by default). Quests in the queue are automatically started when the plugin loads. When the active quest is completed, the plugin will queue up the next quest after a short while. The identifier of a task depends on the task type itself. Some tasks work with item shortnames when considering quest progress, while others may use prefab shortnames.. Leaving the identifier field empty or set to null will consider any action that triggers the check to contribute towards the task. A list of item shortnames can be found here. A list of prefabs can be found here. TaskType: Woodcutting Identifier: Item shortname TaskType: Mining Identifier: Item shortname TaskType: Skinning Identifier: Item shortname TaskType: Collectible Identifier: Item shortname TaskType: Growable Identifier: Item shortname TaskType: Fishing Identifier: Item shortname TaskType: Growable Identifier: Item shortname TaskType: KillNpc Identifier: prefab shortname TaskType: KillNpcSpawn Identifier: Npc displayname [profile name] TaskType: KillAnimal Identifier: prefab shortname TaskType: KillBradleyApc Identifier: prefab shortname TaskType: LootCrates Identifier: prefab shortname TaskType: DestroyBarrels Identifier: prefab shortname TaskType: Dig Identifier: prefab shortname Reward types function similar to Task Types. They allow for identifiers to limit the sources that they impact. For example, you can specify "cloth" for the CollectibleYield RewardType, which would only boost the yield when collecting cloth, and not other items such as pumpkins or diesel. RewardType: WoodGatherBonus Identifier: Item shortname RewardType: MiningGatherBonus Identifier: Item shortname RewardType: SkinningGatherBonus Identifier: Item shortname RewardType: FishingBonus Identifier: Item shortname RewardType: CollectibleYield Identifier: Item shortname RewardType: GrowableYield Identifier: Item shortname RewardType: NpcDamageBonus Identifier: Prefab shortname RewardType: NpcSpawnDamageBonus Identifier: Prefab shortname RewardType: ScientistDefenceBonus Identifier: Prefab shortname RewardType: AnimalDefenceBonus Identifier: Prefab shortname RewardType: BradleyDamageBonus Identifier: Prefab shortname RewardType: BradleyDefenceBonus Identifier: Prefab shortname RewardType: NpcSpawnDamageBonus Identifier: Npc displayName [profile name] RewardType: XpBonus Identifier: None RewardType: UniversalSwipeCardsBonus Identifier: None RewardType: PvpDamageBonus Identifier: None RewardType: PvpDefenceBonus Identifier: None Command: wb.toggle Type: Chat command Description: Toggles the ui on and off. Command: wb.setquestqueueindex <index> Type: Console command Description: Set's the next quest in the queue to the specified index value Requires admin: Yes Command: wb.startnextquest Type: Console command Description: Starts the next quest in the queue if no quest is running. Requires admin: Yes Command: wb.cancelquest <true/false: start next quest in queue> Type: Console command Description: Cancels the current quest Requires admin: Yes Command: wb.completequest Type: Console command Description: Mark the current quest as complete (this gives players rewards from the quest) Requires admin: Yes Command: wb.startquest <quest name> <optional true/false: force cancel the current quest> Type: Console command Description: a Requires admin: Yes

Title Perks - Automatic Buff System for Title Selector by romzar.games - Requires Title Selector Overview TitlePerks is a companion plugin for Title Selector that brings your title system to life. Instead of titles being purely cosmetic, each title can grant configurable gameplay perks that activate instantly when equipped and deactivate when removed. Players earn titles through gameplay achievements (raids, heli kills, boss kills, etc.) and those titles now carry real mechanical weight — creating a meaningful progression loop where effort translates into tangible power. Key Features Automatic Activation & Deactivation Perks activate instantly when a title is selected in Title Selector Perks deactivate instantly when a title is removed, hidden, or cleared Full integration with Title Selector's Hide All, Show All, Clear, and Preset systems Perks auto-restore on player reconnect and server restart 15+ Perk Types Category Perk Type Description Damage damage_structure Bonus damage to building blocks (walls, floors, etc.) Damage damage_deployable Bonus damage to deployables (doors, turrets, boxes, etc.) Damage damage_heli Bonus damage to Patrol Helicopter Damage damage_bradley Bonus damage to Bradley APC Damage damage_boss Bonus damage to bosses (CH47, custom bosses) Damage damage_npc Bonus damage to all human NPCs (scientists, murderers, etc.) Damage damage_animal Bonus damage to animals Damage damage_pvp Bonus damage in PvP (against real players) Damage damage_pve Bonus damage in PvE (against everything except players) Damage damage_global Bonus damage to everything (stacks with specific types) Gather gather_ore Bonus ore yield when mining Gather gather_wood Bonus wood yield when chopping Gather gather_animal Bonus yield when harvesting animals Gather gather_plant Bonus yield when harvesting plants and growables Fishing fishing_rate Bonus fish quantity when catching fish Fishing xp_fishing Bonus fishing XP (permission group-based) Cooldown cooldown_event Reduces event cooldowns (PveMode integration) Cooldown buyable_cooldown_event Buyable event cooldown reduction (PveMode integration) Special legendary_bonus_xp Grants access to bonus XP group (permission-based) Perk Stacking Players can equip multiple titles simultaneously, and their perks stack additively. For example: Title "RaidHard" grants +15% structure damage Title "RaidExpert" grants +20% structure damage Combined: +35% structure damage Smart Entity Detection The damage system correctly identifies and categorizes all entity types: Structures: BuildingBlock (walls, foundations, floors, etc.) Deployables: Doors, storage containers, turrets, barricades, traps, sleeping bags, SAM sites, search lights, ovens NPCs: Scientists, murderers, scarecrows, tunnel dwellers, underwater dwellers, zombies, HumanNPC Vehicles: Patrol Helicopter, Bradley APC, CH47 Chinook Animals: All BaseAnimalNPC entities Players: Real Steam-authenticated players (for PvP perk) External Integrations PveMode: Automatically sets/removes player cooldown modifiers via API_SetPlayerCooldownModifier / API_RemovePlayerCooldownModifier Permission Groups: Configurable perk-to-group mapping — when a player activates a perk, they're added to a permission group; when deactivated, they're removed How It Works Player selects title in Title Selector | v TitlePerks checks config for matching perks | v Perks activated | v Game apply bonuses in real-time Lifecycle Events Event Action Player selects a title Perks activate, player notified Player removes a title Perks deactivate, player notified Player uses "Hide All" All perks deactivate Player uses "Clear" All perks deactivate Player switches preset Old perks deactivate, new perks activate Player disconnects External perks cleaned up, cache freed Player reconnects Perks restored from Title Selector's current selection Server restarts All online players' perks restored (staggered) Plugin reloads All perks recalculated from scratch Default Configuration { "TitlePerks": { "raideasy": [{ "Type": "damage_structure", "Value": 0.05 }, { "Type": "damage_deployable", "Value": 0.05 }], "raidmedium": [{ "Type": "damage_structure", "Value": 0.10 }, { "Type": "damage_deployable", "Value": 0.10 }], "raidhard": [{ "Type": "damage_structure", "Value": 0.15 }, { "Type": "damage_deployable", "Value": 0.15 }], "raidexpert": [{ "Type": "damage_structure", "Value": 0.20 }, { "Type": "damage_deployable", "Value": 0.20 }], "raidnightmare": [{ "Type": "damage_structure", "Value": 0.25 }, { "Type": "damage_deployable", "Value": 0.25 }], "helieasy": [{ "Type": "damage_heli", "Value": 0.05 }], "helimedium": [{ "Type": "damage_heli", "Value": 0.10 }], "helihard": [{ "Type": "damage_heli", "Value": 0.15 }], "heliexpert": [{ "Type": "damage_heli", "Value": 0.20 }], "helielite": [{ "Type": "damage_heli", "Value": 0.25 }], "helinightmare": [{ "Type": "damage_heli", "Value": 0.30 }], "bradleyeasy": [{ "Type": "damage_bradley", "Value": 0.05 }], "bradleymedium": [{ "Type": "damage_bradley", "Value": 0.10 }], "bradleyhard": [{ "Type": "damage_bradley", "Value": 0.15 }], "bradleyexpert": [{ "Type": "damage_bradley", "Value": 0.20 }], "bradleynightmare": [{ "Type": "damage_bradley", "Value": 0.25 }], "bosskiller": [{ "Type": "damage_boss", "Value": 0.15 }], "npcslayer": [{ "Type": "damage_npc", "Value": 0.15 }], "wildhunter": [{ "Type": "damage_animal", "Value": 0.15 }, { "Type": "gather_animal", "Value": 0.20 }], "rareminer": [{ "Type": "gather_ore", "Value": 0.20 }], "fisherman": [{ "Type": "xp_fishing", "Value": 0.25 }, { "Type": "fishing_rate", "Value": 0.15 }], "farmer": [{ "Type": "gather_plant", "Value": 0.25 }], "explorer": [{ "Type": "cooldown_event", "Value": -0.20 }, { "Type": "legendary_bonus_xp", "Value": 0.25 }], "tryhard": [{ "Type": "damage_pve", "Value": 0.10 }, { "Type": "damage_pvp", "Value": 0.05 }] }, "Show perk activation messages": true, "Show perk deactivation messages": true, "Group Perks (perk type -> permission group)": { "legendary_bonus_xp": "legendarybonus" }, "Debug mode": false } Configuration Options Setting Type Default Description TitlePerks Dictionary (see above) Maps title names (lowercase) to lists of perk definitions Show perk activation messages bool true Notify players when perks activate Show perk deactivation messages bool true Notify players when perks deactivate Group Perks Dictionary legendary_bonus_xp -> legendarybonus Maps perk types to permission groups. When a perk is active, the player is added to the group; when removed, they're taken out Debug mode bool false Verbose logging for troubleshooting Adding Custom Perks Simply add new entries to the TitlePerks dictionary. Title names must be lowercase and match the title names configured in Title Selector. "pvpchampion": [ { "Type": "damage_pvp", "Value": 0.15 }, { "Type": "damage_global", "Value": 0.05 } ], "lumberjack": [ { "Type": "gather_wood", "Value": 0.30 } ] Each title supports multiple perks — combine damage, gather, and special bonuses in a single title. Commands Command Type Permission Description /perks Chat None Shows the player's currently active perks and titles titleperks.reload Console titleperks.admin Reloads config and restores all player perks titleperks.debug Console titleperks.admin Toggles debug mode on/off /perks Output Example ======== Your Active Perks ======== Damage Bonuses: - Structure Damage: +15% - Deployable Damage: +15% - Helicopter Damage: +10% Gather Bonuses: - Ore Gather: +20% Active Titles: - raidhard - helimedium - rareminer Permissions Permission Description titleperks.admin Required for titleperks.reload and titleperks.debug console commands Title Selector Integration TitlePerks is designed as a seamless extension of Title Selector. The integration is fully automatic through Oxide/Carbon hooks: Hooks Listened Hook Fired By Action OnTitleSelected(BasePlayer, string) Title Selector Activates perks for the selected title OnTitleDeselected(BasePlayer, string) Title Selector Deactivates perks for the deselected title OnTitlesCleared(BasePlayer, List<string>) Title Selector Deactivates all perks from cleared titles Developer API TitlePerks exposes a complete API for other plugins to query perk data: // Get all active perks for a player (type -> total value) Dictionary<string, float> perks = TitlePerks.Call<Dictionary<string, float>>("API_GetActivePerks", (ulong)player.userID); // Get a specific perk value (returns 0f if not active) float heliDmg = TitlePerks.Call<float>("API_GetPerkValue", (ulong)player.userID, "damage_heli"); // Check if player has a specific perk active bool hasPerk = TitlePerks.Call<bool>("API_HasPerk", (ulong)player.userID, "damage_bradley"); // Get list of active title names for a player List<string> titles = TitlePerks.Call<List<string>>("API_GetActiveTitles", (ulong)player.userID); // Get perk definitions for a title (config lookup) var perks = TitlePerks.Call<List<Dictionary<string, object>>>("API_GetTitlePerks", "raidhard"); // Get formatted perk display string for a title (for UI integration) string display = TitlePerks.Call<string>("API_GetTitlePerksDisplay", "raidhard"); // Returns: "Struct+15% Deploy+15%" Use Cases 1. Raid Progression Rewards Players who complete raid milestones (easy through nightmare) receive scaling damage bonuses to structures and deployables, making them more effective raiders. 2. PvE Combat Specialization Titles like "BossKiller", "NPCSlayer", and "WildHunter" reward players who focus on PvE content with relevant damage bonuses, encouraging engagement with PvE systems. 3. Resource Gathering Bonuses "RareMiner", "Farmer", and "WildHunter" titles provide gathering multipliers, creating an alternative progression path for players who prefer resource-focused gameplay. 4. Event Cooldown Reduction The "Explorer" title reduces event cooldowns by 20% via PveMode integration, rewarding active event participants with faster re-entry. 5. Permission-Based Rewards Through the Group Perks system, titles can grant access to permission groups — enabling integration with any permission-based plugin. Example: "Explorer" title adds players to the "legendarybonus" group for bonus XP. 6. PvP vs PvE Balancing The "Tryhard" title demonstrates dual-category bonuses: +10% PvE damage and +5% PvP damage, allowing fine-tuned balance between gameplay modes. 7. Multi-Title Stacking Strategy Since perks stack, players must strategize which titles to equip based on their planned activities — raiding, farming, fishing, or mixed gameplay. Localization Built-in support for 3 languages out of the box: Language Code English en (default) Portuguese (Brazil) pt-br Spanish es-ES All perk names, categories, activation/deactivation messages, and UI labels are fully translatable through the standard lang system. Requirements Dependency Required Description Title Selector Yes Core dependency — provides the title selection UI and hooks PveMode No (optional) Enables cooldown_event perk type for event cooldown reduction Installation Place TitlePerks.cs in your carbon/plugins/ folder Ensure Title Selector is installed and running Restart or load the plugin Edit carbon/configs/TitlePerks.json to match your title names Run titleperks.reload in console to apply changes Data Storage Player perk data is stored in carbon/data/TitlePerks.json: { "Players": { "76561198000000000": { "active_titles": ["raidhard", "helimedium", "rareminer"], "last_update": "2026-03-03T12:00:00.0000000Z" } } } Data is used for restoration on reconnect and cleaned automatically after 30 days of inactivity.