🏝️ Sky Islands

Minecraft 1.20.1 / 1.21.1 · Forge 47.3+ / NeoForge 21.1+

将整个主世界改造为漂浮于虚空之上的空岛世界，提供完整的岛屿与团队管理系统。 适用于单人生存、多人联机与整合包制作。

---

✨ 简略介绍

Sky Islands 将 Minecraft 主世界改造为由无数漂浮岛屿构成的空岛世界。玩家可以拥有一座属于自己的岛屿，邀请好友共同开发，或独自在虚空中挑战生存。

2.0.0 版本引入了全新的群岛系统——在远方虚空中，由噪声算法生成的大型群岛由多个形态各异的子岛组成，为探索提供了全新目标。

2.0.10 版本进一步完善出生点岛管理，新增管理员指令 /skydev hubspawn，可在游戏内直接调整出生点岛的传送落点；同时 Forge 1.20.1 与 NeoForge 1.21.1 双端功能对齐。

核心亮点：

• 🌍 世界由漂浮岛屿构成，按网格分布，支持小 / 中 / 大三种尺寸
• 🏝️ 群岛系统（2.0.0 新增）：噪声生成的有机形态群岛，多子岛立体错落
• ⛏️ 矿石密度默认提升 ×1.2，补偿空岛资源稀缺
• 👥 完整团队系统：创建、邀请、访问、出生点管理
• 🏗️ 模板岛屿系统：内置 default / two / chushi 三套模板 + 自定义 NBT，含 3D 实时预览
• 🎯 出生点岛管理（2.0.10 新增）：管理员可用 /skydev hubspawn 调整落点，自动同步排除区
• ⚙️ 高度可配置，适合整合包深度定制

常用操作：

操作	指令 / 快捷键
打开团队界面	快捷键 V 或 /sky gui
回到自己的岛	/sky home
前往出生点岛	/sky spawn
热重载模板（管理员）	/skydev template reload
管理出生点落点（管理员）	/skydev hubspawn
管理团队（管理员）	/skydev manage

---

📖 详细介绍

---

基本信息

Mod ID	skyislands
版本	2.0.10
MC 版本	1.20.1（Forge）/ 1.21.1（NeoForge）
加载器	Forge 47.3+ / NeoForge 21.1.224+
Java	17+（Forge）/ 21+（NeoForge）
端	客户端 + 服务端

Forge 与 NeoForge 版本功能一致，指令、配置与模板系统完全互通。

---

🌍 世界生成

Sky Islands 完全替换原版世界生成，整个主世界由漂浮岛屿构成，岛屿之外是无尽的虚空。

岛屿分布

世界按 800 格（可配置）的网格划分，每格随机生成一个岛屿或一片群岛。岛屿布局由世界种子完全决定，相同种子始终生成相同的世界。

岛屿尺寸与权重

类型	直径范围	默认权重	说明
🔹 小型岛	60 ~ 300 格	40%	数量最多，适合初期落脚
🔷 中型岛	200 ~ 750 格	25%	资源丰富，适合长期发展
🔶 大型岛	750 ~ 1500 格	10%	稀有广阔，地形多样
🌐 群岛	半径 550 ~ 750 格	25%	多子岛有机形态，探索目标

四项权重之和决定各自比例，可在配置文件中自由调整。

岛屿连接桥

中型和大型相邻岛屿，若边缘间距在 75 格以内，会自动生成连接桥，方便玩家在岛屿间移动。

⛏️ 矿石倍增

岛屿内所有矿石密度默认提升 ×1.2，涵盖煤、铁、铜、金、红石、青金石、钻石、绿宝石、石英、远古残骸等。倍增系数可在配置中调整。

出生点排除区

以出生点岛的主传送落点为中心，程序化岛屿与玩家模板岛会保持一定边缘距离，避免与出生点区域重叠。管理员通过 /skydev hubspawn 修改落点后，排除区会自动同步更新。

---

🏝️ 群岛系统 ^{2.0.0 新增}

群岛是 2.0.0 版本引入的全新地形类型，与普通浮空岛完全独立生成，互不干扰。

生成原理

双层 Domain Warp + Simplex 噪声
        ↓
生成有机形态地形掩码
        ↓
BFS 连通区域检测 → 分割为多个子岛
        ↓
为每个子岛分配 XYZ 偏移量
        ↓
形成立体错落的群岛景观

子岛特征

• 底部呈现自然锥形收缩，形态参数可配置
• 按面积分为微型 / 小型 / 中型 / 大型四个等级
• XZ 平面无重叠，Y 轴可错层叠放，形成立体景观

分布规则

• 出现在距出生点约 4000 格以外
• 占世界格子约 25%（与普通空岛共用权重系统）
• 群岛优先级高于普通空岛，重叠时群岛保留

---

👥 团队与岛屿系统

每位玩家（或玩家团队）拥有一座专属岛屿，岛屿位置由种子确定，永久存在于世界中。

流程概览

首次进入游戏
    ↓
传送到出生点岛屿
    ↓
创建团队 → 选择模板 → 获得专属岛屿
    ↓
邀请好友 / 开放访问 / 管理出生点

团队功能

功能	说明
邀请成员	邀请其他玩家加入团队，共同开发岛屿
加入申请	玩家可主动申请加入，团队成员审批
访问控制	开放后允许其他玩家参观，但不可破坏
多出生点	支持设置多个出生点，四个方向朝向
死亡传送	死亡后自动传送回团队岛屿

传送系统

类型	指令	默认冷却
回到自己的岛屿	/sky home	3 分钟
前往出生点	/sky spawn	3 分钟
访问其他团队	/sky visit <团队名>	3 分钟

