Tweakeroo Complete Guide

Tweakeroo is a client-side quality-of-life mod by masa, in the same MaLiLib family as Litematica, MiniHUD and Item Scroller. It is not one feature — it is a toolbox of roughly 90 independent tweaks (auto-eat, fast placement, free camera, tool auto-switch, zoom…) plus 50 disable toggles that turn vanilla behaviours off. Every tweak is off by default and has no default hotkey; you pick the ones you want.

⬇ Download on Modrinth ⌥ Source (26.x fork, sakura-ryoko)

How Tweakeroo is organised

Requirements

Open the config screen with XC (the default, and what I use), or the config button in Mod Menu. Everything below is MaLiLib behaviour shared with Litematica and the other masa mods.

The tabs

A few values (fly-speed preset, remembered gamma, current hotbar-scroll row) are stored under Internal and have no tab.

Reading a row

• [true/false] button — the toggle itself. Clicking it changes the state but shows no message.
• [hotkey] button — what key(s) flip it. Pressing the hotkey in game flips it and shows an action-bar message “Toggled … on/off”. The hotkey text turns gold when it overlaps another binding; hold SHIFT while hovering to see which.
• [settings icon] — the advanced keybind settings (left-click). Right-click resets them. The icon border turns orange when they differ from the defaults.
• Enum buttons (list types, modes) — left-click cycles forward, any other mouse button cycles backward.
• The search bar accepts a hotkey as the search term — handy for “what is bound to this key?”.

Setting a hotkey

1. Click the hotkey button — it shows > … <.
2. Press the keys in order (for XC: press X, then C). Each key press appends to the chord; the first press wipes the old binding.
3. Click elsewhere (empty space) to finish. ESC before pressing anything clears the binding; ESC after adding keys just ends editing — so ESC itself can never be bound.

What “X,C” actually means

• In-game only. Default hotkeys use the in-game context: they do nothing while chat, the inventory or any menu is open.
• The prefix key still reaches vanilla. Only the last key of a chord is swallowed. That is why an unused prefix like X is a good idea — a prefix that vanilla uses (e.g. E) would still open the inventory.
• Two hotkeys on the same keys both fire. Names are physical (QWERTY) key names; mouse buttons are MOUSE_LEFT / MOUSE_RIGHT / MOUSE_MIDDLE.

Advanced keybind settings

Each hotkey can be tuned with the settings icon. Tweakeroo uses a handful of presets:

Hold the toggle key and scroll — the “adjustable” toggles

Nine toggles have a hidden second function: hold the toggle hotkey and scroll the mouse wheel to change the related number without opening the GUI. To make that possible they fire on release, and if you scrolled while holding, the toggle is suppressed. So: tap = toggle, hold + scroll = adjust.

Lists tab

• Each …ListType cycles none → blacklist → whitelist. none ignores both lists; a whitelist that is empty allows nothing.
• Click a list button to edit — one entry per row. Item, block, entity and effect lists take exact registry ids such as minecraft:budding_amethyst. No wildcards; #tags only work in silkTouchOverride and pickaxeOverride. An unknown id is skipped with a log warning — no error in the GUI (mine has minecraft:fireworks where the id is minecraft:firework_rocket; harmless because that list type is none).
• Most lists are re-parsed when you close the config screen (or join a world), not live.

Saving

Tweakeroo has no “auto-eat” feature. Eating is built from Periodic Hold Use — it presses and holds right-click for a while, releases, waits, and repeats. Because vanilla only lets you eat when you are hungry, an attempt at full hunger does nothing, and the trick works as auto-eat. It is non-intuitive because several settings do not mean what their names suggest.

The short recipe

