# 🌊 SchemFlow

[![License](https://img.shields.io/github/license/c4g7-dev/SchemFlow?style=for-the-badge)](https://github.com/c4g7-dev/SchemFlow/blob/main/LICENSE) [![Release](https://img.shields.io/github/v/release/c4g7-dev/SchemFlow?style=for-the-badge&color=brightgreen)](https://github.com/c4g7-dev/SchemFlow/releases) [![Java](https://img.shields.io/badge/Java-21+-orange?style=for-the-badge&logo=openjdk)](https://openjdk.org/) [![Paper](https://img.shields.io/badge/Paper-1.21--26.3-00ADD8?style=for-the-badge&logo=minecraft)](https://papermc.io/) **⚡ 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](https://modrinth.com/plugin/schemflow) • [📖 Wiki](https://github.com/c4g7-dev/SchemFlow/wiki) • [🐛 Issues](https://github.com/c4g7-dev/SchemFlow/issues) • [💬 Discord](https://discord.gg/eNNbqS4N2H)

--- ## 🚀 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 [-eab] [-group g]` | Export selection → S3 | | `/schemflow update --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 ` | Save a region of any world as a map (no selection needed) | | `/schemflow provision ` · `cache` · `reload` | World provisioning, cache, hot reload | > Permissions are granular (`schemflow.`); `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` | 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` | Unload (no save) + delete folder. | | `inspect(group, schematic)` | `SchematicInfo` | Dimensions + authored min corner (for fixed-point pasting). | | `saveSelectionAsMap(player, group, name)` | `CompletableFuture` | Save a `pos1`/`pos2` selection to S3 **preserving the absolute origin**. | | `saveRegionAsMap(pos1, pos2, group, name)` | `CompletableFuture` | Same, headless: two corners in any loaded world, no player needed. | ```java 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 ```yaml 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 ``` ---

**🌊 SchemFlow v0.5.17 — On-demand world provisioning for build & game networks** [⭐ GitHub](https://github.com/c4g7-dev/SchemFlow) • [🚀 Download](https://modrinth.com/plugin/schemflow) • [💬 Discord](https://discord.gg/eNNbqS4N2H) *Open source • Apache-2.0 • Built for the Minecraft community*

SchemFlow

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details