ВЕРСИИ (191)

## Added - **`diffState` alias** — captures a state diff mid-chain and posts it to the new `agent_msg` channel - **`printScreen` alias** — grabs an async screenshot and posts base64 PNG to `agent_msg` - **`agent_msg` channel** — structured message channel keyed by clientTick; same-tick state+screenshot entries merge automatically ## Changed - **MCP: simplified snap parameter** — `snap` (multi-entry array) replaced by `snapDeferredTicks` (single integer defer); screenshots moved from snap into `printScreen` alias - **MCP: JS bridge** — extracts `agent_msg` screenshots as MCP image blocks, removes legacy multi-snap code ## Fixed - **cfg auto-load** — world-specific `agent.cfg` no longer wipes global `bind-alias.cfg` aliases - **deferred snap extra** — recipes JSON from `listRecipes` now preserved in deferred snap envelopes - **1.21.x alias parsing** — `divider4AliasArgs` corrected from `\` to `/`, fixing all `BuiltinAliasWithArgs` aliases (`yaw`, `log`, `say`, etc.) on 1.21.x branches

## Added - **`diffState` alias** — captures a state diff mid-chain and posts it to the new `agent_msg` channel - **`printScreen` alias** — grabs an async screenshot and posts base64 PNG to `agent_msg` - **`agent_msg` channel** — structured message channel keyed by clientTick; same-tick state+screenshot entries merge automatically ## Changed - **MCP: simplified snap parameter** — `snap` (multi-entry array) replaced by `snapDeferredTicks` (single integer defer); screenshots moved from snap into `printScreen` alias - **MCP: JS bridge** — extracts `agent_msg` screenshots as MCP image blocks, removes legacy multi-snap code ## Fixed - **cfg auto-load** — world-specific `agent.cfg` no longer wipes global `bind-alias.cfg` aliases - **deferred snap extra** — recipes JSON from `listRecipes` now preserved in deferred snap envelopes - **1.21.x alias parsing** — `divider4AliasArgs` corrected from `\` to `/`, fixing all `BuiltinAliasWithArgs` aliases (`yaw`, `log`, `say`, etc.) on 1.21.x branches

## Added - **`diffState` alias** — captures a state diff mid-chain and posts it to the new `agent_msg` channel - **`printScreen` alias** — grabs an async screenshot and posts base64 PNG to `agent_msg` - **`agent_msg` channel** — structured message channel keyed by clientTick; same-tick state+screenshot entries merge automatically ## Changed - **MCP: simplified snap parameter** — `snap` (multi-entry array) replaced by `snapDeferredTicks` (single integer defer); screenshots moved from snap into `printScreen` alias - **MCP: JS bridge** — extracts `agent_msg` screenshots as MCP image blocks, removes legacy multi-snap code ## Fixed - **cfg auto-load** — world-specific `agent.cfg` no longer wipes global `bind-alias.cfg` aliases - **deferred snap extra** — recipes JSON from `listRecipes` now preserved in deferred snap envelopes - **1.21.x alias parsing** — `divider4AliasArgs` corrected from `\` to `/`, fixing all `BuiltinAliasWithArgs` aliases (`yaw`, `log`, `say`, etc.) on 1.21.x branches

## Added - **`diffState` alias** — captures a state diff mid-chain and posts it to the new `agent_msg` channel - **`printScreen` alias** — grabs an async screenshot and posts base64 PNG to `agent_msg` - **`agent_msg` channel** — structured message channel keyed by clientTick; same-tick state+screenshot entries merge automatically ## Changed - **MCP: simplified snap parameter** — `snap` (multi-entry array) replaced by `snapDeferredTicks` (single integer defer); screenshots moved from snap into `printScreen` alias - **MCP: JS bridge** — extracts `agent_msg` screenshots as MCP image blocks, removes legacy multi-snap code ## Fixed - **cfg auto-load** — world-specific `agent.cfg` no longer wipes global `bind-alias.cfg` aliases - **deferred snap extra** — recipes JSON from `listRecipes` now preserved in deferred snap envelopes - **1.21.x alias parsing** — `divider4AliasArgs` corrected from `\` to `/`, fixing all `BuiltinAliasWithArgs` aliases (`yaw`, `log`, `say`, etc.) on 1.21.x branches

### Fixed - **MCP: snap screenshots were stale** — all screenshots were captured before the alias chain ran, so every snap envelope carried a pre-action frame. Immediate snaps now capture right after the action; deferred snaps capture at expiry on the main thread, ensuring the frame matches the captured state. ### Changed - **MCP: each snap screenshot delivered as its own image block** — multi-snap responses now return one image block per screenshot instead of bundling everything into a single block, matching the documented per-envelope delivery contract.

### Fixed - **MCP: snap screenshots were stale** — all screenshots were captured before the alias chain ran, so every snap envelope carried a pre-action frame. Immediate snaps now capture right after the action; deferred snaps capture at expiry on the main thread, ensuring the frame matches the captured state. ### Changed - **MCP: each snap screenshot delivered as its own image block** — multi-snap responses now return one image block per screenshot instead of bundling everything into a single block, matching the documented per-envelope delivery contract.

### Fixed - **MCP: snap screenshots were stale** — all screenshots were captured before the alias chain ran, so every snap envelope carried a pre-action frame. Immediate snaps now capture right after the action; deferred snaps capture at expiry on the main thread, ensuring the frame matches the captured state. ### Changed - **MCP: each snap screenshot delivered as its own image block** — multi-snap responses now return one image block per screenshot instead of bundling everything into a single block, matching the documented per-envelope delivery contract.

### Fixed - **MCP: snap screenshots were stale** — all screenshots were captured before the alias chain ran, so every snap envelope carried a pre-action frame. Immediate snaps now capture right after the action; deferred snaps capture at expiry on the main thread, ensuring the frame matches the captured state. ### Changed - **MCP: each snap screenshot delivered as its own image block** — multi-snap responses now return one image block per screenshot instead of bundling everything into a single block, matching the documented per-envelope delivery contract.

### Fixed - **MCP: `runAlias` without `snap` returned `{}`** — the pre-execution state diff and channels were discarded when `snap` was not defined. Now returns a single envelope with state diff and drained channels, matching the documented contract.

### Fixed - **MCP: `runAlias` without `snap` returned `{}`** — the pre-execution state diff and channels were discarded when `snap` was not defined. Now returns a single envelope with state diff and drained channels, matching the documented contract.

### Fixed - **MCP: `runAlias` without `snap` returned `{}`** — the pre-execution state diff and channels were discarded when `snap` was not defined. Now returns a single envelope with state diff and drained channels, matching the documented contract.

### Fixed - **MCP: `runAlias` without `snap` returned `{}`** — the pre-execution state diff and channels were discarded when `snap` was not defined. Now returns a single envelope with state diff and drained channels, matching the documented contract.

### Changed - **MCP: deep state diff** — state diffs now use recursive JSON comparison so only changed sub-fields are emitted (e.g. `{"pos":{"yaw":45}}` instead of the entire `pos` object). Arrays are diffed as a whole. - **MCP: verbose and channels scoped to last deferredTick** — in multi-snap calls, `verbose` only applies to the last `deferredTick` envelope; message channels (chat, mod, sound, unlocked_recipe) only appear in the last envelope since entries carry tick-index info internally.

### Changed - **MCP: deep state diff** — state diffs now use recursive JSON comparison so only changed sub-fields are emitted (e.g. `{"pos":{"yaw":45}}` instead of the entire `pos` object). Arrays are diffed as a whole. - **MCP: verbose and channels scoped to last deferredTick** — in multi-snap calls, `verbose` only applies to the last `deferredTick` envelope; message channels (chat, mod, sound, unlocked_recipe) only appear in the last envelope since entries carry tick-index info internally.

### Changed - **MCP: deep state diff** — state diffs now use recursive JSON comparison so only changed sub-fields are emitted (e.g. `{"pos":{"yaw":45}}` instead of the entire `pos` object). Arrays are diffed as a whole. - **MCP: verbose and channels scoped to last deferredTick** — in multi-snap calls, `verbose` only applies to the last `deferredTick` envelope; message channels (chat, mod, sound, unlocked_recipe) only appear in the last envelope since entries carry tick-index info internally.

### Changed - **MCP: deep state diff** — state diffs now use recursive JSON comparison so only changed sub-fields are emitted (e.g. `{"pos":{"yaw":45}}` instead of the entire `pos` object). Arrays are diffed as a whole. - **MCP: verbose and channels scoped to last deferredTick** — in multi-snap calls, `verbose` only applies to the last `deferredTick` envelope; message channels (chat, mod, sound, unlocked_recipe) only appear in the last envelope since entries carry tick-index info internally.

### Changed - **MCP: verbose/nap unification** — replaced /state with verbose param. Added nap to /screenshot. - **MCP: selected hotbar slot** — always emits slot+item; hotbar suppressed while container open. - **MCP: recipe placeability** — placeable field filters by grid size. - change divider4AliasArgs from backslash to slash.

### Changed - **MCP: verbose/nap unification** — replaced /state with verbose param. Added nap to /screenshot. - **MCP: selected hotbar slot** — always emits slot+item; hotbar suppressed while container open. - **MCP: recipe placeability** — placeable field filters by grid size. - change divider4AliasArgs from backslash to slash.

### Changed - **MCP: verbose/nap unification** — replaced /state with verbose param. Added nap to /screenshot. - **MCP: selected hotbar slot** — always emits slot+item; hotbar suppressed while container open. - **MCP: recipe placeability** — placeable field filters by grid size. - change divider4AliasArgs from backslash to slash.

### Changed - **MCP: verbose/nap unification** — replaced /state with verbose param. Added nap to /screenshot. - **MCP: selected hotbar slot** — always emits slot+item; hotbar suppressed while container open. - **MCP: recipe placeability** — placeable field filters by grid size. - change divider4AliasArgs from backslash to slash.

### Changed - **`/time` family without cheats** — the vanilla `/time` command family no longer requires gamemaster permission, so it works in singleplayer worlds with cheats off (client-side only, same approach as the existing `/tick` family).

### Changed - **`/time` family without cheats** — the vanilla `/time` command family no longer requires gamemaster permission, so it works in singleplayer worlds with cheats off (client-side only, same approach as the existing `/tick` family).

### Changed - **`/time` family without cheats** — the vanilla `/time` command family no longer requires gamemaster permission, so it works in singleplayer worlds with cheats off (client-side only, same approach as the existing `/tick` family).

### Changed - **`/time` family without cheats** — the vanilla `/time` command family no longer requires gamemaster permission, so it works in singleplayer worlds with cheats off (client-side only, same approach as the existing `/tick` family).