1. Enable only tweakPeriodicHoldUse (Tweaks tab). Leave tweakPeriodicUse, tweakHoldUse, tweakFastRightClick and tweakPeriodicHoldAttack off. Bind a toggle key (mine: XU).
2. Generic → periodicHoldUseDuration ≥ eat time + ping. Single player: 34–36. Servers: eat time + ping in ticks + 2 (see the table). Too short and the bite is cancelled every cycle.
3. Generic → periodicHoldUseInterval = the pause between attempts, e.g. 100 (5 s). A long pause is fine — each attempt eats at most one item, and only if you are hungry.
4. Put the food where vanilla will use it. Safest: food in the main hand (selected hotbar slot). Or food in the off hand with a harmless main-hand item (sword, pickaxe, empty hand, stick) — see Which item gets used.
5. Turn on tweakHandRestock and keep spare stacks of the identical food in your inventory so the stack refills itself.
6. Close any open screen. The first attempt happens Interval ticks after you enable it (and after every screen closes).

How the timing really works

The tweak runs once per game tick (20 Hz) as a tiny state machine. With I = periodicHoldUseInterval and D = periodicHoldUseDuration:

• While released, a counter counts up; when it reaches I the key is pressed and startUseItem() is called immediately.
• While pressed, another counter counts to D, then the key is released. The interval counter restarts from 0.
• So the cycle is I + D ticks and I is the gap after release, not the time between presses.
• Opening any screen (inventory, chat, pause) resets both counters. Counting restarts from zero when it closes.
• Releasing the key while you are still eating cancels the bite — that is why D must exceed the eating time.

Choosing Duration (D)

The bite is completed by the server, so add round-trip latency (50 ms = 1 tick). D = 40 covers normal food up to roughly 250 ms ping but is marginal for honey. If D is much longer than the meal (≈ 64+), the still-held key starts a second bite that is cancelled at release — harmless, but pointless.

Which item gets used

• Vanilla tries the main hand first, then the off hand. A hand is skipped only if its item returns “pass” or “fail” — e.g. food while you are not hungry fails, so the off hand gets its turn.
• Anything in the main hand that has a right-click use wins over off-hand food: blocks (they get placed), bows, crossbows, shields, buckets, ender pearls, spawn eggs, fireworks, fishing rods, maps, spyglasses, flint & steel, and axes/hoes/shovels (strip/till/path the block you aim at).
• Aiming at a door, button, chest, crafting table, bed or villager means the block/entity interaction wins — and opening a screen resets the cycle.
• Vanilla will not start using an item while you are mid-way through breaking a block, and mining pauses while you eat. Auto-eat while holding attack on a block is unreliable.

Why the other toggles do not work for eating

If both hold-use and periodic-use are on, hold wins and periodic-use is ignored.

Keeping the food stocked (Hand Restock)

With tweakHandRestock on, finishing a meal does trigger a restock (a hook on “item finished being used”). Two conditions matter:

• The restock cache only survives while the use key is still down — true for Periodic Hold Use whenever D is longer than the eating time.
• The replacement must be identical (same item and same components — a renamed or enchant-glint stack will not match). It is searched in inventory rows (and the hotbar too, unless slot-cycle/randomizer is on). See Hand Restock.

Troubleshooting

Six tweaks click or hold the mouse for you. They differ in what they press, how often, and when they run — and the tooltips are misleading on timing.

Things to know

• Fast clicks are per frame, not per tick. fastLeftClickCount / fastRightClickCount default to 10; at 120 fps that is 1,200 clicks per second. Turn the count down on servers.
• Fast Left Click is a silent no-op in survival with a tool (pickaxe, axe, shovel, hoe, shears, flint & steel, fishing rod, brush) unless fastLeftClickAllowTools is on. Swords, bows and an empty hand work. It also removes vanilla’s 10-tick miss penalty.
• Fast Right Click is filtered by fastRightClickListType (item lists) and fastRightClickBlockListType (block lists). Both hands are checked. My block blacklist keeps it off chests, ender chests, trapped chests and a white shulker box.
• Periodic Hold Attack double-fires: the initial press is also a queued click, so each cycle swings twice (the second lands with ~0 cooldown). Prefer Periodic Attack or Fast Left Click for combat.
• Don’t stack the “normal” and “periodic” forms of the same button (the tooltips say so, and the code picks hold over periodic).
• Every periodic tweak resets while a screen is open.

