<img src="https://i.imgur.com/5VcFYfp.png" alt="Alliances Logo" width="88"> 


# 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**.


 <a href="https://discord.com/api/oauth2/authorize?client_id=1410651859936608326&permissions=8&scope=bot%20applications.commands">➕ Invite the bot</a> •
 <a href="https://discord.gg/xV4788y5pD">💬 Support Server</a> •
 <a href="https://github.com/josuens/alliances">⭐ GitHub</a>


---

## ✨ 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`.

---

Alliances

Manage Discord server partnerships with templates, verification codes, modern embeds and smart controls — all via slash commands.

التصويت لـAlliances

هل ترغب في دعمنا؟