ВЕРСИИ (23)

> ## 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.**

## BetterModel ### Fix: - ``Animation signals``**:** > **Fixed dropped/missing BetterModel animation signals.**

## BetterModel ### Fix: - ``SkinsRestorer``**:** > **Fixed a bug that prevented BetterModel from loading a new skin into the cache immediately after the player changed it.**

## Core > **Fixed compatibility issues with the [DenizenM](https://github.com/Energobro/DenizenM-Tjtoxshpilivili1) fork.** ## BetterModel ### Add: - ``BMModelCommand``**:** > **Added support for limb models.** - ``BMBoneTag/BMActiveModelTag.skin``**:** > **Changes the skin of the active model/bone to the player skin associated with the specified UUID or PlayerTag.** > > **This is especially useful when working with limb models.**

Fixed **target player context** in **show_dialog** mechanism

**Fix** queue variables not processing in ConnectionTag show_dialog

## Core **DialogScriptContainer:** * Added a new `showdialog [<dialog>] (def:<ListTag>)` command separately from the standard `PlayerTag.show_dialog` mechanism, allowing developers to pass parameter definitions (`def:`) directly into the dialog container. ## BetterModel **Event:** * Added the `bm player model interact` event, which triggers when a player interacts with any hitbox of an active model.

## DialogScriptContainer - Added ``base.after action`` key with the following options: - **CLOSE** — Closes the dialog and returns to the previous non-dialog screen **(if any)**. - **NONE** — Does nothing **(keeps the current screen open**). - **WAIT_FOR_RESPONSE** — Replaces dialog with a **"waiting for response"** screen.

## DialogScriptContainer: * Fixed an issue where the `initial:` option in Text and Boolean inputs did not parse tags.

# denizen-utilities 2.3.0 ## Core **DialogScriptContainer:** * `on_true` / `on_false`: Boolean Input options now parse tags. * Added compatibility support for the [DenizenM](https://github.com/Energobro/DenizenM-Tjtoxshpilivili1) fork **(DialogScriptContainer)**. ## BetterModel **Fix** * Fixed an issue where bones would become desynchronized when animating specific bones using the `bones:` argument. **Add** * `BMModelTag/BMActiveModelTag.type`: available for both static and active models. Returns the model type (PLAYER, GENERAL). * `BMActiveModelTag.entity`: available for active models. Returns the underlying Bukkit entity that this active model is attached to. * `override`: a new argument added to the `bmstate` and `bmlimb` commands to control animation overrides. # denizen-utilities 2.3.0 ## Core **DialogScriptContainer:** * `on_true` / `on_false`: Boolean Input options now parse tags. * Added compatibility support for the [DenizenM](https://github.com/Energobro/DenizenM-Tjtoxshpilivili1) fork. ## BetterModel **Fix** * Fixed an issue where bones would become desynchronized when animating specific bones using the `bones:` argument. **Add** * `BMModelTag/BMActiveModelTag.type`: available for both static and active models. Returns the model type (PLAYER, GENERAL). * `BMActiveModelTag.entity`: available for active models. Returns the underlying Bukkit entity that this active model is attached to. * `override`: a new argument added to the `bmstate` and `bmlimb` commands to control animation overrides. **Change** * Changed the default `start:` (lerp) argument value from `0` to `1` in animation commands to match BetterModel's native behavior.

# denizen-utilities 2.2.0 ~~**——————————————————**~~ # 🏗️ Restructuring of the model system Model handling is divided into two types of objects: **Static** and **Active**. * **`<model[(model_name)]>` (BMModelTag):** A new object representing a model blueprint. Allows you to retrieve data directly from a model blueprint without creating an object in the world. * **`<EntityTag.model[(<model_name>)]>` (BMActiveModelTag):** A renamed legacy tag representing an active model. **New general tags (available for BOTH object types):** * **`.animations`**: Returns a `ListTag` containing all animation names available in the model. * **`.animation_duration[<name>]`**: Returns a `DurationTag` with the duration of the specified animation. **New tags for active models only (`BMActiveModelTag`):** * **`.viewers`**: Returns all players viewing the model. * **`.running_animation`**: Returns the name of the animation currently playing. * **`.running_animation.type`**: Returns the loop mode (`loop`, `play_once`, `hold_on_last`). **Other new tags:** * **EntityTag:** * **`.models`**: A list of the names of all active BetterModel models on an entity. * **PlayerTag:** * **`.limb`**: Direct access to the player’s limb tracker. * **BMBoneTag:** * **`.item`**: Returns the `ItemTag` of the item currently displayed on this bone. ~~**——————————————————**~~ # ⚡ Animation signals Support for Blockbench scripts (Instructions/Effects track) has been implemented. **🚩 Global signals (`denizen:` prefix)** Trigger exactly once at a specified time for the entire server. * `denizen:name{metadata}` — Triggers the `on bm animation signal` event. * **Contexts:** `<context.model>` and any data from `{}` via `<context.key>`. * **Example:** `denizen:shoot`. **👥 Personal signals (`signal:` prefix)** Uses the official built-in BetterModel prefix `signal:`, which triggers the **`on bm player animation signal`** event. This is a **per-player** signal—it fires individually for each player currently viewing the model (for example, if 5 players are viewing the model, the event will execute 5 times—once for each player). * **Contexts:** `<context.name>`. ~~**——————————————————**~~ ⚠️ **Known limitation and workaround:** Currently, a peculiarity (likely a bug) has been observed in BetterModel 3.0: if there are multiple keys with the same prefix on the **Instructions** track (for example, two `denizen:` keys), only the last one will trigger. * **Solution:** If you need multiple triggers in a row, use the **Particle** track in Blockbench. Write your scripts in the **“Script”** field of the particle settings—there, all keys will trigger correctly and in sequence. 

Future versions will remain compatible, but the `fakeinternaldata` command will require an update to work.

**Important Requirement:** This version now requires **Java 25** or higher to run. This change is necessary to support the latest BetterModel 3.0+ API. ### Plugin Bridges: - Added integrations for **BetterModel**, **DiscordSRV**, and **SkinsRestorer**. This includes new tags, commands, and events that allow you to interact with these plugins directly from your scripts. ### FakeInternalData Patch: - Implemented a fix for the **fakeinternaldata** command. Since this command has remained broken in official Denizen releases for a long time without updates, I've added a custom patch to restore its functionality.