Yeow

Theme

Changelog ​

Recording from 2026-08-08. Brief version: daily entry overview (adjacent dates are merged into a date range). Detailed version see repository root changelog.md.

2026-10-17 ​

0.8.0: sync API removed (breaking), event registration split into subscribe/intercept, permission checks extracted; the test suite gained parallel multi-version matrices and fake-client payloads. See the repository changelog.md for details.

  • API: removed 127 *Sync names / 140 declarations, 81 synchronous property accessors (only Player.inventory and BossBar.handle remain), and the callBatch / call exports; field access is now await x.getXxx() / await x.setXxx(v); added the 10 world time/weather/thunder/difficulty/spawn methods and Player.getName(); new read-only snapshots player.snap() / entity.snap() / world.snap()
  • Control plane: registerCommand / registerPermission return a Promise, http.listen returns Promise<HttpResult>, and eventWatch returns a subscription handle with ready
  • Events: eventOn renamed to eventWatch (subscribe: read-only, never waited on); new eventIntercept (intercept: can modify and waits for event.complete); event.subscribe gained mode: "watch"
  • Permission checks: extracted from the event system as onPermissionCheck(handler) (permission.subscribeCheck / permission.complete, async handlers supported)
  • Runtime: event.complete / command.tabComplete use noReply (event completion no longer blocks the JS thread); service registration and queries return via callbacks; getEnv() no longer includes timestamp
  • Verification: Paper full 139/0; Folia full-folia 133/6 (all six known: two platform differences + four probes that need the /yeow admin command); 12-row matrix Paper 138/0, 135/1, 137/1, Folia 132/6, 129/7, 131/7
  • Docs: pages rewritten for the two registration modes, snapshots, async API and the standalone permission checks (cn + en); site published

2026-09-24 ~ 2026-09-27 ​

0.7.0 breaking development (unpublished): unified message protocol + cross-version runtime compatibility + multi-version test matrix.

  • Unified message protocol (0.7.0, breaking, unpublished): uplink $send(channel, t, p), downlink $hm(t, p, r) (bridge gains multi-arg callHandleArgs); JSON envelope nesting and the PluginThread.normalize shim removed; quickjs-wrapper 0.7.0; all components bumped to 0.7.0. Full changes in the repository root changelog.md

  • Cross-version runtime compatibility: compile target Java 17 (class 61, loadable by older Paper remappers); Folia in-flight reclamation (atomic guard; resolves the event/sync 5s deadlock); task ids owned by core (assigned at submission, passed through the scheduler signature; platforms only carry them); namespace-key → legacy constant-name fallback + a reflective Registry compat shim; command suggestion tree syncCommands(); GameRule coerced by its declared type; event bridge gains the world field / fixes sibling-event cross-talk / routes async events to the target region; block PDC errors explicitly on non-tile entities

  • Test suite: single entry node tests/run.mjs <quickjs|full|full-folia>; reporting over HTTP (/config / /ready / /report / /event); the test main process drives the fake client case by case (/client-next, cases isolated so a single failure does not affect others); version protocol derived from minecraft-data (tests/lib/protocol.mjs + self-test); multi-version matrix --mc-versions=<a,b>|matrix; platform-agnostic suite core + adapters; test plugins are now standard Yeow projects (multi-module with --suite filtering + the lightweight minimal); deterministic world by default (fixed seed, opt-out), entity spawns placed by terrain

  • Matrix results (measured, unified passed / failed): Paper — 1.18.2 passed 120 / failed 0; 1.19.4 / 1.20.4 passed 117 / failed 1; 1.21.1 passed 120 / failed 0; 1.21.4 passed 120 / failed 0; 1.21.8 passed 119 / failed 1; 26.1.2 passed 119 / failed 1. Folia — 1.19.4 / 1.20.4 passed 115 / failed 3; 1.21.4 passed 118 / failed 2; 1.21.8 passed 117 / failed 3 (1.21.1 has no upstream build)

  • Docs: unified frame signatures (AGENTS.md / CONTRIBUTING.md / README.md / tests/README.md / message specs cn+en); global self-lock warning for sync calls; environment requirement Java 17+; Folia guide rewritten

