ВЕРСИИ (23)

### 3D hats on helmets show on the head - Fixed: an item on a helmet base (netherite, diamond and so on) with a model of its own drew the helmet's armour on the head, and the hat only showed in the inventory. It now wears its own model, on Minecraft 1.21.2 and newer, and keeps the helmet's armour points. `hat: true` on a helmet does the same. - ItemsAdder imports: an item's hat behaviour now becomes `hat: true` instead of being skipped.

### A clearer startup - New: a startup banner in the console. It shows the version, links to our Discord, the docs and Studio, and a short report of what started (pack hosting, content, dialogs, other plugins it hooks into), ending with how long it took and how many warnings there were. When a newer version is on SpigotMC, the banner says so. - Fixed: the note that dialogs were written to the world's datapack printed twice on every start.

### More model events, animation fixes, and chat text fixes **Integrations** - Model break events now identify the specific model copy and hitbox that was hit. - Model interaction events now work with Studio models and include the specific model copy and clicked position. - Custom actions can now run once a model is placed, with access to the placed model and its source item stack. - Model seat events now include the specific model copy and seat vehicle. - Entity death events now expose the killer and let integrations modify the drops. - Item use events now include the clicked block face. - Resource pack send events now include the built pack, with an ID that matches Bukkit's resource pack status events. **Fixed** - Models already in the world now animate when playback starts after an animation is added through Studio. - Fixed blank letters in chat text effects and incorrect rendering of animated rank tags. ### 0.2.29: The same, published twice - No changes from 0.2.28: the same `ModelPlaceEvent.stack()` was built twice on one evening and released under both numbers. ### 0.2.28: The item a model is placed from, for developers - For developers: `ModelPlaceEvent.stack()` is the stack in the player's hand a model, piece or vehicle is being placed from, so a listener can read what the item carries (its persistent data, name, lore) and move it onto the placement. Null when a plugin placed it with `Models.place`. ### 0.2.27: /rp models finds Studio models - Fixed: `/rp models` only listed models placed from a content folder, so a Studio model standing right beside you came back as "No models". Studio models are listed now too, as `studio:<id>`. - For developers: `Models.animate` is for a model put on an entity with `bind`, and answers false for a placed one. The javadoc now says so, and shows the call that plays on a placed model: `at(entity)` and `play` on the placement.

### Dialogs open on Spigot again - Fixed: on Spigot, dialogs never opened. The command RP Engine used to show one was refused by Minecraft, which takes no UUID for a dialog target; it now runs it as the player. Paper was unaffected. Thanks to Samu for this one.

### Bows and crossbows that draw back in your own art - New: an item can have a look for each stage of being drawn. `pull:` gives a bow or crossbow its drawing stages, the way vanilla's bow has three, and the game switches between them as the player draws, at vanilla's own timings unless `at:` says otherwise. - Crossbows get their loaded looks too: `charged:` for an arrow and `charged-firework:` for a rocket. - Each stage can be a model or a flat texture, the same as the item's own look. Works from Minecraft 1.19.4; on 1.21.4 and newer any item held in use (a trident, a shield) can have stages. - `first-person:` can now be a Blockbench project too. - Made in Studio: bows, crossbows, tridents, shields, fishing rods, goat horns and brushes have a States card, so a custom bow draws back in its own art there as well. - New: `host.fallback-on-download-failure`. With `upload` hosting, a player whose game can't reach the pack host gets the pack from your own server instead (set `host.port` and `host.public-address` and open the port, as for `own-port`). Thanks to cody and Samu for this one.

### VFX on a loop, until something happens, and every way to cast one - New: VFX can loop. `/rp cast aura Steve loop` plays until stopped, `loop:5m` for five minutes, `loop:3x` three times, and `until:{arena_state} == "ended"` or `while:{mana} > 0` until a condition says, using the same conditions as dialogs (placeholders, PlaceholderAPI, permissions). - Effects made in Studio can have a loop section: the build-up plays once, the middle repeats, and the fade plays when it stops. - New casting options: `speed:`, `scale:`, `turn:`, `offset:`, `follow` (moves with the player), `delay:`, `vary`, `seed:`, `quiet`, `volume:`, `only:caster`, `tag:` and `end:finish|cut`. - `/rp cast stop` can now stop one player's effects or one tag's: `/rp cast stop Steve`, `/rp cast stop tag:aura`. - For developers: `VfxOptions` holds all of it, plus `stopWhen` for a check of your own.