### Added - **Per-save agent cfg** — a second cfg file at `<game_root>/saves/<save>/bind-alias/agent.cfg` loads alongside the main cfg on world join. The maintainer can place initialization details in global cfg that are hidden from the MCP agent. - **MCP `/readNotes` and `/writeNotes` tools** — read/write arbitrary text files inside the per-save agent directory (`<game_root>/saves/<save>/bind-alias/<file>`). Only plain filenames (no path separators, no `..`) are accepted. ### Changed - **MCP `readCFG`/`writeCFG` scope** — both tools now operate exclusively on the per-save agent cfg file and require the player to be in a singleplayer world. The maintainer can place initialization details in global cfg that are hidden from the MCP agent. - **`held_keys` no longer includes `+freeCursor`** — the internal `+freeCursor` toggle is hidden from the standard envelope to avoid confusing the agent with unnecessary state. - **Bridge tool instructions cleaned** — removed `+-freeCursor` and `reapply` from the MCP bridge descriptions since they are developer-oriented and not useful to MCP agents. ### Fixed - **`+use` missing from `held_keys`** in the MCP envelope. - **POST MCP tools timing out** — `req.end()` was missing from the bridge's `apiPost`, causing all POST-based tools (`runAlias`, `writeCFG`, `defineAlias`, `writeNotes`) to hang indefinitely. - **`writeCFG`/`writeNotes` bridge timeout** increased from 10s to 30s to accommodate per-save cfg reload.

### Added - **Per-save agent cfg** — a second cfg file at `<game_root>/saves/<save>/bind-alias/agent.cfg` loads alongside the main cfg on world join. The maintainer can place initialization details in global cfg that are hidden from the MCP agent. - **MCP `/readNotes` and `/writeNotes` tools** — read/write arbitrary text files inside the per-save agent directory (`<game_root>/saves/<save>/bind-alias/<file>`). Only plain filenames (no path separators, no `..`) are accepted. ### Changed - **MCP `readCFG`/`writeCFG` scope** — both tools now operate exclusively on the per-save agent cfg file and require the player to be in a singleplayer world. The main cfg is no longer accessible via the MCP API. - **`held_keys` no longer includes `+freeCursor`** — the internal `+freeCursor` toggle is hidden from the standard envelope to avoid confusing the agent with unnecessary state. - **Bridge tool instructions cleaned** — removed `+-freeCursor` and `reapply` from the MCP bridge descriptions since they are developer-oriented and not useful to MCP agents. ### Fixed - **`+use` missing from `held_keys`** in the MCP envelope. - **POST MCP tools timing out** — `req.end()` was missing from the bridge's `apiPost`, causing all POST-based tools (`runAlias`, `writeCFG`, `defineAlias`, `writeNotes`) to hang indefinitely. - **`writeCFG`/`writeNotes` bridge timeout** increased from 10s to 30s to accommodate per-save cfg reload.

### Added - **Per-save agent cfg** — a second cfg file at `<game_root>/saves/<save>/bind-alias/agent.cfg` loads alongside the main cfg on world join. The maintainer can place initialization details in global cfg that are hidden from the MCP agent. - **MCP `/readNotes` and `/writeNotes` tools** — read/write arbitrary text files inside the per-save agent directory (`<game_root>/saves/<save>/bind-alias/<file>`). Only plain filenames (no path separators, no `..`) are accepted. ### Changed - **MCP `readCFG`/`writeCFG` scope** — both tools now operate exclusively on the per-save agent cfg file and require the player to be in a singleplayer world. The main cfg is no longer accessible via the MCP API. - **`held_keys` no longer includes `+freeCursor`** — the internal `+freeCursor` toggle is hidden from the standard envelope to avoid confusing the agent with unnecessary state. - **Bridge tool instructions cleaned** — removed `+-freeCursor` and `reapply` from the MCP bridge descriptions since they are developer-oriented and not useful to MCP agents. ### Fixed - **`+use` missing from `held_keys`** in the MCP envelope. - **POST MCP tools timing out** — `req.end()` was missing from the bridge's `apiPost`, causing all POST-based tools (`runAlias`, `writeCFG`, `defineAlias`, `writeNotes`) to hang indefinitely. - **`writeCFG`/`writeNotes` bridge timeout** increased from 10s to 30s to accommodate per-save cfg reload.

### Added - **Per-save agent cfg** — a second cfg file at `<game_root>/saves/<save>/bind-alias/agent.cfg` loads alongside the main cfg on world join. The maintainer can place initialization details in global cfg that are hidden from the MCP agent. - **MCP `/readNotes` and `/writeNotes` tools** — read/write arbitrary text files inside the per-save agent directory (`<game_root>/saves/<save>/bind-alias/<file>`). Only plain filenames (no path separators, no `..`) are accepted. ### Changed - **MCP `readCFG`/`writeCFG` scope** — both tools now operate exclusively on the per-save agent cfg file and require the player to be in a singleplayer world. The main cfg is no longer accessible via the MCP API. - **`held_keys` no longer includes `+freeCursor`** — the internal `+freeCursor` toggle is hidden from the standard envelope to avoid confusing the agent with unnecessary state. - **Bridge tool instructions cleaned** — removed `+-freeCursor` and `reapply` from the MCP bridge descriptions since they are developer-oriented and not useful to MCP agents. ### Fixed - **`+use` missing from `held_keys`** in the MCP envelope. - **POST MCP tools timing out** — `req.end()` was missing from the bridge's `apiPost`, causing all POST-based tools (`runAlias`, `writeCFG`, `defineAlias`, `writeNotes`) to hang indefinitely. - **`writeCFG`/`writeNotes` bridge timeout** increased from 10s to 30s to accommodate per-save cfg reload.

### Changed - **MCP envelope channel rename** — the recipe-unlock channel `recipe` is renamed to `unlocked_recipe`. - **MCP state `held_item` refactored** — `held_item` (string) / `held_item_count` / `selected_hotbar_slot` / top-level `durability` collapse into a single item-stack obj `held_item` (same shape as container/hotbar entries: `item`, `name`, `count` plus optional `durability` / `enchanted` / `tooltip`; `null` when the hand is empty). - **MCP state `target` extended** — field `kind` renamed to `class`; added `ray_hit` obj ({`x`, `y`, `z`}) with the exact crosshair ray hit position. - **`/tick` family without cheats** — the vanilla `/tick` command family no longer requires admin permission, so it works in singleplayer worlds with cheats off; `tick rate` valid range expanded to [0.1, 10000] (the internal 1.0 clamp was lifted to match).

### Changed - **MCP envelope channel rename** — the recipe-unlock channel `recipe` is renamed to `unlocked_recipe`. - **MCP state `held_item` refactored** — `held_item` (string) / `held_item_count` / `selected_hotbar_slot` / top-level `durability` collapse into a single item-stack obj `held_item` (same shape as container/hotbar entries: `item`, `name`, `count` plus optional `durability` / `enchanted` / `tooltip`; `null` when the hand is empty). - **MCP state `target` extended** — field `kind` renamed to `class`; added `ray_hit` obj ({`x`, `y`, `z`}) with the exact crosshair ray hit position. - **`/tick` family without cheats** — the vanilla `/tick` command family no longer requires admin permission, so it works in singleplayer worlds with cheats off; `tick rate` valid range expanded to [0.1, 10000] (the internal 1.0 clamp was lifted to match).

### Changed - **MCP envelope channel rename** — the recipe-unlock channel `recipe` is renamed to `unlocked_recipe`. - **MCP state `held_item` refactored** — `held_item` (string) / `held_item_count` / `selected_hotbar_slot` / top-level `durability` collapse into a single item-stack obj `held_item` (same shape as container/hotbar entries: `item`, `name`, `count` plus optional `durability` / `enchanted` / `tooltip`; `null` when the hand is empty). - **MCP state `target` extended** — field `kind` renamed to `class`; added `ray_hit` obj ({`x`, `y`, `z`}) with the exact crosshair ray hit position. - **`/tick` family without cheats** — the vanilla `/tick` command family no longer requires admin permission, so it works in singleplayer worlds with cheats off; `tick rate` valid range expanded to [0.1, 10000] (the internal 1.0 clamp was lifted to match).

### Changed - **MCP envelope channel rename** — the recipe-unlock channel `recipe` is renamed to `unlocked_recipe`. - **MCP state `held_item` refactored** — `held_item` (string) / `held_item_count` / `selected_hotbar_slot` / top-level `durability` collapse into a single item-stack obj `held_item` (same shape as container/hotbar entries: `item`, `name`, `count` plus optional `durability` / `enchanted` / `tooltip`; `null` when the hand is empty). - **MCP state `target` extended** — field `kind` renamed to `class`; added `ray_hit` obj ({`x`, `y`, `z`}) with the exact crosshair ray hit position. - **`/tick` family without cheats** — the vanilla `/tick` command family no longer requires admin permission, so it works in singleplayer worlds with cheats off; `tick rate` valid range expanded to [0.1, 10000] (the internal 1.0 clamp was lifted to match).

### Added - **unloadUser* built-in aliases** — `unloadUserAliases`, `unloadUserVars`, `unloadUserBinds`, `unloadUserAll` remove runtime-created items while preserving CFG-loaded and builtin items. ### Fixed - **`/var cN` feedback** — now correctly shows success instead of "Failed". - **`/runAlias` suggestions** — chain-aware completion with token-level alias + var suggestions. - **`swapSlot` var suggestions** — container slot and general int vars now suggested.

### Added - **unloadUser* built-in aliases** — `unloadUserAliases`, `unloadUserVars`, `unloadUserBinds`, `unloadUserAll` remove runtime-created items while preserving CFG-loaded and builtin items. ### Fixed - **`/var cN` feedback** — now correctly shows success instead of "Failed". - **`/runAlias` suggestions** — chain-aware completion with token-level alias + var suggestions. - **`swapSlot` var suggestions** — container slot and general int vars now suggested.

### Added - **unloadUser* built-in aliases** — `unloadUserAliases`, `unloadUserVars`, `unloadUserBinds`, `unloadUserAll` remove runtime-created items while preserving CFG-loaded and builtin items. ### Fixed - **`/var cN` feedback** — now correctly shows success instead of "Failed". - **`/runAlias` suggestions** — chain-aware completion with token-level alias + var suggestions. - **`swapSlot` var suggestions** — container slot and general int vars now suggested.

### Added - **unloadUser* built-in aliases** — `unloadUserAliases`, `unloadUserVars`, `unloadUserBinds`, `unloadUserAll` remove runtime-created items while preserving CFG-loaded and builtin items. ### Fixed - **`/var cN` feedback** — now correctly shows success instead of "Failed". - **`/runAlias` suggestions** — chain-aware completion with token-level alias + var suggestions. - **`swapSlot` var suggestions** — container slot and general int vars now suggested.

### Changed - **MCP standard envelope** — rename `tick` field to `client_tick`. - **logger helper tickPrefix()** — now use same tick counter format as the MCP tool api. - **style consistency** — make all tick counter formats consistent. - **perf** — pre-size StringBuilders for late-game recipe lists (500+ recipes).

### Changed - **MCP standard envelope** — rename `tick` field to `client_tick`. - **logger helper tickPrefix()** — now use same tick counter format as the MCP tool api. - **style consistency** — make all tick counter formats consistent. - **perf** — pre-size StringBuilders for late-game recipe lists (500+ recipes).

### Changed - **MCP standard envelope** — rename `tick` field to `client_tick`. - **logger helper tickPrefix()** — now use same tick counter format as the MCP tool api. - **style consistency** — make all tick counter formats consistent. - **perf** — pre-size StringBuilders for late-game recipe lists (500+ recipes).

