Description
# Adoner's Tweaks
Adoner's Tweaks is a collection of configurable QoL features for NeoForge and Fabric.
Project pages:
- CurseForge: https://www.curseforge.com/minecraft/mc-mods/adoners-tweaks
- Modrinth: https://modrinth.com/mod/adoners-tweaks
### Quick start
- Put one or more **vanilla chests** (or **trapped chests**) near you.
- Use the **Auto Sorter** to sort your inventory into nearby Category Chests.
- **Category Chest is not craftable**: when the mod needs a new Category Chest, the Auto Sorter can **convert an *empty* vanilla chest** automatically.
- For safety, chests that already contain items are **never** converted.
### Main features
- **Category Chest + Auto Sorter**
- Sorts your inventory into nearby chests by **category id / display name**.
- Supports custom categories and special rules (item/tag → category), plus creative-tab priority (config-driven).
- Sneak + use while looking at a chest: sorts that chest’s contents.
- Client QoL: category chest icons (configurable overrides) + hover shows the category name.
- **Inventory Item Lock**
- In inventory screens, hover a player inventory slot and use the lock key to lock/unlock an ItemStack.
- The lock key is rebindable in Minecraft's Controls menu.
- Locked ItemStacks show a small lock overlay in GUI slots.
- Locked ItemStacks are excluded from Auto Sorter distribution.
- Locked ItemStacks cannot be dropped through normal inventory drop actions.
- **Advanced Crafting Table**
- A standalone feature, separate from the Category Chest system.
- Can pull / auto-refill / return items from nearby chests, trapped chests, and Category Chests.
- Shift-click bulk crafting can continue using nearby storage.
- **Advanced Enchanting Table**
- A standalone feature, separate from the vanilla enchanting table.
- Can use lapis lazuli from nearby chests.
- Adds a reroll UI where you choose target enchantments and an emerald cost per reroll.
- Repeats rerolls until a selected enchantment appears or resources run out.
- **Stack Size Override (configurable)**
- Raise the maximum stack size for **stackable items** (vanilla max stack > 1), up to **2147483647** (default: 5120).
- Note: values above **1000000** are not recommended (may cause performance/compat issues).
- Includes compact large-number formatting (e.g. 1000 → 1K, 1000000 → 1M).
- **Auto Fishing Rod**
- Auto reels in on bite, stores loot into nearby chests and chest boats.
- Right-click toggles auto recast ON/OFF. While ON, it automatically casts again right after auto reeling in.
- Can include FishPlus extra drops as chest-insert candidates.
- Anvil support: merge enchants from a vanilla fishing rod onto the Auto Fishing Rod.
- **FishPlus Extras (configurable)**
- Add extra fishing drops via config (key: `[fish_plus] extra_drops`).
- Luck of the Sea increases the chance and the amount.
- **Capture Capsule**: capture/release villagers & animals.
- **Purifying Amulet (Purify)**: toggleable mode with HUD indicator; each purification consumes 1 durability, with 32 durability total (golden sword level).
- **Cat Amulet**: keeps nearby creepers away while it is in your inventory, and cancels the fuse of creepers that start swelling right next to you.
- **Metal Detector**: detects nearby ores and shows a visual indicator (can prioritize when held in off-hand).
- **Magic Key**: while held, nearby doors auto-open/close.
- **Bonus Chest extras (configurable)**
- Inject extra items into the bonus chest (default: Purifying Amulet + Village Map).
- Config key: `[bonus_chest] extra_items`.
- Note: `adonersmod:village_map` is a special entry that generates a Village Explorer Map.
- **Shockwave (Sword Enchantment)**
- Adds the Shockwave enchantment. Attacking with a Shockwave sword can spawn a shockwave.
- **Shield enchantments**
- Adds Auto Guard for shields: when enemy damage is about to land, the enchanted shield is raised automatically.
- Adds Reflection for shields: blocked projectiles are reflected back to deal damage.
- Both enchantments can appear from librarian trades and the enchanting table.
### Other QoL tweaks (configurable)
- **Auto tree cutting**: break a natural tree log with an axe to break connected logs.
- **Bone Meal+**: bone meal can grow sugar cane (also works via dispenser behavior).
- **Block EXP + Emerald chance**: breaking natural blocks spawns EXP; natural blocks can drop emeralds with Fortune scaling.
- **Villager trades refresh button**: adds a button to the trading screen to re-roll trades for eligible villagers (server-validated).
- **World QoL settings screen**: in singleplayer, the world owner can open an in-game ON/OFF settings screen for these World QoL features using a rebindable key.
- **String from White Wool** (always enabled): shapeless recipe (1× White Wool → 4× String).
- **Waist Lantern** (always enabled): if you have a lantern item from `ItemTags.LANTERNS` in hand or hotbar, you get a small moving light around your feet (places temporary invisible light blocks).
### Inventory / stack QoL (configurable)
- **Max stack size override** for stackable items (key: `[stack_size] max_stack_size`, up to 2147483647; >1000000 not recommended).
- Auto tool exchange: when a tool breaks, swap in a spare of the same item.
- Large stack count display formatting (e.g. 1000 → 1K, 1000000 → 1M).
### Config
- Config file: `config/adonersmod-common.toml`
- In singleplayer, the world owner can open an in-game World QoL settings screen with a rebindable key. There is still no full general-purpose config GUI for every feature.
### Languages
- English (`en_us`)
- Japanese (`ja_jp`)
### Feedback
Suggestions, requests, and comments are welcome!