MultiHooker

MultiHooker 3.10.5 - BIG UPDATE!
================================
Minecraft 1.21.1  |  NeoForge

This was meant to be a small update. It ended up taking me three days.
Covers everything since 3.10.0.

SUMMARY
-------
The crate system is finished: 12 crates (8 normal + 4 special), a new MYTHIC
tier, animated lids, empty crates, data-driven loot and cross-mod loot. Fish a
crate up, place it, then right-click it with an AquaKey to open it. A new
in-game Crate Loot browser and a JEI page show exactly what every crate can
drop, plus its cross-mod bonus roll, and every crate now has its own advancement
in a new advancement tab. There is also a built-in config screen,

ADDED - THE CRATE SYSTEM
------------------------
- 12 crates in two categories. Every one is a PLACEABLE block, modelled in
  Blender and textured with our own art, and encrusted with sea growth
  (barnacles, shells, coral) so each crate looks fished up out of the water.
    - Normal crates (8), weakest to strongest: COMMON, UNCOMMON, RARE, EPIC,
      LEGENDARY, GODLY, MYTHIC (new, directly above GODLY) and SECRET.
    - Special crates (4): DIVINE, ULTRA DIVINE, UNSPOKEN and GHOSTUNSPOKEN.
      They outrank the whole normal group and are the hardest of all to fish up.

- Each crate's tier name is ENGRAVED into the wood and kept clear of the sea
  growth so it always stays readable. From SECRET up, the crates glisten with
  the ENCHANTED SHIMMER in your inventory.

- You catch crates while FISHING, right next to the rest of the loot. Place one
  like a normal block, then RIGHT-CLICK it while holding an AQUAKEY to unlock
  it: the loot rolls straight into your inventory (anything that does not fit
  drops at your feet), it pops a sparkle + a chest sound, and the crate is
  consumed. The AquaKey is consumed too - except in creative mode, where it is
  kept. An AquaKey held in the OFF-HAND opens the crate as well.

- ANIMATED LIDS: a crate opens like a chest - the lid swings up while you look
  at the loot, and it drops back down when you close it.

- EMPTY CRATES: opening a crate leaves a placeable empty shell behind. It is
  loot only - it never appears in the creative tab.

- A crate drops itself when broken, and the whole set sits in the MultiHooker
  creative tab: the eight normal crates first, then the four specials.

- Loot is DATA-DRIVEN (data/multihooker/loot_table/crates/<tier>.json) and
  ESCALATES with the tier - every tier is strictly better than the one below.

- CROSS-MOD LOOT: on top of its own loot, every crate also rolls one extra item
  from the common materials (gems, ingots, nuggets, dusts, raw materials, ores,
  storage blocks, cooked meat), so items added by OTHER mods can drop too. GODLY
  and above can also draw from the heavier set.

- AQUACULTURE 2 SUPPORT: Neptune's Bounty now appears ONLY in the SPECIAL
  crates (Divine, Ultra Divine, Unspoken and GhostUnspoken).

- Crate catch chance is configurable per tier.

ADDED - CRATE LOOT BROWSER (QOL)
--------------------------------
- NEW: the Fishing Panel (default key P) has a "Crate Loot" button that opens an
  in-game browser for the whole crate system. All 12 crates are listed down the
  left; pick one and the right side shows exactly what it can drop - each item's
  icon, its amount range and its odds - plus how many rolls that crate gets and
  its current catch chance.

- The cross-mod bonus roll now shows as its own section, and the list scrolls
  with the mouse wheel.

- The list is generated from the SAME table as the real crate loot, so it can
  never fall out of date.

ADDED - JEI: PRESS R ON A CRATE
-------------------------------
- If you have JEI, pressing R on any crate - exactly like looking a recipe up -
  opens a "Crate Loot" page for that crate: the crate (and the AquaKey it costs)
  on the left, and everything it can give on the right.

- Hover a loot slot to see how much you get and its chance per roll; hover the
  crate to see its catch chance while fishing and how many rolls it gets.