### Changed - **MCP standard envelope** — rename `tick` field to `client_tick`. - **logger helper tickPrefix()** — now use same tick counter format as the MCP tool api. - **style consistency** — make all tick counter formats consistent. - **perf** — pre-size StringBuilders for late-game recipe lists (500+ recipes).

### Changed - **container_grid markers** — occupied slots now use `X` instead of `*`, empty slots use `O` instead of `o`.

### Changed - **container_grid markers** — occupied slots now use `X` instead of `*`, empty slots use `O` instead of `o`.

### Changed - **container_grid markers** — occupied slots now use `X` instead of `*`, empty slots use `O` instead of `o`.

### Changed - **container_grid markers** — occupied slots now use `X` instead of `*`, empty slots use `O` instead of `o`.

### Changed - **MCP hotbar & container diff** — `hotbar` and `container` members are now diffed at slot granularity: full view on getState / open / menu change, afterwards only changed slots (`"item":null` = slot became empty) plus `empty_inv` / `container_grid` or `hotbar_empty` only when they changed.

### Changed - **MCP hotbar & container diff** — `hotbar` and `container` members are now diffed at slot granularity: full view on getState / open / menu change, afterwards only changed slots (`"item":null` = slot became empty) plus `empty_inv` / `container_grid` or `hotbar_empty` only when they changed.

### Changed - **MCP hotbar & container diff** — `hotbar` and `container` members are now diffed at slot granularity: full view on getState / open / menu change, afterwards only changed slots (`"item":null` = slot became empty) plus `empty_inv` / `container_grid` or `hotbar_empty` only when they changed.

### Changed - **MCP hotbar & container diff** — `hotbar` and `container` members are now diffed at slot granularity: full view on getState / open / menu change, afterwards only changed slots (`"item":null` = slot became empty) plus `empty_inv` / `container_grid` or `hotbar_empty` only when they changed.

### Changed - **MCP nap** — moved from the bridge to the mod API, unit changed from real-world seconds to **client ticks** (same unit as `wait\`), and the state envelope is now captured **after** the nap (newest info) instead of before. The bridge forwards the `nap` parameter and scales the request timeout accordingly.

### Changed - **MCP nap** — moved from the bridge to the mod API, unit changed from real-world seconds to **client ticks** (same unit as `wait\`), and the state envelope is now captured **after** the nap (newest info) instead of before. The bridge forwards the `nap` parameter and scales the request timeout accordingly.

### Changed - **MCP nap** — moved from the bridge to the mod API, unit changed from real-world seconds to **client ticks** (same unit as `wait\`), and the state envelope is now captured **after** the nap (newest info) instead of before. The bridge forwards the `nap` parameter and scales the request timeout accordingly.

### Changed - **MCP nap** — moved from the bridge to the mod API, unit changed from real-world seconds to **client ticks** (same unit as `wait\`), and the state envelope is now captured **after** the nap (newest info) instead of before. The bridge forwards the `nap` parameter and scales the request timeout accordingly.

### Fixed - **Builtin key aliases under text-input screens** — `+advancements`, `+debugOverlay` and `pickItem` no longer act while a chat/sign/book/command screen is open, matching the other builtin key aliases. - **Nearby-player direction** — now measured from the local player's eye position instead of feet. - **`sound` channel `here` threshold** — tightened from 0.5 m to 0.31 m. ### Changed - **Bridge** — `mcp_server.js` revisions around the unified state envelope; tool instructions trimmed. - **post-checkout hook** — caches Eclipse config per branch to skip Gradle on re-checkout; cache invalidated when build config files change; `.launch` cleanup scoped to the `BindAliasPlus_` prefix.

### Fixed - **Builtin key aliases under text-input screens** — `+advancements`, `+debugOverlay` and `pickItem` no longer act while a chat/sign/book/command screen is open, matching the other builtin key aliases. - **Nearby-player direction** — now measured from the local player's eye position instead of feet. - **`sound` channel `here` threshold** — tightened from 0.5 m to 0.31 m. ### Changed - **Bridge** — `mcp_server.js` revisions around the unified state envelope; tool instructions trimmed. - **post-checkout hook** — caches Eclipse config per branch to skip Gradle on re-checkout; cache invalidated when build config files change; `.launch` cleanup scoped to the `BindAliasPlus_` prefix.

### Fixed - **Builtin key aliases under text-input screens** — `+advancements`, `+debugOverlay` and `pickItem` no longer act while a chat/sign/book/command screen is open, matching the other builtin key aliases. - **Nearby-player direction** — now measured from the local player's eye position instead of feet. - **`sound` channel `here` threshold** — tightened from 0.5 m to 0.31 m. ### Changed - **Bridge** — `mcp_server.js` revisions around the unified state envelope; tool instructions trimmed. - **post-checkout hook** — caches Eclipse config per branch to skip Gradle on re-checkout; cache invalidated when build config files change; `.launch` cleanup scoped to the `BindAliasPlus_` prefix.

### Fixed - **Builtin key aliases under text-input screens** — `+advancements`, `+debugOverlay` and `pickItem` no longer act while a chat/sign/book/command screen is open, matching the other builtin key aliases. - **Nearby-player direction** — now measured from the local player's eye position instead of feet. - **`sound` channel `here` threshold** — tightened from 0.5 m to 0.31 m. ### Changed - **Bridge** — `mcp_server.js` revisions around the unified state envelope; tool instructions trimmed. - **post-checkout hook** — caches Eclipse config per branch to skip Gradle on re-checkout; cache invalidated when build config files change; `.launch` cleanup scoped to the `BindAliasPlus_` prefix.

### Added - **Unified state envelope** — every game endpoint returns `{tick,state,chat,mod,sound,recipe}`: full snapshot for `getState`, changed-member diffs elsewhere (container diffed at slot granularity); `held_keys` is present whenever non-empty. - **New state fields** — `world_name`, `feet`, `hunger`/`saturation`/`armor`/`xp`, crosshair `target`, active `effects`, nearby `players` (locator-bar style, relative yaw/pitch), `hotbar` (+`hotbar_empty`); container items gained `durability`/`enchanted`/`tooltip`. - **`sound` channel** — subtitle-audible sounds with tick stamp, relative yaw/pitch (20° steps) and distance; repeats coalesce with `xN`. - **`recipe` channel, `listRecipes` tool, `applyRecipe` alias** — recipe unlocks reported by result-item name; unlocked recipes can be listed (diff or per-query) and placed into the crafting grid like a recipe-book click (no crafting). - **MCP port fallback** — the mod falls back to the next free port from 25575; bridge gained `--port`. ### Changed - **chat/mod channels split** — `ChatCapture` replaced by `GameChannels`: `chat` = game chat, `mod` = mod log output (alias feedback, errors, `log\` messages). - **Bridge** — `runAlias` delay parameter renamed to `nap`; `listRecipes` added, `getLogDiff` dropped. ### Fixed - **container_grid leading-blank alignment**.

### Added - **Unified state envelope** — every game endpoint returns `{tick,state,chat,mod,sound,recipe}`: full snapshot for `getState`, changed-member diffs elsewhere (container diffed at slot granularity); `held_keys` is present whenever non-empty. - **New state fields** — `world_name`, `feet`, `hunger`/`saturation`/`armor`/`xp`, crosshair `target`, active `effects`, nearby `players` (locator-bar style, relative yaw/pitch), `hotbar` (+`hotbar_empty`); container items gained `durability`/`enchanted`/`tooltip`. - **`sound` channel** — subtitle-audible sounds with tick stamp, relative yaw/pitch (20° steps) and distance; repeats coalesce with `xN`. - **`recipe` channel, `listRecipes` tool, `applyRecipe` alias** — recipe unlocks reported by result-item name; unlocked recipes can be listed (diff or per-query) and placed into the crafting grid like a recipe-book click (no crafting). - **MCP port fallback** — the mod falls back to the next free port from 25575; bridge gained `--port`. ### Changed - **chat/mod channels split** — `ChatCapture` replaced by `GameChannels`: `chat` = game chat, `mod` = mod log output (alias feedback, errors, `log\` messages). - **Bridge** — `runAlias` delay parameter renamed to `nap`; `listRecipes` added, `getLogDiff` dropped. ### Fixed - **container_grid leading-blank alignment**.

### Added - **Unified state envelope** — every game endpoint returns `{tick,state,chat,mod,sound,recipe}`: full snapshot for `getState`, changed-member diffs elsewhere (container diffed at slot granularity); `held_keys` is present whenever non-empty. - **New state fields** — `world_name`, `feet`, `hunger`/`saturation`/`armor`/`xp`, crosshair `target`, active `effects`, nearby `players` (locator-bar style, relative yaw/pitch), `hotbar` (+`hotbar_empty`); container items gained `durability`/`enchanted`/`tooltip`. - **`sound` channel** — subtitle-audible sounds with tick stamp, relative yaw/pitch (20° steps) and distance; repeats coalesce with `xN`. - **`recipe` channel, `listRecipes` tool, `applyRecipe` alias** — recipe unlocks reported by result-item name; unlocked recipes can be listed (diff or per-query) and placed into the crafting grid like a recipe-book click (no crafting). - **MCP port fallback** — the mod falls back to the next free port from 25575; bridge gained `--port`. ### Changed - **chat/mod channels split** — `ChatCapture` replaced by `GameChannels`: `chat` = game chat, `mod` = mod log output (alias feedback, errors, `log\` messages). - **Bridge** — `runAlias` delay parameter renamed to `nap`; `listRecipes` added, `getLogDiff` dropped. ### Fixed - **container_grid leading-blank alignment**.

### Added - **Unified state envelope** — every game endpoint returns `{tick,state,chat,mod,sound,recipe}`: full snapshot for `getState`, changed-member diffs elsewhere (container diffed at slot granularity); `held_keys` is present whenever non-empty. - **New state fields** — `world_name`, `feet`, `hunger`/`saturation`/`armor`/`xp`, crosshair `target`, active `effects`, nearby `players` (locator-bar style, relative yaw/pitch), `hotbar` (+`hotbar_empty`); container items gained `durability`/`enchanted`/`tooltip`. - **`sound` channel** — subtitle-audible sounds with tick stamp, relative yaw/pitch (20° steps) and distance; repeats coalesce with `xN`. - **`recipe` channel, `listRecipes` tool, `applyRecipe` alias** — recipe unlocks reported by result-item name; unlocked recipes can be listed (diff or per-query) and placed into the crafting grid like a recipe-book click (no crafting). - **MCP port fallback** — the mod falls back to the next free port from 25575; bridge gained `--port`. ### Changed - **chat/mod channels split** — `ChatCapture` replaced by `GameChannels`: `chat` = game chat, `mod` = mod log output (alias feedback, errors, `log\` messages). - **Bridge** — `runAlias` delay parameter renamed to `nap`; `listRecipes` added, `getLogDiff` dropped. ### Fixed - **container_grid leading-blank alignment**.

### Changed - **runAlias response extended** — POS snapshot (`x`, `y`, `z`, `yaw`, `pitch`) captured before alias execution, returned alongside `tick`. - **POS snapshot synced** — new commit cherry-picked and method names aligned across all active branches. - **`MCP_node_js_src/mcp_server.js` updated** — runAlias tool now surfaces POS fields in its output.

