Home/Products/RPG Skills

RPG Skills

Turn your Unturned server into an MMORPG!

RPG Skills Preview 1
Click to Expand

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

  1. Enable via UnturnedForge Cloud Loader: Add RPGSkills to your server through the UnturnedForge Cloud Loader—no manual plugin DLL installation required.
  2. Subscribe to the Workshop UI: Add the RPGSkillsUI Workshop ID to your server's WorkshopDownloadConfig.json so clients automatically download the /skills UI.
  3. 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:

CommandAliasesWhat it doesPermission
/skills/rpg, /perksOpens the RPG Skill Tree menurpgskills.skills
/skills text—Shows your levels & XP in chatrpgskills.skills
/skills upgrade <perkId>—Upgrades a perk via chatrpgskills.skills
/skills top—Shows the top 5 highest-level playersrpgskills.skills
/class [classId]/rpgclassLists classes or chooses your classrpgskills.class
/respec [uconomy|xp]/rpgrespecRefunds all Skill Points and resets your classrpgskills.respec
/rpgadmin reload/rpgaReloads all configs, Classes.json, Perks.json, and ConfigPacks/ liverpgskills.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 playerrpgskills.admin
/rpgadmin reset <player>—Fully wipes a player's RPG level, perks, and classrpgskills.admin
/rpgadmin info <player>—Checks a player's current RPG level, points, and classrpgskills.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 in Host, Port (3306), Database, Username, Password, TablePrefix ("rpgskills_"), and ConnectionTimeoutSeconds (10) if using MySQL.
  • AutoSaveIntervalSeconds: How often player progress saves in the background (default: 60 seconds). 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): When true, players cannot spend XP in Unturned's default skill menu and are told to use /skills instead.
  • 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 (default 100 global / 75 category).
    • Exponent: How fast levels get harder (default 1.45 global / 1.35 category). Lower = faster leveling.
    • MaxLevel: Highest level reachable (default 100 global / 50 category).
    • SkillPointsPerLevel: Skill Points earned each time a player levels up globally (default 1).

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 passive SurvivalTickXp awards.
    • 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 to false if you don't want to install RPGSkillsUI.
  • MenuEffectId (55200) & ToastEffectId (55201): Effect IDs matching RPGSkillsUI (change only if you reassign IDs).
  • EnableXpToast (true), ToastPosition ("TopRight"), ToastDurationSeconds (2.5), ToastMinXpThreshold (10): Controls the non-blocking XP popup.
    • Available ToastPosition values: "TopLeft", "TopCenter", "TopRight", "MiddleLeft", "MiddleRight", "BottomLeft", "BottomCenter", "BottomRight".

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 /skills UI (descriptions support rich text tags like <color=#...>).
  • Enabled (true/false): Set false to 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 /class chat 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): Set false to 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 perk Ids that must reach Rank 1 before unlocking this perk.
  • Effects: One or more bonuses scaled by ValuePerRank * 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.34 on 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

TypeWhat ValuePerRank doesUseful 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
LowHpDamageBonusUp to + damage as your HP gets lowerScope, WeaponFilter
ExecuteDamageBonus+ damage when enemy is woundedThreshold (0.35 = below 35% HP), Scope, WeaponFilter
VampiricHealPercentHeals % HP per kill (0.03 = 3 HP)Scope, WeaponFilter
SplashCleaveDamageMelee hits splash % damage to nearby zombiesThreshold (3.0 = radius in meters)
KillStaminaRestoreRestores flat stamina (15 = +15 stamina) on killScope
SpeedBurstOnKillExtra stamina burst on kill with cooldownCooldownSeconds (5)
IncomingDamageReductionReduces damage taken (0.10 = -10%)Scope, CauseFilter, MaxCap
PreventBleedingChanceChance to ignore bleeding (0.50 = 50%)Scope
PreventBrokenBonesChanceChance to ignore broken legs (0.50 = 50%)Scope

Gathering & Resource Effects

