VortexRPG
Free, open-source Minecraft RPG plugin for Paper, Spigot, and Folia.
VortexRPG is a data-driven RPG framework for Minecraft servers that combines classes, spellcasting, progression, professions, quests, world events, dungeons, bosses, custom items, economy systems, and in-game admin tooling in one plugin.
Overview
VortexRPG is built for servers that want more than a basic skill plugin. It ships with player-facing progression systems, world content loops, and admin tools for editing RPG content directly in-game.
Out of the box, the plugin includes:
- Playable classes with starter items, class-specific abilities, and ascension paths
- Spellcasting, active spell loadouts, spellbook menus, and spell editing tools
- Character stats, talents, progression, and scoreboard/HUD support
- Professions, crafting stations, gathering hooks, and dynamic economy systems
- Quests, adventure boards, seasonal reward tracks, expeditions, fractures, and gateways
- Custom items, effects, bosses, dungeons, party systems, and an auction house
- Admin forges, diagnostics, validation tools, hot reload commands, and support dump generation
Feature Set
| System | What it includes |
|---|---|
| Classes | Class selection, class inspection, ascension paths, class kits, starter relics, and class-specific combat flow |
| Spells | Spellbook GUI, active spell equip/cast flow, spell registry, built-in spell editing, spell forge, and effect bindings |
| Progression | Stats, XP curve, talent trees, skill unlocking, point allocation, and live attribute updates |
| Content Loops | Quests, adventure board objectives, season tracks, expeditions, fractures, breaches, gateways, bosses, and dungeons |
| Items | Custom items, custom effects, click-based class weapons, item forge tooling, locked relic handling, and resource-pack-ready visuals |
| Economy | Vault support, dynamic market pricing, auction house, breach rewards, and profession/crafting hooks |
| Social | Parties, party chat, ready checks, summons, and shared group flows for expeditions and encounters |
| Integrations | Vault, PlaceholderAPI, WorldGuard, Citizens, and optional resource pack delivery |
| Admin Tools | In-game forges, hot reload, diagnostics, persistence snapshots, validation checks, scoreboard controls, and support dump export |
Included Gameplay Areas
Core player systems
/classfor class selection, info, specs, and ascension/skills,/spell, and/castfor spell and skill management/statsand/talentfor progression and passive growth/professionsfor gathering and station access/questand/adventurefor repeatable and seasonal progression
World and encounter systems
/fracturefor rift tracking, gateway travel, and realm administration/expeditionsfor contracts, breach finales, leaderboards, and party content/vbossfor world boss browsing, summoning, and editing/vdungeonfor instanced dungeon browsing, entry, and administration
Economy and social systems
/auctionfor player listings, browsing, and selling/partyand/pcfor party management and party chat
Admin and content creation
/vortexfor admin toolkit access/vrpas a unified command hub for the full plugin surface- In-game forge editors for classes, spells, effects, items, bosses, and other RPG content
- Hot reload commands for spell, effect, and item registries without restarting the server
Supported Platforms
- Paper 1.21+
- Folia
- Spigot 1.21+ via the dedicated Spigot build
- Java 21
Installation
- Install Java 21 on your server host.
- Choose the correct jar for your server:
- Paper/Folia: the standard shadow jar from
build/libs/ - Spigot: the
-spigot.jarbuild frombuild/libs/
- Paper/Folia: the standard shadow jar from
- Drop the jar into your server's
plugins/folder. - Start the server once to generate configuration files.
- Edit the YAML files in
plugins/VortexRPG/to fit your server. - Use the in-game admin tooling and hot reload commands to iterate on content.
Configuration Files
VortexRPG ships with editable YAML resources for its major systems:
| File | Purpose |
|---|---|
config.yml |
Core settings, integrations, scoreboard, resource-pack delivery, economy tuning, and system toggles |
spells.yml |
Spell definitions, mechanics, targeters, scaling, and gating |
effects.yml |
Status effects and reusable combat modifiers |
items.yml |
Custom items, class relics, click bindings, and item overrides |
quests.yml |
Quest content and progression rules |
talents.yml |
Talent tree and passive progression definitions |
fractures.yml |
Fracture pressure, breach pacing, rewards, and world-state tuning |
gateways.yml |
Gateway destinations and travel configuration |
bosses.yml |
Boss encounter definitions and admin-editable boss data |
dungeons.yml |
Dungeon instances, entry rules, and dungeon metadata |
Optional Integrations
| Plugin | Usage |
|---|---|
| Vault | Economy rewards, balance hooks, and reward payouts |
| PlaceholderAPI | Placeholder expansion for external displays and menus |
| WorldGuard | Protection-aware hooks and safer world interactions |
| Citizens | NPC role bindings and neural guide interactions |
Development Notes
- Gradle Kotlin DSL build
- Java 21 toolchain
- JUnit 5 test suite
- Paper/Folia main build plus a dedicated Spigot jar task
- Shaded runtime libraries include bStats, Jackson, and Caffeine
Getting Started In-Game
For a clean first boot flow:
- Join the server and choose a class with
/class. - Open the spellbook with
/spelland equip an active spell. - Review stats with
/statsand talents with/talent. - Explore quests, professions, adventure boards, fractures, and expeditions.
- Use
/vrpto discover the unified command hub.