[1.0.0] - 2026-04-06
Initial release covering 12 Hytale Server API surfaces.hrtk-api
Annotations - 24 annotations for test definition, lifecycle, filtering, parameterization, context requirements, domain shortcuts, and benchmarking. Assertions - 12 assertion classes mapped to Hytale Server API surfaces:| Assert Class | Hytale API Covered |
|---|---|
HytaleAssert | General-purpose (equality, null, exceptions, collections) |
EcsAssert | Store, Ref, ComponentType, Archetype, entity queries |
EventAssert | EventRegistry, EventBus, event capture and cancellation |
CommandAssert | CommandManager, CommandSender, execution and permissions |
CodecAssert | Codec, BuilderCodec, BSON encode/decode |
WorldAssert | Universe, World, blocks, chunks, entity existence |
UIAssert | CustomUIPage, UICommandBuilder, event bindings |
StatsAssert | EntityStatMap, EntityStatValue, stat modifiers |
CombatAssert | DamageSystems, DeathComponent, knockback |
InventoryAssert | Inventory, ItemStack, ItemContainer |
LootAssert | ItemDropList, ItemDrop, drop quantities |
EffectAssert | EffectControllerComponent, EntityEffect |
hrtk-server
Discovery - JAR scanning via PluginClassLoader, annotation indexing, auto re-scan on plugin reload. Execution - Suite/test runner with context injection, world-thread scheduling, timeout enforcement, crash protection (catches Throwable). Adapters - 12 server-side adapters wrapping Hytale internals: ECS, stats, combat, events, commands, inventory, loot, effects, UI, networking, world, codecs. Commands -/hrtk run, list, bench, results, scan, watch, export.
Reporting - Console output, JSON file export, in-game dashboard UI.
hrtk-example-mod
18 test suites demonstrating every HRTK feature across all supported Hytale API surfaces.HRTK is in active development. The API may change between minor versions as Hytale’s server API evolves. Pin your
hrtk-api dependency version to avoid surprises.