创建：交通车票

创建：交通车票

一个专注于交通票价/票务系统的创建插件。

创建：交通车票预览查看大图

🎟️ 机械动力：交通车票 🚂

Create: Transit Tickets mod icon

🚉 适用于机械动力（Create）列车网络的、生存友好的、可配置的交通车票和检票闸机。

GitHub Repository Latest Release License Discussions Open Issues Total Downloads

🚆 简介

机械动力：交通车票为使用 机械动力（Create） 模组构建的公共交通系统添加了可重复使用的车票蓝图、已签发的交通车票以及可正常工作的检票闸机。

车票蓝图通过游戏内菜单进行配置——正常使用不再需要命令。蓝图中存储了自定义名称、使用类型和交通服务类型。

  • 🎫 单次使用 车票允许通过检票闸机一次。
  • 🔢 多次使用 车票允许通过可配置的次数。
  • ⏳ 限时 车票在可配置的时长内有效。
  • ♾️ 不限时 车票永不过期。

车票可以使用 普通（Local）、快速（Semi-Fast） 或 特快（Express） 服务。操作员可以将每个闸机配置为接受任何服务或要求特定的服务。

空白车票、车票蓝图、交通车票和检票闸机均使用机械动力风格的工具提示。悬停时按住 Shift 可查看其摘要和使用说明。

✨ 当前版本亮点

当前的 0.1.1-beta 开发版本包括：

  • 📝 游戏内车票蓝图配置菜单，包含名称、类型、服务、次数和时长控制。
  • 🎫 单次使用、多次使用、限时和不限时四种车票类型。
  • 🚉 普通、快速和特快三种车票服务。
  • 🔧 每个闸机的服务要求由操作员使用机械动力的扳手配置。
  • 📦 仅限操作员使用扳手拆卸，可返还检票闸机物品。
  • 🚶 闸机在玩家通过后或经过五秒硬性超时后关闭。
  • 🛡️ 服务器验证蓝图和闸机的配置数据包。
  • 📖 为每个车票物品和检票闸机提供机械动力风格的 Shift 摘要。

🎫 车票使用流程

📄 空白车票 → 📝 车票蓝图 → 🎟️ 交通车票 → 🚧 检票闸机

  1. 制作一张 空白车票。
  2. 制作一张 车票蓝图。
  3. 手持蓝图（另一只手不拿空白车票）并右键点击，打开其配置菜单。
  4. 选择其名称、车票类型和服务类型，然后选择 完成（Done）。
  5. 一手持有配置好的蓝图，另一手持有空白车票。
  6. 使用蓝图签发一张 交通车票。在生存模式中会消耗一张空白车票；蓝图可重复使用。
  7. 手持签发的车票，在兼容的 检票闸机 上使用以进入。

📄 空白车票

  • 签发票时消耗的材料。
  • 本身不包含任何有效性或过期数据。
  • 两张纸可合成四张空白车票。
  • 悬停时按住 Shift 可显示其机械动力风格的摘要。

📝 车票蓝图

  • 可重复使用的模板，用于签发交通车票。
  • 另一只手未持有空白车票时，右键点击可打开其配置菜单。
  • 存储车票名称、使用类型、服务类型以及任何所需的次数或时长数值。
  • 服务选择器支持 普通、快速 和 特快。
  • 多次使用 会显示一个次数字段。
  • 限时 会显示一个时长字段。支持的后缀有 t（游戏刻）、s（秒）、m（分钟）、h（小时）和 d（Minecraft 天）。
  • 一秒等于 20 游戏刻，一个 Minecraft 天等于 24,000 游戏刻。
  • 单次使用 和 不限时 无需额外数值。
  • 悬停时按住 Shift 可显示其机械动力风格的摘要和使用说明。

🎟️ 交通车票

  • 使用其蓝图配置的名称。
  • 保留其蓝图配置的类型和服务。
  • 限时车票会使用世界的游戏时间存储其签发时间、时长和过期时间。
  • 单次使用和多次使用车票会存储其原始和剩余的次数。
  • 不限时车票永不过期。
  • 在工具提示中清晰显示 有效（Valid）、已过期（Expired） 或 已用尽（Used Up）。
  • 悬停时按住 Shift 可显示其机械动力风格的摘要。

💻 蓝图命令（可选）

