🌌 Player System

Step into a manhwa-style RPG progression! Awaken your rank, spend stat points, fuse skills, pick classes, and clear gates, dungeons, and a Tower all guided by a floating holographic System window.

Player System brings a full manhwa-inspired progression layer to Minecraft. Awaken your true potential, unlock your personal floating System window, and climb the ranks from an E-Rank novice to a legendary SSS-Rank Hunter!

Designed to work fully standalone on NeoForge 1.21.1, while serving as an extensible foundation for modpacks, datapacks, and addon mods.

⚡ How to Activate the System

Unlike typical mods that start immediately upon world creation, Player System requires an awakening trigger to unlock its powers:

1. Experience Death: To activate the System, your character must die for the first time in the world.

2. Safe for Hardcore Mode: Don't worry, this mechanic works safely and seamlessly even in Hardcore mode, allowing you to unlock the System without losing your world!

3. Claim Your Power: Once you respawn after your initial death, the System will fully awaken and be ready to use.

📊 Awakening, Stats & Holographic HUD

• Rank Awakening: Awaken upon your initial death to roll your innate rank (from E up to SSS). Your rank determines the caps for your stat growth.

• Dynamic Stats: Spend stat points freely on health, attack power, movement speed, mana capacity, and more. Features instant allocation, point suspension, and full respec options.

• The System Window: Press I to open your personal 3D holographic interface in the world, featuring tabs for Status, Class, Skills, Quests, Shop, Tower, Wiki, and Options.

• Full Visual Customization: Toggle opacity, adjust UI scale, configure custom keybinds, and choose whether your window and ranking position are visible to other players on the server.

⚔️ Skills, Fusions & Classes

• Uncapped Skill System: Learn active and passive skills via the skill tree, quest rewards, trials, or the System Shop.

• Synthesis & Evolution: Train your skills to ascend them into stronger forms, or combine compatible abilities in the Synthesis Tab to unlock entirely new powers!

• Combat Mechanics: Utilize echo effects, solar flares, miasmas, invincibility windows, and kill-streak damage boosts.

• Class Progression: Pick a class path and follow its upgrade chains to specialize your playstyle and combat role.

📜 Quests, Shop & Rankings

• Dynamic Quests: Accept or decline daily and procedural quests. Risk penalties (mob swarms, item loss, or death risks) for high-value rewards like System Coins, rare items, skills, and titles.

• System Shop: Spend System Coins on consumables, recovery kits, scrolls, emergency supplies, and rare skills.

• Titles & Leaderboards: Complete achievements to unlock stat-boosting titles, register on the Hunter Board, and compete on server-wide player rankings.

🏰 Gates, Dungeons & The Tower

• Gate Breaks & Rifts: Explore randomly appearing Gates that lead to treacherous labyrinths filled with custom bosses, traps, and unique death/grave handling.

• Party System: Form parties with other players to share loot, claim first-clear rewards, and enjoy anti-farm protections.

• The Keep & Tower: Conquer a 10-floor Keep featuring 7 difficulty levels, traps, secret vaults, per-floor time records, and direct-to-pouch protected loot drops!

🛠️ Mobs, Items & Progression

• Ranked Mobs: Mobs spawn with randomized ranks, affixes, and promotion states, ensuring every encounter remains unpredictable.

• Ranked Equipment: Discover ranked weapons, artifacts, and "cheat death" gear effects.

• Survival Kits: Utilize custom Starter Kits, Bandages, Repair Kits, and Recall Scrolls with unique textures and animations.

🔮 Datapack & Modpack Support

• 100% Extensible: Quests, skills, skill fusions, classes, and rewards are managed via datapacks, allowing modpack creators to customize the entire experience.

• Developer API: Includes registries for custom quest objectives, rewards, penalties, and integration hooks for other mods.

🚧 Work in Progress & Roadmap

Current Focus:

• UI Native Layouts: Migrating older window tabs to native renderers so every tab matches the Status tab layout.

• Evolutions & Titles: Expanding skill evolution trials, unlockable titles, and unique progression paths.

• Balance & Scaling: Fine-tuning combat mechanics, stat impact, and rank scaling based on ongoing playtest feedback.

Coming Next:

• Tower & Dungeons: Additional Tower floors, diverse dungeon themes, and fresh environmental layouts.

• World & Structures: Enhanced structure generation across dimensions, including custom portals.

• Mobs & Equipment: Unique Gate bosses and custom mobs with dedicated models and AI behavior, alongside an expanded armory of items and ranked gear.

• Skills & Synthesis: A broader pool of active and passive skills, new fusion recipes in the Synthesis tab, and upgraded visual/particle effects.

• Quests & Progression: More daily and procedural quests, hidden Spire mechanics, and integrated HUD overlay strips (mana bar over XP, custom level plate).

🔌 Requirements & Installation

• Minecraft: 1.21.1 on NeoForge (Java 21 required).

• Installation: Install on both client and server.

• Default Keybind: Press I in-game to initialize your System.

Found a bug or have a suggestion? Report it on GitHub.