!BANNER

📏 Stature — Dynamic Player Scaling Engine

Welcome to Stature, the ultimate premium scaling solution built strictly for modern Paper & Purpur 1.21+ servers.

Whether you want a purely cosmetic roleplay experience or a hardcore survival environment where your real-world physical metrics dictate your in-game attributes, Stature delivers unmatched performance with zero lag.

---

✨ Core Features

• 🚪 First-Join Interception: New players are instantly frozen upon connection until they complete their physical calibration profile.
• ⚡ Native 1.21 Attribute Scaling: No laggy packets, custom entities, or unsafe NMS hacks. Stature utilizes Minecraft's official attribute systems to dynamically scale player models, hitboxes, eye-levels, and name tags flawlessly.
• 🖥️ Immersive Setup Interfaces: Server owners can toggle between a sleek, interactive Inventory GUI with adjustment clickers or an elegant chat prompt.
• ✨ MiniMessage Native: Every title, subtitle, action bar, and chat message fully supports RGB gradients, hex codes, and text effects out of the box.
• 💾 HikariCP Data Management: Includes asynchronous database drivers supporting both local SQLite pipelines and high-performance MySQL networks.

---

🛠️ Configurable Gameplay Impact

Every single physical attribute can be purely aesthetic, or scale dynamically with the player's height using your own custom multipliers, floors, and ceilings:

• 🏃 Walking & Sneaking Speed: Taller players can span land faster, while shorter players move more discreetly.
• 💥 Interaction & Attack Range: Longer arms mean further block-breaking and entity-interaction distances.
• ❤️ Dynamic Vitality: Scale maximum health values organically based on body metrics.
• 🪜 Step Heights: Taller entities walk right over standard slabs or full blocks without jumping.

---

💻 Commands & Permissions

Command	Description	Permission
/height	Opens the graphical tuning interface.	stature.use
/height top	Displays the server's tallest player leaderboard.	stature.use
/height info <player>	Inspects a player's exact metric profile.	stature.admin
/height set <player> <cm>	Manually overrides a target's physical scale.	stature.admin
/height reset <player>	Clears database history and resets target to default.	stature.admin
/height reload	Instantly flushes and reloads configuration files.	stature.reload

💡 Admin Bypass: Users granted the stature.bypasslimits node can bypass configured minimum and maximum boundaries.

---

🔌 Integration & Developer API

🧩 PlaceholderAPI Support

Display tracking stats directly inside Tab, Scoreboards, or Chat plugins with built-in placeholders:

• %stature_height% — Returns raw height value in centimeters (e.g., 182.5).
• %stature_scale% — Displays calculated modifier scale factor (e.g., 1.01x).
• %stature_rank% — Outputs contextual weight terms (e.g., Titan, Standard, Dwarf).

💻 Developer Events

Extend the framework via a simple static API or hook into our custom cancellable event pipeline:

• PlayerHeightChangeEvent
• PlayerFirstHeightSetEvent