Alliances — Discord Partnerships Bot

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.

➕ Invite the bot • 💬 Support Server • ⭐ GitHub

---

✨ 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

1. Invite the bot and run /setup to choose:

   • Admin channel (invites/updates)
   • Publish channel (partner templates)
   • Manager role (who can use commands)

2. Create a template with /template create (modal).

3. Propose an alliance with /alliance propose <guildId>.

4. Target approves with the secure code modal.

5. 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.

---