Henry_Du
e76d0188db
- 增加外设初始化重试机制，等待monitor和检票机外设就绪（最多20秒）， 在等待期间显示进度提示，避免区块加载时脚本提前退出导致屏幕无显示 - 修复Socket.IO服务端未强制websocket传输配置，避免负载均衡环境下轮询产生400错误 - 所有业务拒绝(deny)场景下调用markFault触发红灯，包括： * 无效票/卡、卡ID缺失、票ID缺失 * 站点不匹配、未进站/已出站、已进站/已出站 * 余额不足、票价查询失败、网络错误 * 外设写入/扣费失败等所有错误路径 - 版本号升级至v1.5.29
FTC Ticketing System (Refactored)
A comprehensive ticketing solution for Minecraft (CC:Tweaked) with a modern Web Control Panel.
Features
- Ticket Machine (Lua): Issue tickets, print receipts, write to floppy disks.
- Gate (Lua): Validate tickets, control redstone doors, track entries/exits.
- Web Console:
- Real-time Dashboard: Live updates of sales and passenger flow via Socket.IO.
- Visual Line Editor: Manage stations and lines with an interactive SVG map.
- Fare Management: Configure fares with a visual fare chart.
- Logs: Track ticket usage and system operations.
- System Settings: Configure API endpoints and promotions.
- File Manager: Upload and manage audio files (
.dfpwm) for devices.
Project Structure
server/: Node.js Backend (Express + Socket.IO).services/: Data and logic handling.routes/: API endpoints.
web/: Frontend (Vue 3 + Socket.IO Client).index.html: The new Control Panel.index.js: Vue 3 logic.
Lua/: CC:Tweaked scripts.
Installation
- Prerequisites: Node.js 16+.
- Install Dependencies:
npm install
Running the Server
Development
npm start
Access the console at http://localhost:23333.
Production (PM2)
This project includes an ecosystem.config.js for PM2.
# Start
pm2 start ecosystem.config.js
# View logs
pm2 logs ticket-machine
# Restart
pm2 restart ticket-machine
Configuration
- Server Port: Default
23333. SetPORTenvironment variable to change. - Data Storage: All data is stored in
web/data/. - CC:Tweaked Devices:
- Run
install_machine.luaorinstall_gate.luaon your turtles/computers. - Point them to your server's IP (e.g.,
http://YOUR_IP:23333/api).
- Run
API
/api: Admin API (Stations, Lines, Fares, Logs)./api/public: Public API for devices (Ticket queries, Orders).- WebSocket: Connect to
/for real-time events (stations:updated,stats:ticket:updated, etc.).
Troubleshooting
Error: bind EADDRINUSE 0.0.0.0:23333
This means the port 23333 is already occupied.
- Stop the PM2 process:
pm2 stop ticket-machine - Find the process holding the port:
lsof -i :23333ornetstat -tunlp | grep 23333 - Kill the process:
kill -9 <PID> - Restart PM2:
pm2 restart ticket-machine
Error: Cannot find module 'express'
Run npm install in the project directory to install dependencies.
License
MIT