logo

Forge when?

fabric quilt

forge

(though more assembly is required, see further below)

java gradle

PlayerEX Screen at Level 5

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
WizardEX: Director’s Cut
A bridge between PlayerEX and Wizards / Spell Power Attributes
- 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 your own attribute set 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 Data Attributes DC, 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 define and modify attributes, including custom ones.
The ability to override any registered attribute safely.
APIs to apply attributes to any LivingEntity, 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 docs and on the GitHub repository.

🪨 Forge Users

Yes, we see you.

There is no planned official Forge port 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 at your own risk.
There is no guarantee it will work correctly, and support cannot be provided for Connector-based setups.

🙌 Contributors

The People Who Made This A Reality

The studio – Bare Minimum Studios
The wispforest team 💖 – for owo-lib and general ecosystem magic
One guy’s modpack – you know who you are
Literally YOU – 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

Sponsor Banner

PlayerEx: Directors Cut