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 ` - View your stats or another player's stats
• `/rpg top ` - View top list (global or category)
• `/rpg help` - Show command help

### Admin Commands - `/rpg admin reload` - Reload config - `/rpg admin setlevel ` - Set player level - `/rpg admin givexp ` - 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+

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.