### Choose how many VFX can play at once - New setting: `vfx.max-sprites` in config.yml is how many VFX sprites may be alive at once across the whole server, 4,000 by default, 0 for no limit. When a new effect would go over it, the oldest effects end to make room, so a cast always plays. This replaces the fixed limit of 32 effects, so small effects can play many more at once. - The VFX docs page now has measurements of what sprites cost a server, and what we recommend for busy and quiet servers.

### VFX: spell effects drawn in the world - New: VFX, spell and ability effects drawn in the world out of glowing sprites: a slash, a ring of ice spikes, a lightning storm, a black hole. Needs Minecraft 1.21.4 or newer. - Make them in a content folder's new `vfx/` folder: `preset: frost_nova` picks one of 10 ready-made effects (`/rp vfx presets` lists them), or drop in a recipe exported from Studio as `.json`. RP Engine paints the sprites into your pack, so there are no images to ship. - VFX made in Studio play once the pack is synced: `/rp cast studio:<id>`, or Play in game on the VFX's page. Players without the pack don't see them. - New commands: `/rp vfx` lists every effect, `/rp cast <name> [player]` plays one where a player stands, and `/rp cast stop` ends them all. Permissions: `rpengine.vfx`, `rpengine.cast` and `rpengine.cast.others`, all op by default. - Sounds an effect starts stop when it ends. - For developers: `engine.vfx()` lists effects and plays one at a place or on a player, with a handle to stop it.

### Text Effects: text that waves, burns and shines - New: Text Effects. Write `<fx:fire>Flame Sword</fx>` in an item's name or lore, an action's message, a mob's name or a storage title, and the text moves, burns or shines for every player with the pack. Works on text drawn on the screen: item names and lore, chat, titles, scoreboards, menus. - Make them in a content folder's new `text-effects/` folder: `preset: blaze` picks one of 32 ready-made effects (`/rp effects presets` lists them), or write your own GLSL. RP Engine builds the shader into your pack for every Minecraft version. - Text Effects made in Studio work by name too, once the pack is synced or distributed: `<fx:studio:<id>>`. - Players can use them in chat: `rpengine.chat.effects.all` for every effect, or `rpengine.chat.effects.<name>` for one. Both default to op. `chat.text-effects: false` turns it off. - New commands: `/rp effects` lists every effect drawn in itself, and `/rp effect <name> [text]` sends you text in one. `/rp say` takes `<fx:...>` too. - For developers: `engine.textEffects()` gives each effect's colour, and `apply` and `format` write text in one. - Studio shader HUDs: a label, head, picture or bar can show only when a condition holds, change colour by a value, and a bar can take its length from a value. Push your pack from Studio again to use them.

### HUD values update on the next tick - HUD values a plugin sets through the API (`overlays().set`) now show on the next tick. Before, they waited for the HUD's redraw, up to a second and a half. Setting a value to what it already was sends nothing. - New setting: `overlays.refresh-ticks` (1 to 50, default 30) is how often a HUD is redrawn anyway, which is what updates placeholders the server works out itself, like `{health}` and PlaceholderAPI's.

### Open dialogs with the Quick Actions key (G) - New: `quick-action: true` on a dialog (or **Open it with the Quick Actions key** in Studio) puts it on Minecraft's Quick Actions key (G, 1.21.6 and newer). With several dialogs on it, G shows a list to pick from. - By default G opens the dialog straight away, drawn for each player as they join: their name, live head and PlaceholderAPI values show what was true then, until they rejoin. Its buttons, pages and settings work as usual. Needs Paper. - `quick-action: launcher` has G open a small screen with an Open button that opens the dialog fresh, for dialogs whose values change. Spigot, and dialogs with a permission or the player's items in them, always use it. The button runs the new `/rp quick`, which every player has (`rpengine.quick`). - The key is set by a datapack RP Engine writes, so adding or removing a dialog takes a server restart. The console says when one is owed. - Fixed: on a brand-new 26.x world, the dialog and liquid datapacks written on the first start landed where the server never reads them, so they needed a second restart.

### Minecraft 26.3 for shader HUDs, 3D objects and the BetterHud merge - Studio shader HUDs and 3D shader objects now draw on Minecraft 26.3. Before, players on 26.3 saw HUDs as solid red blocks and 3D objects not at all. Push or export your pack from Studio again to get the 26.3 shaders. - The BetterHud merge now works on 26.3 too, so BetterHud and Studio shader HUDs draw together there as on older versions. - Fixed: a picture in a Studio shader HUD with empty space on its right moved everything after it to the left, so a progress bar over a picture sat a few pixels away from where the editor put it. Push or export again to get it. - Fixed: on 1.21.9 and newer, the client logged a warning about RP Engine's packs every time it loaded them.

