Changelog

0.9.0 — Removed ByteBuddy, 6 new events (23 total)

New events

Event	Cancellable	Args	Fires
`entity_spawn`	❌	`entity`	Any entity loads into a world
`entity_despawn`	❌	`entity`	Any entity unloads from a world
`entity_death`	✅	`entity`, `source`, `amount`	Any living entity is about to die (players + mobs)
`player_join_init`	✅	`player`	Early join, player not fully loaded (renamed from `player_join`)
`player_join`	❌	`player`	Post-load join, player fully ready in world
`player_respawn`	❌	`player`, `wasDeath`	Player respawns after death or end portal

Migration: player_join was renamed to player_join_init (still cancellable, early). The new player_join fires later when the player is fully in-world.

Removed: `mc.observeHook` / `mc.removeHook` / `mc.clearHooks`

ByteBuddy (byte-buddy + byte-buddy-agent) was pulling ~4.3 MB into the output jar for a single unstable API (mc.observeHook). Use mc.on() events instead.

Other changes

Deleted LuaMixinManager.kt (ByteBuddy — 152 lines)
Output jar reduced from ~4.9 MB to ~839 KB

0.8.0 — Async API, PxLuaNova embedded, documentation site

Async API

Added mc.fetch(url) — coroutine-yielding HTTP requests via HttpClient.sendAsync
Added mc.sleep(ticks) — coroutine-yielding timed delay via Scheduler.schedule

PxLuaNova composite build

Embedded PxLuaNova as a Gradle composite build (pxluanova/) — no more Maven Local dependency
Dependency auto-substitution via includeBuild 'pxluanova' in settings.gradle

Documentation site

New Astro + Starlight documentation site at site/ (brand: PxIgnis)
28 documentation pages covering all APIs

Other

.gitignore patterns fixed to match nested directories (trailing-slash form)
General cleanup and minor improvements

Migration: LuaJ → PxLuaNova

Using a custom fork of LuaJ with fixes & performance improvements.

Breaking changes

Sidebar API enhanced — player.sidebar property now returns a sidebar object with title/lines (r/w), show()/hide()/destroy()/setLine(n, text), and visible/lineCount properties. Assignment with {title, lines, visible} creates or updates the sidebar. Sidebar no longer auto-restores on reconnect — script must re-create it.

New Mob AI system

API	Description
`mc.registerBehaviour(id, fn)`	Registers a named AI behaviour function
`mob:setAI("id")` / `mob:setAI(fn)`	Assigns behaviour by name or directly with a function. Persists on reload if ID is used
`mob:clearAI()`	Removes behaviour, restores vanilla AI
`mob.aiActive`	Whether a behaviour is currently active

Mob properties (delegates to entity metatable for entity-level props):

Property	Type	Notes
`mob.isMob`	bool	Always `true`
`mob.target`	entity or nil	Attack target (r/w by UUID)
`mob.speed`	number	Movement speed attribute
`mob.pathRemaining`	0–1	Navigation progress fraction
`mob.pathFound`	bool	Whether a path is active

Mob methods:

Method	Signature

`mob:navigateTo(x, y, z)` / `mob:navigateTo(entity)`	Pathfind to position or entity
`mob:stopNavigation()`	Cancel current path
`mob:lookAt(x, y, z)` / `mob:lookAt(entity)`	Turn toward position or entity
`mob:moveToward(vec, speed)`	Direct movement toward position
`mob:jump()`	Trigger jump
`mob:canSee(entity)`	Line-of-sight check
`mob:distanceTo(entity)` / `mob:distanceTo(vec)`	Euclidean distance

world:spawn() and mc.getEntity() automatically return MobWrapper for MobEntity subtypes.

Built-in behaviours: guard, pet, orbiter, statue, wander (check demo_ai.lua).

ByteBuddy runtime method hooks (experimental, unstable)

Function	Description
`mc.observeHook(class, method, callback)`	Hooks a Java method at runtime via ByteBuddy
`mc.removeHook(class, method)` → bool	Removes a hook
`mc.clearHooks()`	Removes all hooks

Hooks are cleared on /ignis reload and server stop. Callback receives (instance, args). Only single-overload methods supported. May be removed in future versions.

New Lua API

Function	Description
`mc.runtimeNamespace`	Current mapping namespace (e.g. `"named"` or `"intermediary"`)
`mc.mapped(className)`	Map named class → runtime class name
`mc.getMetatable("sidebar")`	Sidebar shared metatable
`mc.getMetatable("mob")`	Mob shared metatable

