Stature

!(https://cdn.modrinth.com/data/cached_images/8927d1f019bf90c9cc2b486f90911a6d55b306f1_0.webp)

# 📏 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 ` | Inspects a player's exact metric profile. | `stature.admin` | | `/height set ` | Manually overrides a target's physical scale. | `stature.admin` | | `/height reset ` | 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`