生存工具箱SurvivalToolbox

# Survival Toolbox 1.2.0 Changelog

- **1.20.1** (Forge 47.x, Java 17): `survival-toolbox-forge1.20.1-1.2.0.jar`

- **1.21.1** (NeoForge 21.1.x, Java 21): `survival-toolbox-neoforge1.21.1-1.2.0.jar`

> Both versions offer the same gameplay. A few features differ slightly between loaders (noted inline).

---

## 1. New Features

### 1. Pocket Dimension panels (Smelting / Anvil / Smithing / Crafting / Disassembly / Stonecutter / Magnet / Restock)

Panels opened from the button strip on the right side of the bag UI — **everything happens inside the main screen**, no need to leave the bag.

**Features and usage:**

- **Smelting panel**: input + fuel + output slots with vanilla furnace rules; toggle where the output goes (output slot / straight into storage); **keeps smelting while the screen is closed**

- **Anvil panel**: input, material and result laid out like vanilla, with cost and result computed by the vanilla implementation; includes a rename box that fills in the item's name automatically

- **Smithing panel**: template / base / addition slots, with vanilla-style empty-slot hints and hover guidance

- **Crafting panel**: 3×3 grid + result, sharing the disassembly table's recipe matching and cost rules; includes an **Auto-refill** toggle that puts the consumed ingredients back into the grid from storage (only items the bag actually has)

- **Disassembly panel**: input on the left, material grid in the middle, result on the right; variant paging and "Disassemble all"

- **Stonecutter panel**: input + result + a scrollable list of available recipes, consuming one input per craft

- **Magnet panel**: automatically collects nearby dropped items (toggle / range / allow-block list / "only what is already stored")

- **Restock panel**: tops up the stacks you already carry from the bag (optionally hotbar only)

### 2. Storage and interaction

**Features and usage:**

- **Fluid storage**: fluids live in the **same page and the same grid** as items, counted in mB with no cap

  - Left-click: pick up / swap with another slot

  - Right-click: fill or pour with a bucket or any fluid container

  - Numbers match Create: below 1000 shows mB, from 1000 up converts to buckets (B)

- **Shared storage mode**: ender-chest style — data lives in the server save, per player; the bag is just the entry point. Switchable from the top-left of the UI, and local storage can be merged into the shared vault in one click (**merge, never overwrite**)

- **Tray (dispatch bench)**: send items/fluids to a container or take them back; with a single fluid in the tray, Shift + right-click places one cell into the world

- **Quick deposit**: right-click an item with the bag in hand; right-click the bag with an item in hand; right-click the inventory background to store the whole backpack (hotbar excluded). **Also works in the creative inventory screen**

- **Consistent Shift behaviour**: Shift + left-click **prioritises the currently open panel** (tray included) and only falls back to the inventory when the panel cannot take the item; on a result slot it takes the craft in bulk

- **Hold to pick up a whole slot**: hold a slot until it highlights, then click another slot to swap whole stacks (handy for very large stacks)

- **Four sort modes**: registry name / grouped by mod / count / tag; scope is either the current page or all pages

- **Count text**: exact up to 9999, abbreviated beyond that (千 / 万 / 亿 / 万亿 / 亿亿)

- **Creative Pocket** (new item): right-click to open the creative inventory, and **items can actually be taken in survival** (cheat-level item)

### 3. Trade Machine

A new item (phone-shaped) that records villager offers so you can trade from anywhere.

**Features and usage:**

- Shift + right-click a villager / wandering trader to record their offers (for each trade only the better deal is kept)

- Right-click to open: the vanilla villager trade UI, **unlimited uses**, and a search bar to filter offers by product

- Useful for storing the offers of villagers you buy from often

### 4. JEI recipe transfer (requires JEI)

The "+" button in the recipe screen can fill the bag's panels directly.

**Features and usage:**

- **Matches the panel you have open**: the crafting panel fills the crafting grid, the disassembly panel fills the disassembly grid; with neither open, it asks you to open one instead of guessing

- **Shaped recipes keep their layout**: strictly placed by the recipe's bounding box (a 2-wide × 3-tall door is never placed as a 3 × 2 trapdoor)

- **"+" is disabled when materials are insufficient**: availability is answered server-side from the real inventory, including shared storage the client cannot see