tweakHandRestock refills your main hand or off hand from your inventory when a stack runs low or out — while placing, using, attacking, or finishing a consumable. It is two separate mechanisms:

• Identical means identical. Same item and same components (enchants, custom name…). Damageable tools use a different search: same item type with enough durability left and at least the same Silk Touch/Fortune level.
• The stack must be cached at the start of the use/attack, and the cache is dropped on any frame where neither use nor attack is held or a screen is open. That is why restock works for held-key actions.
• It also fires on: finishing a consumable, break-replace, and a popped totem (re-equips another totem).
• It never touches shulker boxes, bundles, ender chests or other containers. If nothing matches, it silently does nothing.
• Hotbar sources are excluded when tweakHotbarSlotCycle or tweakHotbarSlotRandomizer is on.
• Lists: handRestockListType (none / blacklist / whitelist). My blacklist holds the bucket family, but the list type is none so it is inactive — switch the type to blacklist to use it.

Tool Switch (tweakToolSwitch)

• Fires when you start digging a block (and again if the target changes while attack is held). It does not switch back.
• The toolPick hotkey does the same on demand for the block you look at, without needing the tweak on.
• Candidates are scanned hotbar first, then inventory; a later slot only wins if strictly better, so equal tools resolve to the lowest hotbar number.
• A tool coming from the inventory is swapped into a slot from toolSwitchableSlots — an empty one if possible, else one holding a non-tool (swords, food and blocks count as non-tools and get displaced!).
• Blocks with no tool tag (torches, flowers) never switch.

Slot syntax

toolSwitchableSlots and toolSwitchIgnoredSlots take hotbar numbers 1–9 and single-digit ranges, comma-separated, no spaces: 1,3-5. Defaults: switchable 1-9, ignored empty. If the currently selected slot is in the ignored list, switching is skipped entirely.

How a tool is chosen

The rules are checked in order and the first one with an opinion wins. The toolSwap* options in Generic switch individual rules on or off:

1. Bamboo → sword first (toolSwapBambooUsesSwordFirst, on)
2. Leaves → hoe instead of shears (toolSwapLeavesUsesHoeFirst, off)
3. Wool/vines/cobwebs → shears (toolSwapNeedsShearsFirst, on)
4. Beacons/glass-type → pickaxe (toolSwapNeedsPickaxeFirst and the pickaxeOverride list)
5. Fortune vs Silk Touch: toolSwapPreferFortuneOverride, toolSwapPreferSilkTouch (on), toolSwapSilkTouchFirst (glass, ender chests; on), toolSwapSilkTouchOres, silkTouchOverride
6. The correct tool for the block, then better enchantments (toolSwapBetterEnchants), better material (netherite > diamond > iron > copper > stone > gold > wood), then simply faster breaking speed

Weapon Switch (tweakWeaponSwitch)

• Fires at the start of every attack on an entity, no switch back. Skipped if the selected slot is ignored or you already hold a mace.
• entityWeaponMapping lines look like minecraft:minecart, minecraft:boat => minecraft:netherite_axe, minecraft:diamond_axe. <default> on the left is the fallback. An entity line replaces the default (no merge).
• The mapping is a preference, not a filter — if no mapped weapon is found you may still get an axe, bow or trident.
• Source says: <ignore> on the right-hand side does not prevent switching in the code (it only means “nothing is preferred”). And the mace can never be chosen even if listed.

Swap Almost-Broken Tools (tweakSwapAlmostBrokenTools)

• Checked every time you use, click or dig (not passively). “Nearly broken” = uses left ≤ itemSwapDurabilityThreshold (default 20).
• Source says: for items with ≤ 100 max durability the limit becomes 8% of max durability if that is smaller (gold tools → 3, wooden → 5, flint & steel → 6). The tooltip says 5%.
• Swap order: identical item with more durability → an empty inventory slot (the tool goes there and your hand empties) → any non-damageable item (which can be food or blocks!).
• toolSwapAllowUnenchantedToBreak: unenchanted tools are allowed to break.

