旅行者讲经台

旅行者讲经台

旅行者系列的一部分:一个讲台,玩家拿走后书本会自动回来,适用于Minecraft 1.20至26.3,并在1.21.6及更高版本中提供游戏内讲台管理器。

冒险

旅行者讲台

旅行者系列的一部分。旅行者讲台制作的讲台,其上的书在被玩家取走后会重新出现。把服务器规则、任务或旅行笔记留给所有人:玩家可以阅读书籍或取走副本,讲台会在冷却结束后自行补充。

特性

  • 书在被玩家取走后,经过一个冷却时间会重新出现在讲台上
  • 任何人都可以阅读书籍,并通过潜行空手或使用讲台的“取走书籍”按钮来取走它
  • 只有管理员可以破坏旅行者讲台
  • 爆炸、凋灵、末影龙和火焰都无法摧毁旅行者讲台
  • Minecraft 1.21.6 及更高版本提供游戏内讲台管理器:/lecterns
  • 仅服务端:玩家无需安装客户端模组

一个 jar 可在 Minecraft 1.20 至 1.20.4、1.21 至 1.21.11 以及 26.1 至 26.3 上运行。Fabric 会加载与你的服务器匹配的构建,因此迁移到其他受支持版本的服务器可以继续使用同一个 jar。它需要 Fabric Loader 0.16.10 或更新版本以及 Fabric API。不支持 Minecraft 1.20.5 和 1.20.6。

从 1.2.x 升级会保留所有旅行者讲台及其书籍。

配置

该模组可以通过 config/travelers-lectern/ 目录中的文件进行配置:

基本设置 (travelers_lectern_config.txt)

debug_logging=false
  • debug_logging:启用或禁用调试日志记录,以在服务器日志中提供详细信息。

讲台数据

  • 讲台按维度和位置保存在配置文件夹中的 lecterns.json 中。该文件由模组管理,请勿手动编辑。
  • 2.0.0 之前的版本将它们保存在 travelers_lecterns.json 中。2.0.0 会导入该文件一次并保持其原样,因此回退到旧版本时仍能找到你的讲台。
  • 如果无法读取 lecterns.json,模组在能够读取之前不会保存任何内容,而不是覆盖它。其之前的版本会作为 lecterns.json.bak 保留在旁边。

命令

管理员(权限等级 4)在看着一个上面有书的讲台时(最远 20 格距离)使用这些命令:

  • /lecterns:在 1.21.6 及更高版本上,打开讲台管理器。
  • /travelers_lectern create [time]:将其变为旅行者讲台,冷却时间以秒为单位(默认:1800,即半小时)。
  • /travelers_lectern edit <time>:更改其冷却时间。
  • /travelers_lectern destroy:将其变回普通讲台。如果其书已被取走,书会先放回。

用法

  1. 放置一个讲台并在上面放一本书。
  2. 面朝它并运行 /lecterns 或 /travelers_lectern create。
  3. 玩家照常阅读书籍,并通过潜行空手或使用“取走书籍”按钮来取走它。
  4. 书在被取走一个冷却时间后重新出现。在此之前,空讲台不会接受其他书,并会告知玩家他们的书何时返回。

游戏中打开的旅行者讲台书籍,带有“完成”和“取走书籍”按钮

在 1.21.6 及更高版本上,/lecterns 会打开一个由 Minecraft 自带对话框界面构建的菜单:

  • 面朝一个上面有书的讲台时,它会提供将其变为旅行者讲台的选项,并设置以分钟为单位的重生时间。
  • 面朝一个旅行者讲台时,它会打开该讲台的编辑器:更改重生时间、给自己一个副本、改用手中的书、立即放回被取走的书、传送到那里,或将其变回普通讲台。
  • 在其他任何地方,它会列出服务器上的所有旅行者讲台。悬停其中一个可查看其位置以及其书是否已被取走。

服务器会再次检查每次按钮按下,因此只有管理员可以更改任何内容。

Minecraft 26.2 上的讲台管理器,列出所有旅行者讲台,并带有“添加我面前的讲台”

讲台编辑器:其书籍、所在位置、书是否已被取走,以及以分钟为单位的重生时间

🛠 开发

该模组使用以下内容构建:

  • Java 17(Minecraft 1.20.x)、Java 21(1.21.x)和 Java 25(26.x),通过 Stonecutter 从单一源码树构建
  • Fabric API
  • Gson 用于 JSON 解析和序列化

项目结构

  • src/main/java:包含主要模组逻辑。
  • src/main/resources:包含资源、mixin 和配置文件。
  • versions/:每个 jar 一个文件夹,命名其构建所针对的 Minecraft 版本。

关键文件

  • TravelersLectern.java:初始化模组并处理服务器事件。
  • Lecterns.java:取走书籍、重生计时,以及命令和管理器的行为。
  • LecternStore.java:读取和保存讲台数据,并导入旧版本留下的文件。
  • LecternBooks.java:在所有受支持版本上将讲台的书籍转为文本并转回。
  • LecternBlockMixin.java:将对旅行者讲台的点击交给模组处理;其他讲台保持原版行为。
  • dialog/:讲台管理器(1.21.6 及更高版本)。

支持

加入 GBTI Network!

GBTI Network 是一个会员社区:

  • 独家的开发工具和资源
  • 私有仓库和代码库
  • 用于协作的 Discord 社区
  • 展示你作品的会员目录列表
  • 合作机会和项目伙伴关系
  • 抢先体验新功能和工具

通过成为 GBTI Network 会员 来支持我们的工作。

其他支持方式:

链接

许可证

本项目采用 GNU 通用公共许可证 v3.0 授权。