Blacklist System

The Blacklist System lets guild management flag players who are not welcome in the guild. Blacklisted players are stored with a reason and the name of who added them. The dashboard automatically cross-checks all currently registered members against the blacklist and alerts leadership if a blacklisted player has managed to register.

🔍 How It Works

The blacklist is a per-server list of Albion Online player names and IDs that leadership wants to track. Each entry stores:

The player's in-game name and Albion API ID
The reason they were blacklisted
Who blacklisted them and when

Any time you open the Blacklist page in the dashboard, the bot automatically compares the blacklist against all currently registered members and flags any matches at the top of the page.

The blacklist does not kick anyone automatically. It is a reference tool that alerts you when a blacklisted player is found registered in your server. You still need to take action manually (remove them, ban them, etc.).

➕ Adding to the Blacklist — `/blacklist add`

Adds one or more players to the blacklist. Requires the Management Role.

/blacklist add player-name:PlayerName reason:Reason

Parameter	Required	Description
`player-name`	Yes	One or more player names to blacklist. You can provide multiple names separated by commas or spaces to blacklist several players at once. Examples: `PlayerOne` or `PlayerOne, PlayerTwo, PlayerThree`
`reason`	Yes	The reason for blacklisting. This same reason is applied to all players in a batch add.

What the bot does for each name

Searches the Albion Online API to find the player and get their official ID.
Checks if they are already on this server's blacklist.
If not found yet, creates the entry with the player's name, ID, reason, and who added them.

Result embed

After processing, the bot replies with a summary embed showing three groups:

Group	Meaning
✅ Successfully Added	Players that were found in the API and added to the blacklist for the first time.
⚠️ Already Blacklisted	Players that were already on the blacklist. No duplicate entry is created.
❌ Failed to Add	Players whose name was not found in the Albion API, or who caused a database error. The short error reason is shown next to the name.

Batch blacklisting tip: You can blacklist an entire group at once — for example: /blacklist add player-name:Player1, Player2, Player3 reason:Toxic behavior in ZvZ. The bot processes each name individually and reports which ones succeeded, were already listed, or failed.

After a successful add, the bot also posts a log embed to the server's configured log channel showing which players were added and by whom.

🗑️ Removing from the Blacklist — `/blacklist remove`

Removes one or more players from the blacklist. Requires the Management Role.

/blacklist remove player-name:PlayerName

Parameter	Description
`player-name`	One or more player names to remove, separated by commas or spaces. The name must match exactly as it appears on the blacklist.

The bot replies with a summary embed grouped into:

✅ Successfully Removed — players that were found on the blacklist and deleted.
❌ Not Found — names that were not on the blacklist for this server.

Successful removals are also logged in the server's log channel.

📋 Listing the Blacklist — `/blacklist list`

Displays the full blacklist for the server in Discord. No special role required.

/blacklist list

The bot replies with a paginated embed showing all blacklisted players. Each page lists player names with their reasons. Navigation buttons (◀️ ▶️) appear when there are multiple pages, and they expire after 5 minutes of inactivity.

For a more detailed view with sorting, filtering, and the ability to edit entries, use the Dashboard → Blacklist page instead.

🖥️ Managing in the Dashboard

The Blacklist page in the dashboard (Dashboard → Blacklist) provides a full management interface with more capabilities than the Discord commands.

Add to Blacklist button

A red Add to Blacklist button appears in the top-right corner of the page. Clicking it opens a modal with:

Player Name field — Start typing a player name. The bot searches the Albion Online API in real time and shows matching results below the field. Click a result to select it.
Reason field — Text area to explain why this player is being blacklisted. Required before the submit button becomes active.
Add to Blacklist button — Only enabled after both a player is selected and a reason is provided. Adds the entry and refreshes the page.

The dashboard Add modal adds one player at a time. To add multiple players in a single operation, use the /blacklist add Discord command with comma-separated names.

🛡️ Member Verification Panel

At the top of the Blacklist dashboard page, just below the heading, there is a Member Verification panel. Every time you load the page, the bot compares all players currently registered in your server against the blacklist.

Result	Meaning
✅ All Clear	None of your currently registered members match any blacklisted player. Your server is clean.
⚠️ Warning	One or more registered members match blacklisted players. Each warning shows the registered member name alongside the blacklisted player name. You should review and take action immediately.

A warning here means a blacklisted player is currently registered in your server. The bot will not remove them automatically. You must manually remove them using /remove or through the Register Status dashboard page.

📊 Blacklisted Players Table

Below the verification panel, the full blacklist is shown in a sortable, filterable table.

Column	Description
Player Name	The in-game Albion Online name of the blacklisted player.
Player ID	The internal Albion API ID. Used to uniquely identify players even if they rename their character.
Reason	The reason given when this player was added to the blacklist.
Blacklisted By	The Discord username of the management member who added this entry.
Date Added	When the entry was created.
Actions	Two buttons appear for each entry: ✏️ Edit — Opens the Edit modal. The player name and ID are locked (read-only) — only the reason can be updated. Click Save Changes to confirm. 🗑️ Delete — Immediately removes the entry from the blacklist. There is no confirmation prompt, so use with care.

Search and Filters

A Global Search box above the table filters across all columns at once — useful for quickly finding a specific player by name, reason, or who added them. Each column header also has an individual dropdown filter to narrow down by a specific value in that column. Columns marked with a sort icon (⇅) can be clicked to sort ascending or descending.

🔧 Troubleshooting

Problem	Cause	Solution
"Player not found" when adding	The name doesn't match any character in the Albion API	Check the exact in-game spelling. Try searching via the dashboard modal to get autocomplete suggestions from the API.
Player shows as "Already Blacklisted"	There is already an entry for this player on this server	No action needed — the player is already tracked. If you want to update the reason, use the ✏️ Edit button in the dashboard.
Member Verification shows a warning but the member was already removed	The member record may still exist in the database	Remove the member using `/remove` or delete their record from the Register Status page. Then reload the Blacklist page to confirm the warning clears.
Cannot add or remove — "You don't have permission"	The user running the command does not have the Management Role	Ask a server manager to perform the action, or have an admin assign the management role to the appropriate users.