SchemFlow

# 🌊 SchemFlow <div align="center"> <img src="https://cdn.modrinth.com/data/cached_images/e1fac996c4818414f4e52a5e27b5dba5c849ab92_0.webp" alt="SchemFlow Logo" width="320"> (https://img.shields.io/github/license/c4g7-dev/SchemFlow?style=for-the-badge)](https://github.com/c4g7-dev/SchemFlow/blob/main/LICENSE) (https://img.shields.io/github/v/release/c4g7-dev/SchemFlow?style=for-the-badge&color=brightgreen)](https://github.com/c4g7-dev/SchemFlow/releases) (https://img.shields.io/badge/Java-21-orange?style=for-the-badge&logo=openjdk)](https://openjdk.org/) (https://img.shields.io/badge/Paper-1.21+-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* (https://modrinth.com/plugin/schemflow) • (https://github.com/c4g7-dev/SchemFlow/wiki) • (https://github.com/c4g7-dev/SchemFlow/issues) • (https://discord.gg/eNNbqS4N2H) </div> --- ## 🚀 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, smart cached tab-completion, and now a **developer API** that lets other plugins provision and tear down worlds on the fly. Fully compatible with native WorldEdit / FastAsyncWorldEdit formats. ### ⚡ What's New in v0.5.13 - **🔌 Developer API** — provision and dispose worlds **on demand from your own plugin**, fully async, with a completion signal. Purpose-built for per-round minigame maps. - **🎯 Absolute-Origin Paste** — restore a schematic at its **exact authored coordinates**, so named locations (spawns, corners, regions) stay valid in the freshly created world. - **🧱 Map Builder Hook** — save a `pos1`/`pos2` selection straight to S3 **preserving the absolute origin** for later one-call provisioning. - **🧹 One-Call World Teardown** — unload (no save) and delete an ephemeral world in a single call. ### ⚡ What's New in v0.5.12 - **🏠 Local Schematic Support** — work offline with `local:name` syntax for downloaded schematics - **⚡ Lightning-Fast Tab Completion** — smart caching eliminates network delays (90% fewer S3 calls) - **🛡️ Safe Update Command** — dedicated `/schemflow update` with mandatory `--confirm` - **🎯 Optimized Performance** — cached data for instant completion and duplicate prevention --- ## ✨ Feature Showcase <table> <tr> <td width="50%"> ### 🎮 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` - **Air block control** with `-a` - **Biome preservation** with `-b` (default on) - **Large schematic** optimization </td> <td width="50%"> ### 🤖 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 </td> </tr> </table> --- ## 🎯 Perfect For <div align="center"> | 🏢 **Build Servers** | 🎮 **Creative Networks** | 🏆 **Minigame Hosts** | 🌍 **Survival Servers** | |:---:|:---:|:---:|:---:| | Template management | Plot schematic storage | Per-round map loading | Structure backups | | Build preservation | Player submissions | Arena distribution | Town planning | | Collaboration tools | Contest archives | Rapid deploy & teardown | Restoration tools | </div> --- ## 📋 Requirements - **Minecraft**: 1.21 – 1.21.11 (Paper / Purpur) - **Java**: 21+ - **WorldEdit** 7.2.18+ **or** FastAsyncWorldEdit - *(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> ` | Export selection → S3 | | `/schemflow update <name> --confirm` | Safely overwrite an existing schematic | | `/schemflow paste n