Forum Moderator

The Forum Moderator module allows you to automate post evaluation and management in your Discord forum channels. By creating custom scripts, you can define specific criteria for new posts and set automated actions to maintain order and engagement. Forum Moderator Dashboard

Overview

Forum Moderator operates on a vertical logic flow:

WHEN: A new post is created in a forum channel.
IF (Filters): The post matches specific criteria (e.g., contains keywords, has an attachment).
THEN (Actions): MurFFy executes predefined actions (e.g., tagging, locking, or sending a message).

Global Configuration

Before creating your first automation script, ensure the module is set up correctly in the global settings.

Master Control

Enable or disable the entire Forum Moderator module globally using the master switch. This allows you to pause all automations instantly if needed.

Global Settings (Audit Logs)

Configure Audit Logging to track every automated action taken by MurFFy. It is highly recommended to select a dedicated log channel to monitor the bot’s activity. Global Settings

Automation Scripts

Automation Scripts are the core of the module. Each script represents a specific rule set for your forum channels.

Script Logic

Each script follows a logical progression:

Scope: Restrict the script to specific forum channels or apply it to the entire server.
Filter Logic: Choose between AND (all filters must match) or OR (at least one filter matches).

Filters (Conditions)

Filters define the criteria for your automation. You can add multiple filters to fine-tune when an automation should trigger. Adding Filters

Filter	Description
Post Title Matches Regex	Checks if the post title matches a specific Regular Expression pattern.
Post Content Matches Regex	Checks if the post content matches a specific Regular Expression pattern.
Post Has Attachments	Triggers if the post contains one or more files/images.
Post Has Tags	Triggers if the post was created with specific tags.
Author Has Role	Triggers if the user who created the post has specific roles.
Author Is Member Since	Triggers based on how long the user has been on the server.

Regex filters are case-insensitive by default to ensure broader matching.

Automated Actions

Define what happens when a post matches your criteria. You can stack multiple actions within a single script. Adding Actions

Action	Technical Action	Description
Send Message	`SEND_MESSAGE`	Sends a plain text message in the current thread.
Send Message in Channel	`SEND_MESSAGE_IN_CHANNEL`	Sends a text message to a specific channel.
Send Embed	`SEND_EMBED`	Sends a Rich Embed in the current thread.
Send Embed in Channel	`SEND_EMBED_IN_CHANNEL`	Sends a Rich Embed to a specific channel.
Send DM	`SEND_DM`	Sends a private message to the post author.
Add Tag	`ADD_TAG`	Adds specific tags to the post.
Remove Tag	`REMOVE_TAG`	Removes specific tags from the post.
Lock Post	`LOCK_POST`	Blocks and archives the thread immediately.
Pin Post	`PIN_POST`	Pins the welcome message in the thread.
Delete Post	`DELETE_POST`	Removes the thread entirely.
Add Role	`ADD_ROLE`	Assigns roles to the post author.
Remove Role	`REMOVE_ROLE`	Removes roles from the post author.
Send Log	`SEND_LOG`	Sends a notification to the bot’s log channel.

Rich Embeds

The SEND_EMBED and SEND_EMBED_IN_CHANNEL actions allow for highly customizable messages. All text fields support dynamic placeholders.

Field	Description
Content	Optional text displayed above the Embed.
Title	The main header of the Embed.
Description	The primary message content.
Color	Side border color in Hex format (e.g., `#5865F2`).
Author	Name, Icon URL, and Link for the top section.
Footer	Text and Icon URL for the bottom section.
Images	Support for both Main Image and Thumbnail (top-right).
Timestamp	Toggle to show the current date/time in the footer.

Dynamic Variables (Placeholders)

Use these variables to make your automated messages and embeds dynamic. They are automatically replaced with real data when the action is executed.

Variable	Replacement
`{user}`	User’s username (e.g., `JohnDoe`)
`{user.mention}`	Mentions the user (e.g., `<@123...>` )
`{user.id}`	User’s unique ID
`{post.title}`	The name of the forum post
`{post.url}`	Direct link to the post
`{channel}`	Name of the forum channel
`{channel.mention}`	Mentions the forum channel
`{server}`	The name of your server
`{rule}`	The name of the automation rule that was triggered

Quick Guide

Keep it Simple: Start with simple rules (e.g., adding a “New” tag to all posts) before moving to complex Regex filters.
Log Everything: During setup, use the Send Log action to verify that your filters are working as expected without interfering with users.
Order Matters: Rules are evaluated in the order they appear. You can reorder scripts to change the execution priority.

​Forum Moderator

​Overview

​Global Configuration

​Master Control

​Global Settings (Audit Logs)

​Automation Scripts

​Script Logic

​Filters (Conditions)

​Automated Actions

​Rich Embeds

​Dynamic Variables (Placeholders)

​Quick Guide

Forum Moderator

Overview

Global Configuration

Master Control

Global Settings (Audit Logs)

Automation Scripts

Script Logic

Filters (Conditions)

Automated Actions

Rich Embeds

Dynamic Variables (Placeholders)

Quick Guide