RPGClasses

RPGClasses 1.0.3

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.
1000003302.jpg

1000003301.jpg

🚀 Features
  • 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
📋 Commands
Player Commands
  • /classes - Show class selection form
  • /classes select - Choose a class
  • /classes info - View your class stats and progression
Admin Commands
  • /classes reload - Reload configuration
  • /classes setlevel <player> <level> - Set player level
  • /classes setxp <player> <xp> - Set player XP
⚔ Classes Overview
🛡 Warrior
  • Role: Balanced melee fighter
  • Strength: High health and consistent damage
  • Critical: 10% base chance, +0.5% per level, 2.5x multiplier
🏹 Archer
  • Role: Ranged specialist
  • Strength: High critical chance and speed
  • Critical: 15% base chance, +0.8% per level, 3.0x multiplier
🔮 Mage
  • Role: Spellcaster
  • Strength: Massive critical damage
  • Critical: 8% base chance, +0.3% per level, 4.0x multiplier
🛡 Tank
  • Role: Damage absorber
  • Strength: Extreme health pool
  • Critical: 5% base chance, +0.2% per level, 2.0x multiplier
🗡 Assassin
  • Role: Fast attacker
  • Strength: Highest critical frequency
  • Critical: 20% base chance, +1.0% per level, 2.8x multiplier
⚙ Configuration Files
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]'
classes.yml:
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
🔧 Installation
  1. Download the plugin JAR file
  2. Place it in your Nukkit server's plugins folder
  3. Restart the server
  4. Configure settings in plugins/RPGClasses/config.yml
  5. Customize classes in plugins/RPGClasses/classes.yml
Level Up Effects
  • Stats automatically updated
  • Level-up sound played
  • Health and speed recalculated
  • Critical hit chances increased
🔄 Permissions
  • rpgclasses.player - Access to basic commands
  • rpgclasses.select - Permission to select classes
  • rpgclasses.info - Permission to view class info
  • rpgclasses.admin - Administrative commands
🐛 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:

  • Configuration loading issues
  • Class data corruption
  • Permission conflicts
🎯 Customization Guide
Adding New Classes
  1. Open classes.yml
  2. Add new class section following the existing format
  3. Define all required stats and multipliers
  4. Reload with /classes reload
Modifying Stats
  • 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
Message Customization
All messages are in config.yml under the messages section. Use § codes for colors.

📈 Performance Tips
  • 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
🤝 Support
For bug reports and feature requests:
  1. Check existing issues in the plugin repository
  2. Provide detailed error messages from console
  3. Include your configuration files
  4. Specify your Nukkit version
  • Like
Reactions: DimBoy and indra87g
Author
Slavko / Frost
Downloads
544
Views
1,320
First release
Last update
Rating
4.50 star(s) 2 ratings

More resources from Slavko / Frost

Latest updates

  1. Crit system! Fix all errors!

    I checked it and say that plugin is the most powerfull class plugin for Nukkit!

Latest reviews

So I figured out why it did work for me. The commands /classes don't do anything. I have to use /rpgclasses to get it to work. Now it works fine. Maybe take them out and can you add a per world option in the config.
Slavko / Frost
Slavko / Frost
Why you need per world config? To block classes in specific world?
I just installed the latest version and it works perfectly so far. I’ll keep testing it to see how it develops, but for now everything looks really good. Great work!
Slavko / Frost
Slavko / Frost
Thanks for rewiew!
Doesn't work on the latest version of Nukkit getting this when using the command /rpgclass - Message not found: classes.seletion.instruction
Slavko / Frost
Slavko / Frost
Check the fix and you will change the rewiew and rating
I tested it on NukkitX and NukkitPetteriM1Edition, but it didn’t work. I’ve tried all Java versions from 8 to 21 and it still doesn’t work. It doesn’t create the language file, not even the default one or the selected one. I will change my rating once it works.
Slavko / Frost
Slavko / Frost
Check the fix and you will change the rewiew and rating
Top