Repair Mode (tweakRepairMode)

Every tick, for each slot in repairModeSlots (default mainhand, offhand; also head/chest/legs/feet), if the item there is fully repaired, has no Mending, or is not damageable at all, it is swapped with a damaged Mending item from the inventory. Empty slots are never filled.

Two ways to bring the 3 inventory rows to the hotbar without opening the inventory.

I have XH as the toggle for Hotbar Scroll, but the hotbarScroll key itself is unbound — bind it before expecting anything.

Fast Block Placement lets you hold right-click and sweep the cursor over new spots to place a block on each one, instead of clicking per block. Placement Restriction constrains where those blocks may go (a plane, a column, a line…) so a sloppy sweep still builds something straight.

Quick start

1. Enable tweakFastBlockPlacement (mine: XG). With “tied to fast” on, the restriction turns on with it.
2. Choose a restriction mode with X1…6 (table below). The hotkey message shows the active mode.
3. Hold right-click and place a first block, then sweep the cursor across new positions. Everything after the first block obeys the restriction and uses the first block’s orientation.
4. Release right-click — the “first block” anchor resets. The next click starts a new anchor.

The restriction modes

Anchor = the position of your first block and the face you first clicked (call its axis A).

restrictionLayerHeight has no tooltip and no scroll handler, despite the lang text — set it in the config screen. The default mode when nothing is chosen is Face.

Related placement filters

• tweakPlacementGrid (placementGridSize, default 3): block coordinates must be multiples of the size away from the first block, on all three axes. Scroll-adjustable. Also satisfies the fast-placement requirement.
• tweakPlacementLimit (placementLimit, default 3): at most N blocks per hold of right-click; further clicks do nothing until you release. Scroll-adjustable.
• tweakPlacementRestrictionFirst: only place against the same block type you first clicked.
• tweakPlacementRestrictionHand: only place against blocks that match the item in your hand. With an empty hand or a mismatch, every right-click on a block does nothing.

Settings

Vanilla decides a block’s orientation from where you stand and look. Flexible Block Placement lets you choose the orientation — and an offset — by which part of a block face you click while holding a modifier key. Accurate Block Placement is the simpler cousin: it just points the block into or away from the clicked face.

The face overlay

Each face is split into a centre square (the middle half of the face) and four trapezoids cut by the diagonals. The region under your crosshair is highlighted in the overlay colour (flexibleBlockPlacementOverlayColor).

For floor and ceiling faces the “left/right/up/down” directions are taken from the way you are facing, so the same physical spot gives a different result depending on which way you stand.

What the three keys do

• Keys stack (adjacent → rotation → offset). Adjacent is not remembered by rememberFlexibleFromClick.
• With rememberFlexibleFromClick (on) the mode from your first block persists while right-click stays down — you don’t need to keep holding the keys during a sweep (needs a restriction/grid on — see Fast Placement).
• These keys click the air block in front of the face, never the real block, so you never open a chest or table you’re pointing at. tweakFakeSneakPlacement gives a similar benefit without a key.

Recipes

Accurate Block Placement (the simple one)

tweakAccurateBlockPlacement plus two hold-keys: accurateBlockPlacementInto (block faces into the clicked block — pistons, droppers, dispensers) and accurateBlockPlacementReverse (the opposite of what vanilla would place). Both are unbound by default, and they draw no overlay. It works only through the protocol below; without protocol support the keys do nothing. Right now the tweak is on but both keys are unbound, so it does nothing.

Does it work on this server? — the placement protocol

Blocks whose orientation is not just “the face you clicked” (logs, quartz pillars, most facing blocks) need the server to decode a hidden value the client encodes in the click position. Without it the client predicts the rotation but the server places the vanilla block, and it visibly snaps back.

