jim/ratph6.jim.engine/JimEngine

JimEngine

The heart of JIM. Compiles each module's TypeScript to JVM bytecode (via JimCompiler), 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: (JimLogLine) -> Unit

Receives every console line (chat, Jim.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.jim.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(): JimModule?

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 Jim.on(name, fn).

enqueue

fun enqueue(r: Runnable): Boolean

evaluate

fun evaluate(code: String)

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