### Changed - **runAlias response extended** — POS snapshot (`x`, `y`, `z`, `yaw`, `pitch`) captured before alias execution, returned alongside `tick`. - **POS snapshot synced** — new commit cherry-picked and method names aligned across all active branches. - **`MCP_node_js_src/mcp_server.js` updated** — runAlias tool now surfaces POS fields in its output.

### Changed - **runAlias response extended** — POS snapshot (`x`, `y`, `z`, `yaw`, `pitch`) captured before alias execution, returned alongside `tick`. - **POS snapshot synced** — new commit cherry-picked and method names aligned across all active branches. - **`MCP_node_js_src/mcp_server.js` updated** — runAlias tool now surfaces POS fields in its output.

### Changed - **runAlias response extended** — POS snapshot (`x`, `y`, `z`, `yaw`, `pitch`) captured before alias execution, returned alongside `tick`. - **POS snapshot synced** — new commit cherry-picked and method names aligned across all active branches. - **`MCP_node_js_src/mcp_server.js` updated** — runAlias tool now surfaces POS fields in its output.

### Changed - **Container grid format unified** — `container_grid` row strings now use space-separated groups inside `|group|` with trailing padding and `\n` row separators. Empty cells use lowercase `o`. Output is identical across all MC versions. - **Internal method rename** — `j()` → `jsonEscape()`, `decode()` → `decodePercent()` for consistency across branches.

### Changed - **Container grid format unified** — `container_grid` row strings now use space-separated groups inside `|group|` with trailing padding and `\n` row separators. Empty cells use lowercase `o`. Output is identical across all MC versions. - **Internal method rename** — `j()` → `jsonEscape()`, `decode()` → `decodePercent()` for consistency across branches.

### Changed - **Container grid format unified** — `container_grid` row strings now use space-separated groups inside `|group|` with trailing padding and `\n` row separators. Empty cells use lowercase `o`. Output is identical across all MC versions. - **Internal method rename** — `j()` → `jsonEscape()`, `decode()` → `decodePercent()` for consistency across branches.

### Changed - **Container grid format unified** — `container_grid` row strings now use space-separated groups inside `|group|` with trailing padding and `\n` row separators. Empty cells use lowercase `o`. Output is identical across all MC versions. - **Internal method rename** — `j()` → `jsonEscape()`, `decode()` → `decodePercent()` for consistency across branches.

## [1.5.9] - 2026-07-27 ### Changed - **/state JSON schema refactored** — all keys use snake_case, reordered (dimension, screen, position, health, tick). Removed `world_name` and `max_health`; added `durability` sub-object for the selected hotbar slot. - **Container grid reworked** — `container_grid` uses pipe-delimited string rows (`"|c00:*","c01:O|"`) instead of nested JSON arrays. `inventory_items` and `empty_inv` now appear before the grid. Removed menu class name and size throttle.

## [1.5.9] - 2026-07-27 ### Changed - **/state JSON schema refactored** — all keys use snake_case, reordered (dimension, screen, position, health, tick). Removed `world_name` and `max_health`; added `durability` sub-object for the selected hotbar slot. - **Container grid reworked** — `container_grid` uses pipe-delimited string rows (`"|c00:*","c01:O|"`) instead of nested JSON arrays. `inventory_items` and `empty_inv` now appear before the grid. Removed menu class name and size throttle.

## [1.5.9] - 2026-07-27 ### Changed - **/state JSON schema refactored** — all keys use snake_case, reordered (dimension, screen, position, health, tick). Removed `world_name` and `max_health`; added `durability` sub-object for the selected hotbar slot. - **Container grid reworked** — `container_grid` uses pipe-delimited string rows (`"|c00:*","c01:O|"`) instead of nested JSON arrays. `inventory_items` and `empty_inv` now appear before the grid. Removed menu class name and size throttle.

## [1.5.9] - 2026-07-27 ### Changed - **/state JSON schema refactored** — all keys use snake_case, reordered (dimension, screen, position, health, tick). Removed `world_name` and `max_health`; added `durability` sub-object for the selected hotbar slot. - **Container grid reworked** — `container_grid` uses pipe-delimited string rows (`"|c00:*","c01:O|"`) instead of nested JSON arrays. `inventory_items` and `empty_inv` now appear before the grid. Removed menu class name and size throttle.

### Changed - **runAlias API returns tick-since-join** — `POST /runAlias` now returns `{"tick": <N>}` (ticks since world join at the moment the alias executed) instead of `{"ok": true}`. The MCP server surfaces this as `[T+<N>]` to the caller.

### Changed - **runAlias API returns tick-since-join** — `POST /runAlias` now returns `{"tick": <N>}` (ticks since world join at the moment the alias executed) instead of `{"ok": true}`. The MCP server surfaces this as `[T+<N>]` to the caller.

### Changed - **runAlias API returns tick-since-join** — `POST /runAlias` now returns `{"tick": <N>}` (ticks since world join at the moment the alias executed) instead of `{"ok": true}`. The MCP server surfaces this as `[T+<N>]` to the caller.

### Changed - **runAlias API returns tick-since-join** — `POST /runAlias` now returns `{"tick": <N>}` (ticks since world join at the moment the alias executed) instead of `{"ok": true}`. The MCP server surfaces this as `[T+<N>]` to the caller.

### Fixed - **WaitAlias deferred chain: `;` → ` ` replacement for greedy-string aliases** — `AliasAlias`, `BindAlias`, and `UnbindAlias` use `;` as their definition divider. When their args are reconstructed in a `wait`-deferred chain, the `;` divider is now replaced with ` ` instead of quoting. - **`wait\1` now defers to next tick; `wait\0` → NOP** — `wait\1` correctly defers the rest of the chain by one tick. `wait\0` is a no-op. - **Root alias resolution in deferred chain** — `getFirst()` → `getLast()` so the deferred chain drain walks aliases from the innermost caller outward. - **Log tag rename** — `[runAlias]` → `[builtinRunAlias]` in log messages. - **CFG autoload uses `UserAlias` for runAlias lines** — fixes chaining syntax support in autoloaded `runAlias` entries.

### Fixed - **WaitAlias deferred chain: `;` → ` ` replacement for greedy-string aliases** — `AliasAlias`, `BindAlias`, and `UnbindAlias` use `;` as their definition divider. When their args are reconstructed in a `wait`-deferred chain, the `;` divider is now replaced with ` ` instead of quoting. - **`wait\1` now defers to next tick; `wait\0` → NOP** — `wait\1` correctly defers the rest of the chain by one tick. `wait\0` is a no-op. - **Root alias resolution in deferred chain** — `getFirst()` → `getLast()` so the deferred chain drain walks aliases from the innermost caller outward. - **Log tag rename** — `[runAlias]` → `[builtinRunAlias]` in log messages. - **CFG autoload uses `UserAlias` for runAlias lines** — fixes chaining syntax support in autoloaded `runAlias` entries.

### Fixed - **WaitAlias deferred chain: `;` → ` ` replacement for greedy-string aliases** — `AliasAlias`, `BindAlias`, and `UnbindAlias` use `;` as their definition divider. When their args are reconstructed in a `wait`-deferred chain, the `;` divider is now replaced with ` ` instead of quoting. - **`wait\1` now defers to next tick; `wait\0` → NOP** — `wait\1` correctly defers the rest of the chain by one tick. `wait\0` is a no-op. - **Root alias resolution in deferred chain** — `getFirst()` → `getLast()` so the deferred chain drain walks aliases from the innermost caller outward. - **Log tag rename** — `[runAlias]` → `[builtinRunAlias]` in log messages. - **CFG autoload uses `UserAlias` for runAlias lines** — fixes chaining syntax support in autoloaded `runAlias` entries.

### Fixed - **WaitAlias deferred chain: `;` → ` ` replacement for greedy-string aliases** — `AliasAlias`, `BindAlias`, and `UnbindAlias` use `;` as their definition divider. When their args are reconstructed in a `wait`-deferred chain, the `;` divider is now replaced with ` ` instead of quoting. - **`wait\1` now defers to next tick; `wait\0` → NOP** — `wait\1` correctly defers the rest of the chain by one tick. `wait\0` is a no-op. - **Root alias resolution in deferred chain** — `getFirst()` → `getLast()` so the deferred chain drain walks aliases from the innermost caller outward. - **Log tag rename** — `[runAlias]` → `[builtinRunAlias]` in log messages. - **CFG autoload uses `UserAlias` for runAlias lines** — fixes chaining syntax support in autoloaded `runAlias` entries.

### Added - **cN container slot source for var alias** — var\name\c3 now stores the container slot number, and swapSlot resolves such variables as container slot references. cN literal args in swapSlot still take priority over same-named variables.

### Added - **cN container slot source for var alias** — var\name\c3 now stores the container slot number, and swapSlot resolves such variables as container slot references. cN literal args in swapSlot still take priority over same-named variables.

### Added - **cN container slot source for var alias** — var\name\c3 now stores the container slot number, and swapSlot resolves such variables as container slot references. cN literal args in swapSlot still take priority over same-named variables.

### Added - **cN container slot source for var alias** — var\name\c3 now stores the container slot number, and swapSlot resolves such variables as container slot references. cN literal args in swapSlot still take priority over same-named variables.

## What's New ### freeCursor hover-pin to slot 14 While `freeCursor` is active, the hovered slot on container screens (chests, furnaces, inventory, etc.) is now pinned to the player-inventory slot 14 (container index 13). This makes `+drop` and swap operations target a deterministic slot regardless of where the OS cursor rests — enabling reliable container-screen automation from alias chains. **Technical**: Added `AbstractContainerScreenMixin` (MC 26.x) / `HandledScreenMixin` (MC 1.21.x) that overrides the hover-slot computation when `freeCursor` is active. ## Supported MC Versions | JAR | Minecraft | |---|---| | `+mc26.2` | 26.1.2 – 26.2 | | `+mc26.1.1` | 26.1 – 26.1.1 | | `+mc1.21.11` | 1.21.9 – 1.21.11 | | `+mc1.21.8` | 1.21 – 1.21.8 | **Full Changelog**: https://github.com/Prohect/BindAliasPlus/blob/26.1.2_26.2/CHANGELOG.md

## What's New ### freeCursor hover-pin to slot 14 While `freeCursor` is active, the hovered slot on container screens (chests, furnaces, inventory, etc.) is now pinned to the player-inventory slot 14 (container index 13). This makes `+drop` and swap operations target a deterministic slot regardless of where the OS cursor rests — enabling reliable container-screen automation from alias chains. **Technical**: Added `AbstractContainerScreenMixin` (MC 26.x) / `HandledScreenMixin` (MC 1.21.x) that overrides the hover-slot computation when `freeCursor` is active. ## Supported MC Versions | JAR | Minecraft | |---|---| | `+mc26.2` | 26.1.2 – 26.2 | | `+mc26.1.1` | 26.1 – 26.1.1 | | `+mc1.21.11` | 1.21.9 – 1.21.11 | | `+mc1.21.8` | 1.21 – 1.21.8 | **Full Changelog**: https://github.com/Prohect/BindAliasPlus/blob/26.1.2_26.2/CHANGELOG.md