TypeWhat ValuePerRank doesUseful Optional Filters
ResourceDamageMultiplier+ damage to trees/ores (0.20 = +20%)ResourceFilter (Tree, Ore, Any)
DoubleDropChanceChance for 2x drops when breaking nodes (0.20 = 20%)ResourceFilter (Ore, Tree, Forage, Any)
ExtraDropItemChance to drop a custom item ID on break/killExtraItemId (67 = Scrap Metal), ResourceFilter or Scope
InstantTreeFellCuts entire tree in 1 melee/chainsaw swing (Timber!)CooldownSeconds (20), StaminaCost (15)
GatherStaminaRestoreRestores stamina when finishing a tree or rock—
PlantHarvestBonusChanceChance for an extra crop when harvesting farms—
SalvageBonusChanceChance for bonus materials when salvaging your base—

Survival, Crafting & Medical Effects

TypeWhat ValuePerRank doesUseful Optional Filters
FoodVirusImmunityBlocks virus from raw/spoiled food (1.0 = 100% immune)—
HypothermiaResistanceReduces freezing damage & slows cold drain (0.30 = 30%)—
VirusResistanceReduces deadzone & zombie infection (0.20 = 20%)—
HungerThirstSlowdownSlows food & water drain (0.20 = 20% slower)—
HealEffectivenessBonusMeds/bandages/aid heal more HP (0.25 = +25%)—
VehicleRepairBonusFaster/stronger vehicle repairs (0.30 = +30%)—
StructureRepairBonusFaster/stronger barricade repairs (0.30 = +30%)—
CraftingRefundChanceChance to refund the first recipe ingredient on craft—
DurabilitySaveChanceChance to prevent tool/weapon quality loss (0.20 = 20%)—
FuelSavePercentChance to save fuel while driving (0.25 = 25%)—

Economy, XP, Group Auras & Vanilla Skills

TypeWhat ValuePerRank doesUseful Optional Filters
XpGainMultiplier+ RPG XP earned (0.10 = +10%)CategoryFilter ("All", "Gathering", "CombatPvE", "CombatPvP", "Survival")
UconomyKillBountyPays Uconomy cash per kill (15 = $15)Scope (PvE, PvP, Both)
GroupAuraHealPerSecondHeals nearby group mates every second (1.5 = 1.5 HP/s)Threshold (12 = radius in meters)
GroupAuraXpBoostGives nearby group mates + XP (0.10 = +10%)Threshold (15 = radius in meters)
VanillaSkillGrantGrants vanilla Unturned skill levelsVanillaSkill (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 for ExecuteDamageBonus (e.g. 0.35 = below 35% HP), or radius in meters for SplashCleaveDamage and Group Auras.
    • CooldownSeconds & StaminaCost: Cooldown & stamina cost for InstantTreeFell and SpeedBurstOnKill.
    • ExtraItemId: Unturned item ID spawned by ExtraDropItem (e.g. 67 = Scrap Metal).
  • Valid VanillaSkill Names:
    • 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"

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 (6 new classes: Ranger, Assassin, Tank, Alchemist, Paladin, Bounty Hunter + 21 perks including class-exclusives).
  • PvP_Competitive: Raid & PvP focused (4 new classes: Ranger, Assassin, Juggernaut, Combat Medic + 10 PvP perks).
  • Hardcore_Survival: Wilderness & deadzone survival (4 new classes: Alchemist, Woodsman, Nomad, Trapper + 10 survival perks).
  • RP_Economy_Utility: Professions, crafting, & Uconomy (4 new classes: Industrial Miner, Master Mechanic, Merchant Guard, Master Farmer + 10 profession perks).

Tip: Anything placed in ConfigPacks/ automatically merges onto Classes.json and Perks.json! If a pack uses the same Id as an existing class/perk, it updates it; otherwise it adds it cleanly.

BUNDLE & SAVE 35%Save $29.75

PvE Expanded

PvE plugins that work great together!

Includes 4 Plugins:

Bundle Price:

$85.00$55.25
RPG Skills

RPG Skills

roleplaypvppveuigeneral (misc)
★New(0 ratings)
$35.00Save up to 35% in a Bundle↓
Current Versionv1.0.0
Last Updated11/19/2026

Required Workshop

Unique Visitors3
Subscribers1
Favorites0
Workshop IDs
3841742665

Developer Support

Need help setting up this plugin? Reach out to the developer directly.

Get Support

Latest Changes

v1.0.0

Initial Release