🌊 SchemFlow

---

🚀 Why SchemFlow?

Stop copying .schem files between servers by hand. SchemFlow stores every schematic in S3-compatible object storage (AWS S3, MinIO, Cloudflare R2, Wasabi, DigitalOcean Spaces…) and serves it to any server on demand, with groups, trash & restore, undo/redo and smart cached tab-completion. Its developer API lets other plugins provision per-round maps on the fly: pasted off the main thread, fully lit, with biomes and display-entity models intact. Fully compatible with native WorldEdit / FastAsyncWorldEdit formats.

⚡ What's New in v0.5.17

• 💬 Commands Reply Again On 26.x: /schemflow replies (help, lists, errors, confirmations) were silently dropped on Minecraft 26.x by an outdated chat library. They now go through Paper's built-in messaging.

⚡ What's New in v0.5.16

• 🪔 Display-Entity Models Survive: models built from block/item/text displays riding a root entity (lamps, furniture, decorations) no longer vanish after a paste. Existing schematics are restored as they are, no re-export needed.
• 🌸 Biomes Travel With The Map: map exports store biomes and pastes write them back, so grass, foliage, water and sky colours and snow match the original. Re-export older maps to get their biomes.

⚡ What's New in v0.5.15

• 💡 Lit Round Maps: provisioned maps no longer come out dark. provisionRoundWorld completes only once the map is lit, so a world unloaded or copied right afterwards keeps its light.

⚡ What's New in v0.5.14

• 🚀 Lag-Free Round Provisioning: pastes run off the main thread under FastAsyncWorldEdit. A large map went from a ~2.9 s main-thread freeze to ~110 ms.
• 🗺️ Headless Map Capture: /schemflow savemap and saveRegionAsMap(...) save a region of any world to S3 without an in-game selection.

---

✨ Feature Showcase

🎮 Hybrid Schematic Management Cloud Storage: S3/MinIO for cross-server sync Local Support: offline access via local:name Smart Caching: instant cached tab-completion Safe Updates: dedicated update command with confirmation Groups: organize schematics by group:name 🔧 Advanced WorldEdit Support FastAsyncWorldEdit fully compatible Entity handling with -e, including display-entity models Air block control with -a Biomes stored and restored (-b, default on) Lit pastes through the server's light engine

🤖 Automation & Developer API On-demand world provisioning API (reflection-friendly, zero compile-time dependency) Absolute-origin paste for valid authored coordinates Skript integration with custom syntax Trash & Restore + Undo/Redo Group lifecycle (create / delete / rename) 🌐 Cloud Storage Integration MinIO self-hosted AWS S3 enterprise-grade Compatible providers: Cloudflare R2, DO Spaces, Wasabi… Ephemeral cache with automatic cleanup

---

🎯 Perfect For

---

📋 Requirements

• Minecraft: 1.21 – 1.21.11 and 26.1 – 26.3 (Paper / Purpur)
• Java: 21+
• WorldEdit 7.2.18+ or FastAsyncWorldEdit (recommended: provisioning pastes run off the main thread; 26.3 needs FAWE 2.16.0+)
• (optional) Skript 2.7+ for automation

⚡ Quick Start

1. Drop SchemFlow-x.y.z-all.jar into plugins/ and start the server once.
2. Edit plugins/SchemFlow/config.yml with your S3/MinIO endpoint, accessKey, secretKey, and bucket.
3. Run /schemflow reload. Done.

---

🎮 Commands

Command	Description
/schemflow pos1 · pos2	Set selection corners
/schemflow upload <name> [-eab] [-group g]	Export selection → S3
/schemflow update <name> --confirm	Safely overwrite an existing schematic
/schemflow paste [group:]name [-eab] · paste local:name	Paste from S3 or local cache
/schemflow fetch [group:]name	Download to local cache
/schemflow list · local	List server / local schematics
/schemflow delete [group:]name · restore name · trash clear --confirm	Trash & restore
/schemflow undo · redo	Undo/redo last paste or delete
/schemflow groups · group create/delete/rename	Group management
/schemflow savemap <world> <x1 y1 z1> <x2 y2 z2> <group> <name>	Save a region of any world as a map (no selection needed)
/schemflow provision <world> · cache · reload	World provisioning, cache, hot reload

Permissions are granular (schemflow.<command>); schemflow.admin grants everything.

---

🔌 Developer API

Other plugins can drive SchemFlow on demand: provision a fresh world, paste a map at its exact authored coordinates, and get a completion signal, without a compile-time dependency. Everything hangs off WorldProvisioner and is safe to call from any thread.

Method	Returns	Purpose
provisionRoundWorld(world, group, schematic, pasteAtOrigin, gamerules)	CompletableFuture<World>	Create a void world, fetch from S3 and paste off the main thread, apply gamerules. Completes only once the map is pasted, its models are spawned and it is lit. Idempotent.
disposeWorld(world)	CompletableFuture<Void>	Unload (no save) + delete folder.
inspect(group, schematic)	SchematicInfo	Dimensions + authored min corner (for fixed-point pasting).
saveSelectionAsMap(player, group, name)	CompletableFuture<Void>	Save a pos1/pos2 selection to S3 preserving the absolute origin.
saveRegionAsMap(pos1, pos2, group, name)	CompletableFuture<Void>	Same, headless: two corners in any loaded world, no player needed.

Object plugin = Class.forName("com.c4g7.schemflow.SchemFlowPlugin")
        .getMethod("getInstance").invoke(null);
Object prov = plugin.getClass().getMethod("getProvisioner").invoke(plugin);

CompletableFuture<?> future = (CompletableFuture<?>) prov.getClass()
        .getMethod("provisionRoundWorld", String.class, String.class, String.class, boolean.class, java.util.Map.class)
        .invoke(prov, "round_42", "blockparty", "W-BLOCKPARTY-regular-Island", true, null);

future.whenComplete((world, error) -> {
    if (error != null) return;          // handle failure
    // (org.bukkit.World) world is pasted, lit and populated: safe to teleport players in
});

Paste-at-origin restores blocks at their authored coordinates and requires maps saved via saveSelectionAsMap or saveRegionAsMap; schematics from /schemflow upload paste relatively. The method signatures are a stable reflection contract.

---

⚙️ Configuration

endpoint: "minio.example.com:9000"   # host:port, or full http(s):// URL
secure: true
accessKey: "YOUR_ACCESS_KEY"
secretKey: "YOUR_SECRET_KEY"
bucket: "schematics"
extension: "schem"                    # schem (recommended) or schematic

storage:
  rootDir: "FlowStack/SchemFlow"      # object-key prefix in the bucket
  defaultGroup: "default"

downloadDir: "plugins/SchemFlow/schematics"
cacheRefreshSeconds: 30               # 0 disables periodic refresh

lighting:                             # relight after pastes (Paper 1.21+)
  relightAfterPaste: true
  maxWaitSeconds: 60
  chunksPerTick: 32

maps:                                 # map exports and round pastes
  copyBiomes: true
  restorePassengers: true             # rebuild display-entity models
  entitiesPerTick: 128

---