## What's New ### freeCursor hover-pin to slot 14 While `freeCursor` is active, the hovered slot on container screens (chests, furnaces, inventory, etc.) is now pinned to the player-inventory slot 14 (container index 13). This makes `+drop` and swap operations target a deterministic slot regardless of where the OS cursor rests — enabling reliable container-screen automation from alias chains. **Technical**: Added `AbstractContainerScreenMixin` (MC 26.x) / `HandledScreenMixin` (MC 1.21.x) that overrides the hover-slot computation when `freeCursor` is active. ## Supported MC Versions | JAR | Minecraft | |---|---| | `+mc26.2` | 26.1.2 – 26.2 | | `+mc26.1.1` | 26.1 – 26.1.1 | | `+mc1.21.11` | 1.21.9 – 1.21.11 | | `+mc1.21.8` | 1.21 – 1.21.8 | **Full Changelog**: https://github.com/Prohect/BindAliasPlus/blob/26.1.2_26.2/CHANGELOG.md

## What's New ### freeCursor hover-pin to slot 14 While `freeCursor` is active, the hovered slot on container screens (chests, furnaces, inventory, etc.) is now pinned to the player-inventory slot 14 (container index 13). This makes `+drop` and swap operations target a deterministic slot regardless of where the OS cursor rests — enabling reliable container-screen automation from alias chains. **Technical**: Added `AbstractContainerScreenMixin` (MC 26.x) / `HandledScreenMixin` (MC 1.21.x) that overrides the hover-slot computation when `freeCursor` is active. ## Supported MC Versions | JAR | Minecraft | |---|---| | `+mc26.2` | 26.1.2 – 26.2 | | `+mc26.1.1` | 26.1 – 26.1.1 | | `+mc1.21.11` | 1.21.9 – 1.21.11 | | `+mc1.21.8` | 1.21 – 1.21.8 | **Full Changelog**: https://github.com/Prohect/BindAliasPlus/blob/26.1.2_26.2/CHANGELOG.md

### Fixed - **WriteCFG endpoint truncates JSON bodies at escaped quotes** — the naive body parser stopped at the first escaped quote instead of honoring JSON string escapes, corrupting any cfg that contained quoted alias args (e.g. `say"..."`, `sendCommand"..."`). Now uses an escape-aware single-pass string extractor. - **Mod logs not reaching `latest.log` after world join** — the `ChatCapture` Log4j appender registered its child `LoggerConfig` inheriting the ROOT's `additivity=false`, which swallowed every `bind-alias-plus` log line after the capture appender was installed on world join. Now registers it with `additive=true` so normal console/file output keeps flowing alongside the capture buffer.

### Fixed - **WriteCFG endpoint truncates JSON bodies at escaped quotes** — the naive body parser stopped at the first escaped quote instead of honoring JSON string escapes, corrupting any cfg that contained quoted alias args (e.g. `say"..."`, `sendCommand"..."`). Now uses an escape-aware single-pass string extractor. - **Mod logs not reaching `latest.log` after world join** — the `ChatCapture` Log4j appender registered its child `LoggerConfig` inheriting the ROOT's `additivity=false`, which swallowed every `bind-alias-plus` log line after the capture appender was installed on world join. Now registers it with `additive=true` so normal console/file output keeps flowing alongside the capture buffer.

### Fixed - **WriteCFG endpoint truncates JSON bodies at escaped quotes** — the naive body parser stopped at the first escaped quote instead of honoring JSON string escapes, corrupting any cfg that contained quoted alias args (e.g. `say"..."`, `sendCommand"..."`). Now uses an escape-aware single-pass string extractor. - **Mod logs not reaching `latest.log` after world join** — the `ChatCapture` Log4j appender registered its child `LoggerConfig` inheriting the ROOT's `additivity=false`, which swallowed every `bind-alias-plus` log line after the capture appender was installed on world join. Now registers it with `additive=true` so normal console/file output keeps flowing alongside the capture buffer.

### Fixed - **WriteCFG endpoint truncates JSON bodies at escaped quotes** — the naive body parser stopped at the first escaped quote instead of honoring JSON string escapes, corrupting any cfg that contained quoted alias args (e.g. `say"..."`, `sendCommand"..."`). Now uses an escape-aware single-pass string extractor. - **Mod logs not reaching `latest.log` after world join** — the `ChatCapture` Log4j appender registered its child `LoggerConfig` inheriting the ROOT's `additivity=false`, which swallowed every `bind-alias-plus` log line after the capture appender was installed on world join. Now registers it with `additive=true` so normal console/file output keeps flowing alongside the capture buffer.

### Fixed - **freeCursor mining survives screen opens and focus loss** — overrides isMouseGrabbed() / isCursorLocked() to always return true while freeCursor is active, so the vanilla hold-to-mine guard (continueAttack / handleBlockBreaking) no longer resets block breaking progress when a screen opens or the game window loses focus.

### Fixed - **freeCursor mining survives screen opens and focus loss** — overrides isMouseGrabbed() / isCursorLocked() to always return true while freeCursor is active, so the vanilla hold-to-mine guard (continueAttack / handleBlockBreaking) no longer resets block breaking progress when a screen opens or the game window loses focus.

### Fixed - **freeCursor mining survives screen opens and focus loss** — overrides isMouseGrabbed() / isCursorLocked() to always return true while freeCursor is active, so the vanilla hold-to-mine guard (continueAttack / handleBlockBreaking) no longer resets block breaking progress when a screen opens or the game window loses focus.

### Fixed - **freeCursor mining survives screen opens and focus loss** — overrides isMouseGrabbed() / isCursorLocked() to always return true while freeCursor is active, so the vanilla hold-to-mine guard (continueAttack / handleBlockBreaking) no longer resets block breaking progress when a screen opens or the game window loses focus.

### Fixed - **`freeCursor` no longer breaks hold-to-mine** — the game now keeps its logical "cursor grabbed" state while only the OS-level grab is skipped, so continuous block breaking (`continueAttack`) works with a free host cursor. Physical mouse movement still never rotates the camera while active, and disabling `freeCursor` cleanly restores the real grab.

### Fixed - **`freeCursor` no longer breaks hold-to-mine** — the game now keeps its logical "cursor grabbed" state while only the OS-level grab is skipped, so continuous block breaking (`continueAttack`) works with a free host cursor. Physical mouse movement still never rotates the camera while active, and disabling `freeCursor` cleanly restores the real grab.

### Fixed - **`freeCursor` no longer breaks hold-to-mine** — the game now keeps its logical "cursor grabbed" state while only the OS-level grab is skipped, so continuous block breaking (`continueAttack`) works with a free host cursor. Physical mouse movement still never rotates the camera while active, and disabling `freeCursor` cleanly restores the real grab.

### Fixed - **`freeCursor` no longer breaks hold-to-mine** — the game now keeps its logical "cursor grabbed" state while only the OS-level grab is skipped, so continuous block breaking (`continueAttack`) works with a free host cursor. Physical mouse movement still never rotates the camera while active, and disabling `freeCursor` cleanly restores the real grab.

### Added - **Player position in `getScreenshot`** — screenshot response now includes `x`, `y`, `z`, `yaw`, `pitch` fields (2 decimal places), captured on the same main-thread roundtrip as the screenshot trigger for zero extra latency

### Added - **Player position in `getScreenshot`** — screenshot response now includes `x`, `y`, `z`, `yaw`, `pitch` fields (2 decimal places), captured on the same main-thread roundtrip as the screenshot trigger for zero extra latency

### Added - **Player position in `getScreenshot`** — screenshot response now includes `x`, `y`, `z`, `yaw`, `pitch` fields (2 decimal places), captured on the same main-thread roundtrip as the screenshot trigger for zero extra latency

### Added - **Player position in `getScreenshot`** — screenshot response now includes `x`, `y`, `z`, `yaw`, `pitch` fields (2 decimal places), captured on the same main-thread roundtrip as the screenshot trigger for zero extra latency

## [1.5.0] - 2026-07-25 ### Added - **`getLogDiff` MCP tool** — game log diff for AI agents: - Captures mod log output (`log\...` alias, CFG autoload, variable setup) via scoped Log4j appender on `"bind-alias-plus"` logger - Captures chat messages (player chat, system messages, command feedback) via `ChatComponentMixin` - Persistent ring buffer (200 msg) with diff cursor tracking — returns only new messages since last call - Log capture starts at world join, diff resets on each join to skip startup noise - `GET /logDiff` endpoint in `McpHttpServer`

## [1.5.0] - 2026-07-25 ### Added - **`getLogDiff` MCP tool** — game log diff for AI agents: - Captures mod log output (`log\...` alias, CFG autoload, variable setup) via scoped Log4j appender on `"bind-alias-plus"` logger - Captures chat messages (player chat, system messages, command feedback) via `ChatComponentMixin` - Persistent ring buffer (200 msg) with diff cursor tracking — returns only new messages since last call - Log capture starts at world join, diff resets on each join to skip startup noise - `GET /logDiff` endpoint in `McpHttpServer`

## [1.5.0] - 2026-07-25 ### Added - **`getLogDiff` MCP tool** — game log diff for AI agents: - Captures mod log output (`log\...` alias, CFG autoload, variable setup) via scoped Log4j appender on `"bind-alias-plus"` logger - Captures chat messages (player chat, system messages, command feedback) via `ChatComponentMixin` - Persistent ring buffer (200 msg) with diff cursor tracking — returns only new messages since last call - Log capture starts at world join, diff resets on each join to skip startup noise - `GET /logDiff` endpoint in `McpHttpServer`

## [1.5.0] - 2026-07-25 ### Added - **`getLogDiff` MCP tool** — game log diff for AI agents: - Captures mod log output (`log\...` alias, CFG autoload, variable setup) via scoped Log4j appender on `"bind-alias-plus"` logger - Captures chat messages (player chat, system messages, command feedback) via `ChatComponentMixin` - Persistent ring buffer (200 msg) with diff cursor tracking — returns only new messages since last call - Log capture starts at world join, diff resets on each join to skip startup noise - `GET /logDiff` endpoint in `McpHttpServer`

