Managing Guild Configuration

After completing the initial setup with /setup start, you can manage your bot configuration in two ways: through Discord commands or through the Guild Settings page in the dashboard. This guide covers both methods — use whichever is most convenient for your needs.

Prerequisites: You must have already completed the First Steps setup process before using these management options.

Check Configuration — /setup check
Update Settings via Dashboard
Update Settings via Discord Command
Reset Configuration
Troubleshooting

Check Current Configuration — `/setup check`

The /setup check command lets you view the full current bot configuration at any time without making any changes.

/setup check

The bot replies with a detailed embed showing:

Guild Information: Albion guild/player name, server region, target type
Core Roles: Member role, Management role, Booster role, Log channel
Class Role Mappings: Arcane Support, Battlemount, Clump Tank, Curse Support, D-Tank, DPS, Healer, Oathkeeper/Groot
Region Role Mappings: NA, EU, ASIA

Run /setup check after any configuration change to confirm the new values were saved correctly.

Update Settings via Dashboard

The easiest way to update your bot configuration after the initial setup is through the dashboard. In the sidebar, navigate to Guild Settings (the last item in the left sidebar menu). This page lets you update almost everything without having to re-type the full /setup start command in Discord.

The Guild Settings page is available at Dashboard → [Your Guild] → Guild Settings. You must be logged into the dashboard and have management access to your guild.

General Settings

The top section of the settings page lets you change the core bot configuration:

Field	Description
Guild Name (in Bot DB)	The name stored in the bot's internal database. This is separate from the Discord server name. Update this if your Albion guild was renamed.
Default Member Role	The Discord role assigned to all newly registered members. Select from a dropdown that loads the server's available roles.
Booster Role	The Discord role used to identify server boosters. Members with this role are excluded from certain cleanup actions.
Management Role	The Discord role that grants access to admin bot commands (e.g., `/stats`, `/members`, `/force-register`).
Log Channel	The text channel where the bot sends activity logs (member joins, role changes, flush reports, etc.). Select from a dropdown of available text channels.
Server URL	Optional URL for the Albion server / invite link. Used internally for some API calls.

Class & Combat Role Mappings

Each class role dropdown maps an in-game class to a Discord role. When a member registers with a class, that Discord role is automatically assigned to them.

Class	Discord Role Mapping
Arcane Support	Dropdown — select the matching Discord role
Battlemount	Dropdown — select the matching Discord role
Clump Tank	Dropdown — select the matching Discord role
Curse Support	Dropdown — select the matching Discord role
D-Tank	Dropdown — select the matching Discord role
DPS	Dropdown — select the matching Discord role
Healer	Dropdown — select the matching Discord role
Oathkeeper / Groot	Dropdown — select the matching Discord role

Region Role Mappings

Each region dropdown maps a geographic region to a Discord role. The role is assigned when a member registers and selects their region.

Region	Discord Role Mapping
NA	Dropdown — select the matching Discord role
EU	Dropdown — select the matching Discord role
ASIA	Dropdown — select the matching Discord role

Saving Changes

After making your changes, click the green Save Changes button at the bottom of the form. A success alert appears at the top of the page to confirm the settings were saved. Changes take effect immediately — new member registrations will use the updated roles.

Role dropdowns load live from Discord. If a role appears as "Loading roles..." and never populates, check that the bot is online and connected to your server. Roles are only shown if the bot can see them — if a role was deleted in Discord it will not appear in the list.

Danger Zone — Reset via Dashboard

At the bottom of the Guild Settings page there is a red Danger Zone section with an "Uninstall Bot & Reset Configuration" button. Clicking this button permanently deletes the entire guild configuration from the database.

This action cannot be undone. All role mappings, channel settings, and configuration data are deleted. Existing member records are preserved, but role assignment will stop working until you run /setup start again to reconfigure the bot.

Update Settings via Discord Command

You can also update settings by re-running /setup start in Discord with new values. The bot will update the existing configuration rather than create a duplicate.

Important: When using /setup start to update, you must provide all parameters again — it is not possible to update only one field through the command. For updating a single field, use the Dashboard → Guild Settings page instead.

Example — Changing Role Mappings

/setup start
server: Europe
target-name: MyGuildName
type: Guild
member-role: @NewMemberRole
management-role: @GuildOfficers
booster-role: @ServerBoosters
log-channel: #bot-logs
arcane-support-role: @ArcaneSupport
battlemount-role: @Battlemount
clump-tank-role: @ClumpTank
curse-support-role: @CurseSupport
d-tank-role: @DTank
dps-role: @DPS
healer-role: @Healer
oathkeeper-groot-role: @Oathkeeper
na-region-role: @NAPlayers
eu-region-role: @EUPlayers
asia-region-role: @ASIAPlayers

Reset Configuration — `/setup reset`

The /setup reset Discord command does the same thing as the Danger Zone button in the dashboard — it completely removes the guild configuration.

/setup reset

What reset removes

Guild name, server URL, target type stored in the database
All role mappings (member, management, booster, class, region)
Log channel assignment
Dashboard access (settings page shows "Setup Required")

What reset preserves

All registered member records — player data is not deleted
Banking, siphon, attendance, and other system data

After resetting, re-run /setup start with the full configuration to restore bot functionality. Use /setup check after to verify the new settings.

Troubleshooting

Problem	Cause	Solution
Role dropdowns show "Loading roles..." and never populate	The bot is offline or lost connection to the Discord server	Check that the bot is online. Refresh the dashboard page and try again
A role I created in Discord does not appear in the dropdown	The bot may not have permission to see that role, or the page needs a refresh	Refresh the page. Ensure the bot role is positioned above the missing role in the Discord role hierarchy
"Save Changes" shows an error alert	A selected role or channel ID is no longer valid (deleted from Discord)	Re-select all dropdowns to ensure they have valid values and save again
`/setup check` shows wrong information after saving via dashboard	The command reads directly from the database — should be immediate	Run `/setup check` again. If still wrong, try saving via dashboard one more time
Members are not getting the updated role after changing the class role mapping	Configuration changes only affect new registrations, not existing members	Use `/remove` then `/register` (or `/force-register`) to re-register the affected member with the new roles
`/setup start` fails with "missing parameter" error	One or more required parameters were not provided	All 19 parameters are required when using the command. Use Dashboard → Guild Settings for partial updates instead