- Handy side effect: pressing U on an AquaKey lists every crate's page, since
  the key is what opens them all.

- The cross-mod BONUS ROLL is shown as its own grid under a "Bonus roll"
  heading, exactly like the in-game screen, so AquaCulture's Neptune's Bounty
  and other mods' items appear here too.

- It is built from the SAME generated loot file as the in-game Crate Loot
  screen, so the two can never disagree.

ADDED - IN-GAME CONFIG SCREEN
-----------------------------
- NEW: MultiHooker now has its own config screen inside the game (Options >
  Mods > MultiHooker > Config), so the crate catch chances, the AquaKey drop
  rate, the points per upgrade and every other setting can be changed without
  hand-editing the config file.

- The SeaMaster Relic's own drop chance is deliberately NOT shown there - the
  relic is the one thing that is not meant to be tuned.

- The RENDERING and DIAGNOSTICS sections are not shown there either. They are
  advanced, one-off tuning (the debug logger and the fishing-line anchors), so
  they stay in the config file only and are edited by hand. Everything a normal
  player touches lives in the Fishing section, which is fully editable in-game.

ADDED - CRATE ADVANCEMENTS
--------------------------
- NEW: the Advancements screen now has its own "MultiHooker" tab (with an
  AquaKey icon), so every advancement of this mod sits together in one place
  instead of being mixed in with the vanilla ones.

- Every crate has its own ADVANCEMENT - 12 in all - branching off that tab.
  Each one unlocks the moment you FISH that crate up, never by picking one up,
  placing and breaking it, or being handed one with /give. Each unlocks with the
  usual toast and is announced in chat.
    - The 8 normal crates chain upwards, each named after the tier below it:
      Common?? (Common) > Better than common! (Uncommon) > Better than
      uncommon! (Rare) > Better than rare! (Epic) > Better than epic!
      (Legendary) > Better than legendary! (Godly) > Better than godly!
      (Mythic) > Better than mythic! (Secret).
    - The 4 special crates continue the chain: Welcome to the Specials
      (Divine) > Better than divine! (Ultra Divine) > Better than ultra
      divine! (Unspoken) > Better than unspoken! (GhostUnspoken).
    - The "Is that??? SPECIAL???" challenge completes once ALL FOUR special
      crates have been fished up (Divine + Ultra Divine + Unspoken +
      GhostUnspoken), as a challenge frame.

BALANCE - CRATE CATCH RATES
---------------------------
These are the real, final values (per fishing catch); the old test numbers made
every crate far too easy:
  COMMON 6%           | UNCOMMON 3.5%       | RARE 1.8%
  EPIC 0.9%           | LEGENDARY 0.45%     | GODLY 0.22%
  MYTHIC 0.14%        | SECRET 0.09%        | DIVINE 0.045%
  ULTRA DIVINE 0.022% | UNSPOKEN 0.009%     | GHOSTUNSPOKEN 0.005%
Loot power climbs with every step:
  Common < Uncommon < Rare < Epic < Legendary < Godly < Mythic < Secret <
  Divine < Ultra Divine < Unspoken < GhostUnspoken.

BUFFS
-----
- AQUAKEY drop chance raised to 0.08 (8%) per catch, from 7.2%.

- AXES break crates faster.

NERFS
-----
- SeaMaster Relic catch chance reduced from 4% to 3.5% per fishing catch.
  The relic is still ONLY obtainable by fishing (there is no recipe).

- The Net ability is now CAPPED at 45% throw chance (previously it could climb
  all the way to 100%). This stops it proccing so often. Once the cap is
  reached, the ability is fully mastered and can no longer be levelled up - the
  Relic menu shows "MAX" / "Fully mastered". With the default scaling (10% base
  + 5% per level) it caps at level 7 (45%). Config option: netMaxChance
  (default 0.45).

- MORE BOBBERS is capped at 12 bobbers total (11 upgrades); it no longer scales
  forever.