## [1.4.0] - 2026-07-25 ### Added - **MCP HTTP server** (`McpHttpServer.java`) — in-game HTTP API for AI agent control: - `GET /state` — player position, health, held item, dimension, open container contents (compressed) - `GET /screenshot` — in-memory PNG screenshot via native `Screenshot.grab()` (no chat spam) - `POST /runAlias` — execute alias chains remotely (pre-checks alias existence, returns error for unknowns) - `POST /defineAlias` — define new aliases via API - `GET /readCFG` / `POST /writeCFG` — read/write `bind-alias-plus.cfg` remotely - **`swapSlot` expanded to any container screen** — works in chests, crafting tables, furnaces, anvils, enchanting tables, and all other `AbstractContainerScreen` subtypes. - New `cN` slot syntax (1-based index into the open menu's slot list) alongside existing player slots 1–41 and variables. - Hotbar/offhand-addressable slots use a single SWAP click; other pairs use a guarded PICKUP sequence. - Take-only result slots (crafting output, furnace output, anvil output) behave as "take result", enabling craft/forge/enchant automation from alias chains. - **MCP `/state` container compression** — open container view with occupied slots as `{index,item,count}`, empty inventory slots as `1-41` ranges, and container slots as an ASCII grid map with per-cell `c`-indices. Sections over 6000 chars are truncated with a screenshot hint. - **MCP chat capture** — `ChatComponentMixin` records incoming chat messages for agent consumption. - **MCP screenshot capture** — `NativeImageMixin` enables in-memory PNG screenshots without file I/O. - **Predefined (protected) user aliases** — bundled aliases that ship with the mod and cannot be overwritten by users. ### Fixed - **`toggleInventory`** — corrected builtin name casing (was registered as `toggleinventory`). ### Changed - **MCP `/state`** — compressed output format for reduced token usage by AI agents. ### Notes - **`swapSlot` container slots (`cN`)**: When swapping a container slot with a hotbar/offhand slot, vanilla's `SWAP` click is used. If the container slot is input-restricted (furnace fuel only accepts fuel, result slots accept nothing, etc.) and the hotbar item is incompatible, the entire swap is silently rejected by the server — neither item moves. Use an empty hotbar slot or the PICKUP fallback (swap with a non-hotbar inventory slot `10`-`36`) to take items from restricted slots. Swapping with an empty slot always works.

## [1.4.0] - 2026-07-25 ### Added - **MCP HTTP server** (`McpHttpServer.java`) — in-game HTTP API for AI agent control: - `GET /state` — player position, health, held item, dimension, open container contents (compressed) - `GET /screenshot` — in-memory PNG screenshot via native `Screenshot.grab()` (no chat spam) - `POST /runAlias` — execute alias chains remotely (pre-checks alias existence, returns error for unknowns) - `POST /defineAlias` — define new aliases via API - `GET /readCFG` / `POST /writeCFG` — read/write `bind-alias-plus.cfg` remotely - **`swapSlot` expanded to any container screen** — works in chests, crafting tables, furnaces, anvils, enchanting tables, and all other `AbstractContainerScreen` subtypes. - New `cN` slot syntax (1-based index into the open menu's slot list) alongside existing player slots 1–41 and variables. - Hotbar/offhand-addressable slots use a single SWAP click; other pairs use a guarded PICKUP sequence. - Take-only result slots (crafting output, furnace output, anvil output) behave as "take result", enabling craft/forge/enchant automation from alias chains. - **MCP `/state` container compression** — open container view with occupied slots as `{index,item,count}`, empty inventory slots as `1-41` ranges, and container slots as an ASCII grid map with per-cell `c`-indices. Sections over 6000 chars are truncated with a screenshot hint. - **MCP chat capture** — `ChatComponentMixin` records incoming chat messages for agent consumption. - **MCP screenshot capture** — `NativeImageMixin` enables in-memory PNG screenshots without file I/O. - **Predefined (protected) user aliases** — bundled aliases that ship with the mod and cannot be overwritten by users. ### Fixed - **`toggleInventory`** — corrected builtin name casing (was registered as `toggleinventory`). ### Changed - **MCP `/state`** — compressed output format for reduced token usage by AI agents. ### Notes - **`swapSlot` container slots (`cN`)**: When swapping a container slot with a hotbar/offhand slot, vanilla's `SWAP` click is used. If the container slot is input-restricted (furnace fuel only accepts fuel, result slots accept nothing, etc.) and the hotbar item is incompatible, the entire swap is silently rejected by the server — neither item moves. Use an empty hotbar slot or the PICKUP fallback (swap with a non-hotbar inventory slot `10`-`36`) to take items from restricted slots. Swapping with an empty slot always works.

## [1.4.0] - 2026-07-25 ### Added - **MCP HTTP server** (`McpHttpServer.java`) — in-game HTTP API for AI agent control: - `GET /state` — player position, health, held item, dimension, open container contents (compressed) - `GET /screenshot` — in-memory PNG screenshot via native `Screenshot.grab()` (no chat spam) - `POST /runAlias` — execute alias chains remotely (pre-checks alias existence, returns error for unknowns) - `POST /defineAlias` — define new aliases via API - `GET /readCFG` / `POST /writeCFG` — read/write `bind-alias-plus.cfg` remotely - **`swapSlot` expanded to any container screen** — works in chests, crafting tables, furnaces, anvils, enchanting tables, and all other `AbstractContainerScreen` subtypes. - New `cN` slot syntax (1-based index into the open menu's slot list) alongside existing player slots 1–41 and variables. - Hotbar/offhand-addressable slots use a single SWAP click; other pairs use a guarded PICKUP sequence. - Take-only result slots (crafting output, furnace output, anvil output) behave as "take result", enabling craft/forge/enchant automation from alias chains. - **MCP `/state` container compression** — open container view with occupied slots as `{index,item,count}`, empty inventory slots as `1-41` ranges, and container slots as an ASCII grid map with per-cell `c`-indices. Sections over 6000 chars are truncated with a screenshot hint. - **MCP chat capture** — `ChatComponentMixin` records incoming chat messages for agent consumption. - **MCP screenshot capture** — `NativeImageMixin` enables in-memory PNG screenshots without file I/O. - **Predefined (protected) user aliases** — bundled aliases that ship with the mod and cannot be overwritten by users. ### Fixed - **`toggleInventory`** — corrected builtin name casing (was registered as `toggleinventory`). ### Changed - **MCP `/state`** — compressed output format for reduced token usage by AI agents. ### Notes - **`swapSlot` container slots (`cN`)**: When swapping a container slot with a hotbar/offhand slot, vanilla's `SWAP` click is used. If the container slot is input-restricted (furnace fuel only accepts fuel, result slots accept nothing, etc.) and the hotbar item is incompatible, the entire swap is silently rejected by the server — neither item moves. Use an empty hotbar slot or the PICKUP fallback (swap with a non-hotbar inventory slot `10`-`36`) to take items from restricted slots. Swapping with an empty slot always works.

## [1.4.0] - 2026-07-25 ### Added - **MCP HTTP server** (`McpHttpServer.java`) — in-game HTTP API for AI agent control: - `GET /state` — player position, health, held item, dimension, open container contents (compressed) - `GET /screenshot` — in-memory PNG screenshot via native `Screenshot.grab()` (no chat spam) - `POST /runAlias` — execute alias chains remotely (pre-checks alias existence, returns error for unknowns) - `POST /defineAlias` — define new aliases via API - `GET /readCFG` / `POST /writeCFG` — read/write `bind-alias-plus.cfg` remotely - **`swapSlot` expanded to any container screen** — works in chests, crafting tables, furnaces, anvils, enchanting tables, and all other `AbstractContainerScreen` subtypes. - New `cN` slot syntax (1-based index into the open menu's slot list) alongside existing player slots 1–41 and variables. - Hotbar/offhand-addressable slots use a single SWAP click; other pairs use a guarded PICKUP sequence. - Take-only result slots (crafting output, furnace output, anvil output) behave as "take result", enabling craft/forge/enchant automation from alias chains. - **MCP `/state` container compression** — open container view with occupied slots as `{index,item,count}`, empty inventory slots as `1-41` ranges, and container slots as an ASCII grid map with per-cell `c`-indices. Sections over 6000 chars are truncated with a screenshot hint. - **MCP chat capture** — `ChatComponentMixin` records incoming chat messages for agent consumption. - **MCP screenshot capture** — `NativeImageMixin` enables in-memory PNG screenshots without file I/O. - **Predefined (protected) user aliases** — bundled aliases that ship with the mod and cannot be overwritten by users. ### Fixed - **`toggleInventory`** — corrected builtin name casing (was registered as `toggleinventory`). ### Changed - **MCP `/state`** — compressed output format for reduced token usage by AI agents. ### Notes - **`swapSlot` container slots (`cN`)**: When swapping a container slot with a hotbar/offhand slot, vanilla's `SWAP` click is used. If the container slot is input-restricted (furnace fuel only accepts fuel, result slots accept nothing, etc.) and the hotbar item is incompatible, the entire swap is silently rejected by the server — neither item moves. Use an empty hotbar slot or the PICKUP fallback (swap with a non-hotbar inventory slot `10`-`36`) to take items from restricted slots. Swapping with an empty slot always works.

## Added - **`+screenshot` / `-screenshot` alias** — captures screenshots via the vanilla screenshot key. - **`+playerList` / `-playerList` alias** — holds/releases the Tab key to show the online-player overlay. - **`+freeCursor` / `-freeCursor` alias** — cancels mouse grab/lock for unrestricted cursor movement (hidden from suggestions). - **`esc` / `closeScreen` alias** — closes the current screen (`\0`) or toggles pause (`\1`). - **`+advancements` / `-advancements` alias** — holds/releases the advancements screen key. - **`+debugOverlay` / `-debugOverlay` alias** — toggles the F3 debug overlay. ## Changed - **Screen tracking** moved from GuiMixin to MinecraftClientMixin.tick for cross-version compatibility. - **fabric.mod.json** version ranges widened for better compatibility. ## Fixed - **SwapSlotAlias** getSelectedSlot() → selectedSlot field on 1.21–1.21.8 for compatibility.

## Added - **`+screenshot` / `-screenshot` alias** — captures screenshots via the vanilla screenshot key. - **`+playerList` / `-playerList` alias** — holds/releases the Tab key to show the online-player overlay. - **`+freeCursor` / `-freeCursor` alias** — cancels mouse grab/lock for unrestricted cursor movement (hidden from suggestions). - **`esc` / `closeScreen` alias** — closes the current screen (`\0`) or toggles pause (`\1`). - **`+advancements` / `-advancements` alias** — holds/releases the advancements screen key. - **`+debugOverlay` / `-debugOverlay` alias** — toggles the F3 debug overlay. ## Changed - **Screen tracking** moved from GuiMixin to MinecraftClientMixin.tick for cross-version compatibility. - **fabric.mod.json** version ranges widened for better compatibility. ## Fixed - **SwapSlotAlias** getSelectedSlot() → selectedSlot field on 1.21–1.21.8 for compatibility.

## Added - **`+screenshot` / `-screenshot` alias** — captures screenshots via the vanilla screenshot key. - **`+playerList` / `-playerList` alias** — holds/releases the Tab key to show the online-player overlay. - **`+freeCursor` / `-freeCursor` alias** — cancels mouse grab/lock for unrestricted cursor movement (hidden from suggestions). - **`esc` / `closeScreen` alias** — closes the current screen (`\0`) or toggles pause (`\1`). - **`+advancements` / `-advancements` alias** — holds/releases the advancements screen key. - **`+debugOverlay` / `-debugOverlay` alias** — toggles the F3 debug overlay. ## Changed - **Screen tracking** moved from GuiMixin to MinecraftClientMixin.tick for cross-version compatibility. - **fabric.mod.json** version ranges widened for better compatibility. ## Fixed - **SwapSlotAlias** getSelectedSlot() → selectedSlot field on 1.21–1.21.8 for compatibility.