• accuratePlacementProtocol (bool, on) decides whether the client sends the encoded value. accuratePlacementProtocolMode (auto / v3 / v2 / slabs-only / none) only controls decoding — slabs-only and none behave identically. Toggle the bool with toggleAccuratePlacementProtocol (bind it if you move between servers).
• Auto = v3 in single player or on Servux, v2 on a Carpet server, otherwise slabs-only.
• itemUsePacketCheckBypass only exists on the integrated server (the mod is client-only); it does nothing for a dedicated server.
• clientPlacementValidation (on) refuses placements whose resulting state can’t survive.
• With the protocol active, rotation-placed stairs and trapdoors are forced to the bottom half regardless of where you click.

The breaking side mirrors placement.

• tweakBreakingRestriction with breakingRestrictionMode (default Line) — same six modes as placement (Plane, Face, Column, Line, Diagonal, Layer), anchored on the first block you start mining and the face you hit. Blocks outside the pattern are simply skipped. Mode hotkeys breakingRestrictionMode* have no default keys. Recipes: mining a wall → Plane; a straight shaft → Column; clearing from the top → Layer (height 1).
• tweakBreakingGrid (breakingGridSize, default 3; mine XB): only break blocks on a grid. Scroll-adjustable.
• tweakBlockTypeBreakRestriction: white/blacklist of blocks that may be broken by hand. Mine blacklists minecraft:budding_amethyst so I can’t destroy a budding block by accident. Warning style: blockTypeBreakRestrictionWarn.
• tweakEntityTypeAttackRestriction: white/blacklist of entities you may attack. Mine blacklists minecraft:villager. Right-click interaction (trading) is unaffected.
• disableBlockBreakCooldown (Yeets) removes the delay between breaking blocks.
• Fast Left Click, Hold Attack and Periodic Hold Attack are covered in the auto-click family.

tweakFreeCamera detaches the view from your body: you fly a spectator-style camera through walls while your real character stays where it was. Toggle it with its hotkey (unbound in my config), or type #fc in chat.

Controls & behaviour

• Mouse look rotates the camera; movement keys fly it (JUMP up, SNEAK down, sprint ×3 forward). Default speed is 0.7 blocks/tick.
• With tweakFlySpeed on, the active fly-speed preset also sets camera speed (preset × 10 blocks/tick) — so flyPreset1–4 and scroll-on-toggle control it.
• Attack, use, place, break and entity interaction are blocked by default. The camera does not collide with blocks and ignores fluid overlays.
• Your body is rendered in the world. Hands, hotbar and status bars are hidden unless freeCameraShowHands, freeCameraShowHotBar, freeCameraShowStatusBars are on.
• You only see chunks the server sent around your real position. tweakRenderEdgeChunks renders the outermost loaded chunks, which helps a lot here.

Options

Camera presets

Save and recall viewpoints. All preset hotkeys are unbound by default.

• Storage: config/tweakeroo/<world or server>.json, one file per world holding all dimensions. Singleplayer uses the world folder name; multiplayer uses the server address; all Realms share one file.
• Written only when you leave to the title screen. By code reading, presets from one world can appear in another world that has no preset file yet (unverified).
• The cycle position is global; after changing dimension the first cycle can land on the last preset.

The #fc chat command

