> ## Client Version > > ### `<PlayerTag.version>` and `<ConnectionTag.version>` tags > Tags have been added to retrieve the exact version of the player’s client: > - Returns a human-readable version name (e.g., `"1.21.1"`, `"26.2"`): > ```yaml > - narrate "Your client version: <player.version>" > ``` > - Add `.protocol` to retrieve the exact integer protocol version identifier (e.g., `767`): > ```yaml > - if <context.connection.version.protocol> >= 767: > - narrate "A modern client has been detected!" > ``` > > ### The `<util.client_version_by_address[<address>]>` tag > A tag has been added specifically for the `on server list ping` event to work around Paper’s limit on the number of versions: > ```yaml > on server list ping: > - narrate <context.client_protocol_version> > - narrate <util.client_version_by_address[<context.address>].protocol> > ``` > > **Note:** In the standard version of Paper, `<context.client_protocol_version>` works correctly for versions that do not exceed the server kernel version. However, if a client connects using a version newer than the kernel (for example, when pinging from version 26.2 to server 1.21.11 via ViaVersion), Paper will cap the value and report 1.21.11 due to ViaVersion. This tag directly reads the raw network handshake data, returning the client’s true version in all cases without restrictions. > > ## Removals and Changes That Break Compatibility > > ### `ViaVersion` bridge > `<ConnectionTag.viaversion_version>` and `<ConnectionTag.viaversion_protocol>` have been removed. > Please switch to using the new universal tags `<ConnectionTag.version>` and `<ConnectionTag.version.protocol>`.

## - **`ConnectionTag` and `PlayerTag`**: > ### - **`transfer`** Mechanism (**`ConnectionTag`**): > Added the **`- adjust <connection> transfer:host:port`** mechanism (or simply `transfer:host`) for direct, vanilla client redirection to any other server without BungeeCord/Velocity. > > ***Note**: The destination server must have `accepts-transfers=true` enabled in its `server.properties` file, otherwise the client will be disconnected.* > > ### - **`<PlayerTag.connection>`** Tag: > Added the **`<player.connection>`** tag, which returns the online player’s `ConnectionTag`: > ```yaml > - adjust <player.connection> transfer:modrinth.cherry.pizza > ``` > ### - **`<ConnectionTag.is_connected>`** Tag: > Returns whether the connection is currently open and active (`true`/`false`). ## - **Dialogs**: > ### - **`DialogScriptContainer` (`procedural:` Generation)**: > Added the ability to dynamically generate inputs, dialog bodies, and buttons via procedural scripts: > ```yaml > procedural: > - repeat 15 as:num: > - definemap button: > label: <[num]> > script: > - adjust <context.connection> connect > - define buttons.<[num]>:<[button]> > - determine buttons:<[buttons]> > ``` > ### - **`player custom click`** Event: > Added full cross-plugin support, allowing safe interception and reading of dialogs created by other plugins on the server. > - **Switches**: `button_id:`, `namespace:`. > - **Contexts**: `<context.connection>`, `<context.button_id>`, `<context.namespace>`, `<context.inputs>`, and lazy-evaluated direct input retrieval via `<context.[input_id]>`. ## - **`BiomeTag`**: > ### - Dynamic **`attribute`** Mechanism & Tag: > Replaced hardcoded properties with a dynamic **`<BiomeTag.attribute[<name>]>`** tag and **`attribute:`** mechanism ([Minecraft Environment Attributes](https://minecraft.wiki/w/Environment_attribute)): > ```yaml > - adjust <biome> attribute:[sky_color=red;fog_color=<color[green]>]``` ## - **`BetterModel` Bridge**: > ### - `bmmodel` Command (Spawn Preconfigurations): > The **`- bmmodel`** command now supports sub-blocks for conveniently preconfiguring model mechanisms right at the moment of its creation: > ```yaml > - bmmodel entity:<entity> model:dragon: > glow: true > glow_color: red > model_scale: 1.5 > ``` > **Some mechanisms are applied only after the animation plays, so we strongly recommend using this preset feature.** > ### - **`model_rotation`** Mechanism (**`BMActiveModelTag`**): > Added the **`- adjust <model> model_rotation:<QuaternionTag>`** mechanism to rotate the entire model as a single unit (preserving shape and bone connections). > ### - Geometry Preservation When Changing Skins: > Fixed a bug where scale, positions, and bone offsets were reset when changing a model’s skin. Custom bone dimensions no longer break when using the `skin` mechanism. ## - **New `ViaVersion` Bridge**: > ### - **`<ConnectionTag.viaversion_protocol>`** Tag: > Returns the raw protocol number of the player’s client (e.g., `765`). > ### - **`<ConnectionTag.viaversion_version>`** Tag: > Returns a human-readable name for the player’s client version (e.g., `"1.20.4"`, `"1.16.5"`). ## - **Events**: > ### - **`player connection configure`** Event: > - The `WAIT` determination now accepts a `DurationTag` (e.g., `WAIT:5s` or `WAIT:1m`). > - Fixed an issue that prevented players from joining the server when using this event. ## - **Compatibility**: > ### - **Minecraft 26.2 Support**: > Added full support and fixed internal NMS version handlers for server version 26.2.

