LucsemporiumRPG v2.0.0 — Initial Release

A full RPG skill point system for Minecraft 1.20.1.

Earn XP, level up, spend points across 31 skills. Build your character your way.

Requires Java 17+ and Forge 47.2.20+.

Core Systems

RPG Progression

• 100 levels, 10 skill points per level, 1,000 total points
• XP earned from killing mobs (RPG orbs drop alongside vanilla XP) and gathering (crops + logs)
• Creative and spectator players don't earn XP
• XP curve: 50 + level * 10 per level step

31 Skills in 5 Categories

• Vitals (4 skills) — Health Points, Hunger, Regeneration, Oxygen
• Movement (5 skills) — Speed, Jump Height, Glide, Swim Speed, Sprint Efficiency
• Offense (6 skills) — Melee Damage, Ranged Damage, Attack Speed, Critical Chance, Lifesteal, Arrow Recovery
• Defense (12 skills) — Knockback Resist, All Resistance, Explosion/Fire/Lightning/Fall/Asphyx/Poison/Wither Resist, Dodge, Thorns, Fireproof
• Utility (4 skills) — Mining Speed, Luck/Loot, Night Vision, Magnet

Total skill cap sum is 1,505 — with 1,000 points available, players must specialize (~66% fill rate). Every build is a meaningful choice.

Skill Point Reset

• Available at level 6+
• Costs 5 levels
• Refunds all spent points
• Shift+Click to confirm (no accidental resets)

GUI

Stats Page

• 5 color-coded category tabs: Vitals (green), Movement (blue), Offense (red), Defense (gold), Utility (purple)
• Each skill shows name, current/cap value, progress bar in category color, and +/- buttons
• Stage multiple points before applying — preview your changes
• Staged points shown in a brighter shade on the progress bar
• Bottom description panel shows a one-line explanation when hovering any skill
• Apply, Undo, and Reset buttons in the top bar

Equipment Page

• 6 vanilla equipment slots (armor + mainhand + offhand) plus Curios slots if the mod is installed
• Compact stat summary: HP, Hunger, Armor, Attack Damage/Speed, Movement Speed, KB Resist
• RPG Bonuses section shows only invested skills (no clutter from zero-point stats)
• Active potion effects with green/red color dots and m:ss format
• Bottom detail panel shows hovered item's enchantments, durability, and attribute modifiers (works with modded gear)

mcMMO Page (hybrid servers)

• Skills grouped by Combat, Gathering, Misc
• Per-skill XP progress bars with category colors
• Jobs Reborn name, level, and XP bar
• Skill descriptions on hover
• Refresh button with 2s cooldown
• Clear messaging when mcMMO is not available

CNPC Quests Page

• Active quests shown first, completed quests after a separator
• Status icons: orange dot for active, green checkmark for completed
• Compact layout: title + giver on one line, objectives with arrow bullets, rewards on one line
• Description shown in bottom panel on hover
• Quest count in header
• Scrollable with full scrollbar support

HUD & Notifications

RPG XP Bar

• Blue bar above the hearts, same width and style as the vanilla experience bar (182px)
• Level number centered above the bar with shadow outline
• Scales dynamically with extra heart rows and armor display
• Respects F1 (hide HUD) and debug screen

Level-Up Banner

• Center-screen "LEVEL UP!" in gold with "Level X" below in blue
• Appears for 3 seconds with fade-in and slight upward drift on fade-out
• Sound: vanilla level-up jingle at 1.4x pitch + note block chime at 1.8x pitch
• One-shot — doesn't repeat or come back

Unspent Points Reminder

• Pulsing text above the XP bar when points are unspent
• Shows "Use [G]" if the key is bound, or "Assign LucRPG key in Controls" if not
• Gentle sine-wave pulse (4 second cycle), never aggressive
• Hidden while the RPG GUI is open or the level-up banner is showing
• Periodic reminders every 90-180 seconds (randomized, not spammy)

RPG XP Orbs

• Custom tagged vanilla ExperienceOrbs — no custom entity types (clean uninstall safe)
• Three billboard textures based on value: orb_1, orb_5, orb_10
• Render at full brightness (glow like vanilla orbs)
• Split into 10/5/1 denominations for visual variety
• Gathering orbs consolidate periodically into larger piles
• Picked up via PickupRpgOrb at HIGHEST priority — awards RPG XP, cancels vanilla XP for that orb

Mod Compatibility

• Curios API — Equipment page auto-detects and displays equipped curio items (rings, amulets, etc.) via reflection. No compile dependency.
• mcMMO — Skills page queries mcMMO data via PlaceholderAPI on hybrid servers (Mohist/Arclight). Falls back gracefully on pure Forge.
• CustomNPCs — Quest page syncs active CNPC quests via reflection bridge. Updates every 2 seconds.
• SpiritLinks — Optional death penalty integration. When both mods are installed, resurrection costs RPG XP (configurable, scaling with death frequency, never drops a level).

All integrations are optional and detected at runtime. LucsemporiumRPG works standalone with zero dependencies beyond Forge.

Requirements

Drop lucrpg-1.20.1-2.0.0.jar into your mods/ folder. Config generates on first run. Press G to open the GUI.

Made by Luc Bellefeuille.