v1.220.0

[pxlarified]

v1.220.0

Changes

• Added packet-based backpack cosmetic displays for armor stands, including viewer tracking, range refreshes, delayed mount synchronization, cleanup when stands or equipped cosmetics are removed, and the armor_stand_enabled and armor_stand_range settings (enabled by default with a 128-block range). Armor stand support is based on the work by @OlivierChiasson in oraxen/oraxen#1852, with additional changes and fixes.

  

• Added in-game recipe builders for smithing, anvil, and grindstone recipes through the existing /oraxen recipes builder and /oraxen recipes save workflow.

  • Added /oraxen recipes builder smithing.
  • Added /oraxen recipes builder anvil <experience_cost>.
  • Added /oraxen recipes builder grindstone <experience>.
  • Smithing recipes are saved to smithing.yml, anvil recipes to anvil.yml, and grindstone recipes to grindstone.yml using the existing recipe formats.
  • Builder inventories are tracked by inventory instance instead of their rendered title, and builder titles no longer include player names.
  • Workstation builders prevent invalid shift-click transfers and suppress automatically generated outputs while authoring recipes.

• Added Paper 1.21.5+ pick-item support for Oraxen custom blocks and furniture.

  • Supports note block, string block, chorus block, and shaped block mechanics, including stairs, slabs, doors, trapdoors, grates, and bulbs.
  • Directional note blocks resolve to their configured parent item, and upper halves of tall string blocks resolve to the custom block below.
  • Picking selects an existing hotbar item where possible, otherwise moves or places the item into a suitable hotbar slot.
  • Vanilla blocks remain untouched when no Oraxen mechanic is present.

• Added cross-version handling for custom item names and custom model data.

• Added the vanilla death_protection item component (1.21.2+) which prevents death and supports configurable death effects.

  • Supports applying and removing effects, clearing effects, random teleportation, and playing sounds when death is prevented.

• Modernized usage of Paper and Adventure APIs across the plugin, including:

  • Component-based item names, lore, inventory titles, broadcasts, and player locales.
  • Modern item damage and Damageable APIs.
  • Damage sources for energy blasts.
  • Registry-based sound lookups.
  • Typed falling block spawning and precise target block lookups.
  • Fireball acceleration, recipe choices, inventory views, and event-owned dispatch APIs.

Fixes

• Fixed crafting permission checks when no matching custom recipe exists.
• Fixed pick-item hotbar selection so it no longer relies on PlayerPickItemEvent#getTargetSlot().
• Registered BlockLocation for Bukkit configuration deserialization so persisted furniture barrier offsets can be read correctly when interacting with or attacking entity furniture.

Maintenance

• Added tests for item compatibility and knockback strike behavior.
• Added regression coverage for BlockLocation PDC serialization and deserialization.
• Removed the obsolete .agents/setup setup script.
• Updated development instructions in AGENTS.md.
• Bumped the project version to 1.220.0.