ForumPoster

插件

· 作者 KohanMathers

允许玩家直接将帖子发布到 Discord 论坛频道。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

一个 Paper 插件,允许玩家直接向 Discord 论坛频道提交帖子。在游戏中创建错误报告、建议和反馈,这些内容会自动作为组织良好的论坛线程出现在 Discord 中。

功能

  • 游戏内发帖 - 玩家使用简单命令提交分类帖子
  • Discord 论坛集成 - 帖子自动创建带有适当标签的论坛线程
  • 状态跟踪 - 通过可自定义的状态(待处理、进行中、已解决等)跟踪报告
  • 双向同步 - 游戏内的状态更改会更新 Discord 线程标题
  • 位置捕获 - 自动记录帖子的提交位置,以便轻松传送
  • 权限系统 - 为玩家和工作人员提供细粒度的权限
  • 持久存储 - 帖子在服务器重启后仍然存在
  • 热重载 - 无需重启即可更新配置

要求

  • Paper 1.21+
  • Java 21+
  • 一个拥有管理论坛频道中线程权限的 Discord 机器人

安装

  1. 下载最新版本并将其放入 plugins 文件夹
  2. 启动服务器以生成默认配置
  3. 停止服务器并编辑 plugins/ForumPoster/config.yml
  4. 添加你的 Discord 机器人令牌和论坛频道 URL
  5. 使用 Discord 论坛标签 ID 配置你的类别
  6. 启动服务器

配置

bot:
  token: "YOUR_BOT_TOKEN_HERE"
  url: "https://discord.com/channels/GUILD_ID/CHANNEL_ID"

command:
  name: "forumpost"
  aliases: ["fp", "postforum"]

categories:
  - name: "bug"
    display: "Bug Report"
    id: 1122334455667788990  # Discord forum tag ID
  - name: "suggestion"
    display: "Suggestion"
    id: 1122334455667788991

status:
  statuses: ["PENDING", "IN_PROGRESS", "RESOLVED", "CLOSED"]
  default: "PENDING"

查找 Discord 论坛标签 ID

  1. 在 Discord 中启用开发者模式(设置 > 应用设置 > 高级 > 开发者模式)
  2. 进入你的论坛频道
  3. 右键单击标签并选择“复制标签 ID”

Discord 机器人设置

  1. 在 Discord Developer Portal 创建一个机器人
  2. 启用机器人并复制令牌
  3. 邀请机器人到你的服务器,权限包括:
    • 查看频道
    • 发送消息
    • 创建公开线程
    • 管理线程
  4. 确保机器人有权访问你的论坛频道

命令

命令 用法 描述
/forumpost /forumpost <category> <message> 提交新报告
/posts /posts 列出你的报告(或有权限时列出所有报告)
/postinfo /postinfo <id> 查看特定报告的详细信息
/setstatus /setstatus <id> <status> 更改报告状态
/deletepost /deletepost <id> 删除报告
/tppost /tppost <id> 传送到报告提交的位置
/fpreload /fpreload 重新加载配置

别名: /forumpost 也可以用作 /fp 或 /postforum

自定义命令名称

/forumpost 命令名称在 config.yml 中完全可自定义。你可以将其重命名以符合服务器的主题或术语:

command:
  name: "report"           # 将 /forumpost 更改为 /report
  aliases: ["r", "submit"] # 自定义别名

示例:

  • name: "report" → 玩家使用 /report bug My issue here
  • name: "ticket" → 玩家使用 /ticket suggestion Add more parkour
  • name: "feedback" → 玩家使用 /feedback bug The shop is broken

更改命令名称后,运行 /fpreload 或重启服务器以使更改生效。新命令将支持类别和状态的完整 Tab 补全。

权限

权限 默认值 描述
forumposter.use Everyone 使用 /forumpost 提交报告
forumposter.seeall OP 查看所有报告,而不仅仅是自己的
forumposter.setstatus OP 更改报告状态
forumposter.delete OP 删除报告
forumposter.teleport OP 传送到报告位置
forumposter.reload OP 重新加载配置

工作原理

当玩家提交报告时:

  1. 在你的 Discord 频道中创建一个带有配置标签的论坛线程
  2. 线程包含报告 ID、作者、类别、位置和完整消息
  3. 报告被本地保存以实现持久化
  4. 工作人员可以在游戏中更新状态,这将同步到 Discord

Discord 线程格式:

Thread Title: [PENDING] PlayerName - Report message preview...

Thread Content:
**Post ID**: 1-abc1234-xyz5678
**Author**: PlayerName
**Category**: Bug Report
**Location**: world: 100, 64, -200
**Created**: <t:1234567890:R>
**Content**: Full report message here...

使用示例

玩家提交错误报告:

/forumpost bug The nether portal at spawn isn't working correctly

工作人员检查报告:

/posts
/postinfo 1-abc1234-xyz5678

工作人员更新状态:

/setstatus 1-abc1234-xyz5678 IN_PROGRESS
/setstatus 1-abc1234-xyz5678 RESOLVED

传送到调查:

/tppost 1-abc1234-xyz5678

支持

发现错误或有任何建议?在 GitHub 上打开一个问题!

许可证

本项目是开源的。欢迎使用、修改和分发。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源