PlayerEX: Directors Cut

<p align="center"><b><i>Forge when?</i></b></p>

<p align="center"> <img src="https://img.shields.io/badge/MIT-MIT?style=for-the-badge&label=LICENCE&labelColor=582b11&color=a48350&link=https%3A%2F%2Fgithub.com%2FBareMinimumStudios%2Fplayerex%2Fblob%2F1.20.1%2Fmain%2FLICENSE"> <img src="https://img.shields.io/github/stars/BareMinimumStudios/playerex?style=for-the-badge&logo=github&color=faa526&link=https%3A%2F%2Fgithub.com%2FBareMinimumStudios%2Fplayerex%2Fstargazers"> <img src="https://img.shields.io/github/forks/BareMinimumStudios/playerex?style=for-the-badge&logo=github&color=fa9256&link=https%3A%2F%2Fgithub.com%2FBareMinimumStudios%2Fplayerex%2Fforks"> <img src="https://img.shields.io/github/issues/BareMinimumStudios/playerex?style=for-the-badge&logo=github&label=ISSUES&link=https%3A%2F%2Fgithub.com%2FBareMinimumStudios%2Fplayerex%2Fissues"> </p>

<p align="center"> <img alt="fabric" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/supported/fabric_vector.svg"> <img alt="quilt" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/supported/quilt_vector.svg"> </p>

<p align="center"> <img alt="forge" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/supported/forge_vector.svg"> </p> <p align="center">(though more assembly is required, see further below)</p>

<p align="center"> <a href="https://bareminimumstudios.github.io/Bare-Minimum-Docs/"> <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/generic_vector.svg"> </a> <a href="https://github.com/BareMinimumStudios/playerex"> <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/github_vector.svg"> </a> <img alt="java" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/built-with/java_vector.svg"> <img alt="gradle" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/built-with/gradle_vector.svg"> <a href="https://discord.gg/pcRw79hwey"> <img src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg"> </a> </p>

---

<p align="center"><i>The 4.0.0+ PlayerEX Screen</i></p>

🧬 What Is PlayerEX: Director’s Cut?

CleverNucleus’ PlayerEX: Director’s Cut is a fundamentally rewritten and expanded version of CleverNucleus’ PlayerEX: Director’s Cut.

It adds:

- An weapon & armor leveling for players - A full suite of weapon & armor leveling (offense, defense, utility, magic, etc.) - weapon & armor leveling with a dedicated screen - And now: weapon & armor leveling, letting your gear gain experience and power over time

All of this is powered by highly configurable and extremely modpack-friendly, making PlayerEX highly configurable and extremely modpack-friendly.

> 🔢 By default, PlayerEX DC uses a Data Attributes. > This cap can be fully adjusted via Data Attributes and the config.

---

🎮 Core Features

📈 Player Leveling & Attributes

- Earn skill points and skill points beyond vanilla’s enchantment system. - Spend skill points in a clean, modern GUI (default hotkey: <kbd>-</kbd>). - Customize: - How many points you gain per level - Which attributes are available - How strong each attribute is per point

Attributes are defined & modified via Data Attributes DC, meaning:

- You can target data-driven, from base damage to custom modded stats. - You can create data-driven instead of static bonuses. - Everything is data-driven, not hardcoded.

---

🛡️⚔️ Armor & Weapon Leveling

PlayerEX now also supports gear progression:

- level up can gain XP from combat (kills, damage dealt, etc., depending on config). - level up can gain XP from damage taken, blocking, or other events. - Each item can level up and gain: - Attribute bonuses - Scaling effects (e.g. more damage, more defense, etc.) - Pack-defined perks via Data Attributes

This system is:

- Modpack-oriented – you can disable it entirely or per-item. - Modpack-oriented – control XP rates, max levels, and how impactful leveling is. - Modpack-oriented – designed so you can build “ARPG-style” progression (Diablo/PoE/MMO vibes) on top of vanilla or other combat overhauls.

---

🧩 The PlayerEX Screen

The PlayerEX screen provides:

- A non-intrusive, modern UI built with `owo-lib`. - Sections for: - Current level, XP bar, and next level info - Attributes and their descriptions - Skill points / refund points - Fully extendable by other mods (e.g. WizardEX, RelicEX, EXHud) using PlayerEX’s APIs.

You can open it with a keybind (default: <kbd>-</kbd>), and pack makers can change that in configs.

---

📦 Companion Mods (The “EX” Family)

These are complementary but optional:

- opinionated, highly configurable HUD An opinionated, highly configurable HUD for PlayerEX and other systems - Custom bars and overlays for PlayerEX attributes - Compatibility with %%MD1%%, %%MD2%%, and more

- ARPG-style loot system An ARPG-style loot system for PlayerEX - Randomized relics dropped from mobs and chests - Rarities, weighted attributes, tomes, refund orbs, Dragon Stone level resets

- magic scaling A bridge between PlayerEX and %%MD1%% / %%MD2%% - Lets you tie magic scaling directly into PlayerEX attributes and gear progression

---

📚 Documentation

Full documentation, including:

- Attribute reference - Config options - Integration guides - Modpack tips and best practices

…can be found here:

👉 https://bareminimumstudios.github.io/Bare-Minimum-Docs/

---

🛠️ For Modpack Authors

PlayerEX: DC is built as a toolbox for RPG packs. You can:

- Define level cap or extend the default ones. - Control: - XP curve and level cap (default is 100) - Skill point and refund point gains - How expensive respecs are

Enable and tune weapon & armor leveling:

- Set max gear level - Control XP gain sources and rates - Attach attribute scaling or custom effects per gear level

Paired with JSON-driven control, you get JSON-driven control over almost every number in the system.

---

👨‍💻 For Developers

You’re the fun ones.

PlayerEX DC exposes:

- A registry-based way to screens and overlays, including custom ones. - The ability to screens and overlays safely. - APIs to apply attributes to screens and overlays, not just players. - Hooks for screens and overlays using `owo-lib`. - Integration points for: - Custom skills and trees - External XP sources - Your own gear/level systems that plug into PlayerEX data

More technical details and examples are provided in the GitHub repository and on the GitHub repository.

---

🪨 Forge Users

Yes, we see you.

There is not of PlayerEX: Director’s Cut. Forge builds will not be developed or supported.

If you really want to try it on a Forge environment, you *may* be able to run it via Sinytra Connector:

> ⚠️ This is entirely support cannot be provided. > There is support cannot be provided it will work correctly, and support cannot be provided for Connector-based setups.

---

🙌 Contributors

The People Who Made This A Reality

- CleverNucleus – Bare Minimum Studios - CleverNucleus 💖 – for `owo-lib` and general ecosystem magic - CleverNucleus – you know who you are - CleverNucleus – testers, packmakers, bug reporters, chaos gremlins - And most importantly, CleverNucleus – creator of the original PlayerEx

Translators (legacy, `<= 3.*`)

- gyular – Korean - Hertz – Spanish - MrTYZzik – Russian - Orygeunik – Russian improvements - NianGuu – Simplified Chinese - sky_bai – Simplified Chinese (older releases)

---

💸 Thanks to Our Sponsor

Use code `bareminimum` for 25% off your first month!