TemplateWorld 是一款专为 AllayMC 设计的插件。它允许你基于模板创建仅在运行时存在的临时世界。该插件非常适合小游戏服务器,能够自动创建并清理临时游戏房间。
基于预设模板创建临时世界
仅限运行时加载,世界数据不会持久化到磁盘
支持不同的世界存储格式(如 LEVELDB 等)
服务器重启时自动清理临时世界文件
为开发者提供简单的 API 调用接口
[1] 从 Releases 下载最新版本的 JAR 文件。
[2] 将其放入服务器的 plugins 文件夹中。
[3] 启动服务器即可。
准备模板:
[1] 在服务器根目录下创建一个名为 templates 的文件夹。
[2] 将你的世界文件夹复制到 templates/ 目录中。
[3] 文件夹的名称将作为该模板的名称。
命令列表:
- /template create <模板名称> - 从指定模板创建一个临时世界
- 权限节点:templateworld.command
Gradle 依赖配置:
代码:
repositories {
mavenCentral()
}
dependencies {
// 引入 TemplateWorld API
compileOnly(group = "org.allaymc", name = "template-world", version = "0.1.0")
}
代码调用示例:
Java:
import org.allaymc.templateworld.TemplateWorld;
import org.allaymc.api.world.World;
// 使用默认的 LEVELDB 格式创建临时世界
World tmpWorld = TemplateWorld.createTmpWorld("bedwars_map1");
// 使用自定义格式创建(模板格式,生成的世界格式)
World tmpWorld = TemplateWorld.createTmpWorld(
"bedwars_map1",
"LEVELDB",
"LEVELDB"
);
- 模板世界存储在 templates/ 目录中。
- 创建临时世界时,系统会从模板读取区块,但将其写入临时位置(worlds/.tmp/)。
- 每个临时世界都会获得一个唯一的 UUID 作为名称。
- 世界被标记为 runtimeOnly,卸载后不会保留。
- 服务器重启时,所有临时产生的残留文件都会被自动清理。
本项目采用 LGPL v3 许可证授权。