2026-09-19 ​

  • Test suite: added test-platform info output (CPU/memory specs via systeminformation) and a fake-player e2e (minecraft-protocol, offline 1.21.4 client; e2e-players subscribes to playerJoin and verifies via player.get, with the harness cross-checking the username); added tests/package.json

  • e2e plugins are now standard Yeow projects (TypeScript + relative-path yeow-api dependency) built by create-yeow's build.js (no hand-written main.js); fixed util:gzip.compress rejecting an omitted level (now -1..9)

  • e2e harness: server output is no longer streamed by default (tail printed on failure; --server-log streams, --outfile records); the runtime jar defaults to the newest local build

  • e2e scenarios expanded (server/material/async util/fs dir ops/command register+dispatch/player direct message + client systemChat check, with per-check info); fixed the ~30s end-of-run delay from a missing explicit exit on the success path

2026-09-18 ​

  • Test suite rewritten into two tiers: node tests/run.mjs simple (QuickJS bridge test component + runtime mvn test, no server) and node tests/run.mjs full (real Paper + test-plugin assertions reported via the [YEOW-E2E] sentinel); new top-level tests/, with a standalone zero-dependency Runner for the QuickJS component (--filter/--json) and auto-discovered e2e plugins under tests/e2e/plugins/; the full tier includes a communication-layer benchmark (debug.payload, fixed small scale, reporting mean/p50/p99/max). See tests/README.md; implementation changes must update the corresponding test components in the same change (see AGENTS.md)

  • quickjs-wrapper: polyfill JS bootstrap moved to native/polyfill/js/ resources; build.mjs generates the C header and hosts the build (invoking zig); license changed from Apache-2.0 to MIT

  • getEnv() timestamp field now (epoch microseconds) → timestamp (epoch milliseconds, microsecond precision); version 0.6.1 → 0.6.2 (not published yet)

2026-09-13 ​

  • yeow-runtime 0.6.1: forced-termination robustness — QuickJSContext enforces thread affinity (foreign-thread calls other than interrupt() throw, avoiding use-after-free/crash); the native interrupt is uncatchable (catch/finally cannot swallow it); if termination fails the engine is abandoned + quarantined (postMessage/ping dropped, its $send raises an uncatchable abort) and a fresh entity is rebuilt (abandonment is temporary: once the stuck call returns or a checkpoint fires the thread destroys its own context and is reclaimed; only a never-returning native op leaks). The timeline is explicit: graceful exit (wait for unloadDone) → timeout → forced kill (interrupt + grace period) → abandon/rebuild; it is documented as platform-agnostic behavior in the Runtime Environment Standard (new "Unload and Forced Termination" section: two MUSTs — ordering and controlled termination, prefer graceful unload — plus an example flow; applies to plugins and Workers alike), referenced by runtime-warning / advanced/lifecycle