- **Materials are really taken from the bag/inventory**: taken and verified first, then placed, with rollback if placement fails — nothing is ever spawned

---

## 2. Updates & Fixes to Existing Features

### Pocket Dimension

- **Fix: anvil rename** — fixed both "the item name is not shown when placed" and "the renamed result cannot be taken out" (the screen used to clear the rename box on click, sending an empty name to the server first)

- **Fix: quick deposit** — the source slot is only cleared after the write is verified, so items can no longer vanish if the write fails

- **Fix: panel buttons disappearing** — the auto-refill / page buttons no longer vanish after returning from JEI or after the screen is re-initialised

- **Fix: crafting "all or nothing"** — validation and consumption now use the same ingredient list, removing dry consumption and infinite output

- **Fix: disassembly panel Shift + left-click** — puts exactly **one** item into the disassembly input slot instead of "one in the grid, one in the inventory, one gone"

- **Fix: tray Shift + left-click** — now returns the stack to storage first instead of pushing it into the player's inventory

- **Fix: magnet messages** — only reports what was collected; no more repeated hints when nothing was collected

- **Fix: death handling** — no longer interferes with the inventory when keepInventory is on

- **Fix: search / rename text boxes** — typing no longer lets the key through (pressing E no longer closes the screen)

### Data safety (important)

- **Fix: bag NBT writes no longer modify the tag in place** — they used to race with the server's per-tick packet encoder on the same tag, causing encode failures and **player disconnects**

- **Fix: storage writes never bypass the open screen's cache** — the tray "take in" and magnet paths can no longer be overwritten by stale cached data

- **Fix: every deposit is verified** — when the write did not actually land, the items stay where they were (never consumed, never dropped)

- **Fix: 1.20.1 local-mode data loss** — page data was written with the wrong tag type, so items stored in local mode disappeared after reopening the bag; fixed, and existing affected data is **recovered** by a compatible reader

### Disassembly Table

- **Fix: recipe pollution** — outputs are always copied before being handed out, so other mods' recipes are never modified (this previously broke e.g. Create recipe entries)

- **Fix: crafting with the centre/activation item missing** — preview and consumption now use the same complete ingredient list

- **Improvement: centre/activation items** — returned as before, and individually collectable from the grid

- **New: custom recipes** — smithing, tacz gunsmith, Avaritia and Goety style recipes that can enumerate materials are now supported

- **Fix: stonecutter slot misalignment** — slot registration order and id constants are now consistent

- **Fix: page retention** — recomputation keeps the current recipe page instead of jumping back to the first

- **Robustness**: recipe parsing and screen handling catch failures per recipe instead of crashing

### Adaptation enchantment

- **Improvement: linear stacking** — a fixed "damage × ratio" number of layers based on pre-mitigation damage; the current hit is mitigated using the layers from before the gain

- **Fix: layer sanitising** — clamped to the configured maximum, with NaN / infinity / negative values reset to zero

- **New: screen-effect suppression** — config option (enabled by default) that suppresses blindness / fire / water fog / freezing / portal screen effects

- **Improvement: low-hydration screen blur** — no longer cancelled outright when wearing adapted armour; it now **fades gradually as adaptation progresses** and disappears once fully adapted

- **Performance**: shield value caching, sync throttling, negative caching for armour checks

### Others

- **Bloodthirsty**: can be applied to bows, crossbows and modded firearms; projectile ownership resolution for damage sources

- **X-Ray Goggles**: whitelist is now **per pair of goggles** (stored in item NBT); no extra background blur on the screen

- **Disarm Staff**: now also strips curios

- **Guardian Lantern / Anvil Orb**: missing loot tables no longer throw and crash the server

- **Commands**: new `max` subcommands for `/adapt` and `/bloodthirsty`

- **Dedicated servers**: main and common classes no longer reference client types, so dedicated servers start correctly

- **1.21.1 compatibility**: fixed a startup crash caused by the item-count mixin's injection point

---

## Installing and upgrading

1. Put the matching jar into your modpack's `mods` folder.

2. **Back up your world before upgrading** (several data-safety fixes are included, but a backup is still recommended).

3. Bags created by older versions keep working: legacy single-page data migrates automatically, and data previously lost in 1.20.1 local mode is recovered when the bag is opened.

**Note**: both versions gained new network packets, so the **client and server versions must match** (update both when playing on a server).