XP2HP Plugin Documentation

Version: 1.0.7 Author: Mr.Lust Minecraft: 1.21.4 to 1.21.6 (Folia supported) API: Paper / Purpur / Folia Tagline: Scale your player's power with experience!

---

🧩 Overview

XP2HP allows Minecraft servers to dynamically boost player health and attributes based on their XP level.

• Fully configurable per-level boosts

• Supports ALL major attributes

• Lightweight, Folia-safe

• Works out-of-the-box with simple YAML

---

⚙️ Configuration

Path: plugins/XP2HP/config.yml

💖 Health Scaling

max-health-on-level:
  0: 20      # Default health (10 hearts)
  10: 24     # 12 hearts at level 10
  20: 28     # 14 hearts at level 20
  30: 32
  40: 36
  50: 40     # 20 hearts at level 50

---

🧠 Stat Boosts Per Level

stat-boost-on-level:
  10:
    - minecraft:attack_damage;1.0
    - minecraft:luck;2.0
  20:
    - minecraft:armor;2.0
    - minecraft:attack_speed;0.5
  30:
    - minecraft:attack_knockback;1.0
    - minecraft:scale;0.05

💡 Format: LEVEL: - minecraft:<attribute>;<value>

---

🔔 Messages and Control Flags

max-health-update-message: "<green>You are growing Stronger!</green>"

heal-on-health-update: true
allow-unsafe-levels: false
notify-only-exact-levels: true

notify-at-levels:
  - 10
  - 20
  - 30

---

⚔️ Supported Attributes

The following attributes can be used in the config:

Attribute	ID in Config	Default
Max Health	max-health-on-level	20.0
Attack Damage	attack_damage	1.0
Armor	armor	0.0
Movement Speed	movement_speed	0.1
Attack Speed	attack_speed	4.0
Luck	luck	0.0
Attack Knockback	attack_knockback	0.0
Scale	scale	1.0
Knockback Resistance	knockback_resistance	0.0

---

💬 Commands

/xp2hp

Main command for interaction.

Subcommands

Command	Description	Permission
/xp2hp info	Plugin metadata	—
/xp2hp reload	Reloads the config	xp2hp.admin
/xp2hp get [player]	View stats for self or another player	—
/xp2hp set <player> <lvl>	Force XP level and recalculate stats	xp2hp.admin.set

---

🔑 Permissions

xp2hp.use:
  description: Enables XP2HP for a player
  default: true

x2h.use:
xh.use:
xph.use:
  description: Aliases
  default: true

xp2hp.admin:
x2h.admin:
  description: Admin access (reload)
  default: op

xp2hp.admin.set:
  description: Allows setting levels manually
  default: op

---

🚀 Installation

1. Drop the plugin JAR into your plugins/ folder.

2. Start your server.

3. Edit config.yml to your liking.

4. Use /xp2hp reload to apply changes.