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

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

📋 Requirements

• 📄 Paper 1.21+ (or Folia 1.21+)
• ☕ Java 21+
• 🏦 Vault (for economy integration)
• ✅ No other hard dependencies

🔗 Links

• 🌐 Website: eternalrealm.uk
• 💬 Discord: 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™ — ⚔️