? SchemFlow
⚡ 支持本地存储的云原生结构图管理器,具备闪电般的 Tab 补全速度和按需世界生成 API
专为多服务器网络打造——适用于建筑服、创造服和迷你游戏服
? 下载 • ? Wiki • ? Issues • ? Discord
? 为什么选择 SchemFlow?
别再手动在服务器之间复制 .schem 文件了。SchemFlow 将每个结构图存储在兼容 S3 的对象存储中(AWS S3、MinIO、Cloudflare R2、Wasabi、DigitalOcean Spaces…),并按需向任何服务器提供服务,支持分组、回收站与恢复、撤销/重做以及智能缓存的 Tab 补全。其 开发者 API 允许其他插件即时生成每轮地图:在主线程之外粘贴,完全照明,并保留生物群系和显示实体模型。完全兼容原生的 WorldEdit / FastAsyncWorldEdit 格式。
⚡ v0.5.17 新增功能
- ? 26.x 版本再次回复命令:由于过时的聊天库,
/schemflow 的回复(帮助、列表、错误、确认)在 Minecraft 26.x 中被静默丢弃。现在它们通过 Paper 内置的消息系统发送。
⚡ v0.5.16 新增功能
- ? 显示实体模型得以保留:由骑乘在根实体上的块/物品/文本显示构建的模型(如灯具、家具、装饰)在粘贴后不再消失。现有的结构图会按原样还原,无需重新导出。
- ? 生物群系随地图迁移:地图导出时会存储生物群系,粘贴时会将它们写回,从而使草地、植被、水面和天空颜色及积雪与原图保持一致。重新导出旧地图即可获取其生物群系数据。
⚡ v0.5.15 新增功能
- ? 亮化的回合地图:生成的地图不再昏暗。
provisionRoundWorld 仅在地图被照亮后才完成,因此随后卸载或复制的世界会保持其光照状态。
⚡ v0.5.14 新增功能
- ? 无卡顿的回合地图生成:在 FastAsyncWorldEdit 支持下,粘贴操作在主线程之外运行。大型地图的主线程冻结时间从约 2.9 秒缩短至约 110 毫秒。
- ?️ 无头地图捕获:
/schemflow savemap 和 saveRegionAsMap(...) 可将任何世界的区域保存到 S3,无需在游戏内进行选择。
✨ 功能展示
? 混合式结构图管理
- 云存储:使用 S3/MinIO 实现跨服务器同步
- 本地支持:通过
local:name 实现离线访问
- 智能缓存:瞬间响应的缓存 Tab 补全
- 安全更新:带有确认机制的专用更新命令
- 分组管理:通过
group:name 组织结构图
? 高级 WorldEdit 支持
- 完全兼容 FastAsyncWorldEdit
- 支持带
-e 参数的实体处理,包括显示实体模型
- 支持带
-a 参数的空气方块控制
- 存储和还原生物群系(
-b,默认开启)
- 通过服务器光照引擎进行亮化粘贴
|
? 自动化与开发者 API
- 按需世界生成 API(支持反射,零编译期依赖)
- 绝对原点粘贴以保留有效的作者坐标
- 带有自定义语法的 Skript 集成
- 回收站与恢复 + 撤销/重做
- 分组生命周期管理(创建/删除/重命名)
? 云存储集成
- MinIO 自建部署
- AWS S3 企业级服务
- 兼容提供商:Cloudflare R2、DO Spaces、Wasabi 等
- 临时缓存配合自动清理
|
? 适用场景
| ? 建筑服 |
? 创造服网络 |
? 迷你游戏服 |
? 生存服 |
| 模板管理 |
地块结构图存储 |
每轮地图加载 |
结构备份 |
| 建筑保存 |
玩家作品提交 |
竞技场分发 |
城镇规划 |
| 协作工具 |
竞赛存档 |
快速部署与拆除 |
修复工具 |
? 要求
- Minecraft: 1.21 – 1.21.11 和 26.1 – 26.3 (Paper / Purpur)
- Java: 21+
- WorldEdit 7.2.18+ 或 FastAsyncWorldEdit(推荐:生成类粘贴操作在主线程之外运行;26.3 需要 FAWE 2.16.0+)
- (可选) Skript 2.7+ 用于自动化
⚡ 快速开始
- 将
SchemFlow-x.y.z-all.jar 放入 plugins/ 目录并启动服务器一次。
- 编辑
plugins/SchemFlow/config.yml,配置你的 S3/MinIO endpoint、accessKey、secretKey 和 bucket。
- 运行
/schemflow reload。完成。
? 命令
| 命令 |
描述 |
/schemflow pos1 · pos2 |
设置选区角点 |
/schemflow upload <name> [-eab] [-group g] |
导出选区 → S3 |
/schemflow update <name> --confirm |
安全覆盖现有结构图 |
/schemflow paste [group:]name [-eab] · paste local:name |
从 S3 或本地缓存粘贴 |
/schemflow fetch [group:]name |
下载到本地缓存 |
/schemflow list · local |
列出服务器/本地结构图 |
/schemflow delete [group:]name · restore name · trash clear --confirm |
回收站与恢复 |
/schemflow undo · redo |
撤销/重做上次粘贴或删除操作 |
/schemflow groups · group create/delete/rename |
分组管理 |
/schemflow savemap <world> <x1 y1 z1> <x2 y2 z2> <group> <name> |
将任意世界的区域保存为地图(无需选区) |
/schemflow provision <world> · cache · reload |
世界配置、缓存、热重载 |
权限粒度细(schemflow.<command>);schemflow.admin 授予所有权限。
? 开发者 API
其他插件可以按需驱动 SchemFlow:即时配置一个新世界,在精确的作者坐标处粘贴地图,并获得完成信号,无需编译时依赖。所有内容都基于 WorldProvisioner,并且可以从任何线程安全调用。
| 方法 |
返回值 |
用途 |
provisionRoundWorld(world, group, schematic, pasteAtOrigin, gamerules) |
CompletableFuture<World> |
创建空世界,从 S3 获取并在主线程外粘贴,应用游戏规则。仅在地图已粘贴、模型已生成且已点亮后完成。幂等操作。 |
disposeWorld(world) |
CompletableFuture<Void> |
卸载(不保存)+ 删除文件夹。 |
inspect(group, schematic) |
SchematicInfo |
尺寸 + 作者定义的最小角点(用于固定点粘贴)。 |
saveSelectionAsMap(player, group, name) |
CompletableFuture<Void> |
将 pos1/pos2 选区保存到 S3,保留绝对原点。 |
saveRegionAsMap(pos1, pos2, group, name) |
CompletableFuture<Void> |
同上,无头模式:任意加载世界中的两个角点,无需玩家参与。 |
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; // 处理失败
// (org.bukkit.World) world 已粘贴、点亮并填充:可安全传送玩家进入
});
按原点粘贴会在其作者定义的坐标处还原方块,要求通过 saveSelectionAsMap 或 saveRegionAsMap 保存的地图;来自 /schemflow upload 的结构图则是相对粘贴。方法签名是一个稳定的反射契约。
⚙️ 配置
endpoint: "minio.example.com:9000" # 主机:端口,或完整 http(s):// URL
secure: true
accessKey: "YOUR_ACCESS_KEY"
secretKey: "YOUR_SECRET_KEY"
bucket: "schematics"
extension: "schem" # schem(推荐)或 schematic
storage:
rootDir: "FlowStack/SchemFlow" # 存储桶中的对象键前缀
defaultGroup: "default"
downloadDir: "plugins/SchemFlow/schematics"
cacheRefreshSeconds: 30 # 0 禁用定期刷新
lighting: # 粘贴后重新照亮(Paper 1.21+)
relightAfterPaste: true
maxWaitSeconds: 60
chunksPerTick: 32
maps: # 地图导出和圆形粘贴
copyBiomes: true
restorePassengers: true # 重建显示实体模型
entitiesPerTick: 128
? SchemFlow v0.5.17 — 面向建造与游戏网络的按需世界配置
⭐ GitHub • ? 下载 • ? Discord
开源 • Apache-2.0 • 为 Minecraft 社区构建
? 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
? 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
| ? 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 |
? 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
- Drop
SchemFlow-x.y.z-all.jar into plugins/ and start the server once.
- Edit
plugins/SchemFlow/config.yml with your S3/MinIO endpoint, accessKey, secretKey, and bucket.
- 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
? SchemFlow v0.5.17 — On-demand world provisioning for build & game networks
⭐ GitHub • ? Download • ? Discord
Open source • Apache-2.0 • Built for the Minecraft community
评论 0
登录后参与评分
还没有评论,来抢沙发吧