• 欢迎加入MineBBS QQ讨论群:点击查看所有的官方讨论群
  • 我们将于近期对服务器进行迁移,服务可能中断至多2日。请各位安排好自己的访问计划,造成不便敬请谅解!
  • MineBBS入站考试已经上线!想要成为【正式会员】解锁更多功能吗?快来参与吧!【点我去看】
资源图标

授权转载 Allay TemplateWorld - 模板世界 v0.1.0

完成注册/登录后下载
版权类型
授权转载
版权链接
https://github.com/AllayMC/TemplateWorld/
语言支持
多语言
前置组件
Allay
适配版本(基岩)
  1. 全版本
🌍 TemplateWorld

TemplateWorld 是一款专为 AllayMC 设计的插件。它允许你基于模板创建仅在运行时存在的临时世界。该插件非常适合小游戏服务器,能够自动创建并清理临时游戏房间。🎮




✨ 功能特性
  • 🗺️ 基于预设模板创建临时世界
  • 💨 仅限运行时加载,世界数据不会持久化到磁盘
  • 📦 支持不同的世界存储格式(如 LEVELDB 等)
  • 🧹 服务器重启时自动清理临时世界文件
  • 🔌 为开发者提供简单的 API 调用接口




📥 安装方法
[1] 从 Releases 下载最新版本的 JAR 文件。
[2] 将其放入服务器的 plugins 文件夹中。
[3] 启动服务器即可。




🎯 使用说明

准备模板:
[1] 在服务器根目录下创建一个名为 templates 的文件夹。
[2] 将你的世界文件夹复制到 templates/ 目录中。
[3] 文件夹的名称将作为该模板的名称。

命令列表:
  • /template create <模板名称> - 从指定模板创建一个临时世界
  • 权限节点:templateworld.command




🔧 开发者 API

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 许可证授权。
后退
顶部 底部