一个 Paper 插件,允许玩家直接向 Discord 论坛频道提交帖子。在游戏中创建错误报告、建议和反馈,这些内容会自动作为组织良好的论坛线程出现在 Discord 中。
功能
- 游戏内发帖 - 玩家使用简单命令提交分类帖子
- Discord 论坛集成 - 帖子自动创建带有适当标签的论坛线程
- 状态跟踪 - 通过可自定义的状态(待处理、进行中、已解决等)跟踪报告
- 双向同步 - 游戏内的状态更改会更新 Discord 线程标题
- 位置捕获 - 自动记录帖子的提交位置,以便轻松传送
- 权限系统 - 为玩家和工作人员提供细粒度的权限
- 持久存储 - 帖子在服务器重启后仍然存在
- 热重载 - 无需重启即可更新配置
要求
- Paper 1.21+
- Java 21+
- 一个拥有管理论坛频道中线程权限的 Discord 机器人
安装
- 下载最新版本并将其放入
plugins 文件夹
- 启动服务器以生成默认配置
- 停止服务器并编辑
plugins/ForumPoster/config.yml
- 添加你的 Discord 机器人令牌和论坛频道 URL
- 使用 Discord 论坛标签 ID 配置你的类别
- 启动服务器
配置
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
- 在 Discord 中启用开发者模式(设置 > 应用设置 > 高级 > 开发者模式)
- 进入你的论坛频道
- 右键单击标签并选择“复制标签 ID”
Discord 机器人设置
- 在 Discord Developer Portal 创建一个机器人
- 启用机器人并复制令牌
- 邀请机器人到你的服务器,权限包括:
- 确保机器人有权访问你的论坛频道
命令
| 命令 |
用法 |
描述 |
/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 |
重新加载配置 |
工作原理
当玩家提交报告时:
- 在你的 Discord 频道中创建一个带有配置标签的论坛线程
- 线程包含报告 ID、作者、类别、位置和完整消息
- 报告被本地保存以实现持久化
- 工作人员可以在游戏中更新状态,这将同步到 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 上打开一个问题!
许可证
本项目是开源的。欢迎使用、修改和分发。
A Paper plugin that allows players to submit posts directly to a Discord forum channel. Create bug reports, suggestions, and feedback in-game that automatically appear as organized forum threads in Discord.
Features
- In-Game Posting - Players submit categorized posts using simple commands
- Discord Forum Integration - Posts automatically create forum threads with appropriate tags
- Status Tracking - Track reports through customizable statuses (Pending, In Progress, Resolved, etc.)
- Two-Way Sync - Status changes in-game update the Discord thread title
- Location Capture - Automatically records where posts were submitted for easy teleportation
- Permission System - Granular permissions for players and staff
- Persistent Storage - Posts survive server restarts
- Hot Reload - Update configuration without restarting
Requirements
- Paper 1.21+
- Java 21+
- A Discord bot with permissions to manage threads in a forum channel
Installation
- Download the latest release and place it in your
plugins folder
- Start your server to generate the default configuration
- Stop the server and edit
plugins/ForumPoster/config.yml
- Add your Discord bot token and forum channel URL
- Configure your categories with Discord forum tag IDs
- Start your server
Configuration
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"
Finding Discord Forum Tag IDs
- Enable Developer Mode in Discord (Settings > App Settings > Advanced > Developer Mode)
- Go to your forum channel
- Right-click on a tag and select "Copy Tag ID"
Discord Bot Setup
- Create a bot at the Discord Developer Portal
- Enable the bot and copy the token
- Invite the bot to your server with permissions to:
- View Channels
- Send Messages
- Create Public Threads
- Manage Threads
- Ensure the bot has access to your forum channel
Commands
| Command |
Usage |
Description |
/forumpost |
/forumpost <category> <message> |
Submit a new report |
/posts |
/posts |
List your reports (or all reports with permission) |
/postinfo |
/postinfo <id> |
View details about a specific report |
/setstatus |
/setstatus <id> <status> |
Change a report's status |
/deletepost |
/deletepost <id> |
Delete a report |
/tppost |
/tppost <id> |
Teleport to where a report was made |
/fpreload |
/fpreload |
Reload the configuration |
Aliases: /forumpost can also be used as /fp or /postforum
Customizing the Command Name
The /forumpost command name is fully customizable in config.yml. You can rename it to fit your server's theme or terminology:
command:
name: "report" # Changes /forumpost to /report
aliases: ["r", "submit"] # Custom aliases
Examples:
name: "report" → Players use /report bug My issue here
name: "ticket" → Players use /ticket suggestion Add more parkour
name: "feedback" → Players use /feedback bug The shop is broken
After changing the command name, run /fpreload or restart your server for changes to take effect. The new command will have full tab completion for categories and statuses.
Permissions
| Permission |
Default |
Description |
forumposter.use |
Everyone |
Submit reports with /forumpost |
forumposter.seeall |
OP |
View all reports, not just your own |
forumposter.setstatus |
OP |
Change report statuses |
forumposter.delete |
OP |
Delete reports |
forumposter.teleport |
OP |
Teleport to report locations |
forumposter.reload |
OP |
Reload the configuration |
How It Works
When a player submits a report:
- A forum thread is created in your Discord channel with the configured tag
- The thread contains the report ID, author, category, location, and full message
- The report is saved locally for persistence
- Staff can update the status in-game, which syncs to Discord
Discord Thread Format:
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...
Example Usage
Player submitting a bug report:
/forumpost bug The nether portal at spawn isn't working correctly
Staff checking reports:
/posts
/postinfo 1-abc1234-xyz5678
Staff updating status:
/setstatus 1-abc1234-xyz5678 IN_PROGRESS
/setstatus 1-abc1234-xyz5678 RESOLVED
Teleporting to investigate:
/tppost 1-abc1234-xyz5678
Support
Found a bug or have a suggestion? Open an issue on GitHub!
License
This project is open source. Feel free to use, modify, and distribute.
评论 0
登录后参与评分
还没有评论,来抢沙发吧