train-ticket

英文版简介（English Description）

This plugin provides a complete station ticketing and fare collection system for Minecraft Paper 1.21.1 servers, with the goal of bringing a realistic subway fare collection experience to the game. Features include: placeable ticket vending machine and turnstile blocks; a station configurator tool (right-click a turnstile to set the station, line, and entry/exit modes); local SQLite-based persistence (stored in stations.db within the mod’s data directory); and synchronization of line and station data every 30 seconds via a configurable remote interface (requires manual configuration in the config file; this feature is currently in beta and is expected to be released in the next version); Integration with Vault billing, supporting route-based pricing and cross-route cumulative billing; after purchasing a ticket, players receive a ticket (in the form of a book page) displaying route, origin station, destination station, and price information. During ticket validation, the system determines whether the player is entering or exiting based on the ticket details and the ticket gate’s configuration, then either opens the gate or deducts the fare. In addition, the system provides a Chinese-localized in-game GUI, as well as a built-in web management panel (configurable port, default 2345) for creating, deleting, modifying, and querying lines, stations, prices, and issued tickets, as well as for manual synchronization. The design emphasizes configurability and ease of operation and maintenance: synchronization URLs, web ports, pricing, and other settings can all be adjusted in the configuration file, and changes made to the database or via the web panel take effect immediately.

中文版简介（Chinese Description）

本插件为 Minecraft Paper 1.21.1服务器提供完整的车站售检票系统，目标是把真实地铁检票体验引入游戏。功能包括：可放置的售票机与检票机方块、车站设置器工具（对检票机右键设置站点、线路与出/入站模式）、基于 SQLite 的本地持久化（插件数据目录下 stations.db）、每 30 秒从可配置的远程接口同步线路与站点数据（需在配置文件里自行配置，目前此功能仅为内测，预计下个版本开放）；集成 Vault 收费，支持按线路定价与跨线路叠加计费；玩家购票后获得带有线路、始发站、终点站与价格信息的车票（书页形式），检票时根据票面与检票机配置判断入站/出站并开闸或消费车票。除此之外提供中文化的游戏内 GUI，以及可通过内置 Web 管理面板（配置端口，默认为 2345）对线路、站点、价格和已发放车票进行增删改查和手动同步。设计注重可配置性与运维便利：同步 URL、Web 端口、定价等均可在配置文件中调整，且数据库与 web 面板修改会即时生效。