mc.runtimeNamespace & mc.mapped(className) have no purpose btw, hooks map names automatically.

player.sidebar = { title = "Title", lines = {"Line 1", "Line 2"} }
local sb = player.sidebar
sb.title = "New Title"             -- update title
sb.lines = {"Line 1", "Line 2"}   -- replace all lines
sb:setLine(1, "Updated")           -- update specific line
sb:show() / sb:hide() / sb:destroy()
sb.visible / sb.lineCount          -- read-only properties

Async API (mc.fetch / mc.sleep)

Coroutines are now supported!

Function	Description
`mc.fetch(url)`	Simple HTTP GET, yields coroutine
`mc.fetch({url, method?, headers?, body?, json?, timeout?})`	Full request table. `json` auto-encodes Lua table as JSON body. `body` and `json` are mutually exclusive
`mc.sleep(ticks)`	Yields the coroutine for `ticks` ticks (20 = 1s), resumes on server thread

mc.fetch returns a response table with a shared metatable:

Field	Description
`res.ok`	`true` for 2xx
`res.status`	HTTP status code
`res.text`	Raw body string
`res.headers`	Response headers table
`res.json`	Parsed JSON. Throws `LuaError` on invalid JSON
`res.error`	Set only on network failures

0.6.0 — Vector arithmetic, Inventory/Container API, Raycast, shared metatables

Breaking changes

Player.kt → PlayerWrapper.kt, World.kt → WorldWrapper.kt (internal refactor, no Lua API change)
player.world:particle(id, x, y, z) → player.world:particle(id, Vec(x, y, z), opts?) (positional args replaced by vector + options table)
Removed dead coerce/KotlinToLua.kt

New vector API

Vec(x, y, z) global constructor with +, -, *, /, unm, ==, tostring operators
Component-wise for v1 * v2, scalar for v / n, both v * n and n * v
Vector metatable accessible via mc.getMetatable("vec")

New inventory / container API

API	Description
`mc.createInventory(size)`	Creates a virtual SimpleInventory (9–54, multiple of 9)
`inv:getItem(slot)`, `inv:setItem(slot, item)`	Slot access (1-based)
`inv:fill(item)`, `inv:clear()`	Bulk ops
`inv:open(player, title?)`	Opens chest screen → Container
`container:onClick(callback)`	Registers click handler (auto-locks inventory)
`container:onClick(nil)`	Unlocks inventory
`container:close()`	Closes the screen

New raycast API

Both entity:raycast(range) and world:raycast(start, dir, range) now return a result table:

-- Block hit:
{ type = "block", blockPos = Vec(...), hit = Vec(...), side = "north", normal = Vec(...) }

-- Entity hit:
{ type = "entity", entity = EntityWrapper, hit = Vec(...) }

New world methods

world:raycast(startVec, dirVec, range, includeFluids?, includeEntities?)
world:playSound(id, x, y, z, volume?, pitch?)
world:particle(id, pos, opts?) — vector position, options table with count, spread, speed, data

New `ItemStack` features

Item wrappers now use shared metatable (mc.getMetatable("item"))
mc.createItem full component table (name, lore, unbreakable, attackDamage, etc.)
ItemStackWrapper.toJson/fromJson for serialization

Other additions

nbtToLua / luaToNbt utility functions in Utils.kt
chestgui.lua — chest GUI library with grid positioning
All wrappers now use shared metatables (one per type) — __index, __newindex, __pairs on the metatable, methods via rawset
player:damage(amount), player:heal(amount), player:give(id/count or ItemStack), player:setItem(slot, item), player:getItem(slot), player:clear()

0.5.1 — Rebuild

No API changes. CI fix for Modrinth publish.

0.5.0 — Entity/Structure/Sidebar/Metatable APIs, 10 new events

New `mc.*` functions

Function	Signature
`mc.getMetatable(name)`	`"entity"\|"player"\|"world"\|"structure"` → shared metatable
`mc.loadStructure(id)`	string → structure table
`mc.loadStructureFile(path)`	file path → structure table
`mc.getEntity(uuid)`	string → entity table or nil
`mc.dump(value, maxDepth?)`	recursive table debug dump
`mc.emit(event, ...)`	programmatic event firing
`mc.players`	property — list of online player tables (cached)
`mc.onlineCount`	property — number of online players

