Execute Lua in the TTSim Global script context and return the result.

Use return to get a value back. Tables arrive as JSON objects/arrays; numbers, strings, booleans and nil (null) work too. TTSim objects (userdata) cannot be returned directly: return their fields instead, e.g. local o = getObjectFromGUID("abc123") return {name = o.getName(), pos = o.getPosition()}. Lua runtime and syntax errors come back as tool errors with the TTSim message. Changes made here are visible to the player immediately, so act deliberately.

Read the loaded game's Lua scripts and UI XML (read-only).

Returns {"global": {"script", "ui"}, "objects": [{"guid", "name", "type", "script", "ui"}]}, listing only objects whose script or UI is not empty.

Messages TTSim sent on its own since sequence number since: print output, Lua errors, game loaded/saved, objects created.

Returns {"events": [{"seq", "time", "kind", ...}], "last_seq"}. Pass last_seq as since next time to get only new events. Only events received while this server runs are available.

Check whether TTSim is reachable; if so, return the loaded game's name, object count and seated players (colour, host). Never fails: an unreachable TTSim is reported, not raised.

List objects on the table: guid, name, description, type, tags, tint (hex), position, rotation, locked, resting. Optional filters: name (case-insensitive substring), type (e.g. "Dice"), tag, tint (hex, e.g. "bbbbbb"). GUIDs change when a game is loaded, so look objects up each session.

Full details of one object: everything list_objects gives, plus scale, bounds (world-axis box: center, size), value (dice etc.), whether it is held or moving, and its snap points in world coordinates (e.g. the slots on a game board).

Move one object to position (optionally rotation) and wait until it has settled. smooth=true (default) glides it so the player sees the move; false teleports it. Place pieces slightly above their resting height and let physics settle them. Returns the final position and rotation.

Move several objects at once and wait until all have settled. Either:

• moves: [{"guid", "position", "rotation"?}, ...] for explicit targets, or

• guids + offset [dx, dy, dz] to shift them together, keeping their formation.

The table's type and bounding box (center, size), and global snap points. Snap points that belong to a board are listed by inspect_object on the board.

Horizontal distance between two objects (GUIDs) or points ([x, y, z]), in world units. Returns center (centre to centre), edge (between bounding boxes, 0 if overlapping), dx, dy, dz.

Highlight an object for a few seconds to point it out to the player. color is a TTSim colour name: White, Red, Orange, Yellow, Green, Blue, Purple, Pink, ...

Roll dice with TTSim's physics roll (visibly lifted and spun, like pressing R) and wait until all have come to rest. Coins (and other objects with named faces) are flipped with TTSim's randomize and report their face name, e.g. "Heads"; only numeric dice count towards the total. Returns each die's value and tilt (degrees from lying flat), the total, and cocked: dice tilted more than cocked_tilt (default 10°, for flat surfaces), whose value may be disputed. Dice bounce: roll them where nothing else can be hit, e.g. in a dice tray.

Read dice values without rolling (e.g. after the player rolled): the given dice/coins, or all dice and coins on the table. Coins report their face name, e.g. "Heads". Each die has value, resting, tilt, cocked, tint and position.