## Added - **`+screenshot` / `-screenshot` alias** — captures screenshots via the vanilla screenshot key. - **`+playerList` / `-playerList` alias** — holds/releases the Tab key to show the online-player overlay. - **`+freeCursor` / `-freeCursor` alias** — cancels mouse grab/lock for unrestricted cursor movement (hidden from suggestions). - **`esc` / `closeScreen` alias** — closes the current screen (`\0`) or toggles pause (`\1`). - **`+advancements` / `-advancements` alias** — holds/releases the advancements screen key. - **`+debugOverlay` / `-debugOverlay` alias** — toggles the F3 debug overlay. ## Changed - **Screen tracking** moved from GuiMixin to MinecraftClientMixin.tick for cross-version compatibility. - **fabric.mod.json** version ranges widened for better compatibility. ## Fixed - **SwapSlotAlias** getSelectedSlot() → selectedSlot field on 1.21–1.21.8 for compatibility.

### Fixed - **Text input guards** — `swapHand`, `use`, and `pickItem` aliases now cancel when the player is typing in chat, signs, books, or command blocks, preventing accidental game actions while typing.

### Fixed - **Text input guards** — `swapHand`, `use`, and `pickItem` aliases now cancel when the player is typing in chat, signs, books, or command blocks, preventing accidental game actions while typing.

### Fixed - **Text input guards** — `swapHand`, `use`, and `pickItem` aliases now cancel when the player is typing in chat, signs, books, or command blocks, preventing accidental game actions while typing.

### Fixed - **Text input guards** — `swapHand`, `use`, and `pickItem` aliases now cancel when the player is typing in chat, signs, books, or command blocks, preventing accidental game actions while typing.

### Added - **`toggleinventory` alias** — toggles the player inventory open/closed. Opens the inventory screen if no screen is active; closes any container screen (chest, furnace, etc.) if one is open.

### Added - **`toggleinventory` alias** — toggles the player inventory open/closed. Opens the inventory screen if no screen is active; closes any container screen (chest, furnace, etc.) if one is open.

### Added - **`toggleinventory` alias** — toggles the player inventory open/closed. Opens the inventory screen if no screen is active; closes any container screen (chest, furnace, etc.) if one is open.

### Added - **`toggleinventory` alias** — toggles the player inventory open/closed. Opens the inventory screen if no screen is active; closes any container screen (chest, furnace, etc.) if one is open.

### Fixed - **`-openInventory`** now closes any container screen (chests, furnaces, etc.), not just the player inventory or creative inventory screens. ### Changed - **CI** — added GitHub Actions workflow to auto-publish releases to Modrinth. - Removed TODO.md from the repository.

### Fixed - **`-openInventory`** now closes any container screen (chests, furnaces, etc.), not just the player inventory or creative inventory screens. ### Changed - **CI** — added GitHub Actions workflow to auto-publish releases to Modrinth. - Removed TODO.md from the repository.

### Fixed - **`-openInventory`** now closes any container screen (chests, furnaces, etc.), not just the player inventory or creative inventory screens. ### Changed - **CI** — added GitHub Actions workflow to auto-publish releases to Modrinth. - Removed TODO.md from the repository.

### Fixed - **`-openInventory`** now closes any container screen (chests, furnaces, etc.), not just the player inventory or creative inventory screens. ### Changed - **CI** — added GitHub Actions workflow to auto-publish releases to Modrinth. - Removed TODO.md from the repository.

## Changes ### Added - **Continuous container drop** — +drop now continuously drops items in inventory/container screens while held - **Continuous 3D-game drop** — held +drop continuously drops in the 3D game via tick-driven clickCount - **Initial delay before continuous drops** (3 ticks) to match the OS key-repeat gap

## Changes ### Added - **Continuous container drop** — +drop now continuously drops items in inventory/container screens while held - **Continuous 3D-game drop** — held +drop continuously drops in the 3D game via tick-driven clickCount - **Initial delay before continuous drops** (3 ticks) to match the OS key-repeat gap

## Changes ### Added - **Continuous container drop** — +drop now continuously drops items in inventory/container screens while held - **Continuous 3D-game drop** — held +drop continuously drops in the 3D game via tick-driven clickCount - **Initial delay before continuous drops** (3 ticks) to match the OS key-repeat gap

## Changes ### Added - **Continuous container drop** — +drop now continuously drops items in inventory/container screens while held - **Continuous 3D-game drop** — held +drop continuously drops in the 3D game via tick-driven clickCount - **Initial delay before continuous drops** (3 ticks) to match the OS key-repeat gap

### Added - **reapply alias** — new `reapply\action` builtin to manually re-assert a held-down boolean alias at the end of a UserAlias sequence (e.g., after a screen transition). - **pickItem alias** — triggers vanilla pick-block behavior via key mapping. - **openInventory alias** — opens/closes the inventory screen via `+openInventory`/`-openInventory` (boolean alias pattern). ### Changed - **drop/dropStack → +drop/-drop** — drop alias now uses the vanilla key-mapping system (`KeyMapping.setDown`) instead of directly calling `player.drop()`. Renamed to follow the + / - press/release convention used by other boolean aliases. ### Removed - **KeyMappingMixin** — the automatic reapply-after-releaseAll mixin is removed. Use the explicit `reapply\action` alias instead for more predictable behavior.

### Added - **reapply alias** — new `reapply\action` builtin to manually re-assert a held-down boolean alias at the end of a UserAlias sequence (e.g., after a screen transition). - **pickItem alias** — triggers vanilla pick-block behavior via key mapping. - **openInventory alias** — opens/closes the inventory screen via `+openInventory`/`-openInventory` (boolean alias pattern). ### Changed - **drop/dropStack → +drop/-drop** — drop alias now uses the vanilla key-mapping system (`KeyMapping.setDown`) instead of directly calling `player.drop()`. Renamed to follow the + / - press/release convention used by other boolean aliases. ### Removed - **KeyMappingMixin** — the automatic reapply-after-releaseAll mixin is removed. Use the explicit `reapply\action` alias instead for more predictable behavior.

### Added - **reapply alias** — new `reapply\action` builtin to manually re-assert a held-down boolean alias at the end of a UserAlias sequence (e.g., after a screen transition). - **pickItem alias** — triggers vanilla pick-block behavior via key mapping. - **openInventory alias** — opens/closes the inventory screen via `+openInventory`/`-openInventory` (boolean alias pattern). ### Changed - **drop/dropStack → +drop/-drop** — drop alias now uses the vanilla key-mapping system (`KeyMapping.setDown`) instead of directly calling `player.drop()`. Renamed to follow the + / - press/release convention used by other boolean aliases. ### Removed - **KeyMappingMixin** — the automatic reapply-after-releaseAll mixin is removed. Use the explicit `reapply\action` alias instead for more predictable behavior.

### Added - **reapply alias** — new `reapply\action` builtin to manually re-assert a held-down boolean alias at the end of a UserAlias sequence (e.g., after a screen transition). - **pickItem alias** — triggers vanilla pick-block behavior via key mapping. - **openInventory alias** — opens/closes the inventory screen via `+openInventory`/`-openInventory` (boolean alias pattern). ### Changed - **drop/dropStack → +drop/-drop** — drop alias now uses the vanilla key-mapping system (`KeyMapping.setDown`) instead of directly calling `player.drop()`. Renamed to follow the + / - press/release convention used by other boolean aliases. ### Removed - **KeyMappingMixin** — the automatic reapply-after-releaseAll mixin is removed. Use the explicit `reapply\action` alias instead for more predictable behavior.

## v1.2.8 ### Added - **Immediate reapply after `releaseAll`** — `SneakAlias` (and any `BuiltinAliasWithBooleanArgs` that opts in) now reapplies its key state instantly when the game calls `KeyBinding.unpressAll()`, preventing a 1-tick gap that could cause the player to fall when opening inventory while sneaking on a ledge. ### Fixed - **Lock alias GL error** — `LockAlias` no longer uses `Integer.MIN_VALUE` as the placeholder key code, which was outside GLFW's valid range and spammed `GLFW_INVALID_VALUE (65539): Invalid key -2147483648` to the render log. Now uses `InputUtil.UNKNOWN_KEY` (GLFW_KEY_UNKNOWN = -1) which is handled gracefully by both GLFW and Minecraft. --- Full changelog: [CHANGELOG.md](https://github.com/Prohect/BindAliasPlus/blob/26.1_26.1.1/CHANGELOG.md)

## [1.2.7] - 2026-06-27 ### Changed - **Lock aliases renamed** — `+lock`/`-lock` → `+lockKey`/`-lockKey` for clarity. - **Action suggestions prefixed** — vanilla game keys now suggested as `gameKey:attack`, `gameKey:forward`, etc. to avoid naming conflicts with custom UserAliases. ### Added - **Custom alias locking** — `+lockKey\myAlias` now locks all physical keys bound to any UserAlias, preventing keyboard/mouse input from triggering it while still allowing `/runAlias` to invoke it. - `+lockKey`/`-lockKey` unified: if the argument is a known `gameKey:*` action, it locks the vanilla key; otherwise it locks by alias name. ---

## v1.2.6 ### Added - `localSay` alias — displays chat message on the local client only, without sending it to the server. Useful for testing, notifications, and debug output. ### Fixed - `SwapSlotAlias`: guard against opening the inventory screen when another screen is already active, preventing unexpected behavior. ### Supported MC versions | JAR | MC Range | |---|---| | `bind-alias-plus-1.2.6-mc1.21_1.21.3.jar` | 1.21 – 1.21.3 | | `bind-alias-plus-1.2.6-mc1.21.4.jar` | 1.21.4 | | `bind-alias-plus-1.2.6-mc1.21.5_1.21.8.jar` | 1.21.5 – 1.21.8 | | `bind-alias-plus-1.2.6-mc1.21.9_1.21.11.jar` | 1.21.9 – 1.21.11 | | `bind-alias-plus-1.2.6-mc26.1_26.1.1.jar` | 26.1 – 26.1.1 | | `bind-alias-plus-1.2.6-mc26.1.2_26.2.jar` | 26.1.2 – 26.2 |

### Screen state tracking - Added `isUnderTextInputScreen` and `isUnderAnyScreen` atomic flags synced via `GuiMixin` (or `MinecraftClientMixin` on 1.21.x) hooking into `setScreen()`. Eliminates scattered `instanceof` checks across mixins.

bugfix

bugfix

### Variable name suggestions - Aliases that accept numeric args (`slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch`) now suggest variable names from `VarAlias` during command completion. - Integer-only aliases filter out `Double`-typed variables.

### Variable name suggestions - Aliases that accept numeric args (`slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch`) now suggest variable names from `VarAlias` during command completion. - Integer-only aliases filter out `Double`-typed variables.

### Variable name suggestions - Aliases that accept numeric args (`slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch`) now suggest variable names from `VarAlias` during command completion. - Integer-only aliases filter out `Double`-typed variables.

### Variable name suggestions - Aliases that accept numeric args (`slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch`) now suggest variable names from `VarAlias` during command completion. - Integer-only aliases filter out `Double`-typed variables.

### Variable name suggestions - Aliases that accept numeric args (`slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch`) now suggest variable names from `VarAlias` during command completion. - Integer-only aliases filter out `Double`-typed variables.

Extend var system: support float/double, add pitch/yaw sources, resolve vars in numeric aliases

Extend var system: support float/double, add pitch/yaw sources, resolve vars in numeric aliases

