PlayerEX: Directors Cut

Forge when?

<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">

(though more assembly is required, see further below)

---

The 4.0.0+ PlayerEX Screen

🧬 What Is PlayerEX: Director’s Cut?

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

It adds:

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

All of this is powered by Data Attributes: Director’s Cut, making PlayerEX highly configurable and extremely modpack-friendly.

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

---

🎮 Core Features

📈 Player Leveling & Attributes

• Earn experience and levels 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 any attribute, from base damage to custom modded stats.
• You can create complex formulas instead of static bonuses.
• Everything is data-driven, not hardcoded.

---

🛡️⚔️ Armor & Weapon Leveling

PlayerEX now also supports gear progression:

• Weapons can gain XP from combat (kills, damage dealt, etc., depending on config).
• Armor 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:

• Optional – you can disable it entirely or per-item.
• Configurable – 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:

• EXHud: Director’s Cut

An opinionated, highly configurable HUD for PlayerEX and other systems

• Custom bars and overlays for PlayerEX attributes
• Compatibility with Thermoo, AppleSkin, and more

• RelicEX: Director’s Cut

An ARPG-style loot system for PlayerEX

• Randomized relics dropped from mobs and chests
• Rarities, weighted attributes, tomes, refund orbs, Dragon Stone level resets