ALLIANCES

<p align="center"> <img src="https://i.imgur.com/5VcFYfp.png" alt="Alliances Logo" width="88"><br> </p> # 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**. <p align="center"> <a href="https://discord.com/api/oauth2/authorize?client_id=1410651859936608326&permissions=8&scope=bot%20applications.commands"><b>➕ Invite the bot</b></a> • <a href="https://discord.gg/xV4788y5pD"><b>💬 Support Server</b></a> • <a href="https://github.com/josuens/alliances"><b>⭐ GitHub</b></a> </p> --- ## ✨ 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`. ---