Rpgskill

RPGSkills

A complete MMORPG framework for Paper servers.

Build a full RPG experience directly inside Minecraft with 11 classes, 48 skills, 38 stats, custom damage, RPG items, bosses, dungeons, quests, economy, parties, guilds, pets, and a complete summon system.

Everything is designed to be fully configurable through YAML — no coding required.

Server Setup Guide / Player Guide

✨ Features ⚔️ Classes & Skills

11 playable classes, each with its own progression, equipment restrictions, starter kit, stats, and skill tree:

Warrior Knight Mage Necromancer Paladin Assassin Ranger Archer Priest Berserker Summoner

48 skills across seven skill trees with:

Self targeting Single-target Area Cone Location Projectile

Skills use a flexible effect system, allowing complex abilities to be created entirely through configuration.

Bind skills to your hotbar and cast them by swapping hands.

📊 Advanced RPG Stats

A complete 38-stat system.

Six primary attributes calculate into 32 derived statistics, including elemental resistances.

Stats can come from:

Classes Skills Passives Equipment Guild upgrades Pets Summons

Everything goes through a unified recalculation system, preventing bonuses from being accidentally applied twice.

💥 Custom Damage Engine

A complete RPG damage system supporting:

9 damage types Critical hits Armor penetration Life steal Thorns Elemental resistance Combo system Floating damage indicators

Melee and skill damage use the same damage pipeline, keeping combat consistent across the entire plugin.

🛡️ RPG Items

Create powerful RPG equipment with:

10 rarity tiers Randomized stat ranges Item sockets Runes Upgrade forge Configurable upgrade failure penalties 18 virtual accessory slots

Item data is stored in NBT, allowing RPG items to safely retain their state.

👹 Boss System

Create bosses with advanced combat mechanics:

Multi-phase encounters Health-based phase changes Ability changes Damage scaling Defense changes Speed changes Boss bar colors Adds Enrage timers Leashing

The threat system supports both damage and healing aggro, with threat decay and taunt mechanics.

Tanks actually have a reason to hold threat.

🏰 Instanced Dungeons

Run multiple dungeon instances simultaneously.

Features include:

4 difficulty tiers Enemy scaling Reward scaling Shared party life pool Time limits Wave stages Boss stages Intermissions Checkpoints Matchmaking queue Fastest-clear leaderboards

Each dungeon is arena-based, allowing multiple parties to run the same content independently.

📜 Quest System

Create complete quest chains with:

Main quests Side quests Daily quests Weekly quests Repeatable quests 8 objective types

Daily and weekly quests reset automatically at 00:00 UTC.

Quest progression is event-driven, so quests continue working as you add more content.

💰 Economy

A complete RPG economy system featuring:

Vendor shops Generated RPG items Random item stats Independent Buy/Sell prices Per-item stock Automatic restocking Savings bank Compound interest Vault integration

The savings bank is kept separate from the normal Vault wallet.

🤝 Parties & Guilds

Build your own social system.

Parties Player trading Dual-confirmation trading Shared boss loot Experience sharing Guilds Guild ranks Guild bank Shared storage Guild levels Purchasable upgrades Bonuses affecting all members 🐾 Pets

A complete pet progression system:

Pet collection Pet Shop Pet leveling Pet evolution Persistent progression Periodic pet abilities Stat bonuses

Pet evolution is earned through progression, not simply purchased.

☠️ Summon System

A shared summon framework used by:

Necromancer skills Summoner skills Classes Bosses Pets

Summons automatically scale from their owner and are temporary by design.

Summons have proper ownership, targeting, behavior, duration, and cleanup.

🧠 Smart Summon & Combat Relationships

One of the most important parts of RPGSkills is how summons interact with players.

A summoned creature must never attack the player who created it.

RPGSkills prevents this at the targeting level rather than simply cancelling the damage afterward.

This means the summon does not:

Target its owner Chase its owner Attack its owner Repeatedly attempt to attack its owner

The plugin uses a shared Relationship Manager to determine how entities relate to each other.

This system is used by:

