Changelog

Unreleased

• Fixed: /fwg script run was calling the synchronous, blocking World#getChunkAt once per chunk (1024 times per region) to force-load terrain before running generateRegion, causing repeated Watchdog "server has not responded" timeouts/freezes on any ungenerated area. Script regions are now loaded via World#getChunkAtAsync (Paper's supported non-blocking API, same pattern already used by normal /fwg start jobs) and the script only runs once all of a region's chunks are confirmed ready.

• Added docs/SCRIPTING.md: a dedicated Custom Generation scripting guide (bindings, full api reference, region-coordinate math, patterns, troubleshooting table). README's scripting section now summarizes and links to it instead of duplicating it.

• Added update checking: on enable, FastWorldGen asynchronously queries Hangar (hangar.papermc.io/firesmasher/FastWorldGen) for the latest release and compares it against the running version. Result is logged to console in color; if an update is available, operators (and fastworldgen.admin holders) get a colored chat notice shortly after joining.

• Added the wand: /fwg wand give hands out a named Blaze Rod; left-click sets position 1, right-click sets position 2 (WorldEdit-style, clicks are cancelled so nothing breaks or places). /fwg wand save <name> fills a vanilla Structure from the selection and writes it to data/structures/<name>.nbt. Also adds /fwg wand pos1|pos2|info|clear.

  • New fastworldgen.wand permission (defaults to op, included in fastworldgen.admin).
  • Selections capped at 2,000,000 blocks and must stay within a single world.

FastWorldGen 1.1.0

• Added /fwg continue [world] to explicitly re-plan and continue a saved job after a restart, instead of that only happening automatically when another command triggered it.
• Memory: regions are now streamed as compact bitmasks instead of per-chunk objects during planning, and generated chunks are unloaded once a configurable number stay loaded at once (safety.max-loaded-chunks), bounding memory growth on large-radius jobs.
• Default config and built-in fallbacks retuned for a 4 GB heap / 2 CPU cores: lower chunks-per-tick-batch, max-chunks-per-tick-batch, max-inflight-chunk-tasks, max-loaded-chunks, and regions-per-batch, with adjusted MSPT watermarks.
• Added Custom Generation: embeds Mozilla Rhino (ES6 JavaScript) for scripted generation.
  • New /fwg script run <script.js> [world ...] [radius|bounds ...] [--fresh], /fwg script list, /fwg script status [world], /fwg script cancel [world].
  • New scripts/ folder for .js scripts and data/structures/ folder for .nbt structures, created under the plugin's data folder on startup.
  • Scripts get world, seed, area, random, and an api object for block placement, .nbt structure placement (via Paper's StructureManager), deterministic per-region randomness, and logging.
  • Script jobs run on the main thread with the same chunk force-load/unload discipline as normal generation, and share the one-job-per-world limit.
  • Per-call execution timeout (scripting.max-script-execution-ms, default 5000ms) guards against a runaway script hanging the server; scripting.enabled can disable the feature entirely.
  • New fastworldgen.script permission (defaults to op, included in fastworldgen.admin).

Requirements: Paper 1.21.11, Java 21+.

FastWorldGen 1.0.0

Initial release.

• Plan-first pipeline: /fwg plan shows total chunks, existing chunks, chunks to generate, and region count before any generation happens.
• /fwg start begins generation immediately after planning; works with just a world name (uses a configurable default radius) or explicit radius/bounds + optional center.
• Existing chunks are skipped by default; pass --fresh to force regeneration.
• Work is grouped into 32×32 chunk regions and batches, ordered for spatial locality.
• Adaptive throughput throttles generation based on live server tick time (MSPT).
• /fwg status shows live progress, speed, ETA, region/batch counts, and MSPT.
• Detailed logging: per-region and per-batch completion lines as generation runs, plus a full summary (chunks generated/failed, elapsed time, average speed) when a job finishes.
• /fwg pause / /fwg resume / /fwg cancel, all graceful — in-flight chunk operations are allowed to finish rather than being interrupted.
• Job state survives server restarts; the world is re-inspected on startup rather than trusting stored progress.
• Full permission set, all defaulting to op.

Requirements: Paper 1.21.11, Java 21+.