**Feedbackify** 是一个用于管理 Paper 服务器上玩家反馈的综合系统。它允许玩家通过直观的 GUI 提交反馈,同时为管理员提供强大的工具来审查、管理和回复反馈。该插件与 Discord 集成,以发送有关新反馈、状态更改等通知。插件发送的所有消息都会自动添加可配置的字符串前缀。
---
## 特点
### 玩家反馈提交
- **反馈 GUI**
玩家使用 `/feedback` 命令来打开一个 GUI,允许他们:
- 选择反馈类别。
- 输入反馈文本(根据可配置的长度自动拆分为行)。
- 查看唯一的反馈 ID(带有复制到剪贴板的功能)。
- 切换反馈是否公开。
- 确认并提交他们的反馈。
- **开放反馈限制和冷却时间**
- 每个玩家的开放(待处理)反馈工单的最大数量是可配置的(设置为 `-1` 表示无限制)。
- 可配置的冷却时间(以分钟为单位)可以防止垃圾提交新的反馈。
- 具有 `feedback.cooldownbypass` 权限的玩家可以绕过冷却时间。
### 管理员工具
- **分析和日志**
- 管理员可以使用带有 `/feedback analytics` 的分页分析 GUI 来查看所有提交的反馈。
- `/feedback logs ` 命令显示特定玩家的详细反馈日志。
- `/feedback view ` 命令(反馈 ID 自动补全)打开特定反馈条目的详细管理员视图。
- **详细反馈管理**
- 管理员可以更改状态(在“待处理”、“已审查”和“已解决”之间循环)。
- 他们可以添加管理员回复。
- 他们可以锁定或解锁反馈。
- 他们可以永久删除反馈(这将擦除所有关联的数据,包括回复)。
- **反馈历史**
- 玩家和管理员都可以通过 `/feedback history` 查看分页显示的反馈条目历史记录。
- 管理员可以从历史GUI打开详细视图进行进一步管理。
### 社区反馈
- **社区 GUI**
公开的反馈条目显示在单独的社区 GUI 中,所有玩家都可以看到。
- 玩家可以查看反馈、查看回复以及通过点赞和点踩进行互动。
- 存在一个专门的分页回复GUI来详细查看回复。
### 通知
- **游戏内通知**
- 当反馈收到回复、状态更改或被锁定/解锁时,玩家会收到通知。
- 如果玩家在线,则会立即传递通知;如果玩家离线,则会将通知存储并在下次登录时传递。
- 玩家可以使用 `/feedback togglenotifications` 切换通知的开关。
---
## 配置 (`config.yml`)
```yaml
feedback:
debug: false
dataFile: "feedbacks.yml"
autoSaveInterval: 300
guiSize: 27
guiItemSpacing:
nextPage: 53
previousPage: 45
itemFormats:
category: "&eCategory: %category%"
status: "&bStatus: %status%"
lineLength: 20
maxOpenFeedback: 3 # 每个玩家的最大开放反馈工单数量 (-1 表示无限制)
cooldown: 5 # 冷却时间,单位分钟 (-1 表示无冷却时间)
```
## 命令
/feedback
打开反馈创建 GUI。
/feedback analytics
打开管理员分析 GUI,列出所有反馈条目(需要 feedback.analytics)。
/feedback logs
显示指定玩家的详细反馈日志(需要 feedback.logs)。
/feedback view
打开特定反馈的详细管理员视图(仅限管理员;反馈 ID 自动补全)。
/feedback history
打开分页显示的您提交的反馈历史 GUI。
/feedback community
打开公共社区反馈 GUI。
/feedback togglenotifications
切换游戏内反馈通知的开关。
/feedback reload
重新加载插件配置(需要 feedback.manage)。
/feedback blacklist [time] / /feedback unblacklist
管理反馈提交的黑名单(需要 feedback.blacklist)。
## 权限
feedback.manage
允许管理反馈系统(启用/禁用/重新加载)。
feedback.logs
允许查看详细的反馈日志。
feedback.blacklist
允许管理反馈提交的黑名单。
feedback.cooldownbypass
允许绕过提交新反馈的冷却时间。
feedback.analytics
授予访问分析GUI的权限。
在 Discord 服务器上报告任何错误。(链接在侧边)