ValeTickets

插件

· 作者 wolftailvale

ValeTickets 旨在让玩家能够轻松寻求帮助,并方便工作人员进行跟踪。这是一个小型插件,包含游戏内命令和一个供工作人员使用的小型网页。我利用业余时间维护这个项目,因此力求使其实用且安全。

0 本站下载 0 关注 更新于 1 年前

最新 1.21.8_1.5.0 · 1.21.8 · Paper

一键开服(送7天)

ValeTickets - 为你的服务器提供简单的工单系统

ValeTickets 旨在让玩家能够轻松地寻求帮助,并让管理员方便地跟踪这些请求。这是一个小巧的插件,包含游戏内命令和一个供管理员使用的简易网页界面。我利用业余时间维护这个项目,因此力求保持其实用性和安全性。

▶️ 快速开始

  1. 将 jar 文件放入 plugins/ 目录并启动服务器一次。
  2. 在游戏中(作为 OP),运行 /ticketsetup 创建所有者账户。
  3. 访问 http://<server-ip>:<configured-port>/admin 并登录。
  4. 使用 /ticketadmin add <username> 添加管理员。
  5. 玩家使用 /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(付费获胜)功能的服务器中使用此插件来获利。 请参阅许可证文件以获取更多信息。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源