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.<\/p>\n
## Features<\/p>\n
– **In-Game Posting** – Players submit categorized posts using simple commands
\n– **Discord Forum Integration** – Posts automatically create forum threads with appropriate tags
\n– **Status Tracking** – Track reports through customizable statuses (Pending, In Progress, Resolved, etc.)
\n– **Two-Way Sync** – Status changes in-game update the Discord thread title
\n– **Location Capture** – Automatically records where posts were submitted for easy teleportation
\n– **Permission System** – Granular permissions for players and staff
\n– **Persistent Storage** – Posts survive server restarts
\n– **Hot Reload** – Update configuration without restarting<\/p>\n
## Requirements<\/p>\n
– Paper 1.21+
\n– Java 21+
\n– A Discord bot with permissions to manage threads in a forum channel<\/p>\n
## Installation<\/p>\n
1. Download the latest release and place it in your `plugins` folder
\n2. Start your server to generate the default configuration
\n3. Stop the server and edit `plugins\/ForumPoster\/config.yml`
\n4. Add your Discord bot token and forum channel URL
\n5. Configure your categories with Discord forum tag IDs
\n6. Start your server<\/p>\n
## Configuration<\/p>\n
“`yaml
\nbot:
\n token: “YOUR_BOT_TOKEN_HERE”
\n url: “https:\/\/discord.com\/channels\/GUILD_ID\/CHANNEL_ID”<\/p>\n
command:
\n name: “forumpost”
\n aliases: [“fp”, “postforum”]<\/p>\n
categories:
\n – name: “bug”
\n display: “Bug Report”
\n id: 1122334455667788990 # Discord forum tag ID
\n – name: “suggestion”
\n display: “Suggestion”
\n id: 1122334455667788991<\/p>\n
status:
\n statuses: [“PENDING”, “IN_PROGRESS”, “RESOLVED”, “CLOSED”]
\n default: “PENDING”
\n“`<\/p>\n
### Finding Discord Forum Tag IDs<\/p>\n
1. Enable Developer Mode in Discord (Settings > App Settings > Advanced > Developer Mode)
\n2. Go to your forum channel
\n3. Right-click on a tag and select “Copy Tag ID”<\/p>\n
### Discord Bot Setup<\/p>\n
1. Create a bot at the Discord Developer Portal
\n2. Enable the bot and copy the token
\n3. Invite the bot to your server with permissions to:
\n – View Channels
\n – Send Messages
\n – Create Public Threads
\n – Manage Threads
\n4. Ensure the bot has access to your forum channel<\/p>\n
## Commands<\/p>\n
| Command | Usage | Description | **Aliases:** `\/forumpost` can also be used as `\/fp` or `\/postforum`<\/p>\n ### Customizing the Command Name<\/p>\n The `\/forumpost` command name is fully customizable in `config.yml`. You can rename it to fit your server’s theme or terminology:<\/p>\n “`yaml **Examples:** 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.<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | ## How It Works<\/p>\n When a player submits a report:<\/p>\n 1. A forum thread is created in your Discord channel with the configured tag **Discord Thread Format:** Thread Content: ## Example Usage<\/p>\n **Player submitting a bug report:** **Staff checking reports:** **Staff updating status:** **Teleporting to investigate:** ## Support<\/p>\n Found a bug or have a suggestion? Open an issue on GitHub!<\/p>\n ## License<\/p>\n This project is open source. Feel free to use, modify, and distribute.<\/p>\n","protected":false},"excerpt":{"rendered":" Allow players to submit posts directly to a Discord forum channel.<\/p>\n","protected":false},"featured_media":72382,"template":"","meta":{"_minecraft_slug":"forumposter","_minecraft_project_id":"EJ0UjZCX","_minecraft_author":"KohanMathers","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"forumposter.zip","_minecraft_size_bytes":39823,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:14:58.683389Z","_minecraft_date_created":"2026-01-25T00:50:40.063396Z","_minecraft_date_modified":"2026-01-22T03:56:43.820372Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/forumposter","_minecraft_icon_attachment_id":72382,"_minecraft_imported_at":"2026-06-04T02:34:25+00:00","_minecraft_import_hash":"733718df899165cfaf2204376935d321","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,867,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-72381","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| ————- | ——————————— | ————————————————– |
\n| `\/forumpost` | `\/forumpost
\n| `\/posts` | `\/posts` | List your reports (or all reports with permission) |
\n| `\/postinfo` | `\/postinfo
\n| `\/setstatus` | `\/setstatus
\n| `\/deletepost` | `\/deletepost
\n| `\/tppost` | `\/tppost
\n| `\/fpreload` | `\/fpreload` | Reload the configuration |<\/p>\n
\ncommand:
\n name: “report” # Changes \/forumpost to \/report
\n aliases: [“r”, “submit”] # Custom aliases
\n“`<\/p>\n
\n– `name: “report”` \u2192 Players use `\/report bug My issue here`
\n– `name: “ticket”` \u2192 Players use `\/ticket suggestion Add more parkour`
\n– `name: “feedback”` \u2192 Players use `\/feedback bug The shop is broken`<\/p>\n
\n| ———————– | ——– | ———————————– |
\n| `forumposter.use` | Everyone | Submit reports with `\/forumpost` |
\n| `forumposter.seeall` | OP | View all reports, not just your own |
\n| `forumposter.setstatus` | OP | Change report statuses |
\n| `forumposter.delete` | OP | Delete reports |
\n| `forumposter.teleport` | OP | Teleport to report locations |
\n| `forumposter.reload` | OP | Reload the configuration |<\/p>\n
\n2. The thread contains the report ID, author, category, location, and full message
\n3. The report is saved locally for persistence
\n4. Staff can update the status in-game, which syncs to Discord<\/p>\n
\n“`
\nThread Title: [PENDING] PlayerName – Report message preview…<\/p>\n
\n**Post ID**: 1-abc1234-xyz5678
\n**Author**: PlayerName
\n**Category**: Bug Report
\n**Location**: world: 100, 64, -200
\n**Created**:
\n**Content**: Full report message here…
\n“`<\/p>\n
\n“`
\n\/forumpost bug The nether portal at spawn isn’t working correctly
\n“`<\/p>\n
\n“`
\n\/posts
\n\/postinfo 1-abc1234-xyz5678
\n“`<\/p>\n
\n“`
\n\/setstatus 1-abc1234-xyz5678 IN_PROGRESS
\n\/setstatus 1-abc1234-xyz5678 RESOLVED
\n“`<\/p>\n
\n“`
\n\/tppost 1-abc1234-xyz5678
\n“`<\/p>\n