
---

# 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

1. Visit the HalloweenBot Dashboard.

2. Sign in with your Discord account.

3. 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:

1. Open your server settings.

2. Navigate to **Language Settings**.

3. Select your preferred language.

4. 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:

1. Refresh the dashboard.

2. Confirm the setting was saved successfully.

3. 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.