Docs← Homepage
Dark War Survival

Alliances

The Alliances module manages alliances in the Dark War Survival game: creation, deletion, membership with rank hierarchy (R1–R5), tags, Discord role integration, and optionally integration with the Reaction Roles module.

Enabling the Module

Dashboard → Your server → toggle Alliances

Click Edit to configure module options

Save changes

Configuration

OptionTypeDefaultDescription
max_alliancesnumber10Maximum number of alliances per server
max_membersnumber50Maximum number of members per alliance
auto_reaction_rolebooleanfalseAutomatic sync with Reaction Roles
auto_nick_tagbooleanfalseAutomatically add [TAG] prefix to nickname when joining an alliance
reaction_role_indexnumber / nullnullReaction roles panel index to sync with
management_roleslist[]Roles that can manage alliances (besides admins)
r5_roleslist[]Additional roles for R5 leaders
r4_roleslist[]Additional roles for R4 officers

Rank System

RankNamePermissions
R5LeaderEverything: create (when R5 in any alliance), invite, kick (all), promote, demote, transfer
R4OfficerInvite, kick (only R1–R3)
R3—No management permissions
R2—No management permissions
R1—No management permissions (default rank for new members)

Tag System

Each alliance has a short tag (1–5 alphanumeric characters):

  • User provides: KNS
  • System stores: [KNS]
  • Discord role: [KNS] Alliance Name

Tags must be unique within the server.

Dashboard — Configuration

The Alliances edit panel in the dashboard contains:

  • List view — cards of all alliances with information
  • Detail view — after clicking an alliance: member list, ranks, actions
  • Configuration — max alliances, max members, management roles, auto-reaction-role

Commands

/alliance create

Creates a new alliance.

ParameterRequiredDescription
name✅Alliance name (2–32 characters: letters, numbers, spaces, hyphens)
tag✅Short tag (1–5 alphanumeric characters)
color❌Role hex color (default #5865F2)

Requirements: Administrator, management_roles, or R5 in any alliance.

Flow:

Validates name and tag

Checks alliance limit

Checks for name and tag duplicates

Inserts record into DB (with placeholder role_id)

Creates Discord role [TAG] Name with the specified color

Updates record with role_id

Adds creator as R5

Assigns role to creator

Optional sync with Reaction Roles

Log + response

Rollback

If Discord role creation fails, the database record is automatically deleted (DB-first approach with rollback).

/alliance import

Imports an existing Discord role as an alliance without creating a new role.

ParameterRequiredDescription
role✅Existing Discord role to import
name✅Alliance name (2–32 characters)
tag✅Short tag (1–5 alphanumeric characters)

Requirements: Administrator or management_roles.

Flow:

Validates name and tag

Checks alliance limit and duplicates

Checks the role is not already linked to another alliance

Creates DB record using the existing role (no new role created)

Scans all server members who have this role

Assigns ranks based on R5/R4 role configuration:

  • Members with an R5 role → rank 5
  • Members with an R4 role → rank 4
  • Everyone else → rank 1

Optional sync with Reaction Roles

Log + response

Migration

Use this command to migrate existing alliances into ArcBot without deleting and recreating roles. All current role assignments are preserved.

Also available in the dashboard via the Import button next to Create in the Alliances panel.

/alliance delete

Deletes an alliance (Administrator only).

ParameterRequiredDescription
name✅Alliance name to delete

Deletes: DB record + alliance_members (CASCADE) + Discord role + cleanup reaction roles.

/alliance invite

Invites a user to your alliance (R4/R5).

ParameterRequiredDescription
member✅User to invite

Adds with rank R1. User cannot be in another alliance.

/alliance kick

Kicks a user from your alliance (R4/R5).

ParameterRequiredDescription
member✅User to kick

R4 can only kick R1–R3. R5 can kick everyone except themselves.

/alliance leave

Leaves your current alliance.

R5 cannot leave without a prior /alliance transfer.

/alliance promote

Promotes a member by 1 rank (R5 only, max to R4).

ParameterRequiredDescription
member✅User to promote

/alliance demote

Demotes a member by 1 rank (R5 only, min R1).

ParameterRequiredDescription
member✅User to demote

/alliance transfer

Transfers leadership to another alliance member (R5 only).

ParameterRequiredDescription
member✅New leader

New leader → R5, old leader → R4. Executed in a single DB transaction.

/alliance info

Displays alliance information with member list grouped by ranks.

ParameterRequiredDescription
name❌Alliance name (default: user's own alliance)

/alliance list

Lists all active alliances on the server with member count and leader.

Listened Events

EventAction
on_member_removeRemoval from alliance + R5 auto-succession
on_member_updateIntegration with Reaction Roles (adding/removing alliance role)

Auto-succession (on_member_remove)

When the leader (R5) leaves the server:

  1. Removed from alliance_members
  2. If other members remain → highest-ranked (R4 > R3 > R2 > R1, seniority by joined_at) is promoted to R5
  3. If no members remain → alliance marked as is_active = FALSE

Reaction Roles Integration (on_member_update)

When auto_reaction_role = true and a user gains/loses an alliance role through Reaction Roles:

Role added:

  • If in another alliance → role removed, log "rejected"
  • If in the same alliance → idempotent, ignored
  • If not in any alliance → added as R1

Role removed:

  • Removed from alliance_members

Logging

Actions logged by Logs under the alliances category:

  • ⚔️ Alliance Created
  • 🗑️ Alliance Deleted
  • ➕ Member Added / Invited
  • ➖ Member Removed / Kicked
  • ⬆️ Member Promoted
  • ⬇️ Member Demoted
  • 👑 Leadership Transferred
  • 🚪 Member Left / Departed Guild
  • 💤 Alliance Deactivated
  • 🚫 Reaction Role Rejected (multi-alliance conflict)

Database

TableDescription
alliancesid, guild_id, name, tag, role_id, color, is_active, created_at
alliance_membersid, alliance_id, user_id, rank, joined_at

Tips

Best practices

  • Set max_members appropriately for your server size
  • Enable auto_reaction_role so users can join alliances themselves
  • Tags should be short and recognizable (e.g., KNS, DWS, ARC)
  • Regularly check if R5 leaders are active — inactive ones can block alliances

Warning

Deleting an alliance is irreversible — the Discord role and all member records are permanently deleted.

Dark War Survival

Overview of ArcBot modules dedicated to Dark War Survival game — alliances, presidents, armory, and APC rankings.

Presidents

Server president system for Dark War Survival — appointing, removing, issuing decrees, and term history tracking.

On this page

AlliancesEnabling the ModuleConfigurationRank SystemTag SystemDashboard — ConfigurationCommands/alliance create/alliance import/alliance delete/alliance invite/alliance kick/alliance leave/alliance promote/alliance demote/alliance transfer/alliance info/alliance listListened EventsAuto-succession (on_member_remove)Reaction Roles Integration (on_member_update)LoggingDatabaseTips