LitematicaFolia

Servux Direct Paste placement fidelity

Big thanks to stavapin for an unusually thorough and precise bug report. This release works through it point by point so that a server-side paste matches exactly what the Litematica client shows. Fixed - Replace modes (None / With non-air / All) are now honored. - Entities no longer land offset, and their fractional coordinates rotate correctly. - Entity orientation now rotates and mirrors together with the schematic. - Per-sub-region overrides (enabled, position, rotation, mirror) are applied. - Paste layer behavior and render layer range are respected. - maxBlocksPerChunkTask actually paces large pastes now instead of being advisory. - /litematica save no longer captures an entity twice when it straddles a chunk border. - Bonus: block states such as stairs rotate and mirror correctly, and structure void is never pasted. Validated with 103 unit tests and a 56-check fidelity suite across 12 scenarios on Folia 26.2. For Minecraft 26.2.

LitematicaFolia now runs on Minecraft 1.21.11

This is a real 1.21.11 build, not a compatibility shim. It has its own 1.21.11 server internals, a PacketEvents version that actually supports 1.21.11, and it speaks the Servux protocol that the 1.21.11 Litematica client uses. It also carries every placement-fidelity fix from 0.8.0. What works - Full Servux "Direct Paste" from a real Litematica 1.21.11 client. This was tested end to end on a live Folia 1.21.11 server: a genuine client connects, pastes, and the blocks and entities land correctly. - Coexists with a separate PacketEvents plugin. By default the plugin does not touch PacketEvents at all; it only initializes it if you turn on Easy Place. Tested with a standalone PacketEvents installed and Easy Place enabled: clean joins, no conflict. - Correct placement for rotation, mirror, per-sub-region overrides, replace modes, layer ranges, and entity position and orientation. Which version do I use? - Minecraft 1.21.11: this release. - 26.2: 0.8.x. 26.1.2: 0.4.x/0.6.x. On any version it is not built for, the plugin now disables itself cleanly instead of interfering. Thanks to venson for the report that led to proper 1.21.11 support, and to stavapin for the detailed placement report behind the fidelity fixes this build inherits.

Safety release, nothing changes on a supported 26.2 server. - The plugin now checks the server version at startup and disables itself with a clear error on anything that is not Minecraft 26.2. Bukkit does not block a plugin built for a newer version, so the 26.2 jar could end up running on 1.21.x or 26.1.x servers with a mismatched packet pipeline, which could break every player join. - PacketEvents is now only injected when Easy Place is enabled. The Servux bridge runs on plain plugin messages and never needed it. Version guide: 26.2 -> this release, 26.1.x -> 0.4.x, 1.21.x and older -> unsupported.

First release with an external contribution: CoreProtect support, by UPSOKen. Thanks for a clean PR. Optional hook, no-op default, and it survives CoreProtect dying mid-paste without touching the paste itself.

Added

- CoreProtect integration. Pasted block changes are now recorded in CoreProtect when it's installed, under the player who started the paste (console/RCON pastes log as #litematica). Replacements are logged WorldEdit-style: removal of the old block, then placement of the new one, so /co i and /co rollback behave exactly as they do after a WorldEdit operation. Unchanged blocks are skipped (re-pasting the same schematic writes zero records). Block states only for now; tile-entity NBT and entities are not logged. - logging.coreprotect config toggle (default true). Measured cost on a 4.19M-block stress paste: 5.4 s without logging, 7.1 s with it, plus one CoreProtect consumer-queue entry per changed block. If you paste city-sized schematics and don't need the audit trail, flip it off.

Changed

- Now built against the Paper 26.2 stable dev bundle (build 111). 0.5.1 was built on the build-62 beta bundle.

Compatibility

- Requires CoreProtect API v10+ to log (the plugin prints the detected API version at startup). No CoreProtect, a too-old build, or a failing one: clean no-op, pastes are never affected. - Heads-up for 26.2 servers: stock CoreProtect CE 24.0 predates Minecraft 26.2 and disables itself at boot ("Minecraft 26.2 is not supported"). You need a newer dev or patched CoreProtect build to actually get records on 26.2. Until then the integration simply stays dormant. - Tested on Paper 26.2 (build 111) and Folia 26.2: full unit suite, boot/paste/save smokes with and without CoreProtect, replacement semantics verified against the CoreProtect database, attribution checks, and the 4.19M-block + 629k-tile-entity stress paste on both plain and CoreProtect-enabled servers. Zero errors, all rows ingested. On Folia the logging calls run on region threads; no thread-safety issues in any run. For 26.1.x servers, use the 0.4.x releases.