Extend var system: support float/double, add pitch/yaw sources, resolve vars in numeric aliases

Extend var system: support float/double, add pitch/yaw sources, resolve vars in numeric aliases

Extend var system: support float/double, add pitch/yaw sources, resolve vars in numeric aliases

1.21.9_1.21.11` — v1.2.0 (from v1.1.1) ### 🔒 Lock Aliases - `+lock:<action>` / `-lock:<action>` — temporarily block physical key input during alias sequences - Supported actions: `attack`, `use`, `forward`, `back`, `left`, `right`, `jump`, `sneak`, `sprint` - Prevents user input from interfering with automated alias execution - Works for both vanilla keybinds and mod-bound keys ### 🐛 Bug Fixes - Fixed `UNKNOWN_KEY` collision when unbinding vanilla keys (no longer triggers wrong bindings like Toggle Cinematic Camera) - Lock now correctly blocks mod-bound keys in addition to vanilla keybinds

1.21_1.21.3` / `1.21.4` / `1.21.5_1.21.8` — v1.2.0 (from v1.0.4) ### 🔒 Lock Aliases (new in v1.2.0) - `+lock:<action>` / `-lock:<action>` — temporarily block physical key input during alias sequences - Supported actions: `attack`, `use`, `forward`, `back`, `left`, `right`, `jump`, `sneak`, `sprint` - Prevents user input from interfering with automated alias execution - Works for both vanilla keybinds and mod-bound keys ### 📦 Variable System (new in v1.1.0) - `/var <name> <source>` — store values from game state into named variables - Sources: `hotbarSlot`, `itemsOfSlot0-9`, or literal numbers - Use variable names anywhere a number is expected (e.g. `slot\mySlot`) - Variable references supported in: `slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch` ### 🎥 Perspective Aliases (new in v1.1.0) - `cyclePerspective` — cycle between first-person / third-person back / third-person front - `FPS` / `TPS` / `TPS2` — directly set perspective (first-person, third-person, third-person front) ### 🔄 Config Management (new in v1.1.0) - `/unloadCFGAliases` — remove all config-loaded aliases at runtime - `/unloadCFGBinds` — remove all config-loaded keybindings - `/unloadCFGVars` — remove all config-loaded variables - `/unloadCFGAll` — remove all config-loaded items at once - Autoload tracking: runtime-created aliases/binds/vars survive `/reloadCFG

1.21_1.21.3` / `1.21.4` / `1.21.5_1.21.8` — v1.2.0 (from v1.0.4) ### 🔒 Lock Aliases (new in v1.2.0) - `+lock:<action>` / `-lock:<action>` — temporarily block physical key input during alias sequences - Supported actions: `attack`, `use`, `forward`, `back`, `left`, `right`, `jump`, `sneak`, `sprint` - Prevents user input from interfering with automated alias execution - Works for both vanilla keybinds and mod-bound keys ### 📦 Variable System (new in v1.1.0) - `/var <name> <source>` — store values from game state into named variables - Sources: `hotbarSlot`, `itemsOfSlot0-9`, or literal numbers - Use variable names anywhere a number is expected (e.g. `slot\mySlot`) - Variable references supported in: `slot`, `swapSlot`, `wait`, `yaw`, `pitch`, `setYaw`, `setPitch` ### 🎥 Perspective Aliases (new in v1.1.0) - `cyclePerspective` — cycle between first-person / third-person back / third-person front - `FPS` / `TPS` / `TPS2` — directly set perspective (first-person, third-person, third-person front) ### 🔄 Config Management (new in v1.1.0) - `/unloadCFGAliases` — remove all config-loaded aliases at runtime - `/unloadCFGBinds` — remove all config-loaded keybindings - `/unloadCFGVars` — remove all config-loaded variables - `/unloadCFGAll` — remove all config-loaded items at once - Autoload tracking: runtime-created aliases/binds/vars survive `/reloadCFG

v1.1.1: Add autoload tracking and unload CFG commands - Add fromAutoload tracking to KeyBindingPlus, UserAlias, and VarAlias - Add 4 new built-in aliases: unloadCFGAliases, unloadCFGBinds, unloadCFGVars, unloadCFGAll - Add 4 new commands: /unloadCFGAliases, /unloadCFGBinds, /unloadCFGVars, /unloadCFGAll - Update BindAliasPlusClient to mark items loaded from config file - Preserve runtime-created items when unloading config items - Update README.md and README_CN.md with new command documentation - Bump version to 1.1.1

Release v1.1.0: Variable System with item count tracking Features: - Add variable system for dynamic value storage - New /var command to create and manage variables - Support three variable sources: hotbarSlot, itemsOfSlot0-9, direct integers - Enhance slot and swapSlot aliases to accept variable names - Add item count tracking from hotbar and offhand slots - Variable name validation (cannot start with numbers) - Full config file support for var commands Documentation: - Add comprehensive CHANGELOG.md - Update README.md with variable examples and use cases - Update DEVELOP.md with technical implementation details - Add variable system documentation across all guides Implementation: - New VarAlias builtin with global variable storage - Enhanced SlotAlias to resolve variables - Enhanced SwapSlotAlias to resolve variables in both arguments - Automatic variable/number resolution via VarAlias.resolveValue() Backward Compatibility: - 100% backward compatible - no breaking changes - All existing configs and aliases work unchanged - Variables are opt-in feature Version: 1.0.4 -> 1.1.0

Fix issue #4: Config parser not recognizing nested bind/alias after wait operations - Fixed leading space bug in WaitAlias handling that caused empty definitions - Added automatic quote wrapping for arguments containing spaces - Added blank split filtering to handle trailing backslashes - Bump version to 1.0.3 feat: Add silent mode to suppress command feedback messages - Add SilentAlias builtin alias (builtinSilent\1 and builtinSilent\0) - Add convenient shortcuts +silent and -silent - Wrap all sendFeedback() calls with silentMode check - Update README.md with silent mode documentation and examples - Update README_CN.md with Chinese translation - Add example patterns: state switcher vs press-and-hold - Resolves issue #5 - prevent chat spam from toggle binds

Fix issue #4: Config parser not recognizing nested bind/alias after wait operations - Fixed leading space bug in WaitAlias handling that caused empty definitions - Added automatic quote wrapping for arguments containing spaces - Added blank split filtering to handle trailing backslashes - Bump version to 1.0.3 feat: Add silent mode to suppress command feedback messages - Add SilentAlias builtin alias (builtinSilent\1 and builtinSilent\0) - Add convenient shortcuts +silent and -silent - Wrap all sendFeedback() calls with silentMode check - Update README.md with silent mode documentation and examples - Update README_CN.md with Chinese translation - Add example patterns: state switcher vs press-and-hold - Resolves issue #5 - prevent chat spam from toggle binds

Fix issue #4: Config parser not recognizing nested bind/alias after wait operations - Fixed leading space bug in WaitAlias handling that caused empty definitions - Added automatic quote wrapping for arguments containing spaces - Added blank split filtering to handle trailing backslashes - Bump version to 1.0.3 feat: Add silent mode to suppress command feedback messages - Add SilentAlias builtin alias (builtinSilent\1 and builtinSilent\0) - Add convenient shortcuts +silent and -silent - Wrap all sendFeedback() calls with silentMode check - Update README.md with silent mode documentation and examples - Update README_CN.md with Chinese translation - Add example patterns: state switcher vs press-and-hold - Resolves issue #5 - prevent chat spam from toggle binds

feat: Add silent mode to suppress command feedback messages - Add SilentAlias builtin alias (builtinSilent\1 and builtinSilent\0) - Add convenient shortcuts +silent and -silent - Wrap all sendFeedback() calls with silentMode check - Update README.md with silent mode documentation and examples - Update README_CN.md with Chinese translation - Add example patterns: state switcher vs press-and-hold - Resolves issue #5 - prevent chat spam from toggle binds

Fix issue #4: Config parser not recognizing nested bind/alias after wait operations - Fixed leading space bug in WaitAlias handling that caused empty definitions - Added automatic quote wrapping for arguments containing spaces - Added blank split filtering to handle trailing backslashes - Bump version to 1.0.3 Fixes #4

Changelog for v1.0.2 #### Bug Fixes - **Fixed config reload issue** (#2): Config was reloading on every world change, breaking aliases with persistent state (e.g., loops, waits spanning worlds). Config now loads once at client startup instead of on every server join. - **Improved config parsing**: Added support for `/` prefix in config lines (e.g., `/alias` and `/bind` now work in the config file, matching in-game command format). - **Removed faulty assert**: Eliminated an assertion that caused issues during initialization when no player was present. - **Fixed console warnings**: Config parsing now properly handles empty and comment lines without logging warnings. #### Improvements - **Command descriptions**: Fixed typos in `/alias` and `/bind` command help text. - **Code formatting**: Updated formatter settings for 128-character lines, tabs, and improved consistency. - **IDE setup**: Added Eclipse Google Java formatter profile, configured Zed editor for Gradle import and JDTLS dependency resolution. #### Other Changes - Updated Gradle wrapper properties. - Minor README updates. - Merged remote changes.

Changelog for v1.0.2 #### Bug Fixes - **Fixed config reload issue** (#2): Config was reloading on every world change, breaking aliases with persistent state (e.g., loops, waits spanning worlds). Config now loads once at client startup instead of on every server join. - **Improved config parsing**: Added support for `/` prefix in config lines (e.g., `/alias` and `/bind` now work in the config file, matching in-game command format). - **Removed faulty assert**: Eliminated an assertion that caused issues during initialization when no player was present. - **Fixed console warnings**: Config parsing now properly handles empty and comment lines without logging warnings. #### Improvements - **Command descriptions**: Fixed typos in `/alias` and `/bind` command help text. - **Code formatting**: Updated formatter settings for 128-character lines, tabs, and improved consistency. - **IDE setup**: Added Eclipse Google Java formatter profile, configured Zed editor for Gradle import and JDTLS dependency resolution. #### Other Changes - Updated Gradle wrapper properties. - Minor README updates. - Merged remote changes.

Changelog for v1.0.2 #### Bug Fixes - **Fixed config reload issue** (#2): Config was reloading on every world change, breaking aliases with persistent state (e.g., loops, waits spanning worlds). Config now loads once at client startup instead of on every server join. - **Improved config parsing**: Added support for `/` prefix in config lines (e.g., `/alias` and `/bind` now work in the config file, matching in-game command format). - **Removed faulty assert**: Eliminated an assertion that caused issues during initialization when no player was present. - **Fixed console warnings**: Config parsing now properly handles empty and comment lines without logging warnings. #### Improvements - **Command descriptions**: Fixed typos in `/alias` and `/bind` command help text. - **Code formatting**: Updated formatter settings for 128-character lines, tabs, and improved consistency. - **IDE setup**: Added Eclipse Google Java formatter profile, configured Zed editor for Gradle import and JDTLS dependency resolution. #### Other Changes - Updated Gradle wrapper properties. - Minor README updates. - Merged remote changes.

fix NoSuchMethodError on SwapSlotAlias run (fabric mc 1.21.4, mod version 1.0.1)

remove command feedback on automatically cfg loading!

for 1.21.4 - 1.21.8

for 1.21 - 1.21.3