2026-09-12 ​

  • quickjs-wrapper rewritten as a Yeow-specific bridge: native C + Zig 0.16 single-toolchain build (six-platform cross-compilation), Java package wiki.yexin.quickjs keeping only evaluate / global function up- and down-calls / job pump / interrupt; Maven group io.yeow → wiki.yexin, new artifact wiki.yexin:yeow-quickjs
  • New native polyfills (quickjs-wrapper/native/polyfill/, C, injected at context creation without touching QuickJS sources): performance.now() (origin captured per context) / performance.timeOrigin (monotonic high-resolution time) and native UTF-8 TextEncoder / TextDecoder; yeow-api global.d.ts declares performance
  • JS↔Java link cleanup (JSON path only): bound $hm handle, single-JNI drainJobs() microtask pump, cbMessageRaw envelope from pre-serialized result JSON, raw batch result concatenation, ASCII/BMP string fast path
  • Mandatory native declaration: yeow.config.json must declare native (build-time check: service:registerNative permission but empty manifest / missing file → build fails; empty manifest at load → refuse to load); registerNativeService verifies serviceId, binary path and SHA-256, refusing when any is missing; directory mode removed (single file only); native-service-allow-untrusted retained (declaration ≠ trusted)
  • Unified permission gate + Worker permissions/destroy: main plugin and Workers share PermissionGate (all message nodes gated, task:* default-owned, deny wins, allow cannot escalate); createWorker({ permissions: { allow?, deny? } }); new worker.destroy()
  • Version 0.5.3 → 0.6.0 (runtime core/paper/folia, yeow-template, create-yeow, quickjs); bundled template jars synced to yeow-runtime-0.6.0.jar / yeow-runtime-folia-0.6.0.jar / yeow-template-0.6.0.jar; yeow-api 0.5.0 → 0.6.0
  • Native Service protocol v2 (breaking): TCP switched from JSON line to a framed protocol (header JSON + raw/chunked body), supporting raw binary and streaming; serviceRequest now returns a fetch-style Response (json()/bytes()/...); event semantics unchanged; also fixes concurrent write interleaving, the missing shutdown frame, and missing size limits
  • Service API now OOP (breaking): registration returns PluginService/NativeService handles; new getService/hasService (with the non-atomicity warning) and unregister; Service base has request/subscribe, PluginService has token/publish, NativeService has ready/onTerminate; runtime service channel gained info/unregister, request/response support headers and requests support a timeout; functional serviceRequest/serviceSubscribe/servicePublish removed
  • Docs: service docs restructured into three scenarios (plugin provides its own / dependency package wraps calls / dependency package embeds a service), with the self-containment design moved to the most complex scenario
  • Removed experimental integration features: deleted the Adapter Specification and Java Plugin Integration (requestService/subscribeService) docs, their code (requestJava/subscribeJava, the registerPluginEntity(PluginEntity) overload) and site navigation; may be merged back into the mainline later
  • Plugin package cache threshold: new assets.cache-max-bytes (default 30 MiB); packages larger than this are not cached in memory (falls back to direct ZipFile reads); <=0 = unlimited
  • /yeow load enhancement: when the path is not found, fall back to plugins/Yeow/<path> then plugins/Yeow/<name>-<version>.yeow.zip (case-insensitive, exact-case preferred, newest version wins)
  • CI rewritten: Zig build + smoke test, v* tags auto-publish yeow-quickjs.jar

2026-09-06 ​

  • yeow-runtime 0.5.2 → 0.5.3: in-memory asset cache (pre-parsed at load, enabled by default) + __plugin.version/author fix + native dynamic approval replaced by config switch (allow with warning by default) + auto merge-and-write-back of missing config fields; yeow-template / create-yeow synced to 0.5.3

2026-08-26 ​

  • Docs: setMotd persists to server.properties — use the serverPing event write-back for dynamic MOTD (not persisted)
  • yeow-runtime 0.5.1 → 0.5.2: hung auto-reload (30s warn / 120s reload, enabled by default, cooldown 300s / max 3 retries) + BudgetScaler encoding fix; yeow-template synced to 0.5.2

2026-08-21 ​

  • yeow-runtime 0.5.0 → 0.5.1: Fix Adventure 4.20+ TranslatableComponent.args() NoSuchMethodError (Paper 26.2 compat)
  • yeow-template 0.5.0 → 0.5.1: Depends on runtime 0.5.1
  • Template jars synced to 0.5.1

2026-08-20 ​

  • Version 0.5.0: yeow-api / create-yeow / yeow-runtime / yeow-template full version upgrade (BossBar/Scoreboard OOP + breaking change eliminating uuid friction; template depends on yeow-api ^0.5.0)
  • API refactor: BossBar / Scoreboard changed to OOP; eliminate "must pass uuid" friction (potion/advancement/sound moved up as instance methods, target parameters accept objects)
  • Value domain appendix structure adjustment: Block state directly maintained + new reference implementation section
  • Block state state retains type (number/boolean)
  • Block state: New common key-value specification table
  • New Material.getMaxDurability (and synchronous version)
  • Documentation cleanup: API index rewrite and ⭐ marker reassignment / Task·event statistics verification / Remove date annotations / Value domain references / http-server delete examples
  • Development mode hot reload allows reloading permissions (modifying permissions takes effect with hot reload)

2026-08-19 ​

  • fetch arrayBuffer + init.js split into polyfill.js (TextEncoder / TextDecoder)
  • util naming convention: Default async, Sync suffix + global TextEncoder/TextDecoder
  • Game rule value domain: Output camelCase + input truly lenient

2026-08-18 ​

  • New world.isChunkGenerated
  • Remove Player#setBorder (client boundary; retain world.setBorder*)
  • assets channel: Remove permission interception + dest强制限定 plugin directory

