ValeTickets - 为你的服务器提供简单的工单系统
ValeTickets 旨在让玩家能够轻松地寻求帮助,并让管理员方便地跟踪这些请求。这是一个小巧的插件,包含游戏内命令和一个供管理员使用的简易网页界面。我利用业余时间维护这个项目,因此力求保持其实用性和安全性。
▶️ 快速开始
- 将 jar 文件放入
plugins/ 目录并启动服务器一次。
- 在游戏中(作为 OP),运行
/ticketsetup 创建所有者账户。
- 访问
http://<server-ip>:<configured-port>/admin 并登录。
- 使用
/ticketadmin add <username> 添加管理员。
- 玩家使用
/ticket 提交工单,并使用 /ticket check 查看更新。
如果 /admin 返回 401 错误,可能是因为所有者账户尚未创建或凭据有误。
? 功能介绍
- 玩家可以通过简短的引导流程在聊天中打开工单。
- 管理员可以在小型网页仪表板上查看工单。
- 支持可选的文件上传(截图/日志),并设有类型和大小限制。
- 简单的角色权限:
OWNER(可管理账户)和 ADMIN。
- 对公共表单实施基本的速率限制,以减少垃圾信息。
- 当工单状态更新时,会在游戏中发送通知。
- 计划在未来版本中支持 DiscordSRV 集成。
? 命令
玩家
/ticket - 启动简短的引导流程以创建工单
/ticket check - 查看你的工单及其状态
管理员
/ticketadmin passwd - 更改自己的密码
所有者
/ticketsetup - 创建第一个所有者账户(权限:valetickets.setup)
/ticketadmin add <username> - 添加管理员
/ticketadmin reset <username> - 重置管理员密码
/ticketadmin list - 列出账户
/ticketreload - 重新加载插件配置并重启 Web 服务器(权限:valetickets.reload)
示例
/ticketadmin add alice
/ticketadmin reset bob
? Web 界面
- 公共表单:
http://<server-ip>:8765/
- 管理员仪表板:
http://<server-ip>:8765/admin
- 更改密码:
http://<server-ip>:8765/change-password
? 安全性
- 密码使用 Argon2id 进行哈希处理。绝不存储明文。
- 插件打包为单个 jar 文件,所需库已内置其中。
⚙️ 配置
plugins/ValeTickets/config.yml
web:
enabled: true
bind: 0.0.0.0
port: 8765
# 向玩家显示工单 URL 的方式
urlDisplay:
mode: "ip" # "ip", "domain", or "custom"
domain: "your-server.com" # 当 mode 为 "domain" 时使用
customMessage: "Check our website!" # 当 mode 为 "custom" 时使用
uploads:
enabled: true
dir: uploads
maxBytesPerTicket: 104857600 # 每个工单最多 100 MB
maxBytesPerFile: 10485760 # 每个文件最多 10 MB
allowedTypes: ["png", "jpg", "jpeg", "txt"]
rateLimit:
windowSeconds: 600
maxTicketsPerWindow: 3
如果有任何不清楚的地方,欢迎提交 Issue。该插件设计为可在普通的 Paper 服务器上轻松运行。
本插件的开发使用了 GPT-5、Gemini 2.5 和 Claude Sonnet 4。因此,禁止通过重新分发或在具有 P2W(付费获胜)功能的服务器中使用此插件来获利。
请参阅许可证文件以获取更多信息。
ValeTickets - simple ticketing for your server
ValeTickets intends to make it easy for players to ask for help and for staff to keep track of it. It’s a small plugin with in‑game commands and a tiny web page for staff. I run this in my spare time, so I try to keep it practical and safe.
▶️ Quick start
- Drop the jar in
plugins/ and start the server once.
- In‑game (as OP), run
/ticketsetup to create the owner account.
- Visit
http://<server-ip>:<configured-port>/admin and sign in.
- Add admins with
/ticketadmin add <username>.
- Players use
/ticket to file tickets and /ticket check to see updates.
If /admin returns 401, the owner account may not exist yet or the credentials are wrong.
? What it does
- Players can open tickets in chat with a short guided flow.
- Staff can view tickets on a small web dashboard.
- Optional file uploads (screenshots/logs) with type/size limits.
- Simple roles:
OWNER (can manage accounts) and ADMIN.
- Basic rate limiting on the public form to reduce spam.
- In-game notifications when tickets are updated.
- DiscordSRV integration support planned for future versions.
? Commands
Players
/ticket - start a short guided flow to create a ticket
/ticket check - view your tickets and their status
Admins
/ticketadmin passwd - change your own password
Owner
/ticketsetup - create the first owner account (permission: valetickets.setup)
/ticketadmin add <username> - add an admin
/ticketadmin reset <username> - reset an admin’s password
/ticketadmin list - list accounts
/ticketreload - reload plugin config and restart the web server (permission: valetickets.reload)
Examples
/ticketadmin add alice
/ticketadmin reset bob
? Web interface
- Public form:
http://<server-ip>:8765/
- Admin dashboard:
http://<server-ip>:8765/admin
- Change password:
http://<server-ip>:8765/change-password
? Security
- Passwords are hashed with Argon2id. No plaintext, ever.
- The plugin ships as a single jar with needed libraries inside.
⚙️ Config
plugins/ValeTickets/config.yml
web:
enabled: true
bind: 0.0.0.0
port: 8765
# How to show ticket URLs to players
urlDisplay:
mode: "ip" # "ip", "domain", or "custom"
domain: "your-server.com" # Used when mode is "domain"
customMessage: "Check our website!" # Used when mode is "custom"
uploads:
enabled: true
dir: uploads
maxBytesPerTicket: 104857600 # 100 MB total
maxBytesPerFile: 10485760 # 10 MB per file
allowedTypes: ["png", "jpg", "jpeg", "txt"]
rateLimit:
windowSeconds: 600
maxTicketsPerWindow: 3
If anything’s unclear, feel free to open an issue. The plugin is intended to be simple to run on a normal Paper server.
This Plugin was built with the use of GPT-5, Gemini 2.5, and Claude Sonnet 4. As such, profiting off this plugin through redistribution or use in servers with P2W features is prohibited.
Please see license file for more information.
评论 0
登录后参与评分
还没有评论,来抢沙发吧