🌊 SchemFlow

⚡ Cloud-native schematic manager with local support, lightning-fast tab completion, and an on-demand world-provisioning API

Purpose-built for multi-server networks — build servers, creative networks, and minigame hosts alike

📥 Download • 📖 Wiki • 🐛 Issues • 💬 Discord

🚀 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

🎯 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

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.

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