Initial Setup

Once HalloweenBot has been added to your Discord server, you can configure and manage it through the HalloweenBot Dashboard.

Dashboard URL:

https://dash.halloweenbot.com

Access the Dashboard

Visit the HalloweenBot Dashboard.
Sign in with your Discord account.
Select Servers from the navigation menu.

The Servers page displays all Discord servers you have permission to manage.

/assets/docs/halloweenbot/server-list.png

Your server will appear if:

You are signed in with the correct Discord account.
You have the Manage Server permission.
Discord has successfully synced your server list.

Verify HalloweenBot Is Installed

Locate your server on the Servers page.

If HalloweenBot is installed, you should see:

✅ Bot Installed
✅ Manage Button

Select Manage to open your server configuration.

If HalloweenBot has not yet been added, select Invite HalloweenBot and complete the Discord authorization process.

You can also confirm installation by checking your Discord server member list.

Open Server Settings

After selecting Manage, you'll be taken to the server management page.

![Server Managementeenbot/bot-installed.png

This is where you'll configure all available HalloweenBot features.

Review Permissions

HalloweenBot requires the appropriate Discord permissions to function correctly.

Common permissions include:

View Channels
Send Messages
Embed Links
Attach Files
Read Message History
Manage Roles

Some features may require additional permissions.

HalloweenBot's role must be positioned above any Discord roles it needs to manage.

If a feature is not functioning correctly, verify both channel permissions and role hierarchy.

Configure Server Features

Depending on your plan and available features, you may be able to configure:

Welcome Messages
Farewell Messages
Halloween Events
Countdown Messages
Custom Commands
Language Settings
Timezone Settings
Premium Features

Open the relevant section within the dashboard and save your configuration when finished.

Configure Language

HalloweenBot supports multiple languages for supported bot messages and responses.

To change your server language:

Open your server settings.
Navigate to Language Settings.
Select your preferred language.
Save your changes.

For a complete list of supported languages, see the Language Settings guide.

Configure Timezone

Several HalloweenBot features depend on your server timezone, including:

Scheduled Events
Countdown Messages
Automated Announcements
Seasonal Features

Ensure your timezone is set correctly so events occur at the expected local time.

Configure Channels

Many features require a channel to be selected before they can operate.

Common examples include:

Welcome Channel
Farewell Channel
Announcement Channel
Event Channel
Countdown Channel

Ensure HalloweenBot has permission to:

View the channel
Send messages
Embed links
Read message history

Without these permissions, features may not function correctly.

Configure Role Management

If HalloweenBot needs to assign or remove roles, its role must be positioned above the target roles in Discord's role hierarchy.

To check role positioning:

Server Settings → Roles

Move the HalloweenBot role above any roles it needs to manage.

Discord prevents bots from modifying roles that are higher than their own role.

Save Your Changes

Always save your configuration before leaving a settings page.

Changes are usually applied immediately, although some settings may take a few moments to update.

If you do not see the update:

Refresh the dashboard.
Confirm the setting was saved successfully.
Try the feature again.

Test Your Configuration

After configuring a feature, verify that it works as expected.

Checklist:

✅ Bot can access configured channels
✅ Messages send successfully
✅ Embeds display correctly
✅ Roles can be assigned or removed
✅ Timezone-based features trigger correctly
✅ Messages use the selected language

If something isn't working, review the bot's permissions and your dashboard configuration.

Server Not Appearing

If your server is missing from the dashboard:

Confirm you're using the correct Discord account.
Verify you have the Manage Server permission.
Refresh the Servers page.
Sign out and sign back in.

The dashboard only displays servers that your Discord account is allowed to manage.

Next Steps

Your server is now ready to use HalloweenBot.

Continue to the Permissions Guide to ensure HalloweenBot has all required permissions for the features you plan to use.