Forgotten Technology

[0.2.1] — 2026-05-26 — Hytale Server 0.5.1 compatibility

Changed

• SDK upgrade: Hytale Server 2026.03.26-89796e57b → 0.5.1 (new semver-style version numbering — Hytale moved off date-coded builds). The 0.5.1 build refactors core math types: com.hypixel.hytale.math.vector.Vector3i / Vector3d / Vector3f are gone, replaced by the JOML library's org.joml.Vector3i / Vector3d / Vector3f directly. Rotation is no longer a Vector3f of Euler angles — it's now a dedicated com.hypixel.hytale.math.vector.Rotation3f class with yaw() / pitch() / roll() accessors.
• Plugin migrated to the new API — 47 source files updated:
  • All Vector3i / Vector3d / Vector3f imports retargeted to org.joml.*.
  • JOML method names: .assign(x, y, z) → .set(x, y, z), .setX/Y/Z(int) → direct field access (v.x = ...) or .set(x, y, z).
  • ItemComponent.generateItemDrops 4th parameter changed from Vector3f velocity to Rotation3fc rotation — all 8 drop-on-destroy callsites updated to pass Rotation3f.IDENTITY.
  • TransformComponent / HeadRotation rotation field is now Rotation3f instead of Vector3f — all entity-spawn callsites in MultiblockBuildSystem, PylonPulseSystem, RunicCollectorTickSystem, RunicStasisChamberDisplaySystem updated.
  • Rotation3f.yaw() replaces Vector3f.getYaw() (no get prefix).
  • Player.sendMessage(Message) removed — moved to PlayerRef.sendMessage(Message). All ~50 callsites in interactions (UseLinkingRodInteraction, UseResonatingRodInteraction, UseFormingRodInteraction, ToggleCollectorBorderInteraction) and pages (CrystalExporterFilterPage, PylonUpgradePage) updated to chain through player.getPlayerRef().sendMessage(...).

Fixed

• Plugin failed to load on server update 6 with NoClassDefFoundError: com/hypixel/hytale/math/vector/Vector3i. All affected math types repointed; plugin now boots clean on Hytale 0.5.1.
• manifest.json ServerVersion must now be a SemverRange, not a bare exact version. Old format "0.5.1" is rejected with IllegalArgumentException: Bare version '0.5.1' is not a valid range, which silently skipped the entire asset pack — every block and item registered as "invalid item" in-game. Manifest now uses "^0.5.1" (compatible with 0.5.x) via a new hytale.server.range Maven property, kept separate from hytale.server.version so the SDK dependency lookup and JAR filename stay unaffected.

Compatibility

• Hytale Server: 0.5.1 (was 2026.03.26-89796e57b)
• Saves from 0.1.x / 0.2.0 load without modification — only import paths and method names changed; persisted codec keys, component IDs, item IDs, and field types are all unchanged. Vector3i codec still serializes as 3 ints under the same VECTOR3I / VECTOR3I_LIST keys.