EUCALIPTUS Advanced Randomizer

DISCLAMER*  This mod was inspired by the other drop randomizer mods. but revamped for better control and FRESH TABLES!!!!  

Features

• **Seed-derived shuffle**: no two seeds shuffle the same way, and the same seed always reshuffles identically, every time.
  - **Two modes**:
    - **CHAOS** (default) — every loot table shares one pool. A dirt block might drop a Woodland Mansion chest.
  
    - **BUCKETED** — shuffling stays within categories (blocks→blocks, mobs→mobs, chests→chests, etc.) for a more playable experience.
  
  
  - **Cross-bucket loot** toggle — let chests, blocks, and mobs share one pool without going full CHAOS.
  
  - **Food source control** — force all food to come from mobs only, blocks only, or let it shuffle freely.
  
  - **Wood randomization** toggle — logs and leaves are excluded by default (so a run always has a path to basic tools), but can be turned on.
  
  - **In-game Loot Tracker book** — a creative-menu-styled screen (accessible from a blue tab button in your inventory) that tracks every block, mob, and chest you've personally discovered:
  
    - Laid out and categorized using the game's own real creative-menu tab data (Building, Natural, Functional, Redstone, Colored, plus Mobs and Chests).
  
    - Grid slots stay grey until *you* personally trigger them — nothing about the shuffle is ever spoiled ahead of time.
  
    - A gold border marks anything whose full loop you've completely discovered.
  
    - A dedicated **Progress** tab lists your discoveries in the order you found them.
  
    - Click any discovered slot to open its full multi-step chain (A → B → C → …), as far as you've personally uncovered it.
  
    - Fully multiplayer-aware — every player tracks their own discoveries independently, synced from the server.
  
  - **Op commands** for admin control (`/lootrandomizer status`, `mode`, `wood`, `crossbucket`, `food`, `reshuffle [salt]`, `reset`, `lookup`, `reverse`, `dump`, `reloadconfig`).
  
  - Config file (`config/loot_randomizer.json`) exposes per-category shuffle toggles, custom table exclusions, starting mode/salt, and mapping-log output.

## Requirements

- Minecraft **1.21.1**
- **Fabric Loader** 0.16.0+
- **Fabric API** (required dependency)
- **Java 21**
- Works in both singleplayer and dedicated servers — no client-side install needed for players to join a server running this mod.

## Known limitations

- No progression/reachability logic yet. In CHAOS mode especially, a seed can occasionally produce an unwinnable early game (e.g. nothing reachable drops wood or iron). BUCKETED mode is safer but not guaranteed either. Worth testing a seed before committing a full playthrough to it.
- Default exclusions cover logs/leaves (toggleable) and copper (permanent, config-editable) to reduce dead ends and shuffle clutter.

## Commands

All require operator permission (level 2):

- `/lootrandomizer status` — current seed, mode, and toggle state
- `/lootrandomizer mode bucketed|chaos`
- `/lootrandomizer wood on|off`
- `/lootrandomizer crossbucket on|off`
- `/lootrandomizer food off|mobs|blocks|random`
- `/lootrandomizer reshuffle [salt]` — reshuffle in place, optionally with a specific salt for reproducibility
- `/lootrandomizer reset` — restore the seed-derived mapping
- `/lootrandomizer lookup <table>` / `reverse <table>` — check what a table maps to/from
- `/lootrandomizer dump` — write the full mapping to a text file
- `/lootrandomizer reloadconfig`