- **``player connection configure``**: > The `WAIT` determination now requires a `DurationTag` (e.g., `WAIT:5s` or `WAIT:1m`) instead of a fixed 1-minute timeout. (default 1m)

Support **26.2**. ### DialogScriptContainer **Add:** * `procedural`: Added the ability to dynamically generate `inputs`, `bodies`, and `buttons`. ```yaml procedural: - repeat 15 as:x: - definemap button: label: <[x]> script: - adjust <context.connection> connect - define buttons.<[x]>:<[button]> - determine buttons:<[buttons]> ``` ### PlayerCustomClickScriptEvent * `player custom click` Event: Full cross-plugin support, allowing safe interception and reading of dialogs created by other plugins on the server. * **Switches**: `button_id:`, ``namespace``. * **Contexts**: `<context.connection>`, `<context.button_id>`, `<context.namespace>`, `<context.inputs>`, and lazy-evaluated direct input retrieval via `<context.[input_id]>`. ### ConnectionTag **Add:** * `<ConnectionTag.is_connected>`: Returns whether the connection is currently open and active. ### BiomeTag **Add:** * `attribute` Mechanism & Tag: Replaced hardcoded properties with a dynamic `<BiomeTag.attribute[<name>]>` tag and `attribute:` mechanism. ```yaml - adjust <biome> attribute:[sky_color=red;fog_color=<color[green]>] ```

## PlayerConnectionConfigureEvent ### Fixed: - ``Determinations``**:** > **Fixed an issue where event determinations (such as `determine WAIT`) were evaluated incorrectly or failed to register.** ### Added: - ``reflect_event Context``**:** > **Added the `<context.reflect_event>` context to allow reflective access to the underlying `AsyncPlayerConnectionConfigureEvent` via `JavaReflectedObjectTag`.**

chore(config): change default fakeinternaldata to false

## DialogScriptContainer ### Add: - ``Condition``**:** > **Added ability to hide/show specific input fields, body elements, and buttons based on condition checks.** > ```yml > bodies: > 1: > type: message > condition: <player.inventory.contains_item[diamond]> > message: <gray>You have a diamond in your inventory, so cool! > ```

Fixed view range mechanism in tracker.

## BetterModel ### **Add:** - **`BMActiveModelTag/BMBoneTag.brightness`**: > **Adds support for a brightness override, containing "block" and "sky" keys (0-15).** - **`BMActiveModelTag.model_scale`**: > **Adds unified model scaling while preserving the relative positions of bones, geometry, and pivot points.**

## BetterModel ### Fix: - ``SkinsRestorer``**:** > **Fixed crash on startup if SkinsRestorer is not installed.**