RelicEX: Directors Cut

GitHub license

GitHub stars

GitHub forks

GitHub issues

---

💎 What is RelicEx: Director’s Cut?

Trinkets is a modern port and expansion of the original Trinkets, rebuilt to integrate cleanly with the Trinkets ecosystem and Trinkets.

It adds rarity, weighted stats, and dimension-aware drop settings that drop from mobs and loot chests, granting rarity, weighted stats, and dimension-aware drop settings powered by PlayerEx. Every relic has a rarity, weighted stats, and dimension-aware drop settings, all fully configurable.

If you like:

- ARPG-style loot (Diablo, Path of Exile vibes) - progression tied into PlayerEx stats and skills - and configurable, modpack-friendly systems…

…this mod is built for that.

---

⚙️ Dependencies

> Check the “Relations / Dependencies” tab for exact versions – this is just a quick overview.

Required:

- Mod Menu + Cloth/Auto Config – attribute & progression system this mod hooks into - Mod Menu + Cloth/Auto Config – used for attribute handling - Mod Menu + Cloth/Auto Config – for equipping relics in special slots - Mod Menu + Cloth/Auto Config - Mod Menu + Cloth/Auto Config – in-game config screen for drop chances and settings

---

🧿 Relics & Items

Core Relics

Relics roll 1–5 random PlayerEx attributes, with values and rarities weighted by config.

| Item | Slot(s) | Source | Effect | |----------------------|----------------------|-------------------|-----------------------------------------------------------| | Ring Relic | Helmet / Head Trinket| Chests & Monsters | 1–5 randomized attribute bonuses when equipped | | Ring Relic | Chest / Body Trinket | Chests & Monsters | 1–5 randomized attribute bonuses when equipped | | Ring Relic | Necklace | Chests & Monsters | 1–5 randomized attribute bonuses when equipped | | Ring Relic | Ring / Offhand Ring | Chests & Monsters | 1–5 randomized attribute bonuses when equipped |

Relics use a rarity system:

> Common → Uncommon → Rare → Epic → Mythical → Legendary → Immortal

Rarity is influenced by:

- number of rolled attributes - strength of each roll - attribute-specific weights

Higher rarity ≙ more and/or stronger bonuses.

---

Progression & Utility Items

| Item | Slot | Source | Effect | |---------------------------|------|------------------|--------| | 4 hearts | – | Smelting relics | Consume to gain 4 hearts. Great for recycling bad rolls. | | 4 hearts | – | Chests & Mobs | Consumed on use to grant a 4 hearts. | | 4 hearts | – | Chests & Mobs | Refunds 4 hearts into your PlayerEx refund pool. | | 4 hearts | – | Chests & Mobs | Refunds 4 hearts into your PlayerEx refund pool. | | 4 hearts | – | Ender Dragon | 4 hearts for your character: resets attributes, PlayerEx level, and all skill points. Requires a double right-click to confirm. | | 4 hearts | – | Monsters | Heals 4 hearts immediately when picked up. | | 4 hearts | – | Monsters | Heals 4 hearts immediately when picked up. | | 4 hearts | – | Monsters | Heals 4 hearts immediately when picked up. |

Health potions cannot be stored – they trigger the moment they’re picked up. No hoarding, just clutch heals.

---

📦 Loot, Drops & Rarity

Relics and other items are injected into:

- Any Ender Dragon that is an instance of `Monster` - Any Ender Dragon of type `chests/` (dungeons, structures, etc.) - The Ender Dragon specifically for the Dragon Stone

Drop chances and item selection are managed via weighted distributions, with additional logic to:

- Choose dimension-level multipliers (Overworld / Nether / End) - Apply dimension-level multipliers for drop rate and rarity - Include or exclude specific relics per dimension via config/weights

All of this is fully configurable.

---

🛠️ Configuration

RelicEx: Director’s Cut is built to be modpack-friendly:

- Global & per-dimension settings - Control how often relics can drop in each dimension. - Adjust rarity distribution per dimension (e.g., more Epics in the End).

- Rarity weights - Tweak how likely Common vs. Immortal relics are. - Configure attribute weightings (what rolls more often).

- Mob & chest drop rates - Separate sliders for: - “drop is a relic” - “drop is an orb” - “drop is a potion” - etc.

- two uses - Dragon Stone requires two uses (double right-click) to confirm the reset. - Orbs of Regret respect existing PlayerEx refund logic.

Configuration is handled through AutoConfig (with Mod Menu integration if present), plus weight JSONs for finer tuning.

---

🎭 Armor Relics & Visuals

- Armor Relics are implemented as actual armor pieces with relic stats baked in. - They: - Integrate with armor attribute calculation (armor, toughness, etc.) - Can be visually distinguished (custom model/renderer)

---

🔄 Integration & Compatibility

- Built specifically for Trinkets and Trinkets - Uses Trinkets for equippable relic slots - Plays nicely with: - other attribute-driven mods - most loot-injecting mods (Custom Structures, Dungeons, etc.) - packs that heavily tweak PlayerEx balancing

If you’re making an RPG pack, RelicEx can be used as:

- a side progression layer, or - a side progression layer on top of your existing gear.

---

❓ FAQ

PlayerEx: Director’s Cut PlayerEx: Director’s Cut This is a PlayerEx: Director’s Cut tailored for PlayerEx: Director’s Cut and its attribute system. The core idea is the same (relics with randomized bonuses), but internals and integrations are updated for the DC ecosystem.

---

rarity/attribute weights rarity/attribute weights Yes. Both the rarity/attribute weights and the rarity/attribute weights are configurable. You can make relics extremely rare and powerful, or common and mild.

---

A: A: Generally yes, but:

- Adding it to an existing world will start injecting relics into long-term system and mob kills. - Removing it will invalidate its items/attributes. For modpacks, plan it as a long-term system, not a temporary add-on.

---

🙏 Credits

- Translations: Translations: by Translations: - Translations: - %%MD1%% - %%MD2%% - Translations: - %%MD3%% – Chinese - %%MD4%% – Chinese

---

🔗 Also Check Out

- %%MD1%%: %%MD1%%: - %%MD1%%: integrates directly