Alliances helps communities run server partnerships the right way:
- Propose alliances, verify with a secure one-time code, accept or reject with buttons.
- Publish sleek, Markdown-ready embeds using templates (public/private).
- Control who can manage alliances with role checks and slash commands.
✨ Highlights
- 🔗 End-to-end Alliance Flow — propose → verify (one-time code) → accept or reject.
- 📝 Embeds & Templates — public/private templates with Markdown and dynamic variables:
{GUILD_NAME} {GUILD_ID} {GUILD_ICON} {MEMBER_COUNT} {PARTNER_ID} {CREATOR} {CODE}
- 🧭 Multi-Guild & Multi-User — role-based control + permission validation.
- 🛡️ Safety Controls — server blocklist, intake toggle, global availability.
- 🌍 Bilingual — English & Spanish; switch anytime with
/lang
. - 💎 VIP Tier — higher limits (alliances/templates) and shorter send cooldown.
- 📣 Modern Embeds — unified footer
ALLIANCE.TOP
, timestamps, emojis. - 📜 Internal Logs — alliances created/accepted/rejected, templates sent, etc.
- 🚧 Rate Limiting — avoid spam of commands.
- 🧪 Basic Tests — for critical commands.
- ☁️ Ready to host — MongoDB-backed, scalable.
🧰 Commands (slash)
English command names; descriptions localized.
General
/help
— Show help/lang code:<en|es>
— Switch bot language
Setup
/setup channel type:<admin|publish> channel:<#channel>
— Set admin & publish channels/setup role role:<@role>
— Choose who can manage alliances
Templates (per guild)
/template create
— Create via modal (name, title, description, optional image)/template list
— List templates/template edit name:<TemplateName>
— Edit template/template delete name:<TemplateName>
— Delete template
Alliances
/alliance propose target_guild_id:<ID>
— Propose an alliance/alliance list
— List alliances/alliance remove target_guild_id:<ID>
— Remove alliance (both directions)
Sending
/send template target_guild_id:<ID> template:<TemplateName>
— Publish a template to an allied server- Cooldown per alliance: every 5 days (VIP: 24h)
- Requires at least 1 template created
Availability
/toggle allow:<true|false>
— Allow/block new requests (also blocks acceptance)/public set enable:<true|false>
— Toggle global availability/public list
— Discover public servers
VIP
/vip enable:<true|false>
— Grant VIP to this server (owner only)
🛠 Quick Start
-
Invite the bot and run
/setup
to choose:- Admin channel (invites/updates)
- Publish channel (partner templates)
- Manager role (who can use commands)
-
Create a template with
/template create
(modal). -
Propose an alliance with
/alliance propose <guildId>
. -
Target approves with the secure code modal.
-
Publish your template to the partner via
/send template
.
The bot must be installed & configured on both servers to create or accept alliances.
🌐 Languages
- English (default)
- Español
🔒 Privacy & Safety
Alliances does not require message content. It uses Guilds and GuildMembers intents for role checks and server member counts.
Admins can block new requests with /toggle
and curate visibility with /public
.