Combat Targeting Area damage Pets Summons Parties Guilds

Owner protection is always enforced, while other friendly-fire rules remain configurable.

For example:

A Mage's Meteor will not accidentally destroy their own summons or party members.

A Necromancer's skeletons will not turn against their master when caught inside an area attack.

⚙️ Requirements Requirement Version Server Paper 1.21.x / Purpur Java 21+ Storage SQLite by default Optional Database MySQL

SQLite requires no setup.

Database drivers and the connection pool are loaded automatically through Paper's library loader.

No manual database installation is required.

🔌 Optional Integrations Vault + Economy Plugin

Adds:

Shops Bank Guild Bank Pet Shop Money in player trades

Without Vault/economy integration, these features automatically disable while the rest of the plugin continues working.

PlaceholderAPI

Adds 40+ placeholders for:

Scoreboards Chat Other compatible plugins LuckPerms

Adds per-rank experience bonuses.

Without LuckPerms, the plugin falls back to permission nodes.

🚀 Getting Started Download the plugin. Place the .jar into your server's plugins/ folder. Start the server. RPGSkills automatically generates its configuration files. Players can immediately begin using the RPG system. Player Commands /rpg class /rpg stats /rpg skills /rpg bind <skill> <1-9> /rpg quest

What they do

/rpg class — Choose your class.

/rpg stats — View your RPG statistics.

/rpg skills — Open the skill tree.

/rpg bind <skill> <1-9> — Bind a skill to a hotbar slot.

/rpg quest — Open the quest journal.

Everything is located under /rpg, with tab completion throughout.

Admin commands are restricted to operators by default.

rpgskills.admin grants access to all admin commands.

🛠️ Configuration

RPGSkills is designed to be configured without coding.

Each system has its own configuration file, and values can use formulas.

Example:

cooldown: "20 - level * 2" health: "owner_max_health * 0.5"

This allows you to configure:

Skills Bosses Quests Shops Guild upgrades Summons Pets Stats And more

All player-facing text is stored in messages.yml using MiniMessage, allowing the plugin to be completely translated.

After editing configuration:

/rpg reload

Invalid configuration entries are reported in the console and skipped instead of bringing down the entire server.

⚠️ Before Installing Dungeons

Dungeons require your own maps.

The default dungeons.yml expects a world named dungeons with arenas at configured coordinates.

Build your dungeon maps and update the configuration to match your server.

World Support

RPGSkills is active across all server worlds.

There is currently no global per-world enable/disable option.

However, safe zones, dungeon arenas, and summon world-change behavior are world-aware.

Optional Plugins

ProtocolLib, MythicMobs, and ModelEngine are declared as soft dependencies for correct load ordering when installed.

Integration code for these plugins is not currently implemented.

👨‍💻 Developer API

RPGSkills includes RPGSkillsAPI, exposed through the Bukkit Services Manager.

The API provides access to the plugin's major domain services and 28 events covering areas such as:

Experience Leveling Stats Classes Skills Damage Item upgrades Bosses Dungeons Quests Shops Trading Parties Guilds Pets Summons

Example:

RPGSkillsAPI api = Bukkit.getServicesManager().load(RPGSkillsAPI.class);

api.guild(player).ifPresent(guild -> ...);

api.summon( player, "risen-skeleton", location, 3, 60.0 );

boolean allowed = api.canAttack(summon, target);

Database schema migrations are versioned and executed automatically during upgrades.

📈 Project Status

Alpha — Feature Complete

The core feature set is implemented and internally verified.

Current internal verification includes:

256 source files 427 automated assertions Static checks for symbols Message placeholder validation Cross-file reference validation

The project has not yet completed a long public playtest.

If you encounter an issue, please include:

Minecraft version Server software/version RPGSkills version Full console error Full stack trace ⭐ Why RPGSkills?

RPGSkills is designed to give Paper servers a complete MMORPG foundation without requiring server owners to code every system themselves.

Classes → Skills → Stats → Items → Combat → Bosses → Dungeons → Quests → Economy → Guilds → Pets → Summons