First release for Minecraft 26.2 Paper API 26.2, JDK 25, Folia supported.

Fixed

- Direct Paste on Leaves/lineage servers (Lophine, Leaves, …) those 26.2 server cores handle the Servux protocol themselves and consumed the plugin's servux:* channels before the plugin could see them: Litematica clients hung forever on "The placement is being uploaded to Servux for pasting". The plugin now reclaims its channels automatically when the Servux bridge is enabled; on plain Paper/Folia this is a clean no op. - /litematica save now writes origin-normalized regions: re-pasting a schematic you saved lands exactly at the coordinates you give it, instead of inheriting the absolute world position it was saved from.

Changed

- Servux wire format re-verified byte-for-byte against upstream Servux 26.2-0.11.1: Direct Paste from vanilla Litematica clients keeps working exactly as on a Fabric+Servux server. - Bundled PacketEvents upgraded to 2.13.0 (26.2 server version strings now parse). - Cleaner protocol logging: one INFO line per inbound packet, hex dumps off by default.

Compatibility

Tested on Paper 26.2 (build 62, boot + paste), Folia 26.2 (built from source, upstream has no published 26.2 build yet; boot + full Servux Direct-Paste end-to-end) and Lophine 26.2 (production). For 26.1.x servers, use the 0.4.x releases.

Fixed: PasteOperation semaphore deadlock (Folia region self-deadlock)

Completes the v0.4.1 fix, which only moved the pass-1 dispatch loop off the region tick thread. Root cause. The pass-2 and deferred-physics-sweep loops were chained with a plain (non-async) thenCompose, which runs on the thread that completed the upstream future, a Folia region tick thread (FoliaCompat.runOnRegion completes it there). Those loops then called the blocking acquireSlot() on that region thread; when the region still had more pending chunk tasks than free CHUNK_THROTTLE permits, it parked in Semaphore.acquire() waiting for permits only it could release → self-deadlock. Regions froze indefinitely (observed ~116h on a production server); the Folia Watchdog logged Tick region ... has not responded without ever crashing. Fix. 1. Both continuation loops now run via thenComposeAsync(..., offRegionExecutor) (Folia async pool / Paper async worker), so every acquireSlot() runs off-region, a blocked dispatch thread can no longer park a region. 2. acquireSlot() now uses tryAcquire(60s): a timeout dispatches the chunk unthrottled and logs a warning instead of blocking forever. The release guard is seeded so an untaken permit is never over-released. No config/schema change vs 0.4.1: in-place drop-in. Normal-load behaviour (32 in-flight chunk-task throttle) unchanged.

v0.3.0+26.1.2: Servux Direct Paste end-to-end

Added

- Real Litematica 0.27.6 clients can now Direct-Paste their schematics to the server with full block-state, tile-entity, entity and pending-tick fidelity, validated in production with 869,514 blocks + 6,516 TEs in 5.6 s. - Inline LitematicaPaste task handler (the maruohon Litematica payload schema, separate from the upstream Servux multi-frame Transmit protocol; both now handled). - Servux BulkRequest fulfillment with per-player rate limiter. - Easy Place V3 server-side scaffold (PacketEvents 2.7, gated off by default). - Java protocol bot for autonomous validation (test-harness/protocol-bot/). - Local Fabric client harness for visual smoke testing.

Fixed

- Brigadier StackOverflowError at command registration (recursive flag dedup via bitmask). - /litematica paste parses off the command thread → no more Folia Watchdog ERRORs on big files. - PackedLongArray switched to compact cross-word packing (the .litematic format). - 7 Servux wire-format discrepancies vs upstream sakura-ryoko/servux 26.1.2-0.10.2. - PacketSplitter cap raised 16 MiB → 128 MiB, configurable. - Proactive S2C_METADATA push 3 s after PlayerJoin so Litematica clients enter Servux mode without user action.

Production gotchas documented (in README + TUTORIAL)

- Litematica client config: must set ENTITY_DATA_SYNC = true in Generic config; PASTE_USING_SERVUX = true alone is useless. - Velocity 3.5: set [packet-limiter] decompressed-bytes-per-second = -1 (default 5 MiB/s kicks Direct Paste). - Paper: add -Dpaper.playerconnection.keepalive=120 for clients running DataFixer on old .litematic files.

Performance

- 4,194,304 blocks + 629,533 tile entities in 9.5 s (stress fixture). - 870 k blocks + 6.5 k tile entities in 5.6 s (real client Direct Paste). - 62 JUnit tests + 3 smoke harnesses all green.