# \u2694 VortexRPG
\n### A full-scale MMO engine for Paper 1.21+ \u2014 by Eternal Realm\u2122<\/p>\n
—<\/p>\n
VortexRPG is a production-grade MMO core framework that transforms your Paper server into a fully realized RPG world. Choose your class, master a spell arsenal, close fracture rifts tearing open across the realm, run expedition contracts with your party, and trade on a dynamic player economy \u2014 all powered by a **single, zero-dependency JAR**.<\/p>\n
Drop it in your `plugins\/` folder.<\/p>\n
—<\/p>\n
## \u2726 Core Systems<\/p>\n
### \u2694 Classes & Ascension
\n– Six base classes \u2014 **Knight, Mage, Ranger, Cleric, Beastmaster, Engineer**
\n– Two ascension paths per class \u2014 12 specializations total
\n– Custom stat profiles, XP curves, and attribute scaling per class
\n– Skill point allocation, passive bonuses, and class-bound relics
\n– Lock in your ascension path with `\/class ascend`<\/p>\n
### \ud83d\udd2e Spells & Skill Atlas
\n– Data-driven spell system \u2014 define everything in `spells.yml`
\n– Built-in spells: **Ember Lance** (Mage \u2014 AoE fire + Bleed), **Warden’s Bloom** (Cleric \u2014 AoE heal + Arcane Ward)
\n– Composable mechanics: damage, heal, apply effect, spawn particles, play sound, send message
\n– Spell Forge for crafting custom spells in-game
\n– Per-class restrictions, level gates, cooldown management
\n– Cast with `\/cast` or bound item clicks<\/p>\n
### \u2728 Effects Engine
\n– Fully stackable, tick-driven status effects defined in `effects.yml`
\n– Built-in: **Bleed** (5-stack physical DoT with crit particles), **Arcane Ward** (3-stack magic barrier)
\n– On-apply, on-tick, and on-remove hook pipelines
\n– Harmful and beneficial categories with tag filtering<\/p>\n
### \ud83c\udf00 Fracture Rifts
\n– Dynamic rift events that tear open across your world at runtime
\n– Built-in profiles: **Wild, Skeletal Assault, Necrotic Surge, Arcane Tempest** and more
\n– Per-profile mob tables, health\/damage multipliers, and effect assignments
\n– Named boss encounters with configurable multipliers and boss-exclusive effects
\n– Gateway network \u2014 fast-travel nodes discovered and traversed in-world
\n– Spiral auto-generation with `\/fracture gateway generate`<\/p>\n
### \ud83d\uddfa Expeditions & Breach Finales
\n– Expedition board with contract tiers, objectives, and time limits
\n– Full party system \u2014 form a group, run contracts together, split rewards
\n– Breach Finales \u2014 instanced boss arenas triggered from the expedition board
\n– Leaderboards, reward tracks, and quartermaster NPC for loot turn-ins<\/p>\n
### \ud83d\udcb0 Economy & Marketplace
\n– Dynamic market with supply\/demand elasticity, price floors, and caps
\n– Configurable decay rates keep the economy balanced over time
\n– Vault bridge for compatibility with any external economy plugin<\/p>\n
### \ud83e\udd16 AI-Driven NPCs
\n– Citizens integration for quest givers, merchants, and trainers
\n– Neural NPC manager powered by Ollama or any OpenAI-compatible API
\n– Per-NPC conversation memory, greeting templates, and timeout handling<\/p>\n
### \ud83e\uddf0 Professions & Adventure Board
\n– Profession ledger with gathering, crafting stations, and profession stats
\n– Adventure board \u2014 seasonal objectives, reward tracks, daily\/weekly missions<\/p>\n
### \ud83d\udcbe Zero-Setup Persistence
\n– Player data saved as **JSON files** \u2014 no external database required
\n– Atomic file writes prevent data corruption on crash
\n– Caffeine in-memory cache for near-zero latency on active players
\n– Revision-based optimistic locking prevents concurrent save conflicts
\n– All data in `plugins\/VortexRPG\/playerdata\/`<\/p>\n
### \ud83d\udee1 Admin Toolkit
\n– `\/vortex` hub \u2014 forge editors, hot reload, registry inspection, diagnostics
\n– 50+ granular permission nodes
\n– Support dump generator for easy bug reports
\n– PlaceholderAPI expansion for scoreboards, TAB, and chat
\n– **Folia-compatible** \u2014 scales across multi-threaded server environments<\/p>\n
—<\/p>\n
## \u2726 Requirements<\/p>\n
| Requirement | Version |
\n|—|—|
\n| Paper (or fork) | 1.21+ |
\n| Java | 21+ |<\/p>\n
> \u26a0 Requires **Paper 1.21+** \u2014 Pufferfish, Purpur, and Folia are supported. Plain Spigot is not.<\/p>\n
### Optional Integrations
\n| Plugin | Purpose |
\n|—|—|
\n| Citizens 2.0+ | NPC system (quest givers, merchants, AI companions) |
\n| WorldGuard 7.0+ | Region-based protection |
\n| PlaceholderAPI | Expose player stats to any compatible plugin |
\n| Vault | Economy bridge to existing server currency |<\/p>\n
—<\/p>\n
## \u2726 Installation<\/p>\n
1. Drop `VortexRPG.jar` into your `plugins\/` folder
\n2. Start or restart your server
\n3. All configs are generated automatically in `plugins\/VortexRPG\/`
\n4. Edit `config.yml`, `spells.yml`, `effects.yml`, `fractures.yml`, and `items.yml` to customize
\n5. Use `\/vortex reload` to hot-reload configs without restarting<\/p>\n
—<\/p>\n
## \ud83d\udcac Support<\/p>\n
<\/p>\n
Join our Discord for bug reports, feature requests, and support: **https:\/\/discord.gg\/4NspeUX6tG**<\/p>\n","protected":false},"excerpt":{"rendered":"
VortexRPG is a fully self-contained MMORPG engine built for modern Paper servers. No dependencies. No stitching together five separate resources. Everything \u2014 classes, talents, spells, professions, dungeons, bosses, quests, economie<\/p>\n","protected":false},"featured_media":167672,"template":"","meta":{"_minecraft_slug":"vortexrpg","_minecraft_project_id":"vuXiXUvx","_minecraft_author":"asuna_yuki","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":53,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vortexrpg.zip","_minecraft_size_bytes":36506172,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-15T20:58:47.739146Z","_minecraft_date_created":"2026-04-16T19:54:30.244154Z","_minecraft_date_modified":"2026-05-14T15:37:19.037919Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vortexrpg","_minecraft_icon_attachment_id":167672,"_minecraft_imported_at":"2026-06-09T19:10:28+00:00","_minecraft_import_hash":"28a7af77a98f2e5ceef277b6944f4d6d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,125,89,137,127,128,129],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-167671","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n