RPG Craft

This plugin is designed for survival and RPG servers that want long-term progression with scalable PvE difficulty.

---

What's in Beta 0.1.4

Core RPG Progression

• Global player leveling system (starts at Level 1)
• Individual skill categories with separate XP and level progression:
  • Combat
  • Mining
  • Farming
  • Fishing
  • Crafting
• Configurable XP curve (base * level^exponent)

Skill Point System

• Skill points gained on level-up with scaling rewards:
  • +1 on normal levels
  • +2 on multiples of 5
  • +3 on multiples of 20
• Skill points can be spent in GUI on attributes

Attribute System (RPG style)

• STR (Strength): increases max HP
• DEX (Dexterity): increases evasion chance
• INT (Intelligence): increases mana (currently display + data ready)
• Attribute effects are applied automatically on join and after upgrades

Dynamic Mob Leveling

• Hostile mobs get dynamic levels based on:
  • nearby player level average
  • distance from world spawn
  • moon cycle bonus
  • random variance
  • group scaling bonus (more nearby players = stronger mobs)
• Scaled mob health and damage
• Persistent mob level data via PDC

Mob Stat Displays

• TextDisplay overlay above mobs with:
  • mob level
  • current HP / max HP
• Optional classic name tag display can be disabled in config
• Live update task keeps displays synced to moving/damaged mobs

Player HUD + XP Feedback

• ActionBar player HUD:
  • HP
  • Mana
  • Level
  • XP progress
• XP gain ActionBar messages for all XP sources
• XP message hold/suppress system so gain text stays visible longer

Scoreboard Sidebar

• Optional sidebar scoreboard with live RPG stats:
  • Level
  • XP percent
  • HP
  • Mana
  • Skill points
  • all 5 skill category levels
• Fully configurable title and update interval

GUI System

• Main menu (/rpg)
• Stats GUI
• Attribute GUI
• One-click attribute spending
• Category bonuses and progression visuals

Data + Performance

• MySQL storage (HikariCP pooling)
• Async data loading/saving
• Auto-save task
• Safe shutdown save

---

Commands

• /rpg - Open main RPG menu
• /rpg stats [player] - View your stats or another player's stats
• /rpg top [category] - View top list (global or category)
• /rpg help - Show command help

Admin Commands

• /rpg admin reload - Reload config
• /rpg admin setlevel <player> <level> - Set player level
• /rpg admin givexp <player> <amount> [category] - Give XP

---

Permissions

• rpgcraft.use - Basic plugin usage
• rpgcraft.admin - Admin command access
• rpgcraft.stats.others - View other players' stats

---

Skill Category Bonuses (Current)

Combat

• Damage bonus by level milestones
• Crit chance bonus
• Bonus mob XP

Mining

• Haste effect by level milestones
• Extra ore drop chance

Farming

• Double harvest chance

Fishing

• Luck effect by level milestones

Crafting

• Bonus output chance

All values are configurable in config.yml.

---

Configuration Highlights

• XP curve and reward values
• Dynamic mob scaling settings
• Group scaling settings
• Attribute scaling values
• HUD settings
• XP action bar duration/refresh
• Scoreboard toggle/title/interval
• Mob TextDisplay settings
• MySQL credentials and pool size

---

Supported Platform

• Paper 1.21.x
• Java 21+

---

Setup

1. Place the plugin jar into your plugins/ folder
2. Start server once to generate config
3. Configure MySQL settings in config.yml
4. Restart server
5. Use /rpg in-game

---

Beta Notes (0.1.0)

This is an early beta focused on establishing a stable RPG gameplay foundation.
Core systems are fully playable, but balancing and additional RPG mechanics will continue to evolve.

Planned future areas:

• deeper mana-based mechanics
• resistances and elemental systems
• more category perks
• additional GUI pages and advanced stats
• optional per-player HUD/scoreboard toggles

---

If you have ideas, balancing feedback, or bug reports, feel free to share them for the next beta update.