- Compatible API Versions
- 1.0.1+
RPG Classes Plugin Documentation
Overview
RPG Classes is a feature-rich Nukkit plugin that adds a comprehensive class system with level progression, unique stats, critical hits, and customizable character development. Players can choose from multiple classes, each with distinct abilities and growth patterns.
Features
Commands
Player Commands
Classes Overview
Warrior
Archer
Mage
Tank
Assassin
Configuration Files
config.yml:
classes.yml:
Installation
Permissions
Troubleshooting
Common Issues
Q: Colors not displaying correctly?
A: Ensure you're using § format in config files, not & format
Q: Stats not updating after level up?
A: Check console for errors and verify classes.yml syntax
Q: Critical hits not working?
A: Verify enable-critical-hit-messages is true in config
Q: Permission errors?
A: Check your permission plugin configuration
Log Files
Check server.log for detailed error messages related to:
Customization Guide
Adding New Classes
All messages are in config.yml under the messages section. Use § codes for colors.
Performance Tips
Support
For bug reports and feature requests:
RPG Classes is a feature-rich Nukkit plugin that adds a comprehensive class system with level progression, unique stats, critical hits, and customizable character development. Players can choose from multiple classes, each with distinct abilities and growth patterns.
- 5 Unique Classes with individual stat progression
- Level System with XP gain from killing mobs
- Critical Hit System with class-specific chances and multipliers
- Customizable Stats (Health, Damage, Speed, Regeneration)
- Bedrock-Compatible Colors and UI
- Admin Commands for management
- Multi-language Support (fully configurable messages)
- Automatic Stat Updates and regeneration
Player Commands
- /classes - Show class selection form
- /classes select - Choose a class
- /classes info - View your class stats and progression
- /classes reload - Reload configuration
- /classes setlevel <player> <level> - Set player level
- /classes setxp <player> <xp> - Set player XP
- Role: Balanced melee fighter
- Strength: High health and consistent damage
- Critical: 10% base chance, +0.5% per level, 2.5x multiplier
- Role: Ranged specialist
- Strength: High critical chance and speed
- Critical: 15% base chance, +0.8% per level, 3.0x multiplier
- Role: Spellcaster
- Strength: Massive critical damage
- Critical: 8% base chance, +0.3% per level, 4.0x multiplier
- Role: Damage absorber
- Strength: Extreme health pool
- Critical: 5% base chance, +0.2% per level, 2.0x multiplier
- Role: Fast attacker
- Strength: Highest critical frequency
- Critical: 20% base chance, +1.0% per level, 2.8x multiplier
config.yml:
YAML:
max-level: 50
base-xp-required: 100
xp-per-kill:
default: 10
xp-multiplier: 1.2
enable-level-up-effects: true
enable-regeneration: true
regeneration-interval: 20
critical-hit-multiplier: 3.0
enable-critical-hit-messages: true
critical-hit-sound: true
base-health: 20
base-speed: 0.1
base-damage: 1.0
messages:
system:
plugin-enabled: §aRPG Classes plugin enabled!
plugin-disabled: §cRPG Classes plugin disabled!
reload-success: §aConfiguration reloaded successfully!
stats-updated: §aYour stats have been updated!
errors:
no-permission: §cYou don't have permission to use this command!
players-only: §cThis command can only be used by players!
player-not-found: §cPlayer not found!
invalid-number: §cInvalid number!
class-not-found: §cClass not found!
classes:
selection:
title: §6Select Your Class
instruction: §7Choose your class carefully! This choice is permanent.
selected: §aYou have selected the §e%class% §aclass!
no-class-selected: §cYou haven't selected a class yet! Use /classes select
info:
description: §6Description
damage: §4Damage
regen: §aRegeneration
health: §cHealth
speed: §bSpeed
critical: §dCritical Hit
level: §eLevel
xp: §3XP
stats: §6Character Stats
health-stat: '§cHealth: §f%health%'
damage-stat: '§4Damage: §f%damage%x'
speed-stat: '§bSpeed: §f%speed%'
regen-stat: '§aRegen: §f%regen% HP/s'
critical-stat: '§dCritical: §f%chance%% (%multiplier%x)'
progress:
xp-gained: §a+%xp% XP! §7(%current%/%needed%)
level-up: §6Level Up! §eYou are now level %level%!
max-level-reached: §cYou have reached the maximum level!
critical:
hit: §d⚡ CRITICAL HIT! §f%damage% damage!
hit-other: §d⚡ %player% landed a CRITICAL HIT! §f%damage% damage!
admin:
level-set: §aSet §e%player%'s §alevel to §e%level%
your-level-set: §aYour level has been set to §e%level%
xp-set: §aSet §e%player%'s §aXP to §e%xp%
your-xp-set: §aYour XP has been set to §e%xp%
commands:
classes:
description: RPG Classes management command
usage: '§cUsage: /classes [select|info|reload|setlevel|setxp]'
YAML:
classes:
warrior:
name: §4Warrior
description: §7Strong melee fighter with high health and balanced critical hits
damage-multiplier: 1.3
regeneration-rate: 0.8
health-multiplier: 1.5
speed-multiplier: 0.9
base-damage-bonus: 2.0
base-health-bonus: 10
health-per-level: 3
damage-per-level: 0.15
speed-per-level: 0.005
base-critical-chance: 10.0
critical-chance-per-level: 0.5
critical-multiplier: 2.5
archer:
name: §2Archer
description: §7Ranged specialist with high speed and critical chance
damage-multiplier: 1.1
regeneration-rate: 0.5
health-multiplier: 1.0
speed-multiplier: 1.4
base-damage-bonus: 1.0
base-health-bonus: 0
health-per-level: 1
damage-per-level: 0.08
speed-per-level: 0.02
base-critical-chance: 15.0
critical-chance-per-level: 0.8
critical-multiplier: 3.0
mage:
name: §9Mage
description: §7Powerful spellcaster with high damage and massive criticals
damage-multiplier: 1.4
regeneration-rate: 0.3
health-multiplier: 0.8
speed-multiplier: 1.1
base-damage-bonus: 1.5
base-health-bonus: -5
health-per-level: 1
damage-per-level: 0.2
speed-per-level: 0.01
base-critical-chance: 8.0
critical-chance-per-level: 0.3
critical-multiplier: 4.0
tank:
name: §6Tank
description: §7Extremely durable with massive health but low criticals
damage-multiplier: 0.8
regeneration-rate: 1.2
health-multiplier: 2.0
speed-multiplier: 0.7
base-damage-bonus: 0.5
base-health-bonus: 20
health-per-level: 4
damage-per-level: 0.05
speed-per-level: 0.003
base-critical-chance: 5.0
critical-chance-per-level: 0.2
critical-multiplier: 2.0
assassin:
name: §8Assassin
description: §7Fast and deadly with very high critical chance
damage-multiplier: 1.2
regeneration-rate: 0.4
health-multiplier: 0.9
speed-multiplier: 1.6
base-damage-bonus: 1.2
base-health-bonus: -3
health-per-level: 1
damage-per-level: 0.12
speed-per-level: 0.025
base-critical-chance: 20.0
critical-chance-per-level: 1.0
critical-multiplier: 2.8
- Download the plugin JAR file
- Place it in your Nukkit server's plugins folder
- Restart the server
- Configure settings in plugins/RPGClasses/config.yml
- Customize classes in plugins/RPGClasses/classes.yml
- Stats automatically updated
- Level-up sound played
- Health and speed recalculated
- Critical hit chances increased
- rpgclasses.player - Access to basic commands
- rpgclasses.select - Permission to select classes
- rpgclasses.info - Permission to view class info
- rpgclasses.admin - Administrative commands
Common Issues
Q: Colors not displaying correctly?
A: Ensure you're using § format in config files, not & format
Q: Stats not updating after level up?
A: Check console for errors and verify classes.yml syntax
Q: Critical hits not working?
A: Verify enable-critical-hit-messages is true in config
Q: Permission errors?
A: Check your permission plugin configuration
Log Files
Check server.log for detailed error messages related to:
- Configuration loading issues
- Class data corruption
- Permission conflicts
Adding New Classes
- Open classes.yml
- Add new class section following the existing format
- Define all required stats and multipliers
- Reload with /classes reload
- Adjust health-per-level for HP growth
- Modify damage-per-level for damage scaling
- Change critical-chance-per-level for critical progression
- Update multipliers for class balance
All messages are in config.yml under the messages section. Use § codes for colors.
- Set regeneration-interval higher for better performance
- Use reasonable max-level values (50-100 recommended)
- Monitor XP gain rates for server balance
- Consider critical hit effects on PvP balance
For bug reports and feature requests:
- Check existing issues in the plugin repository
- Provide detailed error messages from console
- Include your configuration files
- Specify your Nukkit version