Wizards of Lua

Dynamic Commands: New Enum-String Placeholder
Added support for an enum-string placeholder (%s[opt1|opt2|…]) that restricts string inputs to a given set, enabling built-in tab-completion and automatic validation of allowed values.

Standard io Module Support
Wizards of Lua now officially supports Lua’s standard io module, allowing scripts to create, read, and update files in the server’s world folder.

New Class: Structure
Represents a captured box-shaped region of the world.

New Class: Server
Provides server-level operations:

• Server:loadStructure(name) — Load a saved Structure by name.
• Server:saveStructure(name, structure) — Save a Structure to disk.

New Functions on Spell

• Spell:copyStructure(oppositeCorner [, includeEntities, ignoreBlockId]) — Captures a box-shaped region into a Structure object.
• Spell:pasteStructure(structure [, originPos, ignoreBlockIds]) — Pastes a Structure at the spell’s position.
• Spell:setYaw(direction) — Sets the spell’s yaw to face a given compass direction ("north", "south", "west", "east").

New Properties on Spell

• Spell.facing — Read-only compass direction the spell is oriented toward ("north", "east", "south", "west").
• Spell.server — Reference to the Server object for accessing server-level operations (filesystem, version, structures).

Updated Method: Spell:move
Now accepts relative directions ("forward", "back", "left", "right") in addition to absolute directions to execute relative movement.

New Property: Entity.facing
Exposes the entity’s current compass direction.

New Event: SpellFinishEvent
Fired immediately before a spell completes execution, allowing interceptors to perform cleanup tasks.

Refactoring:
Under-the-hood refactoring of the internal spell lifecycle management for improved stability and consistency.