Forums
Give your community a dedicated space to connect, share ideas, and have discussions. Zander's built-in forum system supports threaded conversations, embedded polls, edit history, and a full suite of moderation tools — all managed from the dashboard without needing a third-party forum platform.
📸 Screenshot: The forums homepage showing recent discussions across multiple categories with post counts and last-reply info
Structure
| Layer | Description |
|---|---|
| Category | Top-level grouping (e.g. "General", "Announcements", "Help"). Each category has its own view and post permissions. |
| Discussion | A thread started within a category — has a title, body, and optional poll. |
| Post | A reply within a discussion. Posts track edit history as revisions. |
For Players
Browsing
| URL | Description |
|---|---|
/forums | Recent discussions across all accessible categories |
/forums/category/<slug> | All discussions in a specific category |
/forums/discussion/<id> | Full discussion thread with all replies |
Categories you don't have permission to view are hidden from the listing automatically.
Starting a Discussion
- Navigate to a category.
- Click New Discussion.
- Enter a title and body. Optionally add a poll (see below).
- Post — your discussion is live immediately.
Requires login. Posting is also subject to the category's configured post permission.
Replies and Editing
Reply to any discussion you can view by using the reply box at the bottom. You can edit your own posts at any time — each edit is saved as a revision in the history.
Polls
Discussions can include an embedded poll. To vote:
- Click your chosen option.
- You can change your vote later if you change your mind.
Reporting
If you see content that violates the rules, use the Report option on any post to flag it for staff review.
📸 Screenshot: A forum discussion showing the original post, replies, and the reply input box at the bottom
For Staff
Moderation Actions
Moderators can take the following actions from discussion and post pages:
| Action | Permission |
|---|---|
| Edit any post or discussion body | zander.forums.moderate |
| Delete any post | zander.forums.post.delete |
| Move a discussion to a different category | zander.forums.moderate |
| Lock a discussion (prevents new replies) | zander.forums.discussion.lock |
| Unlock a locked discussion | zander.forums.discussion.lock |
| Pin a discussion to the top of its category | zander.forums.discussion.sticky |
| Unpin a pinned discussion | zander.forums.discussion.sticky |
| Archive a discussion | zander.forums.discussion.archive |
| View archived discussions | zander.forums.viewArchived |
| Manage categories (dashboard) | zander.forums.category.manage |
Authors can always edit and delete their own content without any moderation permission. The permissions above grant the ability to act on any user's content.
Edit History
Every post edit is recorded as a revision. View the full edit history for any post at /forums/post/<postId>/revisions. This is useful for reviewing what was changed and when.
📸 Screenshot: The post revision history page showing timestamps and diffs of each edit
Managing Categories
Category management is at Dashboard → Forums → Categories (requires zander.forums.category.manage).
Category Fields
| Field | Description |
|---|---|
| Name | Display name shown in the forum navigation |
| Slug | URL-safe identifier used in all category paths — e.g. general → /forums/category/general |
| View Permission | LuckPerms node required to see this category (leave blank for public) |
| Post Permission | LuckPerms node required to create discussions in this category (leave blank for all logged-in users) |
📸 Screenshot: The category management dashboard showing category list with edit and permission controls
Setting Up Your First Category
- Go to Dashboard → Forums → Categories and click New Category.
- Enter a name (e.g.
General) and slug (e.g.general). - Leave view/post permissions blank for a public category, or enter LuckPerms nodes to restrict access.
- Save.
Granting Permissions in LuckPerms
If your categories use permission nodes, grant them to the relevant groups:
# Allow all registered users to view and post in the general category
/lp group default permission set <view-permission-node> true
/lp group default permission set <post-permission-node> true
# Grant moderation permissions to your moderation group
/lp group moderator permission set zander.forums.moderate true
/lp group moderator permission set zander.forums.post.delete true
/lp group moderator permission set zander.forums.discussion.lock true
/lp group moderator permission set zander.forums.discussion.sticky true
/lp group moderator permission set zander.forums.discussion.archive true
/lp group moderator permission set zander.forums.viewArchived true
Feature Toggle
"forums": false
Disabling forums removes the forum from the navigation and returns a feature-disabled error from all forum API endpoints.