New entity methods

Method	Signature	Notes
`entity:readNbt()`	→ table	Dump entity NBT to Lua table
`entity:writeNbt(t)`	← table	Write NBT back to entity
`entity:raycast(range, includeFluids?)`	→ entity or `{x,y,z}` or nil	Hits entities before blocks
`entity:damage(amount, sourceEntity?)`	—	With optional damage source
`entity:addEffect(id, duration, amplifier?, particles?, icon?)`	→ bool	Status effect
`entity:removeEffect(id)`	→ bool
`entity:hasEffect(id)`	→ bool
`entity:setOnFireFor(ticks)`	—
`entity.removed`	r/o bool	Whether entity is removed
`entity.pos.x/y/z`	r/w now live	Previously snapshot; now reads/writes current pos

New player methods

Method	Signature
`player:sendActionBar(text)`
`player:sendTitle(title, subtitle?, fadeIn?, stay?, fadeOut?)`
`player:playSound(id, volume?, pitch?)`
`player:getItem(slot)` → item table or nil
`player:setItem(slot, item)`	item from `mc.createItem` or nil
`player:clear()`	Clear inventory
`player.sidebar`	r/w property — set to `{title="...", lines={...}}` or `nil` to clear
`player.sidebar.title`	r/w string
`player.sidebar[i]`	r/w lines (1-indexed)

New world methods

Method	Signature	Notes
`world:particle(id, pos, opts)`	Moved from `mc.particle`	Particle visible to all in that world
`world:broadcastInRange(text, pos, range, overlay?)`	Moved from `mc.broadcastInRange`
`world:getEntities(pos, radius, typeFilter?)`	→ table of entity tables	Spatial entity query

Removed from `mc.*`

mc.particle(...) → use world:particle(...)
mc.broadcastInRange(...) → use world:broadcastInRange(...)

New events (10 added, 16 total)

Cancellable:

player_block_break(player, pos, blockId)
player_block_place(player, pos, blockId)
player_use_item(player, hand, item, itemId)
player_attack_entity(player, entity)
player_interact_entity(player, entity)
player_hurt(player, source, amount)
entity_hurt(entity, source, amount)

Non-cancellable:

player_damage(player, source, damageTaken, blocked)
entity_damage(entity, source, damageTaken, blocked)
player_kill(player, killedEntity, source)

New types/values

Structure table — .size (vector), :place(world, pos, opts?) (rotation, mirror, on_entity)
Shared metatables — mc.getMetatable("entity"|"player"|"world"|"structure")
item.custom_model_data — now readable on item tables
mc.createItem(id, {attackDamage = N}) — new option to set attack damage

Other

world:spawn(id, pos, overrides?) now returns entity with all new methods (raycast, damage, effects, NBT)
entity.dir, entity.bodyDir now return {x,y,z} vector tables (previously Java userdata)
Player cache: mc.players() and world.players reuse wrappers across lookups
Sidebar persists across world changes and reconnects (restored 2 ticks after join)
player.block_break/player.block_place migrated from mixins to Fabric API events

0.4.0 — World/Entity API, tags, item creation

New `mc.*` functions

Function	Signature
`mc.world(name)`	string → world table
`mc.createItem(id, countOrTable?)`	→ item table
`mc.setBlock(x,y,z,block,world)`	Removed in 0.5.0 — use `world:setBlock`
`mc.getBlock(x,y,z,world)`	Removed in 0.5.0 — use `world:getBlock`
`mc.fill(x1,y1,x2,y2,z1,z2,block,world)`	Removed in 0.5.0 — use `world:fill`

New world methods

Method	Notes
`world:spawn(id, pos, overrides?)`	→ entity table
`world:setBlock(pos, blockId)`
`world:getBlock(pos)`	→ block id string
`world:fill(pos1, pos2, blockId)`
`world.name`, `world.time`, `world.raining`, `world.thundering`	r/w properties

New entity properties

Entity table returned by world:spawn() and player delegation:

