SkyblockCraft

SkyblockCraft

经典的Skyblock模组，带有虚拟硬币经济和可配置的天空商人村民。使用 /island create 生成你的起始岛屿，赚取并交易硬币，通过右键点击自定义商人购买物品。Fabric 1.21.1。

SkyblockCraft

一款适用于 Minecraft 1.21.1（Fabric）的经典空岛生存模组，拥有虚拟硬币经济和可随处生成的专属天空商人村民。

⚠ 这是一个早期 alpha 版本（v0.1.0-alpha.1）。 功能已完备，但尚未在生产环境多人服务器中进行过充分测试。如有任何问题，请在 GitHub 跟踪器 上报告。

功能特性

🏝 生成你的初始空岛

运行 /island create，一个经典的空岛便会生成，你将被传送到岛屿顶部：一小块草方块平台、一棵橡树、一个带有仙人掌的沙块，以及一个装有基础物资的初始箱子（岩浆桶、冰、西瓜/南瓜/甘蔗/小麦种子、蘑菇、骨粉、橡树树苗）。

随时使用 /island home 传送回家。如果在配置中启用，/island visit <player> 可让你前往其他玩家的岛屿。

每座空岛都放置在以可配置原点为中心的间距网格上（默认间隔 512 格），因此多名玩家可以在同一世界中拥有各自独立的岛屿而互不重叠。

💰 虚拟硬币经济

每位玩家都拥有一个硬币余额，该余额在世界级别持久化（随世界存档保存，而非玩家存档）。默认情况下，你以 100 枚硬币 起步——此数值可配置。

  • /balance（别名 /bal）— 显示你的余额
  • /balance <player> — 查询其他玩家的余额（OP）
  • /pay <player> <amount> — 向好友发送硬币

可为每位玩家设置可选的最大余额；设置为 0 表示无上限。

🧑‍🌾 天空商人村民

使用 /skyblock spawn merchant（OP）生成一个自定义商人。该村民 不可被伤害、AI 已禁用（不会四处游荡），且头顶显示 “Sky Merchant” 的名字。

右键点击商人，一个基于聊天的商店界面便会弹出，每个交易旁边都有可点击的 [购买] 按钮——例如 64× 泥土 5 硬币、1× 铁锭 30 硬币、1× 钻石 150 硬币。点击 [购买] 会从你的余额中扣除相应价格并给予你物品。

默认交易涵盖空岛生存玩家通常需要的一切：泥土、橡木原木、圆石、铁、金、钻石、绿宝石、水桶、岩浆桶。完整列表（及价格）完全可在 config/skyblockcraft.json 中配置——添加你自己的交易、修改价格、或移除默认项。使用 /skyblock reload 可无需重启服务器即可应用更改。

⚙️ Mod Menu + Cloth Config

如果安装了 Mod Menu 和 Cloth Config，游戏内将出现一个包含五个类别的配置界面（岛屿、经济、商人、UI 和调试——调试仅在调试版本中可见）。

🔒 公开版 + 调试版双构建，具备强化安全性

从同一源码产出两个 JAR 变体：

  • 公开版（即此处发布的版本）：/skyblock debug … 命令完全不可用，调试配置类别已隐藏，且构建即使管理员编辑 JSON 配置文件也会拒绝启用调试标志。
  • 调试版（不公开发布，可在 GitHub Actions 构建产物中获取）：所有调试辅助功能均已启用，用于测试。

公开版会拒绝从配置文件启用调试标志，即使服务器管理员手动编辑 skyblockcraft.json 将 enableDebugCommands 改为 true 也不例外。服务器日志中会出现警告，且该标志会在内存中被重置为 false。这意味着公开版 JAR 零隐藏作弊面——你可以放心在生产服务器上使用。

命令速查表

命令 权限 作用
/island create 玩家 生成你的初始空岛并将你传送过去
/island home（或 /is home） 玩家 传送回你的空岛
/island visit <player> 玩家 访问其他玩家的空岛（若已启用）
/island delete <player> OP 删除某位玩家的空岛记录
/balance（或 /bal） 玩家 显示你的余额
/balance <player> OP 显示其他玩家的余额
/pay <player> <amount> 玩家 向其他玩家转账硬币
/skyblock spawn merchant OP 在你所在位置生成一个天空商人
/skyblock buy <offerId> 玩家 由 [购买] 点击触发——通常无需手动输入
/skyblock reload OP 从磁盘重新加载 skyblockcraft.json
/skyblock version 玩家 输出版本号及构建类型

环境要求

  • Minecraft 1.21.1
  • Fabric Loader ≥ 0.16.5
  • Fabric API（必需）
  • Cloth Config（可选——启用游戏内配置 GUI）
  • Mod Menu（可选——在模组列表中显示配置 GUI）
  • Java 21
  • 模组必须同时安装在 客户端和服务器端

开发路线图

计划在 v0.2 中实现：

  • 基于真实 ScreenHandler 的商人界面（替代聊天式商店）
  • 空岛保护（其他玩家无法在你的空岛上破坏/放置方块）
  • 多类别商人（农民、矿工、冒险家……）
  • 每位玩家在独立维度中拥有各自的初始空岛

如果你有功能需求，请在 GitHub 上提交 Issue！

错误报告与贡献

由 Remilulz_91 用 ❤ 制作。