Deep's Lucky Block

# Deep’s Lucky Block V2.0 — Devlog

V2.0 is the biggest Deep’s Lucky Block update yet, featuring a completely expanded outcome system, new roulette mechanics, improved item generation, and full compatibility with the Lucky World Invasion ecosystem.

## New Bad Outcome Roulette

Bad outcomes now use a complete 37-pocket European roulette:

- **GREEN: 5%** — 1 in 20
- **RED: 47.5%**
- **BLACK: 47.5%**

The animation completes a full wheel rotation, displays the green zero, and always stops on the color matching the selected outcome.

The original positive roulette remains unchanged, including its yellow numbers, red/green pixels, real final Luck value, sounds, and particles.

## 86 Different Events

Deep’s Lucky Block now contains **86 possible events** distributed between GREEN, RED, and BLACK categories.

These include:

- invasions and ambushes;
- bosses and special creatures;
- environmental hazards;
- terrain transformations;
- structures and arenas;
- Nether, End, and void-related events;
- companion events;
- many new surprises inspired by Lucky World Invasion.

## Cat Invasion Rework

The Cat Invasion event has been completely redesigned:

- spawns between 1 and 5 companions;
- every companion is unique within the group;
- includes the 11 original cats, Nevada, and Ymir;
- Dewey has a 10% chance to occupy one of the available slots;
- Dewey can heal his owner while nearby;
- Dewey also has his own separate GREEN event.

Cat Invasion now has a **17% chance inside the GREEN event pool**.

## Improved Item Generation

The main item selection is evenly distributed between 13 item types:

- helmet;
- chestplate;
- leggings;
- boots;
- sword;
- pickaxe;
- axe;
- shovel;
- hoe;
- bow;
- crossbow;
- trident;
- shield.

Each primary item type has exactly a **1 in 13 chance**, or approximately **7.69%**.

### ETERNAL Fix

A true ETERNAL item now guarantees:

- one real level 100 enchantment;
- 1 to 4 additional enchantments between levels 1 and 5;
- no curses.

Previously, the supposed level 100 enchantment could be reduced to level 1, level 15, or the enchantment’s normal maximum level.

### Protection Progression

Only `minecraft:protection` uses the special grade-based progression:

- COMMON: I–II
- UNCOMMON: I–III
- RARE: II–IV
- EPIC: II–V
- LEGENDARY: III–VI
- MYTHIC: III–VII
- RELIC: III–VIII
- MASTERWORK: VI–X
- ETERNAL: 100

All other enchantments retain their original systems.

### Healer’s Sword

The Healer’s Sword is now strictly focused on healing:

- Blood Transfusion and Mending are preserved;
- damage enchantments can never remain on the sword;
- a final safety filter removes offensive enchantments even if an external configuration incorrectly categorizes them as utility enchantments.

### Exclusive Special Rewards

- **Apple Stash** now gives only the apple chest, with no additional item, potion, or fallback reward.
- The **dog companion event** now gives only the dogs, with no additional item or Healer’s Sword.
- The missing hoe case in Broken Cursed Item generation has been fixed.

## Full Lucky Tools Compatibility

Deep’s Lucky Block now supports the official Lucky Tools equipment while keeping every integration optional.

### Lucky Wand

- recognizes Deep’s Lucky Block as Luck-aware;
- reads and stores the official `Luck` NBT value;
- preserves Luck when the block is moved or harvested.

### Lucky Ring

- applies the Ring’s Luck contribution;
- correctly increases the Ring’s break counter;
- includes a fallback if the official handler does not recognize the block.

### Lucky Belt

- rerolls the complete outcome if the first result is below LEGENDARY;
- keeps the first result when it is already LEGENDARY or better.

### Lucky Idol

- a boost forces Deep’s best possible result;
- a curse forces a real negative outcome;
- curse debt is correctly confirmed to Lucky Tools;
- forced outcomes remain excluded from Average Luck, matching the official Lucky Stats rules.

### Lucky Hammer

- Deep Lucky Blocks can be sacrificed to charge the Hammer;
- sacrifices produce no normal reward;
- charge progression and official messages are preserved.

### Lucky Radar

When a Radar configured for Deep’s Lucky Block is held in either hand:

- the Deep Lucky Block drop chance increases from **10% to 20%**;
- a client-side indicator immediately displays the active bonus;
- the indicator disappears as soon as the Radar is no longer held.

## Native Lucky Stats Integration

Deep’s Lucky Block now updates the native Lucky Stats values:

- **Average Luck**
- **Average Luck All-Time**

The score always stays between 0 and 100:

- BLACK outcomes: 0–24
- RED outcomes: 25–49
- GREEN outcomes: 50
- positive outcomes: 50–100 based on the real Luck value

Examples:

- Luck 0 → 50
- Luck 50 → 75
- Luck 90 → 95
- Luck 100 → 100

Immediate synchronization was added so the HUD updates as soon as a valid sample is recorded.

Creative breaks and deterministic Lucky Idol results remain excluded.

## Lucky XP Event Integration

Deep’s Lucky Block can now participate in the official Lucky XP event roulette:

- included in the server-side result pool;
- included in the client-side roulette;
- included in JACKPOT block showers;
- receives the event’s Luck value through its Block Entity;
- uses its actual item icon inside the roulette.

An early Mixin connector ensures the compatibility is loaded before Lucky XP’s client interface.

## Enchantment Description Compatibility

When **Enchantment Descriptions** (`enchdesc`) is installed:

- it becomes the primary description and “Hold Shift” provider;
- duplicated descriptions are automatically removed;
- the fix applies to Minecraft, Deep, and third-party enchantments;
- the official dark-gray Enchantment Descriptions line is prioritized.

Without `enchdesc`, Deep’s normal tooltip behavior remains unchanged.

## Stability and Bug Fixes

V2.0 also includes:

- safer potion-effect handling;
- preservation and restoration of pre-existing effects;
- Falling Block and UUID fixes;
- Lucky Snow Golem and mob-spawning fixes;
- improved cat taming and teleportation;
- cumulative and visible Dewey healing;
- Poisoned Gift fixes;
- Sand Hourglass structure and NBT fixes;
- deprecated `ResourceLocation` cleanup;
- runtime English and French translations;
- external compatibility injection that preserves the original MCreator block code.