Getting Started with Event Sentinel

Step 1: Add Event Sentinel to Your Server

Before you can use Event Sentinel, it needs to be added to your Discord server. If the bot is already in your server, skip to Step 2.

Invite Instructions:

1. Click the invite button above (or use this link)
2. Select your Discord server from the dropdown menu
3. Review and authorize the required permissions
4. Click "Authorize" to add Event Sentinel to your server

Required Permissions:

Event Sentinel needs these permissions to function properly:

• ✅ View Channels
• ✅ Send Messages
• ✅ Embed Links
• ✅ Attach Files
• ✅ Read Message History
• ✅ View Audit Log (to capture moderator information)

Step 2: Create a Logging Channel

Before configuring the bot, you should create a dedicated channel for event logs. This keeps your logs organized and separate from regular chat.

1. In your Discord server, create a new text channel (e.g., #event-logs or #mod-logs)
2. Make sure the channel is visible to administrators or moderators (you can restrict it to specific roles if needed)
3. Important: Ensure Event Sentinel has permission to send messages in this channel

Step 3: Configure the Log Channel

Now it's time to tell Event Sentinel where to send the logs. This is done with a simple command!

Using the /setlogchannel Command

1. In your Discord server, type /setlogchannel in any channel
2. You'll see a dropdown menu - select the channel where you want logs to be sent
3. Press Enter or click the channel option
4. The bot will confirm that the log channel has been set!

What Happens Next?

Once you've set the log channel, Event Sentinel will immediately start logging events to that channel. You don't need to restart anything or run additional commands!

Step 4: Verify It's Working

To make sure everything is set up correctly, you can use the test command or try some actions:

Option 1: Use the Test Command (Recommended)

The easiest way to verify logging is working:

1. Type /testlog in any channel
2. The bot will send a test embed to your configured log channel
3. If successful, you'll see a confirmation message

Option 2: Trigger Real Events

Alternatively, try one of these actions in your server:

• Have someone join or leave the server
• Edit or delete a message
• Change a channel name or settings
• Add or remove a role

You should see a detailed log message appear in your configured log channel!

Multiple Servers?

Event Sentinel supports multiple Discord servers! Each server has its own independent configuration.

1. Add Event Sentinel to each server you want to monitor
2. Run /setlogchannel in each server
3. Select a different log channel for each server (or use the same channel name - it's up to you!)

Note: Each server's configuration is completely separate. Changing the log channel in one server won't affect the others.

Changing Your Log Channel

Need to change where logs are sent? No problem!

1. Simply run /setlogchannel again
2. Select the new channel
3. The bot will immediately start sending logs to the new channel

You can change the log channel as many times as you need.

Setting Up Modmail (Optional)

Modmail allows users to contact your server staff by sending direct messages to the bot. Each conversation creates a thread in a dedicated channel for organized support.

Step 1: Create a Modmail Channel

First, create a channel where modmail threads will be created:

1. Create a new text channel (e.g., #modmail or #support-tickets)
2. Make sure the channel is visible to your staff/moderator roles
3. Important: Ensure Event Sentinel has these permissions in this channel:
   • Send Messages
   • Embed Links
   • Create Public Threads
   • Send Messages in Threads

Step 2: Set the Modmail Channel

Configure where modmail threads should be created:

1. Type /setmodmailchannel in any channel
2. Select the channel you created for modmail
3. The bot will confirm the modmail channel has been set

Step 3: Enable Modmail

By default, modmail may be disabled. Enable it with:

1. Type /togglemail enabled:true
2. The bot will confirm that modmail is now enabled

How It Works

1. Users send a direct message to Event Sentinel
2. A thread is automatically created in your modmail channel
3. Staff members can respond in the thread
4. Users receive responses in their DMs
5. All conversations are organized in threads for easy tracking

Troubleshooting

Bot isn't logging events

• ✅ Check that you've run /setlogchannel and selected a channel
• ✅ Verify the bot has permission to send messages in the log channel
• ✅ Make sure the bot has "View Audit Log" permission in your server
• ✅ Check that the bot is online (look for the green status indicator)

Can't use the /setlogchannel command

• ✅ You must be a server administrator to use this command
• ✅ Make sure the bot has been properly added to your server
• ✅ Try typing / and see if the command appears in the list

Logs are missing information

• ✅ Ensure the bot has "View Audit Log" permission (needed for moderator information)
• ✅ Some events may not have audit log entries if they happened before the bot was added

Quick Command Reference

Here are the most commonly used commands:

• /setlogchannel - Set or change the log channel
• /testlog - Send a test message to verify logging works
• /config - View your server's current configuration
• /checkperms - Check if the bot has all required permissions
• /setmodmailchannel - Set the channel for modmail threads (optional)
• /togglemail - Enable/disable modmail for your server (optional)
• /help - View all available commands

For a complete list of all commands and advanced configuration options, see the Configuration Guide.