RPG Skills
Turn your Unturned server into an MMORPG!

Players earn XP by gathering, fighting zombies, surviving, or PvPing—then spend Skill Points in /skills to unlock perks and choose a specialized Class.
Everything in this plugin—classes, perks, prerequisites, XP rates, PvP caps, and respec costs—is customizable using simple JSON config files.
SINCE THIS IS QUITE A LARGE PLUGIN I HAVE MADE MORE ORGANIZED DOCUMENTATION HERE
1. Quick Setup
- Enable via UnturnedForge Cloud Loader: Add RPGSkills to your server through the UnturnedForge Cloud Loader—no manual plugin DLL installation required.
- Subscribe to the Workshop UI: Add the RPGSkillsUI Workshop ID to your server's
WorkshopDownloadConfig.jsonso clients automatically download the/skillsUI. - First Launch: Start the server once. The plugin will automatically generate:
Rocket/Plugins/RPGSkills/RPGSkills.configuration.xml(general settings, XP rates, DB, respec)Rocket/Plugins/RPGSkills/Classes.json(all player classes)Rocket/Plugins/RPGSkills/Perks.json(all skill tree perks)Rocket/Plugins/RPGSkills/ConfigPacks/(drop extra packs here!)
2. Commands & Permissions
Add these permissions to your Rocket Permissions.config.xml:
| Command | Aliases | What it does | Permission |
|---|---|---|---|
/skills | /rpg, /perks | Opens the RPG Skill Tree menu | rpgskills.skills |
/skills text | — | Shows your levels & XP in chat | rpgskills.skills |
/skills upgrade <perkId> | — | Upgrades a perk via chat | rpgskills.skills |
/skills top | — | Shows the top 5 highest-level players | rpgskills.skills |
/class [classId] | /rpgclass | Lists classes or chooses your class | rpgskills.class |
/respec [uconomy|xp] | /rpgrespec | Refunds all Skill Points and resets your class | rpgskills.respec |
/rpgadmin reload | /rpga | Reloads all configs, Classes.json, Perks.json, and ConfigPacks/ live | rpgskills.admin |
/rpgadmin givexp <player> <category> <amount> | — | Gives XP (Gathering, CombatPvE, CombatPvP, or Survival) | rpgskills.admin |
/rpgadmin givepoints <player> <amount> | — | Gives extra Skill Points to a player | rpgskills.admin |
/rpgadmin reset <player> | — | Fully wipes a player's RPG level, perks, and class | rpgskills.admin |
/rpgadmin info <player> | — | Checks a player's current RPG level, points, and class | rpgskills.admin |
3. Main Config Settings (RPGSkills.configuration.xml)
Database Storage
DatabaseProvider: Set to"LiteDB"(default, zero setup—saves to a local file) or"MySQL"(recommended if you sync data across multiple servers).LiteDbFileName: File name for local storage (default:"rpgskills.db").MySql: Fill inHost,Port(3306),Database,Username,Password,TablePrefix("rpgskills_"), andConnectionTimeoutSeconds(10) if using MySQL.AutoSaveIntervalSeconds: How often player progress saves in the background (default:60seconds). Progress also saves whenever a player disconnects or the server stops.ChatPrefix("[UnturnedForge RPG] "): Prefix shown before plugin chat messages (supports Unity rich text tags like<b>and<color=#...>).ChatIconUrl(""): Optional image URL shown as the chat avatar icon next to plugin messages.
Vanilla Unturned Skills
DisableVanillaSkillMenu(true/false): Whentrue, players cannot spend XP in Unturned's default skill menu and are told to use/skillsinstead.SyncVanillaSkillsFromPerks(true/false): Automatically applies vanilla skill bonuses (like Sharpshooter, Parkour, Crafting) when players unlock RPG perks.ResetVanillaSkillsOnDisable(true/false): Keeps vanilla skills locked at 0 unless unlocked through your RPG tree.
Leveling & XP Curves
Players have 4 Specialization Levels (which unlock perks in each tab) and 1 Global RPG Level (which awards Skill Points and unlocks Classes).
GlobalXpCurve&CategoryXpCurve:BaseXp: XP needed for Level 1 → 2 (default100global /75category).Exponent: How fast levels get harder (default1.45global /1.35category). Lower = faster leveling.MaxLevel: Highest level reachable (default100global /50category).SkillPointsPerLevel: Skill Points earned each time a player levels up globally (default1).
XP Rewards (XpRewards)
Adjust how much XP each action gives (set any value to 0 to disable XP from that action):
- Gathering:
TreeHitXp(4),TreeBreakXp(18),OreHitXp(5),OreBreakXp(24),ForageXp(10),PlantHarvestXp(12) - Combat:
ZombieKillXp(20),MegaZombieKillXp(150),AnimalKillXp(18),PvpKillXp(60) - Survival & Crafting:
CraftXp(8),HealAidXp(14),RepairXp(6),SurvivalConsumeXp(6),SurvivalTickXp(4)
Anti-Exploit & PvP Safety
AntiExploit:ResourceHitXpCooldownMs(400) &ZombieKillXpCooldownMs(200): Stops macro spam.PvpKillSameTargetCooldownSeconds(180): Prevents friends from farming each other for PvP XP.SurvivalTickIntervalSeconds(30): Seconds between passiveSurvivalTickXpawards.IgnoreFriendlyFireXp(true): Group members don't get PvP bonuses or XP for hurting teammates.MaxXpPerMinutePerCategory(2500): Caps how much XP a player can farm in 1 minute per branch (0= no limit).
PvpCaps: Hard limits so stacked PvP perks never become overpowered:MaxPvpDamageBonus(0.25= max +25% damage)MaxPvpHeadshotBonus(0.25= max +25% headshot bonus)MaxPvpDamageReduction(0.20= max 20% damage reduction)
Respec Settings (Respec)
AllowRespec(true/false): Lets players reset their perks & pick a new class with/respec.PaymentMode: Choose"Uconomy","Experience","Both"(auto-falls back to EXP if Uconomy is not installed), or"FreeWithCooldown".UconomyCost(2500) &ExperienceCost(1000): Base cost to respec.ScaleCostByLevel(true/false): Multiplies the cost by the player's Global RPG Level (e.g., Level 10 = 10x base cost).CooldownMinutes(30): Wait time between respecs (0= no cooldown).
UI Settings (UI)
EnableCustomUI(true): Uses the Unity UI for/skills. Set tofalseif you don't want to installRPGSkillsUI.MenuEffectId(55200) &ToastEffectId(55201): Effect IDs matchingRPGSkillsUI(change only if you reassign IDs).EnableXpToast(true),ToastPosition("TopRight"),ToastDurationSeconds(2.5),ToastMinXpThreshold(10): Controls the non-blocking XP popup.- Available
ToastPositionvalues:"TopLeft","TopCenter","TopRight","MiddleLeft","MiddleRight","BottomLeft","BottomCenter","BottomRight".
- Available
4. How to Create Custom Classes (Classes.json)
Every class lives inside "Classes": [ ... ] in Classes.json. You can add new classes, edit descriptions, change required levels, or disable defaults by setting "Enabled": false.
Example Custom Class (Copy & Paste Template)
{
"Id": "pyromancer",
"DisplayName": "Firestarter",
"Description": "Thrives in chaos. Resistant to fire and explosions while hitting harder with shotguns.",
"Enabled": true,
"SortOrder": 5,
"RequiredLevel": 5,
"CapstoneTitle": "Ashen Shield",
"CapstoneDescription": "-50% fire damage, -15% explosive damage, and +12% shotgun damage.",
"PassiveEffects": [
{ "Type": "IncomingDamageReduction", "CauseFilter": "Burning", "ValuePerRank": 0.50 },
{ "Type": "IncomingDamageReduction", "CauseFilter": "Explosive", "ValuePerRank": 0.15 },
{ "Type": "RangedDamageMultiplier", "Scope": "Both", "WeaponFilter": "Shotgun", "ValuePerRank": 0.12 }
]
}
Class Fields Explained
Id: Unique lowercase ID with no spaces (e.g."ranger"). Used if players type/class ranger.DisplayName&Description: Shown in the/skillsUI (descriptions support rich text tags like<color=#...>).Enabled(true/false): Setfalseto hide a class without deleting it.RequiredLevel: Minimum Global RPG Level needed to select this class.SortOrder: Controls the order classes appear in the UI (1,2,3...).BadgeColorHex: Accent hex color used for this class in/classchat listings (e.g."#FBBF24").CapstoneTitle&CapstoneDescription: Summary text shown on the class card.PassiveEffects: List of bonuses automatically active while the player has this class.
5. How to Build Custom Perk Trees (Perks.json)
Perks live inside "Perks": [ ... ] in Perks.json. Each perk appears under one of the 4 UI Tabs:
"Gathering"(Mining & Logging)"CombatPvE"(Zombies & Animals)"CombatPvP"(Player vs Player)"Survival"(Food, Cold, Meds, Crafting, Repairs, Auras)
Perk Fields Explained
Id: Unique lowercase ID with no spaces (e.g."double_ore_yield").DisplayName&Description: Shown on the UI card and Inspector (supports Unity rich text).Category: Which tab & branch level the perk uses ("Gathering","CombatPvE","CombatPvP", or"Survival").Enabled(true/false): Setfalseto disable without removing.SortOrder: Controls card order inside the tab (1,2,3...).RequiredCategoryLevel&RequiredGlobalLevel: Minimum branch level and global RPG level required.RequiredClassId: Optional class ID ("berserker", etc.) to lock the perk to one class, or omit/""for all players.MaxRank&SkillPointCostPerRank: Maximum upgrades allowed and Skill Points spent per rank.Prerequisites: Optional list of perkIds that must reach Rank1before unlocking this perk.Effects: One or more bonuses scaled byValuePerRank * Rank.
Example 1: Standard Upgradeable Perk
{
"Id": "big_game_hunter",
"DisplayName": "Big Game Hunter",
"Description": "Deal +15% extra rifle damage per rank against zombies and animals.",
"Category": "CombatPvE",
"Enabled": true,
"SortOrder": 5,
"RequiredCategoryLevel": 3,
"RequiredGlobalLevel": 1,
"MaxRank": 3,
"SkillPointCostPerRank": 1,
"Effects": [
{ "Type": "RangedDamageMultiplier", "Scope": "PvE", "WeaponFilter": "Rifle", "ValuePerRank": 0.15 }
]
}
Example 2: Branching Perk Tree (Prerequisites) & Class-Exclusive Perks (RequiredClassId)
- Use
Prerequisites:[ "perk_id_1", "perk_id_2" ]to force players to unlock an earlier perk before unlocking this one! - Use
RequiredClassId:"berserker"to make a perk exclusive to a specific class (leave it out or""so anyone can unlock it).
{
"Id": "crimson_cleave",
"DisplayName": "Crimson Cleave",
"Description": "[Berserker Only] Melee strikes splash 30% damage per rank to nearby zombies within 3 meters.",
"Category": "CombatPvE",
"Enabled": true,
"SortOrder": 8,
"RequiredCategoryLevel": 5,
"RequiredGlobalLevel": 5,
"RequiredClassId": "berserker",
"MaxRank": 2,
"SkillPointCostPerRank": 2,
"Prerequisites": [ "vampiric_strikes" ],
"Effects": [
{ "Type": "SplashCleaveDamage", "Scope": "PvE", "WeaponFilter": "Melee", "ValuePerRank": 0.30, "Threshold": 3.0 }
]
}
Example 3: Linking a Vanilla Unturned Skill
Want a perk to also level up a vanilla skill like Parkour, Crafting, or Diving? Use VanillaSkillGrant!
Tip: Since Unturned skills max out at 3 or 7, using
"ValuePerRank": 2.34on a 3-rank perk gives levels 2 → 4 → 7 automatically!
{
"Type": "VanillaSkillGrant",
"VanillaSkill": "Offense:Parkour",
"ValuePerRank": 2.34
}
6. Cheat-Sheet: All Available Effects & Filters
When creating a perk or class, mix and match any of these Type values inside Effects or PassiveEffects.
(Note: Percentages are written as decimals — 0.10 = 10%, 0.25 = 25%, 1.0 = 100%.)
Combat Effects
Type | What ValuePerRank does | Useful Optional Filters |
|---|---|---|
MeleeDamageMultiplier | + melee damage (0.15 = +15% per rank) | Scope (PvE, PvP, Both) |
RangedDamageMultiplier | + gun/bow damage (0.10 = +10%) | Scope, WeaponFilter, MaxCap |
RangedHeadshotMultiplier | + headshot bonus damage (0.25 = +25%) | Scope, WeaponFilter, MaxCap |
LowHpDamageBonus | Up to + damage as your HP gets lower | Scope, WeaponFilter |
ExecuteDamageBonus | + damage when enemy is wounded | Threshold (0.35 = below 35% HP), Scope, WeaponFilter |
VampiricHealPercent | Heals % HP per kill (0.03 = 3 HP) | Scope, WeaponFilter |
SplashCleaveDamage | Melee hits splash % damage to nearby zombies | Threshold (3.0 = radius in meters) |
KillStaminaRestore | Restores flat stamina (15 = +15 stamina) on kill | Scope |
SpeedBurstOnKill | Extra stamina burst on kill with cooldown | CooldownSeconds (5) |
IncomingDamageReduction | Reduces damage taken (0.10 = -10%) | Scope, CauseFilter, MaxCap |
PreventBleedingChance | Chance to ignore bleeding (0.50 = 50%) | Scope |
PreventBrokenBonesChance | Chance to ignore broken legs (0.50 = 50%) | Scope |
Gathering & Resource Effects
Type | What ValuePerRank does | Useful Optional Filters |
|---|---|---|
ResourceDamageMultiplier | + damage to trees/ores (0.20 = +20%) | ResourceFilter (Tree, Ore, Any) |
DoubleDropChance | Chance for 2x drops when breaking nodes (0.20 = 20%) | ResourceFilter (Ore, Tree, Forage, Any) |
ExtraDropItem | Chance to drop a custom item ID on break/kill | ExtraItemId (67 = Scrap Metal), ResourceFilter or Scope |
InstantTreeFell | Cuts entire tree in 1 melee/chainsaw swing (Timber!) | CooldownSeconds (20), StaminaCost (15) |
GatherStaminaRestore | Restores stamina when finishing a tree or rock | — |
PlantHarvestBonusChance | Chance for an extra crop when harvesting farms | — |
SalvageBonusChance | Chance for bonus materials when salvaging your base | — |
Survival, Crafting & Medical Effects
Type | What ValuePerRank does | Useful Optional Filters |
|---|---|---|
FoodVirusImmunity | Blocks virus from raw/spoiled food (1.0 = 100% immune) | — |
HypothermiaResistance | Reduces freezing damage & slows cold drain (0.30 = 30%) | — |
VirusResistance | Reduces deadzone & zombie infection (0.20 = 20%) | — |
HungerThirstSlowdown | Slows food & water drain (0.20 = 20% slower) | — |
HealEffectivenessBonus | Meds/bandages/aid heal more HP (0.25 = +25%) | — |
VehicleRepairBonus | Faster/stronger vehicle repairs (0.30 = +30%) | — |
StructureRepairBonus | Faster/stronger barricade repairs (0.30 = +30%) | — |
CraftingRefundChance | Chance to refund the first recipe ingredient on craft | — |
DurabilitySaveChance | Chance to prevent tool/weapon quality loss (0.20 = 20%) | — |
FuelSavePercent | Chance to save fuel while driving (0.25 = 25%) | — |
Economy, XP, Group Auras & Vanilla Skills
Type | What ValuePerRank does | Useful Optional Filters |
|---|---|---|
XpGainMultiplier | + RPG XP earned (0.10 = +10%) | CategoryFilter ("All", "Gathering", "CombatPvE", "CombatPvP", "Survival") |
UconomyKillBounty | Pays Uconomy cash per kill (15 = $15) | Scope (PvE, PvP, Both) |
GroupAuraHealPerSecond | Heals nearby group mates every second (1.5 = 1.5 HP/s) | Threshold (12 = radius in meters) |
GroupAuraXpBoost | Gives nearby group mates + XP (0.10 = +10%) | Threshold (15 = radius in meters) |
VanillaSkillGrant | Grants vanilla Unturned skill levels | VanillaSkill (see valid list below) |
Available Filter Options
Scope:"Both","PvE","PvP"WeaponFilter:"Any","Melee","Gun","Rifle"(includes Snipers),"Sniper","Pistol","Shotgun","SMG","Bow"ResourceFilter:"Any","Tree","Ore","Forage"CauseFilter:"Any","Gun","Melee","Zombie","Animal","Explosive","Fall","Freezing","Infection","Burning","Breath"- Optional Numeric Controls:
MaxCap: Hard limit for a single modifier regardless of rank (e.g.0.25= caps at +25%).Threshold: HP fraction forExecuteDamageBonus(e.g.0.35= below 35% HP), or radius in meters forSplashCleaveDamageand Group Auras.CooldownSeconds&StaminaCost: Cooldown & stamina cost forInstantTreeFellandSpeedBurstOnKill.ExtraItemId: Unturned item ID spawned byExtraDropItem(e.g.67= Scrap Metal).
- Valid
VanillaSkillNames:- Offense:
"Offense:Overkill","Offense:Sharpshooter","Offense:Dexterity","Offense:Cardio","Offense:Exercise","Offense:Diving","Offense:Parkour" - Defense:
"Defense:Sneakybeaky","Defense:Vitality","Defense:Immunity","Defense:Toughness","Defense:Strength","Defense:Warmblooded","Defense:Survival" - Support:
"Support:Healing","Support:Crafting","Support:Outdoors","Support:Cooking","Support:Fishing","Support:Agriculture","Support:Mechanic","Support:Engineer"
- Offense:
7. Ready-to-Use Addon Config Packs (ExternalConfigPacks/)
The plugin ships lean by default (4 core classes + 16 core perks). To expand your server in seconds or customize packs for UnturnedForge.com—just copy any .classes.json and .perks.json files from HERE into Rocket/Plugins/RPGSkills/ConfigPacks/ and run /rpgadmin reload:
MMORPG_Expansion: Full RPG setup (6new classes: Ranger, Assassin, Tank, Alchemist, Paladin, Bounty Hunter +21perks including class-exclusives).PvP_Competitive: Raid & PvP focused (4new classes: Ranger, Assassin, Juggernaut, Combat Medic +10PvP perks).Hardcore_Survival: Wilderness & deadzone survival (4new classes: Alchemist, Woodsman, Nomad, Trapper +10survival perks).RP_Economy_Utility: Professions, crafting, & Uconomy (4new classes: Industrial Miner, Master Mechanic, Merchant Guard, Master Farmer +10profession perks).
Tip: Anything placed in
ConfigPacks/automatically merges ontoClasses.jsonandPerks.json! If a pack uses the sameIdas an existing class/perk, it updates it; otherwise it adds it cleanly.
PvE Expanded
PvE plugins that work great together!
Bundle Price:
RPG Skills
Required Workshop
Latest Changes
v1.0.0