VortexPRG

# ⚔️ VortexRPG **The Complete MMORPG Engine for Paper 1.21+** *v1.2.0-alpha — 🌐 Folia-Native — ☕ Java 21 — 🔧 38 Systems* --- ## 🎮 What is VortexRPG? VortexRPG is a fully self-contained MMORPG engine built for modern Paper servers. No dependencies. No placeholder plugins. No stitching together five separate resources. Everything — classes, talents, spells, professions, dungeons, bosses, quests, economies, parties, and more — ships in a **single JAR** and works out of the box. Built from the ground up on **Folia-native async architecture**, VortexRPG is designed to scale. Every subsystem runs without blocking the main thread, giving you smooth gameplay even on large servers. --- ## 🛡️ Class System **6 Hand-Crafted Classes — 12 Ascension Paths** | Class | Role | Starter Spell | |---|---|---| | 🗡️ **Knight** | Frontline tank, shields & protective auras | Fortify | | 🔮 **Mage** | Ranged arcane devastation & mana management | Arcane Bolt | | 🏹 **Ranger** | Precision striker with traps & companions | Hunter's Mark | | ✨ **Cleric** | Divine healer, buffs & holy wrath | Mend | | 🐺 **Beastmaster** | Tamed companions & pack tactics | Beast Call | | ⚙️ **Engineer** | Turrets, gadgets & field constructs | Deploy Turret | Each class has **10 unique talent nodes** (60 total), **dedicated spells**, and **2 ascension paths** unlocking **12 unique specialisations**. --- ## ⚔️ Combat Engine Stats matter. Every hit runs through a real combat pipeline: - 💥 **CRIT** — chance scales with Dexterity (up to 35%), multiplier scales with Strength (up to 2.5×) - 💨 **DODGE** — chance scales with Dexterity (up to 25%), fully negates the hit - 🔷 **Mana** — max pool = 20 + (WIS + INT) × 4, regens passively from Wisdom - 📊 **6 Core Attributes** — Strength, Vitality, Wisdom, Dexterity, Intelligence, Spirit - 🖥️ **Live HUD** — ActionBar showing ❤️ HP | ✦ Mana | ⭐ Level at all times --- ## 🪄 Spell System **10 Launch Spells — Fully YAML-Extensible** All spells are defined in `spells.yml`. Adding new spells requires **zero Java** — define the type, target, cost, cooldown, and effects entirely in config. The spell framework supports: - 🎯 **80+ mechanic types** — damage, healing, CC, summons, beams, projectiles & more - 🧩 **40+ conditions** — target checks, resources, world state, caster state - ⚡ **30 trigger types** — cast, melee, projectile, sneak, sprint, region enter & more - 🎯 **9 targeter modes** — self, entity, cone, linear, area, sphere, chain, party, ground --- ## 🌳 Talent System **60 Talent Nodes across 6 classes** A fully visual in-game talent GUI lets players invest points into class-specific abilities. Talents are persistent, resettable, and directly influence combat, gathering, and crafting output. - 🔒 Class-locked talent trees — no cross-class bleed - 🖼️ Visual GUI with live tooltips - 🔄 Refund system with configurable cooldown - 🔗 Talent synergy with spell scaling --- ## 🔨 Profession System **17 Professions — Combat, Gathering & Crafting** ⚔️ **Combat (7):** Swordsmanship, Archery, Spellcasting, Shield Mastery, Beast Taming, Engineering Combat, Holy Arts ⛏️ **Gathering (4):** Mining, Woodcutting, Fishing, Herbalism 🛠️ **Crafting (6):** Blacksmithing, Alchemy, Enchanting, Cooking, Leatherworking, Jewellery Each profession has its own XP curve, level milestones, and unlockable perks that feed into the talent and economy systems. --- ## 🏰 Dungeon System **2 Launch Dungeons — Instance-Ready Architecture** - 💀 **Crypt of the Fallen** — Undead gauntlet with escalating wave pressure and a lich overseer - 🔥 **Infernal Depths** — Volcanic descent with timed hazards and the Infernal Warden boss ✅ Full party entry support ✅ Breach Token rewards on completion ✅ Death/lives system per run ✅ Per-dungeon cooldowns ✅ YAML-defined — add dungeons with zero Java --- ## 👹 Boss System **3 World Bosses with Phase Mechanics** - 🔥 **Infernal Warden** — Fire-phase guardian, enrages below 30% HP - 🧊 **Frost Colossus** — Area-freeze mechanics, summons ice shards - 🌀 **Void Harbinger** — Teleports players, corrupts the arena Custom loot tables, phase transitions, announcements, and respawn schedules — all in config. --- ## 👥 Party System **Full Group Management — 18 Subcommands** - 👑 Leader / 🛡️ Officer / 👤 Member role hierarchy - 💗 ActionBar HUD showing party HP in real time - 💬 Party chat channel (`/pc` toggle) - ✅ Ready check system with 30-second voting - 📍 Party summon with accept/decline prompt - 🖼️ Full GUI with player heads, health bars, management submenu - ⬆️ Promote, demote, kick, transfer leadership, rename --- ## 💰 Economy & Auction House - 🏦 Vault-integrated economy with custom currency - 🏪 Full Auction House — list, browse, bid, buy-now, expire - 🪙 Breach Token secondary currency (dungeon rewards) - 📈 Market item state tracking (price history, demand) - 📋 Per-player transaction logs --- ## 📜 Quest System **6 Launch Quests — YAML-Driven Framework** - ⚔️ First Blood — Introductory combat quest - ⛏️ Gathering Basics — Tutorial for profession XP - 🏰 The Deep Descent — Dungeon entry chain - 🎯 Hunter's Mark — Mob-hunting bounty - 👹 Realm Warden — World boss participation - 🔄 Daily Hunt — Repeatable daily with rotating targets Quests support objectives, stage chains, rewards (XP, currency, items), cooldowns, and daily repeatables — all in config. --- ## 🌩️ World Events — Fractures **4 Fracture Profiles — Dynamic World Events** - 🌿 **Wild** — Nature invasion, beast mob surge - 💀 **Skeletal Assault** — Undead wave across configured zones - ☠️ **Necrotic Surge** — Spreading corruption with debuff aura - 🔮 **Arcane Tempest** — Magic storm with spell-amplification effects Fractures trigger on a configurable schedule, broadcast server-wide, and reward participants based on contribution. --- ## 📦 Full System List **38 Integrated Systems:** 🗡️ Class Engine ● 🌟 Ascension/Prestige ● 🌳 Talent Trees (GUI) ● 🪄 Spell Framework ● ⚔️ Combat Engine (CRIT/DODGE) ● 🔷 Mana System ● 🖥️ Player HUD ● 💫 Status Effects ● 🔨 Profession Engine (17) ● 📜 Quest Engine ● 🏰 Dungeon Instancing ● 👹 Boss Framework ● 👥 Party System ● 🗺️ Expedition Manager ● 🌩️ World Fractures ● 🏪 Auction House ● 💰 Economy (Vault) ● 🪙 Breach Tokens ● 📈 Market Tracking ● 📊 Scoreboard ● 🤖 AI NPC Framework ● 🌍 Ecology/Wildlife ● 🚪 Gateway (Fast Travel) ● 💾 Player Data Repository ● 🔍 Diagnostics ● 📈 Levelling & XP Curves ● 🐺 Companion System ● 🎁 Loot Tables ● 🗡️ Item Framework ● 💫 Effects Engine ● 📊 Stat Engine ● ⚔️ Combat Log ● 💀 Death System ● ⏱️ Cooldown Manager ● 🔐 Permission Engine ● 🛠️ Admin Commands ● 🔄 YAML Hot-Reload ● ⚡ Folia Scheduler --- ## 💻 Commands | Command | Description | |---|---| | `/vortex` | 🛠️ Core admin hub (reload, debug, version, inspect) | | `/class` | 🗡️ Class selection, info, ascension | | `/talent` | 🌳 Open talent GUI, reset, inspect | | `/cast` | 🪄 Spell list, bind, cast | | `/quest` | 📜 Quest log, active, complete, abandon | | `/professions` | 🔨 Profession levels, XP, perks | | `/vdungeon` | 🏰 Dungeon list, enter, leave, status | | `/vboss` | 👹 Boss schedules, locations, info | | `/party` | 👥 Full party management (18 subcommands) | | `/pc` | 💬 Quick party chat toggle | | `/auction` | 🏪 Auction house browser | | `/fracture` | 🌩️ Active fracture status | | `/expeditions` | 🗺️ Expedition board and contracts | | `/stats` | 📊 Player stat sheet | | `/adventure` | 🌟 Adventure board and season track | | `/skills` | ⚡ Skill browser and spell binding | --- ## 📋 Requirements - 📄 Paper 1.21+ (or Folia 1.21+) - ☕ Java 21+ - 🏦 Vault (for economy integration) - ✅ No other hard dependencies --- ## 🔗 Links - 🌐 **Website:** [eternalrealm.uk](http://eternalrealm.uk) - 💬 **Discord:** [discord.gg/Tya84XrgSF](https://discord.gg/Tya84XrgSF) - 🐙 **Source Code:** github.com/Sauron05/vortexrpg - ☕ **Ddonate:** https://www.paypal.com/ncp/payment/Y2AMUPMY3GBU6 *VortexRPG is in active alpha development. Systems are functional and tested. Content counts will grow with each release. All configs are fully documented for server owners and developers.* **⚔️ — EternalRealm™ — ⚔️**