世界模板重铸版

一键从现成模板创建你的整合包世界。

World Templates Reforged 让整合包作者可以把一个预先构建好的世界（出生点建筑、结构、NPC、数据包，应有尽有）直接打包进模组本身，并在世界选择界面为玩家提供一个专用的“创建世界”按钮。只需一键，模组便会安装模板并将其克隆为一个全新随机种子的新世界——服务器风格的模板，但用于单人游戏。

✨ 功能特性

• 🌍 内嵌世界模板——你完成的世界会以 zip 形式打包进模组内。首次使用时自动安装（带 zip-slip 防护），并按需克隆。
  - 🖱️ 自定义世界按钮——在世界选择界面添加一个可配置的按钮。原版的*“创建新世界”*按钮可以隐藏或保留。
  - 🗂️ 模板选择界面——玩家可在已注册的模板之间进行选择；每个条目都会显示其名称、图标和文件夹。
  - 🖼️ 持久保留的世界图标——创建出的世界会保留模板的图标，并自动调整为原版要求的 64×64 尺寸，且原版永远不会覆盖它。
  - 🔀 每次都是全新种子——每个世界都会获得一个全新的 `SecureRandom` 种子（绝不为 0，绝不重复），并写入 `level.dat`。
  - 🧹 干净的克隆流程——playerdata、进度和统计数据都会被清除；世界会在一个暂存文件夹中构建，只有全部成功后才会正式发布。失败的尝试绝不会留下垃圾世界，残留的损坏内容也会被自动清理。
  - ⚙️ 完整的游戏内配置——从模组列表 → 配置 打开。一切都可以自定义，无需触碰任何文件。

🎛️ 面向整合包创作者

从 模组 → World Templates Reforged → 配置 打开配置：

按钮选项卡

选项	作用
文本 / 提示	按钮标签和悬停文本
X 位置 / Y 位置	按钮位置（-1 表示 X 居中）
宽度 / 高度	按钮尺寸（带实时预览）

模板选项卡

选项	作用
默认模板	在已注册的模板之间循环切换
选择	YES：打开模板选择器 · NO：直接使用第一个模板
主模板名称	覆盖模板显示的名称
图标	覆盖图标纹理
世界基础名称	新世界将命名为 Trilcera、Trilcera 2……
显示描述	在列表中显示文件夹/来源信息行
显示“创建新世界”	保留或隐藏原版按钮

所有设置都会保存在 config/worldtemplates-client.toml 中。

发布你自己的世界：将模组 jar 中内嵌的 /trilcera-template.zip 替换为你自己的世界 zip（世界可以位于 zip 根目录，也可以嵌套在一层文件夹内——两种布局均支持）。

❓ 常见问题

它在服务器上能用吗？仅限于客户端——专为单人世界创建而设计。在专用服务器上它不起任何作用。

模板存储在哪里？位于 <game dir>/trilcera-template/。创建出的世界会像普通世界一样保存到 saves/。

玩家还能创建普通世界吗？可以——在配置中将*“显示‘创建新世界’”*设为 YES 即可。

🙏 致谢

- 架构灵感来自 World Templates by BrandonItaly（NeoForge）

- 世界克隆流程基于 LonKraft Template API

- 由 iSkyh 为 Trilcera 整合包 打造

📜 许可证

MIT——可自由包含在你的整合包中。