- Bobber upgrades now cost 30 points per level (was 25).

REMOVED
-------
- Legacy keys are deleted: any leftover Fisherman's Keys (or legacy AquaKeys
  from the previous points work) in any world are removed on first login for
  that player - a one-time migration. They are NOT converted to points.

- The old test drop rates are gone, replaced by the real values in BALANCE.

- Instruction books: guidebooks and manuals (for example Adorable Hamster Pets'
  "Hamster Tips") can no longer come from a crate. They are filtered out of the
  cross-mod bonus roll, the Crate Loot screen and the JEI page, so a crate never
  gives one.

- We removed a stale config comment that wrongly claimed the SeaMaster Relic
  could be crafted.

FIXES & IMPROVEMENTS
--------------------
- The SeaMaster Relic is now NON-STACKABLE.

- The version is now reported correctly in the mods list.

- FISHING LINES: every line now anchors at your ROD TIP instead of the vanilla
  mid-rod hand point. (The rod-tip anchor had been dropped from the mod, so all
  lines started at the wrong place and the lineAnchorX / lineAnchorY settings
  did nothing. It is now restored.)

- PUNCHY COMPATIBILITY: first-person animation mods such as Punchy replace the
  vanilla hand position by cancelling getPlayerHandPos outright, which used to
  completely bypass the rod-tip anchor on vanilla rods (so lineAnchorX/Y
  appeared dead while Aquaculture rods still responded). The anchor is now
  applied at the renderer level: it keeps whatever hand position the renderer
  produced (vanilla OR Punchy's animated gripping hand) and shifts it toward the
  rod tip. With Punchy installed, the line stays attached to its animated rod;
  without it, the result is identical to before.

- Vanilla rods and Aquaculture rods now have SEPARATE line anchors, because the
  two rod models are held in different spots and one value cannot fit both:
    - vanilla rods:   lineAnchorX / lineAnchorY
    - Aquaculture:    aquaLineAnchorX / aquaLineAnchorY
  Defaults are calibrated to each rod's tip; tune in small steps (0.02) if your
  setup (FOV, resource packs, other animation mods) differs. These four values
  live in the config file (the Rendering section, which is not exposed in the
  in-game config screen).

- Fixed a startup CRASH for players who do NOT have the Aquaculture mod
  installed: the compatibility mixins moved to a separate OPTIONAL config, and
  Aquaculture is now an optional dependency. With Aquaculture installed,
  behaviour is unchanged.

- AquaKey rename: Fisherman's Keys are now called AQUAKEY throughout the mod.
  The renaming is a cosmetic/name change; keys still work as before.

- AquaKeys and the SeaMaster Relic now go STRAIGHT INTO YOUR INVENTORY when you
  fish them up, instead of being thrown on the ground for you to pick up.
  (Previously the catch was spawned at the bobber and had to fly to you, which
  is why it only sometimes ended up in your inventory.) Anything that does not
  fit is still dropped at your feet. Toggle: instantCatchPickup (default true);
  set it false for the old thrown-to-you behaviour.

- AquaKeys held in the OFFHAND are now counted by the Fishing Panel and can be
  spent on upgrades (previously only keys in the main inventory worked).

- The JEI info page for the SeaMaster Relic now reads the drop chance from the
  config instead of a hardcoded value, so it always shows the correct number.

NOTES
-----
- Requires NeoForge for Minecraft 1.21.1.

- Optional (Curios): wear the SeaMaster Relic in the necklace slot to activate
  its "The Net" ability. Without Curios it works from the inventory.

- Optional (Aquaculture): extra hooks are also cast on Aquaculture fishing rods.

- Compatible with first-person animation mods such as Punchy: the rod-tip line
  anchor still applies and follows their animated hand.

- Player skill level and relic level are saved per player and kept on update.

- netMaxChance appears in your config file the next time the game loads.

- instantCatchPickup appears in your config file the next time the game loads.