冷却时间可独立配置，可选开启传送时取消下落伤害。

---

🏗️ 模板岛屿系统

内置模板

模组内置 3 套起始模板（default / two / chushi），首次启动自动复制到配置目录。出生点岛使用独立的 moban.nbt 模板。

自定义模板

将 .nbt 或 .snbt 格式的结构文件放入以下目录：

config/skyislands/templates/islands/

在 templates.json5 中配置出生点坐标和朝向，执行 /skydev template reload 即可热重载，无需重启。

3D 实时预览

创建团队时，GUI 界面会实时渲染所选模板的 3D 旋转预览，让玩家在选择前直观了解岛屿样式。

多人同步

模板文件自动从服务端同步到客户端，本地缓存，离线也能正常显示预览。

出生点岛屿

在 templates.json5 中配置 mainSpawnIsland，所有新玩家首次进入游戏时降落在此专属岛屿上。管理员亦可通过 /skydev hubspawn 在游戏内微调实际传送落点（按世界存档，不影响全局模板文件）。

---

📋 指令列表

以下指令在 /sky 与 /skyislands 下均可使用（别名相同）。

玩家指令

指令	说明
/sky gui	打开团队管理主界面
/sky create [名称]	创建团队并获得岛屿
/sky leave	离开当前团队
/sky home	传送回自己的岛屿
/sky spawn	传送到出生点岛屿
/sky visit <团队名>	访问其他团队的岛屿
/sky invite <玩家名>	邀请玩家加入团队
/sky accept <团队名>	接受团队邀请
/sky decline <团队名>	拒绝团队邀请
/sky join <团队名>	申请加入团队
/sky team rename <名称>	重命名团队
/sky team toggle visits	开关他人访问权限
/sky team toggle requests	开关加入申请功能
/sky team accept <玩家>	批准玩家的加入申请
/sky team deny <玩家>	拒绝玩家的加入申请
/sky team spawns add <x> <y> <z>	添加团队出生点
/sky team spawns remove <x> <y> <z>	删除团队出生点
/sky team spawns reset	重置为模板默认出生点

管理员指令（/skydev，需权限等级 4）

模板管理

指令	说明
/skydev template reload	热重载模板配置，并同步推送给所有在线玩家

出生点岛管理 ^{2.0.10 新增}

管理 Spawn 团队（出生点岛）的传送落点。修改保存在当前空岛世界的存档数据中，不会写入 templates.json5。

指令	说明
/skydev hubspawn here [south|north|east|west]	将当前站立位置设为出生点（覆盖现有全部落点）
/skydev hubspawn set <x> <y> <z> [方向]	设置单个出生点坐标（覆盖现有全部落点）
/skydev hubspawn add <x> <y> <z> [方向]	新增一个出生点（保留已有落点）
/skydev hubspawn remove <x> <y> <z>	移除指定坐标的出生点
/skydev hubspawn list	列出当前世界的出生点岛中心、排除区与所有落点
/skydev hubspawn reset	重置为 moban.nbt 模板默认出生点
/skydev hubspawn tp	传送到出生点岛

修改出生点落点后，程序化岛屿的排除区会自动以主落点为中心重新计算。

团队管理

指令	说明
/skydev manage create <名称>	创建指定名称的团队
/skydev manage create <名称> join	创建团队并将执行者自动加入
/skydev manage delete <团队名>	删除团队
/skydev manage clear <团队名>	清空团队所有成员
/skydev manage add <团队名> <玩家...>	强制将玩家加入团队
/skydev manage remove <团队名> <玩家...>	强制将玩家移出团队

---

⚙️ 配置文件

位于 config/skyislands-common.toml，首次启动自动生成，所有参数均有中文注释。

[island_sizes]
# 各尺寸岛屿的直径范围（格）
small_min = 60      small_max = 300
medium_min = 200    medium_max = 750
large_min = 750     large_max = 1500

[island_weights]
# 四项权重之和决定各自生成概率
small_weight = 40           # 小型岛 ~40%
medium_weight = 25          # 中型岛 ~25%
large_weight = 10           # 大型岛 ~10%
archipelago_weight = 25     # 群岛   ~25%

[world]
ore_multiplier = 1.2        # 矿石密度倍增（1.0 = 不倍增）
island_spacing = 800        # 岛屿网格间距（格）

[teleports]
spawn_cooldown = 3600       # 传送冷却（tick，3600 = 3 分钟）
home_cooldown = 3600
visit_cooldown = 3600
negate_fall_damage = false  # 传送后取消下落伤害

[archipelago_carving]
arch_max_depth_large = 55   # 大型子岛最大底部深度（格）
arch_mid_threshold = 0.55   # 底部收缩阈值（越小底部越厚）

模板配置位于 config/skyislands/templates.json5，结构文件目录为 config/skyislands/templates/islands/。

---

📦 整合包制作

Sky Islands 为整合包提供了充分的自定义空间：

需求	方案
自定义起始岛屿	放入 NBT 文件并配置出生点
调整世界密度	修改四项权重配置
资源平衡	调整矿石倍增系数
传送节奏	独立配置三种传送冷却
权限管控	配置 0~4 级权限等级
热重载模板	/skydev template reload 无需重启
调整出生点落点	/skydev hubspawn 游戏内即时生效

---

🔧 安装

Forge 1.20.1

✅ Minecraft  1.20.1
✅ Forge        47.3+
✅ Java         17+

NeoForge 1.21.1

✅ Minecraft  1.21.1
✅ NeoForge   21.1.224+
✅ Java       21+

• 单人游戏：仅需客户端安装
• 多人游戏：服务端与客户端均需安装，且加载器与 MC 版本须匹配