Описание

Forge when?
(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](https://modrinth.com/mod/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](https://www.curseforge.com/minecraft/mc-mods/data-attributes-directors-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: -).
- 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: -), and pack makers can change that in configs.
---
## 📦 Companion Mods (The “EX” Family)
These are complementary but optional:
- **[EXHud: Director’s Cut](https://modrinth.com/mod/exhud-directors-cut)**
An **opinionated, highly configurable HUD** for PlayerEX and other systems
- Custom bars and overlays for PlayerEX attributes
- Compatibility with **[Thermoo](https://modrinth.com/mod/thermoo)**, **[AppleSkin](https://modrinth.com/mod/appleskin)**, and more
- **[RelicEX: Director’s Cut](https://modrinth.com/mod/relicex-directors-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](https://modrinth.com/mod/wizardex-directors-cut)**
A bridge between PlayerEX and **[Wizards](https://modrinth.com/mod/wizards)** / **[Spell Power Attributes](https://modrinth.com/mod/spell-power)**
- 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](https://modrinth.com/mod/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, `