WT Sky Grid

天空网格模组（Sky Grid Mod）

一个面向 Minecraft 1.21.1 与 1.21.11 的现代天空网格世界生成模组，支持 NeoForge 和 Fabric 两个加载器。

1.21.1 是当前活跃开发的分支，也是当前版本所针对的目标。1.21.11 虽然受支持，但版本会落后一些，因为大多数大型科技模组尚未迁移到该版本。

这个世界是由悬浮在虚空中的单个方块组成的三维网格——矿石、木头、箱子、刷怪笼——中间空无一物。每一块方块都至关重要，而坠落通常是致命的。

灵感来源于 SethBling 的经典天空网格地图。

---

特性

• 三维方块网格 —— 在 X、Y、Z 轴上每隔 4 个位置生成一个方块，可配置
• 独立维度方块池 —— 主世界、下界和末地各有自己的方块、生物和战利品表
• 完整模组支持 —— 任何已安装模组的方块都可能出现；方块池基于实时方块注册表构建
• 方块标签 —— 写入 #minecraft:logs 而无需逐一列举所有原木类型，并自动纳入模组方块
• 生成权重 —— 可以按方块设置，让钻石矿石稀有而石头常见
• 战利品箱子 —— 包含地牢、废弃矿井、要塞、神庙、堡垒遗迹和末地城的战利品表，按维度选择
• 生物刷怪笼 —— 生成符合维度特征的生物，主世界不会出现烈焰人
• 矿石簇 —— 矿石偶尔会以小矿脉而非单独方块的形式生成
• 智能植物放置 —— 树苗会得到泥土，仙人掌会得到沙子，下界真菌会得到对应的菌岩
• 出生平台 —— 网格顶部附近有一个 9x9 的黑曜石平台，带有玻璃围边以防有人被挤入虚空，世界出生点固定在平台上
• 可调节频率 —— 箱子、刷怪笼和矿石簇的频率均为配置值；修改后运行 /skygrid reload 即可生效，无需重启
• 游戏内编辑器 —— 通过图形界面添加或移除方块并调整权重，无需编辑文件

---

快速上手

1. 安装模组（如果使用 Fabric，还需安装 Fabric API）
2. 单人游戏 → 创建新世界
3. 点击 世界类型，直到显示为 Sky Grid（天空网格）
4. 创建世界

你会在网格顶部附近的黑曜石平台上出生，俯瞰整个网格。小心向外搭桥，并预期需要向下探索——那里才是游戏的核心。

下界和末地同样是天空网格，拥有各自的方块池。

---

环境要求

项目	要求
Minecraft	1.21.1 或 1.21.11
Java	21 或更新版本
NeoForge	1.21.1 对应 21.1.x，1.21.11 对应 21.11.44+
Fabric	加载器 0.19.3+ 及 Fabric API

在 Fabric 上 ModMenu 为可选安装——它提供配置按钮。没有它的话，可以使用 /skygridgui 命令。

---

配置方块池

在 config 文件夹中会生成三个文件：skygrid.json、skygrid_nether.json 和 skygrid_end.json。

{
  "mode": "whitelist",
  "whitelist": [
    "#minecraft:logs",
    "minecraft:stone",
    { "id": "minecraft:diamond_ore", "weight": 3 }
  ]
}

条目可以是方块 ID、方块标签（以 # 为前缀），或带有显式 weight（权重）的对象。权重越高表示越常见。

或者完全跳过文件，使用游戏内编辑器：/skygridgui 命令，或 Mods 界面上的配置按钮。

---

命令

所有命令都需要权限等级 2，因此单人游戏需要开启作弊。

命令	描述
/skygrid blocks	显示方块池摘要
/skygrid blocks log	将完整方块池转储到日志
/skygrid reload	从磁盘重新加载配置
/skygrid add <方块> [权重] [维度]	添加方块，或修改其权重
/skygrid remove <方块> [维度]	移除方块
/skygrid weight <方块> <数值> [维度]	设置权重
/skygrid tag add <标签> [权重] [维度]	添加整个方块标签
/skygrid tag remove <标签> [维度]	移除标签
/skygridgui	打开编辑器

dimension（维度）参数默认为 overworld（主世界）。Tab 补全覆盖所有已注册的方块和标签，因此模组内容会自动出现。

---

重要提示：修改仅影响新生成的区块

方块池是在区块生成时读取的。编辑配置——无论以何种方式——绝不会改变已存在的地形。请前往未生成的区块或创建新世界以查看更改效果。

---

为什么没有水或岩浆？

它们被有意排除在默认方块池之外。作为网格中的水源方块，它们会向下倾泻穿过虚空，淹没大片区域。

如果你想要经典的水流天空网格，可以添加回来：

/skygrid add minecraft:water
/skygrid add minecraft:lava

---

从 1.x 版本升级

1.x 版本仅支持 Fabric，且仅针对 1.21.1。2.0 版本重构了项目以支持两个加载器：

• 世界不兼容。 请创建新世界。
• 网格现在依赖于世界种子。 在 1.x 中，无论种子如何，每个世界都生成相同的布局——那是一个缺陷。
• NeoForge 的生成器 ID 已更改，以与 Fabric 保持一致。
• NeoForge 的 TOML 配置已移除，由 Fabric 使用的相同 JSON 配置替代。
• 水、岩浆和甘蔗 已从默认方块池中移除。

---

问题反馈与源代码

源代码与缺陷报告：github.com/whotevatech/skygrid-mod

提交缺陷报告时，请提供你的 Minecraft 版本、加载器及其版本、你的 config/skygrid*.json 文件和 logs/latest.log，这会非常有帮助。

以 MIT 许可证发布。