Multiple Guilds System Documentation

The Multiple Guilds system lets you keep one primary guild and add secondary guilds under the same Discord server, so member management works across your full guild structure.

Table of Contents

• System Overview
• Requirements
• Dashboard Access
• Guild List
• Add Secondary Guild
• Remove Secondary Guild
• Discord Command: /multi-guild
• Troubleshooting

System Overview

This system was built for guild structures that operate with more than one Albion guild under a single Discord server.

• Primary guild: the guild configured during setup. It is protected and cannot be removed.
• Secondary guilds: additional guilds that can be added or removed when needed.
• Unified management: all guilds are grouped under the same Discord server context.

Requirements

• Bot setup completed with /setup start.
• A valid management role configured in setup.
• The guild must exist in Albion Online API for the selected server.

Dashboard Access

1. Open the web dashboard.
2. Select your Discord server.
3. Open Guilds in the dashboard sidebar.
4. Use the page to search and manage secondary guilds.

Guild List

The guild list shows all guilds configured for the selected Discord server.

• Primary badge: locked entry (cannot be removed).
• Secondary badge: removable entry.
• Each row includes guild name, Albion guild ID, and server.

Add Secondary Guild

1. Click Add Secondary Guild.
2. Type at least 2 characters of the guild name.
3. Select the correct guild from the search results.
4. Click Add Guild.

The system blocks duplicates and also blocks adding the same guild that is already the primary guild.

Remove Secondary Guild

1. Find the secondary guild in the list.
2. Click Remove.
3. Confirm removal.

Only secondary guilds can be removed. Primary guild removal is not allowed.

Discord Command: /multi-guild

Managers can use slash commands to manage guilds without opening the dashboard.

Add

/multi-guild add guild-name: YourGuildName

• Searches Albion API by guild name.
• Adds the guild as secondary when valid.
• Blocks primary guild and duplicate entries.

Remove

/multi-guild remove guild-id: AlbionGuildId

• Removes a secondary guild by Albion guild ID.
• Prevents removing the primary guild.

View

/multi-guild view

• Returns an embed with Primary Guild and Secondary Guilds.
• Shows name, guild ID, and server for each entry.
• Useful for quick verification directly in Discord.

Troubleshooting

• Server not configured: run /setup start first.
• No permission: your account needs the configured management role.
• Guild not found: verify guild name spelling and server.
• Duplicate guild: the guild is already configured as secondary.
• Primary removal blocked: expected behavior by design.