RPGHP v2.0 - The Ultimate

RPGHP v2.0 - The Ultimate RPG Progression System
Author: mercay_aitaem | API Version: 1.21 | Soft Depend: PlaceholderAPI

Overview
RPGHP transforms your server's survival experience into a challenging RPG adventure. Level up your character, increase your health, and face stronger monsters as you grow. Featuring a robust Scaling Difficulty system, Custom Head Drops with texture support, and stunning visual effects.

✨ Key Features

• RPG Progression: Experience an exponential leveling system. The higher you go, the harder it gets!
  
  
• True HP Cap: Grind levels infinitely, but your actual health is capped (Default: 50 Hearts) to maintain PVP balance.
  
  
• Scaling Difficulty: Monsters evolve with you! Higher-level players face enemies that deal increased damage and True Damage (armor piercing).
  
  
• Advanced Head Drops:
  
  • Supports drops for almost every mob.
    
    
  • Custom Texture Support: Uses Base64 textures (No more Steve heads!).
    
    
  • Fully configurable drop chances.
• Roguelike Death Penalty: Death matters! You lose 50% of your current level upon death.
  
  
• Visuals:
  
  • Real-time Action Bar stats.
    
    
  • Wings & Auras: Unlock cosmetic particles at high levels.
    
    
  • Level-up particle effects.
• GUI Menus: Beautiful, user-friendly menus for checking status and drop rates.
  
  
• Developer Friendly: Full PlaceholderAPI support and a native Developer API.

️ Installation & Configuration
1. Installation

1. Download RPGHP-2.0.jar.
   
   
2. Place it in your server's /plugins folder.
   
   
3. (Highly Recommended) Install PlaceholderAPI for scoreboard integration.
   
   
4. Restart your server.

2. Configuration (config.yml)
The config file is generated automatically. Here are the key settings:

Leveling System
YAML
xp-per-heart: 400 # Base XP required for Level 1
xp-multiplier: 2.0 # Difficulty multiplier (XP required doubles every level)

Custom Head Drops
You can define custom textures for any mob using Base64 strings (get them from minecraft-heads.com).

YAML
head-drops:
DEFAULT: 1.0 # Default drop chance (1%)

# Vanilla Head Example
ZOMBIE: 2.0 # 2% chance

# Custom Texture Example
COW:
chance: 5.0 # 5% chance
texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv..."

Commands & Permissions
Command Description Permission
/rpghp menu Opens the main GUI menu. None
/rpghp status Displays your current stats in chat. None
/wing <on/off> Toggles cosmetic wings/aura. None
/rpghp addxp <player> <amount> (Admin) Gives XP to a player. rpghp.admin
/rpghp reload (Admin) Reloads the configuration. rpghp.admin

Placeholders
Fully compatible with PlaceholderAPI (Scoreboard, TabList, Chat):

• %rpghp_level% - Current Level
  
  
• %rpghp_xp% - Current XP
  
  
• %rpghp_reqxp% - XP required for next level
  
  
• %rpghp_hp% - Max HP (Actual)
  
  
• %rpghp_rank% - Rank Title (Novice, Warlord, GOD, etc.)

Known Issues & Bug Reporting
Before reporting a bug, please check the following:

1. Texture Loading: Custom heads require an internet connection to load textures from Mojang's servers. If heads appear as "Steve" or "Alex," check your server's connection.
   
   
2. Plugin Conflicts: This plugin manages Max Health. It may conflict with other plugins that also modify player health attributes (e.g., LevelHearts, OldCombatMechanics).
   
   
3. Damage Scaling: At very high levels (Lv. 100+), monsters deal significant True Damage. This is intended behavior, not a bug!

Found a Bug?

Please report any issues or suggest features via:

• Discord: https://discord.gg/KES7JTpY

Developed by: mercay_aitaem