旅行者的讲台

旅行者的讲台

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

Traveler's Lectern

Traveler's Series 的一部分。Traveler's Lectern 会制作一个讲台,当玩家取走上面的书后,书会自动返回。把服务器规则、任务或旅行笔记留给大家:玩家可以阅读书籍或拿走副本,讲台会在冷却时间后自动补充。

特性

  • 玩家取走书后,经过一个冷却时间,书会重新出现在讲台上
  • 任何人都可以阅读书籍,并通过潜行(空手)或讲台上的“取书”按钮取走它
  • 只有管理员可以破坏 Traveler's Lectern
  • 在 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 升级会保留所有 Traveler's Lectern 及其书籍。

配置

该模组可通过 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]:将其设为 Traveler's Lectern,冷却时间以秒为单位(默认:1800,即半小时)。
  • /travelers_lectern edit <time>:更改其冷却时间。
  • /travelers_lectern destroy:将其恢复为普通讲台。如果书已被取走,书会先返回。

使用方法

  1. 放置一个讲台并在上面放一本书。
  2. 面对它并运行 /lecterns,或 /travelers_lectern create。
  3. 玩家可以像往常一样阅读书籍,并通过潜行(空手)或“取书”按钮取走它。
  4. 书在被取走一个冷却时间后返回。在此之前,空的讲台不会接受其他书,并会告知玩家他们的书何时返回。

A Traveler's Lectern's book open in game, with Done and Take Book

在 1.21.6 及更高版本中,/lecterns 会打开一个基于 Minecraft 原生对话框界面构建的菜单:

  • 面对一个放着书的讲台时,它会提供将其设为 Traveler's Lectern 的选项,重生时间以分钟为单位。
  • 面对一个 Traveler's Lectern 时,它会打开该讲台的编辑器:更改重生时间、给自己一份副本、使用手中持有的书、立即归还已取走的书、传送到那里,或将其恢复为普通讲台。
  • 在其他任何地方,它会列出服务器上的所有 Traveler's Lectern。将鼠标悬停在其中一个上可查看其位置以及书是否已被取走。

服务器会再次检查每次按钮按下,因此只有管理员才能进行任何更改。

The lectern manager on Minecraft 26.2, listing every Traveler's Lectern with Add the lectern I'm facing

A lectern's editor: its book, where it stands, whether the book is out, and the respawn time in minutes

🛠 开发

该模组使用以下技术构建:

  • 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:将对 Traveler's Lectern 的点击交给模组处理;其他讲台保持原版行为。
  • dialog/:讲台管理器(1.21.6 及更高版本)。

支持

加入 GBTI Network!

GBTI Network 是一个会员社区:

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

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

其他支持方式:

链接

AI 披露

Traveler's Lectern 由 GBTI Network 开发,该团队在产品与应用开发方面拥有超过 20 年的综合经验。

我们在工作流程中使用现代 AI 编码工具(Claude Code、Codex 和 OpenClaw)作为助手。

许可证

本项目采用 GNU General Public License v3.0 许可。