游戏内蓝图菜单是推荐的配置方法。旧版辅助命令仍然对创造模式玩家和权限等级 2 或更高的命令源可用。

通过命令创建的蓝图使用普通服务，并涵盖旧版的限时和限次格式。请使用游戏内菜单选择全部四种车票类型和所有服务选项。

⏳ 限时车票

/transittickets blueprint <duration_ticks> [name]

duration_ticks 必须至少为 1。可选名称可以包含空格，最长限制为 64 个字符。如果未提供名称，车票将被命名为 Transit Ticket。

例如，一张 30 分钟的车票持续 36,000 游戏刻：

/transittickets blueprint 36000 30 Minute Pass

Minecraft 通常每秒运行 20 游戏刻。车票时间随世界的游戏时间推进，并在世界未运行时暂停。

🔢 限次车票

/transittickets blueprint passages <count> [name]

count 必须至少为 1。每次在检票闸机成功验证后，会立即消耗一次次数。

示例：

/transittickets blueprint passages 1 Single Ride
/transittickets blueprint passages 5 Five Ride Pass

🚧 检票闸机行为

  • 手持已签发的、有效的 交通车票 并使用闸机。
  • 闸机默认接受 任何服务（Any Service）。
  • 操作员可以使用机械动力的扳手右键点击已放置的闸机，改为要求 普通、快速 或 特快 服务。
  • 闸机配置仅限于权限等级 2 或更高的操作员。
  • 操作员可以潜行并使用机械动力的扳手右键点击来拆卸闸机并掉落其物品。
  • 有效的车票会播放接受音效并打开中央屏障。
  • 服务类型不匹配的有效车票会被拒绝，且不会消耗次数。
  • 限次车票在闸机接受后立即消耗一次次数。当次数归零时，车票变为 已用尽（Used Up），无法再打开其他闸机。
  • 限时车票可以在其世界时间过期前反复打开闸机。不限时车票永不过期。
  • 闸机在玩家通过并离开闸机方块后关闭。
  • 闸机总是在 100 游戏刻（约五秒）后关闭，即使玩家仍在其内部。
  • 空手、未签发的车票、已过期的车票、已用尽的车票或任何其他物品都会被拒绝，并播放拒绝音效和屏幕上的错误消息。
  • 悬停时按住 Shift 可显示闸机物品的机械动力风格摘要和扳手使用说明。

🔮 计划功能

  • 机械动力部署器打印车票
  • 与其他机械动力交通和安全附加组件的可选兼容性

随着开发的继续，计划功能可能会发生变化。

🌐 可用语言

  • 英语（美国）

欢迎通过拉取请求提交翻译。

📦 安装方法

  1. 安装 Minecraft 1.20.1。
  2. 安装 Minecraft Forge 47.x。开发环境当前使用 Forge 47.4.0。
  3. 安装适用于 Minecraft 1.20.1 的 机械动力 0.5.1.f。
  4. 从 GitHub Releases 页面下载机械动力：交通车票。
  5. 将机械动力和机械动力：交通车票都放入 Minecraft 的 mods 文件夹中。
  6. 使用 Forge 配置文件启动 Minecraft。

机械动力 0.5.1.f 在其分发的模组 jar 中包含所需的 Flywheel 和 Registrate 组件。

🛠️ 从源码构建

要求：

  • Java 开发工具包 17
  • Git

克隆并构建项目：

git clone https://github.com/RSlover521/Create-Transit-Tickets.git
cd Create-Transit-Tickets
./gradlew build

在 Windows PowerShell 或命令提示符中，请使用：

.\gradlew.bat build

构建好的模组 jar 将生成在 build/libs/ 目录中。

要启动 Forge 开发客户端：

.\gradlew.bat runClient

🔗 链接

✅ 支持的模组版本

版本 Minecraft Forge 机械动力 是否支持
0.1.2-beta（当前） 1.20.1 47.x 0.5.1+ 是
0.1.1-beta 1.20.1 47.x 0.5.1.f 是
0.1.0-beta 1.20.1 47.x 0.5.1.f 是

此项目目前处于测试阶段，因此功能已保存的物品数据可能在版本之间发生变化。在提交问题之前，请确认您使用的是受支持的版本。

📜 许可证

  • MIT 许可证——详情请参见项目许可证。
  • Minecraft、Minecraft Forge 和机械动力归其各自所有者所有。