2026-08-17 ​

  • Version upgrade 0.4.2 / 0.4.3 / 0.4.4 (yeow-api / create-yeow)
  • http.request response body Uint8Array-ified + fetch on-demand decoding (responseEncoding, body binary, remove requestSync)
  • $_send closure-ified: Externally only usable $send
  • New debug:payload (payload echo)
  • dev-server: Remove proxy capability
  • Fix getItemInMainHand NPE (attributeModifiers is null)
  • Fix concurrent event mode field writeback failure (deathMessage etc.)
  • Player inherits LivingEntity / Entity (setVelocity etc. available)

2026-08-16 ​

  • yeow-fflate 0.3.1: ZipReader
  • Version upgrade (0.4.1 / 0.1.2)
  • New player.sendBlockChange (client fake block)
  • Consistency fix (overall read-through review)
  • http-server respond: body + encoding (remove bodyBase64)
  • yeow-server: mount / mountAssets directory request try index.html
  • fs.list returns entry names (no longer leaks absolute paths)

2026-08-15 ​

  • Value domain appendix structure adjustment: Platform enums directly maintained + version change domain regularization
  • Value domain format unification (R1-R5 framework): Potion/particle/attribute key-ified + appendix completion
  • Protocol/API consistency revision (P1-P4): Entity type key-ified, enum lowercase, item/coordinate unified
  • Dev mode stack trace fix: Unhandled rejection can also restore complete async chain (P1-P6)
  • init.js fix: interval parameters / GC flush / fetch hanging / duplicate logs
  • dir channel merged into env (pluginDir) + log channel level support
  • Event handler throwing error no longer hangs event bridge (event.complete finally releases)
  • Remove dedupe plugin: yeow-api multiple copies can safely coexist
  • fs API: Binary-first (Node-style encoding) + remove Base64 dedicated API
  • assets.read merge: Default Uint8Array + explicit encoding
  • Version upgrade (0.4.0)
  • Streaming API: File stream + chunked gzip; util limits configurable; http callback fix
  • yeow-utils split into yeow-command + yeow-server (independent npm packages)
  • Version upgrade (0.3.10 / 0.1.30)

2026-08-14 ​

  • Three fixes: dev-server Chinese garbled / event player zero-roundtrip construction / log prefix alignment
  • PlayerDeath ghost trigger: Root cause located and fixed
  • Event triggered within task → 5s deadlock (Paper scheduler) fix
  • Paper scheduler restores pre-split thread model (setBlock throughput regression)
  • New util channel (gzip + UTF-8 ↔ byte conversion)
  • Profiler: Virtual plugins (Worker) do not alert heartbeat timeout by default
  • CommandBuilder overload matching validates enum values
  • path module compatible with Windows backslash paths

2026-08-13 ​

  • Callback system cross-generation crosstalk fix (PlayerDeath ghost trigger root cause)
  • yeow-utils Command API supports Permission objects
  • Version upgrade (0.3.2 / 0.1.23)
  • Timer channel fix (three items)
  • Event writeback field expansion (common stable fields) + Folia aligns with Paper
  • Event writeback mechanism expansion (three methods) and death message writeback
  • Folia scheduler hardening (ghost execution blocking / LOW starvation protection / unload cleanup)
  • Version upgrade (0.3.0 release)
  • API coverage expansion (Entity / WorldBorder / Tab / batch tasks / Inventory contents)
  • Folia: Tasks / events / permissions fully aligned with Paper
  • Folia: Real-machine verification fix
  • Folia: Scheduler v1 polish and watchdog
  • PDC / ItemStack API expansion
  • Inventory unified refactor
  • Documentation (event reentrant deadlock special section etc.)
  • Runtime fix: 8 audit-confirmed bugs
  • quickjs-wrapper 3.9.0: QuickJSContext.interrupt()
  • Task executor audit fix: 30 items
  • Documentation structure optimization

2026-08-12 ​

  • Folia: Scheduler scaffolding + runtime split completion

2026-08-11 ​

  • Runtime architecture: core / paper dual module split
  • Protocol layer: instance id opaque handle
  • Scheduler fix

2026-08-10 ​

  • Scheduler: Event spin no-budget drain

2026-08-09 ​

  • Permission system (permissionCheck / registerPermission)
  • CommandSender type refactor
  • Java plugin integration API
  • dev-server AI / headless mode
  • Documentation and templates

2026-08-08 ​

  • Text and Message objects
  • Worker API (virtual plugins)
  • HTTP / yeow-utils
  • Other APIs
  • Documentation site and AI workflow