Type in the chat box (with #, not /) — it is handled locally and never sent. No argument toggles free camera.

Zoom (tweakZoom)

• Hold zoomActivate to replace your FOV with zoomFov (default 30). A value above your normal FOV zooms out.
• Scroll while zoomed (holding the tweakZoom key or zoomActivate) to change zoomFov; CTRL uses the bigger step zoomFovDifferenceCtrl (5 vs 1). Wheel up = zoom in. Range zoomMinimumFov…zoomMaximumFov.
• zoomAdjustMouseSensitivity (on) lowers sensitivity while zoomed. Gotcha: zoomResetFovOnActivate (restore the scroll-changed FOV on release) only works while sensitivity adjustment is on.
• tweakSpyglassUsesTweakZoom: spyglass use zooms to zoomFov and scrolls the same way. swapSpyglassAndActivate (pull a spyglass from the inventory into utilityHandSlot and scope; release swaps it back) does nothing unless this tweak is on.

Elytra Camera (tweakElytraCamera + elytraCamera)

Hold elytraCamera and the mouse only moves a separate camera angle while your real rotation (flight direction) stays fixed — look down at your build while flying dead straight. Release and the view snaps back. elytraCameraIndicator (never / with_key / always) draws a bar showing your real pitch. The key uses default settings (no extra keys) — press it before other keys or mouse buttons, or enable “allow extra keys” on it.

Snap Aim & Aim Lock

• tweakSnapAim rounds your aim to a multiple of snapAimYawStep (default 45° = 8 compass headings) and/or snapAimPitchStep (12.5°). snapAimMode: yaw / pitch / both. Yaw 0 = south, 90 = west, −90 = east, 180 = north.
• With snapAimOnlyCloseToAngle (on) it only sticks within snapAimThresholdYaw (5°) / …Pitch (1.5°) of a step, otherwise aim is free — a magnet feel. Off = hard steps.
• Gotcha: with pitch step 12.5 and “only close” off, straight down (90°) is unreachable (snaps to 87.5°). Use a step that divides 90 (15, 22.5, 30, 45).
• tweakSnapAimLock freezes the last snapped value (needs SnapAim on); tweakAimLock freezes yaw+pitch at their current values (independent). The other axis stays free in single-axis modes.
• The indicator flashes for 0.75 s (snapAimIndicator, colour configurable).

Auto elytra & rockets

• tweakAutoSwitchElytra: equips your best elytra and, on landing, your previous chest armour. It triggers on a fresh Jump press while airborne (a ground jump does nothing).
• Landing quirk: if the remembered chestplate is gone, it equips the best chestplate you own (armour, toughness, Protection), not necessarily the one you wore.
• tweakAutoSwitchRockets: pulls the best rocket stack (longest flight) into utilityHandSlot; explosive rockets excluded unless rocketSwapAllowExplosions. swapElytraChestplate is a manual swap between elytra and chestplate.
• utilityHandSlot (any / main_hand / off_hand) only affects rockets and the spyglass — not food, whatever older text says.

Server data sync

To read a chest or entity you have not opened, on a non-integrated server, Tweakeroo needs the data sent to it:

• Single player: reads the integrated server directly — nothing to configure.
• entityDataSync (Servux): requires the Servux server mod with a matching version.
• entityDataSyncBackup: uses vanilla NBT query packets; only works if the server lets you query (operator status) and is only attempted for a limited time after login.
• Without either on a remote server, chest/shulker-block/ender previews are empty or stale; the item tooltip previews above still work.
• inventoryPreviewToggleScreen opens the preview as a real screen with hover tooltips (its villager-colour option is ignored).

50 toggles that turn a vanilla behaviour off. All are off by default with no hotkey. Grouped by what they touch:

A few tweaks come from Andrew54757’s “TweakFork”, merged into the 26.x line.

• Area Selector (tweakAreaSelector): look at a block; LEFT CLICK sets pos 1 (red), RIGHT CLICK sets pos 2 (blue). Hold areaSelectionOffset (mine LEFT_SHIFT) to select the block beside the face. While on, normal attack/use/place is cancelled entirely. In-memory only. areaSelectionAddToList / …RemoveFromList (unbound) add the box’s non-air blocks to the list chosen by selectiveBlocksListType.
• Selective Blocks Rendering (tweakSelectiveBlocksRendering): a blacklist hides listed positions; a whitelist shows only listed positions (an empty whitelist hides everything). The blocks are actually swapped out of the client world, so they’re also untargetable and your client collision no longer sees them (rubber-banding likely, unverified). Lists are absolute coordinates x,y,z|x,y,z, stored globally. tweakSelectiveBlocksRenderOutline draws green (whitelist) / red (blacklist) outlines. selectiveBlocksNoHit is never read — no effect.
• Scaffold Place and Zoom are covered above.

Everything is client-side code. On vanilla servers and Realms nothing is sent that a normal client would not send — except the placement-protocol click values and any reach values you choose. Some servers’ anti-cheat may dislike fast placement, hand restock’s rapid slot clicks, or flexible placement’s extra look packets.

With Sodium and Iris installed, a few options are compiled out (see the Yeets table). The startup log prints “Disabled mixin … due to” for each.

These are my personal keybindings, not defaults. Everything with the X prefix is a chord — hold X, tap the second key — and works only in-game with no other key held. Tweakeroo’s defaults use Z for placement restrictions; I consolidated everything under X in June 2026.

Config & GUIs

Toggles

Placement restriction modes

Hold modifiers

Bound in the config but currently doing nothing

• tweakElytraCamera toggle is bound, but elytraCamera is not.
• tweakHotbarScroll toggle is bound, but hotbarScroll is not.
• tweakAccurateBlockPlacement is on, but neither accurate hotkey is bound.
• tweakFlexibleBlockPlacement is off, so Alt/Ctrl placement keys do nothing.
• inventoryPreview is bound but tweakInventoryPreview is off.

Instance 26.3, Tweakeroo 0.30.0 with Sodium and Iris. Settings that differ from the defaults, and what is currently enabled.

Currently enabled tweaks

tweakFastBlockPlacement, tweakPlacementRestriction (mode plane), tweakHandRestock, tweakAccurateBlockPlacement, tweakShulkerBoxDisplay. No Yeets are on.

Notable settings

Lists

• Block-break blacklist: minecraft:budding_amethyst. Attack blacklist: minecraft:villager.
• Fast-placement blacklist: ender chest, white shulker box. Fast-right-click block blacklist: chest, ender chest, trapped chest, white shulker box (item list type none, whitelist has buckets/bottle).
• Hand-restock blacklist: bucket, lava bucket, water bucket (list type none, so inactive).
• Weapon mapping: default = mace + all swords; end crystals, item frames, glow item frames and leash knots = ignore; minecarts and boats = mace + all axes. (Remember: the mace is never selected, and <ignore> does not block a switch.)
• Potion warning: blacklist of harmful effects and whitelist of fire resistance / invisibility / water breathing (list type none).
• Unstacking protection: bucket, glass bottle. Repair-mode slots: main hand, off hand.

Where in-game text and older guides disagree with what 0.30.0’s code actually does:

Options that exist in the config file but have no code (0.30.0)

These appear in the language file or older configs but do nothing: tweakCreativeExtraItems, tweakCustomFlatPresets (+ their lists), tweakMatchingSkyFog, tweakServerDataSync / …Backup and serverDataSyncCache* (now Generic entityDataSync*), disableNetherFog, skipAllRendering, elytraFix, elytraSprintCancel, periodic*ResetIntervalOnActivate, translationTryBaseLanguage, and selectiveBlocksNoHit (parsed but never read).

• Source code: sakura-ryoko/tweakeroo, branch 26.3 (0.30.0) and sakura-ryoko/malilib, branch 26.3 — every behaviour statement in this guide was read from these. The vanilla eat-time and hand-order facts were checked in the decompiled 26.3 client.
• The only official written how-to: maruohon’s gist “Block rotations and offsets in Tweakeroo” — Flexible/Accurate placement and server requirements (its option name carpetAccuratePlacementProtocol is now accuratePlacementProtocol in Generic).
• In-game text: the mod’s en_us.json tooltips — the most complete per-option description, but terse and sometimes stale (see above).
• Modrinth page: modrinth.com/mod/tweakeroo — feature list and the anti-cheat warning.
• Not recommended: DeepWiki’s auto-generated pages (older snapshot with wrong defaults), and unofficial tweakeroo.com.

Verified against source 2026-09-24 (commit 7bad693). Behaviour may differ on other Minecraft versions. A few items were derived from code reading without an in-game test and are marked (unverified).