### BetterHud and Studio shader HUDs now draw together - New: when another plugin's pack replaces Minecraft's text shader (BetterHud does, and so do Studio's shader HUDs and live player heads), RP Engine merges the two into its own pack so both draw. No extra pack and no extra loading screen. The console says what was merged, on which versions, and what could not be and why. - When a merge happened, a joining player's packs wait up to three seconds for the other plugin's pack, so RP Engine's land on top of it in one load. - Fixed: a plugin that sends its pack with `setResourcePack` (BetterHud does) took every RP Engine pack off the player. RP Engine now sends them again, on top. - New settings: `shaders.merge` turns merging off, and `shaders.notify-players: false` keeps the messages to the console instead of telling ops in chat. Players with `rpengine.shaders` (ops) are told. - Using BetterHud? Update it to 2.2.0: 2.0.0's own shader does not work on 1.21.6 to 1.21.11, so nothing can be merged on those versions. Re-export or re-push packs made in Studio before this update so they can be merged.

### Players get your packs with nothing to set up - New: packs are uploaded to our free pack host by default and players download them from there. No port to open, no IP to set, and it works behind a proxy and on any host. Choose another way with `host.mode` in config.yml: `same-port` serves packs from your server's own Minecraft port, `own-port` is the old second-port setup, and `none` only builds them. - If an upload fails, the pack is served on your game port instead, and the console says so. - A config that already set its own `host.public-address` keeps working exactly as before. - New: when an update adds a setting, RP Engine writes it into your config.yml with its explanation, keeps your file otherwise as it was, and saves the old one as a backup. - New: when a player's game cannot download a pack, the console says which link it was sent and what to check. `/rp bundles` shows the link each bundle is served at. - Changed: custom items no longer count as their base material in vanilla recipes, so a custom item made from paper no longer crafts into a book. This covers the crafting grid, furnaces, the stonecutter, smithing table, anvil and crafter. Set `vanilla-recipes: true` on an item, or `items.vanilla-recipes: true` in config.yml, to allow it. - Fixed: `mode: loop` on an animation imported from Blockbench as play-once now starts it on its own, instead of waiting for a right-click.

### Removing a model from code no longer drops its item when told not to - Fixed: `Placement.remove(false)` on a Studio model still dropped the item that places it. Plugins removing models through the API now get no drop unless they ask for one.

### Packs with version overlays load on 1.21.9 and newer - Fixed: on 1.21.9 and newer, a pack whose content declared version overlays only for those versions was refused by every client, so players got none of the server's pack. Addons that ship their own shaders (Portals among them) were the usual way to hit it. - Fixed: a fresh `config.yml` listed `emotes.rigs` twice, which logged a duplicate key warning on every start.

### Server-controlled 3D objects, armor mesh support, and vehicle fixes **3D objects** - Control each placed shader object's state, timing, movement, rotation, and size, with smooth client-side animation. - Create sequences that combine object changes, waits, sounds, commands, removal, and restarts. - Spawn objects at coordinates from the console or command blocks. All `/rp object` actions now work from command blocks and through `execute as <entity>`. - State and sequence commands now target the nearest object that supports the requested state or sequence. - Set separate permissions for each `/rp object` action. - Added portal, meteor, and black hole examples with states and sequences. - Fixed rendering around triangle edges on driven 3D objects. **Dialogs** - Studio dialogs can show icons from your server's own resource pack, pasted in or named by RP Engine icon id. **Portal scenes** - Fixed floating tree sections and shimmering in the snowy pine scene. - Replaced the odd-world scene with a Manhattan avenue, including buildings, street traffic, and the Empire State Building. **3D armor** - Armor models now support Blockbench mesh elements. - Set `shader-helmet: true` to render a set's helmet through shaders. - Fixed one wearer's armor failure preventing armor updates for other players. - Fixed armor displays not being hidden correctly when a viewer quickly rejoins. **Resource packs** - Fixed quitting and rejoining during the initial skin wait leaving the new session without its resource packs. **Vehicles** - Fixed `holdOccupant` blocking dismounts caused by death, teleporting, switching to spectator, or disconnecting. It now blocks only sneak-key dismounts while the vehicle is moving.

