tessera/ratph6.tessera.engine/TesseraEngine

TesseraEngine

The heart of Tessera. Compiles each module's TypeScript to JVM bytecode (via TesseraCompiler), invokes its main() entry point, and dispatches triggers by invoking the named exported function through a cached MethodHandle. No V8, no JNI on the dispatch path.

Minecraft-free on purpose, so the whole pipeline can be exercised from a plain JVM test.

Properties

var booted: Boolean

var chatSink: (String) -> Unit

consoleSink

@Volatile

var consoleSink: (TesseraLogLine) -> Unit

Receives every console line (chat, Tessera.log, errors). The console window registers here.

jsThread

@Volatile

var jsThread: Thread?

modulesChangedSink

@Volatile

var modulesChangedSink: () -> Unit

Invoked (on the JS/render thread) after modules load or reload, so the client can re-register script commands with brigadier (commands from post-startup loads are otherwise "unknown").

resetHooks

val resetHooks: CopyOnWriteArrayList<Runnable>

Callbacks run on reload/shutdown so MC-side state (e.g. HUD displays) can be cleared.

scriptClassLoader

@Volatile

var scriptClassLoader: ClassLoader

Class loader scripts compile against (so import { ChatLib } from 'ratph6.tessera.api' resolves).

tickCount

@Volatile

var tickCount: Long

Functions

bootstrap

fun bootstrap(modulesDir: Path, scriptClassLoader: ClassLoader)

cancelCurrentEvent

fun cancelCurrentEvent()

chat

fun chat(message: String)

clearTimer

fun clearTimer(id: Int)

consoleLog

fun consoleLog(level: String, message: String)

currentModule

fun currentModule(): TesseraModule?

dispatch

fun dispatch(type: String, vararg args: Any?): Boolean

Fire all triggers of type. Returns true if any callback cancelled the event. JS thread only.

dispatchAsync

fun dispatchAsync(type: String, vararg args: Any?)

Dispatch from any thread (e.g. a mixin on the netty/packet thread): marshalled onto the JS thread, so it's observe-only (the originating call has already proceeded — no inline cancel). Cheaply skips work when no script listens for type, so high-volume sources (packets) are free until something registers.

dispatchCommand

fun dispatchCommand(name: String, args: Array<String>): Boolean

Run a client command registered by a script (by name), passing the raw args array.

emitEvent

fun emitEvent(name: String, args: Array<out Any?>)

Emit a custom event to scripts listening via Tessera.on(name, fn).

enqueue

fun enqueue(r: Runnable): Boolean

evaluate

fun evaluate(code: String)

Run a one-off TypeScript snippet (used by /te eval) on GraalJS, so it gets real ECMAScript (arrays, closures, let, JSON). The Tessera API objects (Tessera, Event, ChatLib, ...) are bound as globals by GraalRuntime, so no import line is needed.