Property	Type	Notes
`uuid`	string
`type`	string	e.g. `"minecraft:zombie"`
`name`, `displayName`, `customName`	string
`world`	table	World wrapper (was string in 0.3.0)
`pos`	`{x,y,z}` vector	r/w (snapshot in 0.4.0; live proxy in 0.5.0)
`dir`, `bodyDir`	`{x,y,z}` vector
`health`, `maxHealth`	number
`fallDistance`, `fireTicks`	number
`glowing`, `invulnerable`	boolean
`isSneaking`, `isSprinting`	boolean
`air`, `maxAir`	number
`tags`	boolean proxy	`pairs(entity.tags)`, `entity.tags["tag"] = true/false`
`speed`, `armor`, `attackDamage`, `maxHealth_attr`, `followRange`, `knockbackResistance`, `luck`, `horseJump`, `flyingSpeed`, `armorToughness`, `movementEfficiency`, `scale`, `stepHeight`	number	Attribute accessors (r/w where vanilla permits)
`mainhand`, `offhand`, `head`, `chest`, `legs`, `feet`	item table or nil	Equipment slots (writable)

Player changes

player.world now returns a world table (was a world name string)
player:give(id, count) also accepts item table from mc.createItem
All entity properties delegated to entity metatable (player inherits pos, health, tags, equipment, etc.)

New command argument types

word — single-word string (StringArgumentType.word())

Other

Block IDs auto-prefixed with minecraft: if no namespace given
demo.lua no longer requires return {...} at file end
Shadow relocates org.luaj → ru.pyxiion.lib.luaj and Permissions API

0.3.0 — Scheduler, teleport fix, Lua arg fallback

New `mc.*` functions

Function	Signature
`mc.schedule(delayTicks, callback)`	→ task id
`mc.scheduleRepeating(delayTicks, intervalTicks, callback)`	→ task id
`mc.cancelTask(id)`	→ bool
`mc.data`, `player.data`	Persistent key-value storage

Events

server_start, server_stop
player_join(player) — cancellable
player_leave(player), player_death(player, source, message)
player_chat(player, message) — cancellable

Player (initial API)

player:send(msg), player:teleport(x,y,z), player:kick(reason?)
player:give(id, count), player:damage(amount)
player:getInventory() → table of item stacks
player:getBlockPos() → {x,y,z}
player.name, player.uuid, player.world, player.pos (read-only snapshot)
player.health (r/w), player.displayName (r/w)

Commands

register(syntax, handler, permission?) — literal/arg syntax with <name:type> and [optional]
Types: text, player (alias target), int, double, float, bool, block_pos, choice=a,b,c
Reserved commands: stop, reload, op, deop, ban, ban-ip, pardon, pardon-ip, save-all, save-on, save-off, whitelist, pxrp

Storage

JSON storage: mc.data → global, player.data → per-player
Saved on server stop, player disconnect, /ignis reload
Nested tables require re-assignment (data.nested = t)

Other

require "format" — format(template), broadcastFormat(template)
require "simple" — registerSimple(syntax, template, range?, overlay?)
Vec(x, y, z) constructor with arithmetic metamethods

Changelog

Changelog

0.9.0 — Removed ByteBuddy, 6 new events (23 total)

New events

Removed: mc.observeHook / mc.removeHook / mc.clearHooks

Other changes

0.8.0 — Async API, PxLuaNova embedded, documentation site

Async API

PxLuaNova composite build

Documentation site

Other

0.7.0 — Mob AI, ByteBuddy hooks, sidebar rewrite, PxLuaNova migration

Migration: LuaJ → PxLuaNova

Breaking changes

New Mob AI system

ByteBuddy runtime method hooks (experimental, unstable)

New Lua API

Sidebar API

Async API (mc.fetch / mc.sleep)

0.6.0 — Vector arithmetic, Inventory/Container API, Raycast, shared metatables

Breaking changes

New vector API

New inventory / container API

New raycast API

New world methods

New ItemStack features

Other additions

0.5.1 — Rebuild

0.5.0 — Entity/Structure/Sidebar/Metatable APIs, 10 new events

New mc.* functions

New entity methods

New player methods

New world methods

Removed from mc.*

New events (10 added, 16 total)

New types/values

Other

0.4.0 — World/Entity API, tags, item creation

New mc.* functions

New world methods

New entity properties

Player changes

New command argument types

Other

0.3.0 — Scheduler, teleport fix, Lua arg fallback

New mc.* functions

Events

Player (initial API)

Commands

Storage

Other

Removed: `mc.observeHook` / `mc.removeHook` / `mc.clearHooks`

New `ItemStack` features

New `mc.*` functions

Removed from `mc.*`

New `mc.*` functions

New `mc.*` functions