### Seamless dialogs, separate emote packs, and Minecraft 26.3 support **Dialogs** - Dialogs now switch seamlessly by default, without briefly showing the world or a waiting screen. - Fixed Wait dialogs staying on the “Waiting for Server” screen for five seconds after a click. - Set a click sound, volume, and pitch for each dialog or clickable piece, or silence it. - Dialogs can now have up to 99 pages, up from 10. **Resource packs** - On Minecraft 1.20.3+ with pack stacking and engine hosting enabled, emote rigs use a separate pack. New skins update only that pack without changing the main bundle’s hash or reloading content. - Packs now use the correct format for Minecraft 26.3. - Fixed Paper 26.x version detection passing build numbers instead of the release version to edit sessions and distribution reports. **Models and animations** - Placed-piece states, jukebox playing models, and connected shapes can now use a model without a matching item. Unknown models produce a build warning. - Fixed alternate looks using a different item material and animated parts showing missing models on versions below 1.21.4.

### 3D armour from your content folder, animations that hold their last frame, and security fixes - 3D armour can be hand-authored in your content folder, drawn by core shaders. Plugins can reach it through `engine.armor()`. - Animations can stay on their last frame instead of going back to rest, and keep that pose across restarts. Use it for doors, or a plant that grows in stages. - Items can have a separate first-person model. - Studio HUDs can live in a content folder. - Plugins can place a content model. - Fixed: people sat a third of a block above a chair's seat. - Fixed: a scaled model sank into the block it stood on. - Fixed: a wide model's hitbox stopped another being placed in the block beside it. - Fixed: HUDs on the boss bar lost their fonts on Paper. - Hardening: pushed links must be https and downloads are capped. Skin fetches only go to Mojang. The pack host has timeouts and per-address limits. Dialog ids and addon content can't leave their folders. Stored containers only load known item classes.

### Dialog pieces only some players see, upright progress bars, and an update notice - A piece of a Studio dialog can be shown only to some players: by a setting they chose in the dialog, a value, or a permission. - Progress bars in Studio dialogs can stand upright, filling from the bottom, and fade between two colours. - When a newer RP Engine is on SpigotMC, the console says so on startup and ops are told when they join. `update-check: false` turns it off. - The anonymous usage count now includes how many players are online, as a single number. `telemetry.enabled: false` still turns it off. - Fixed: when a dialog's list got shorter (a player's history after a punishment was removed, say), the rows past the end were hidden but their words were still drawn.

### Dropdowns that open, click sounds, and fixes for newer clients - Dropdowns in Studio dialogs open as a real list. - A click on a dialog's picture makes the game's button click sound. - Two plugins whose dialogs share a font no longer break each other's screens. - A dialog's footer button can be hidden. - Live words in a dialog can take their colour from a placeholder. - Fixed: on Minecraft 1.21.9 and newer the whole resource pack could be refused. - Fixed: closing a dialog no longer tells every op in chat.

### Dialogs, custom blocks, and importers for Nexo, Oraxen, CraftEngine and BetterModel Everything since 0.1.51. **Dialogs** (1.21.6+) - Minecraft's own dialog screens, from YAML or pushed from Studio, opened without a restart. - Pages, with `/rp page` to turn them, and a command players open a dialog with. - Live `{placeholders}`, player heads, progress bars and lists the server fills, per player. - Switches and sliders bound to each player's own settings. - Item slots: the player's inventory, ender chest, backpacks and plugin containers, with items that can be moved. **Blocks and placed models** - Custom blocks with states, real shapes, light, growth stages, plants on tripwire, and containers. - Blocks that strip, switch, fall, resist blasts and vary at random. - Placed models that cycle through states on click (lamps, doors, screens), grow into other models, hold storage, play music discs, run actions and join their neighbors like a sofa. **Importers** - Nexo and Oraxen: items, furniture, blocks in their own shapes, recipes, animated glyphs with their chat keys, mechanics and click commands. - ItemsAdder: sounds, events, block loot, item flags, armor layers, and wire, transparent, directional and variant blocks. - CraftEngine packs: items, blocks, furniture and their events. - BetterModel's plugin folder: its models as items, its player animations as emotes. - Smithing, brewing and anvil recipes, natively and from every importer. **Also** - Animated icons, with chat aliases and a permission. - Item flags and a particle action step. - `rpengine.<command>.others` permissions for pointing a command at another player. - Bedrock players through Geyser get placed models, 3D armor and the content folder's pack. - Fixed: one emote session could stop every emote on the server; a new player joining reloaded everybody's pack.