CGA - Azeroth Guild Calendar

# CGA — Azeroth Guild Calendar

**Plan your guild activities in WoW and let members sign up from Discord.**

Developed by **Geekphenix**. French name: **Calendrier des Guildes d’Azeroth**.

CGA provides an event editor for the World of Warcraft Retail calendar, with planned characters, classes, specializations and roles. Its companion Discord bot creates signup cards so guild members can respond while they are away from the game.

## In-game calendar

- Organize raids, dungeons, Mythic+ activities and other guild events.
- Choose the date, server time, activity, recommended item level and target role composition.
- Use the Mythic+ dungeon rotation supplied by your WoW client.
- Declare the character planned for the activity, its specialization and its role.
- View participants with class and specialization icons, roles and attendance.
- Switch CGA between **French and English**, with your preference saved between sessions. Character names, your own text and activity names provided by WoW retain their original content or client language.
- Access the normal Blizzard interface from the event window.

## With the companion Discord bot

**Starting in WoW:** create an event and post its guild announcement. Once the existing WoW–Discord guild connection relays that announcement, CGA finds it and creates a signup card in the configured Discord channel.

**Starting in Discord:** a responsible member uses `/cga_creer` to create a CGA card and receive a private event code. In WoW, open the calendar and click **CGA · Discord**, paste that code, review it and prepare the event. Choose the specific raid or dungeon if needed, then click **Create event**. Its guild announcement links back to the existing card and keeps the signups already received.

Members playing WoW respond in the in-game calendar. Members away from the game can use the card's **Present**, **Tentative** and **Absent** controls. A responsible member then exports those Discord responses and imports the code into the matching WoW event.

Transfers require a pasted code, review and a confirmation click. CGA does not read Discord directly from the addon. The two calendars keep their own attendance until you perform that transfer. A more recent in-game attendance choice is kept when importing an older Discord response.

The bot checks repeated announcements to update the same card. Confirmed deletion notices relayed from WoW allow it to remove the related card and signups. Private exports are restricted to authorized responsible members; character and realm matching is checked in the guild before attendance is imported.

## Add CGA to your guild

1. Install CalendarGuildsAzeroth in WoW. Open the calendar normally or with `/cga`.
2. A Discord server manager clicks [Add the CGA bot] (https://discord.com/oauth2/authorize?client_id=1559156332442157207&scope=bot%20applications.commands&permissions=536955904&integration_type=0)
3. Use `/cga_configurer` in Discord to select the text channel already connected to your WoW guild chat.
4. Start with a WoW guild announcement or create a CGA event directly in Discord.

The in-game calendar editor can be used without the bot. Discord integration uses a shared hosted bot: guild members do not install a desktop companion program or set up their own bot hosting. Members who only respond on Discord do not need the WoW addon.

The WoW–Discord guild connection must already be configured for guild announcements to reach Discord. See the **[official connection guide](https://discord.com/blog/link-world-of-warcraft-with-discord)**. The bot reads announcements and publishes its cards in the same configured channel in this version. Importing event cards created by other Discord bots is not included.

The current bot's commands and cards are presented in French. The addon interface supports both French and English. Automatic card detection runs periodically rather than instantly; `/cga_actualiser` requests a scan for your server, and `/cga_etat` reports its configuration.

## Version and feedback

**v0.2.0 — Build 0015**, intended for **WoW Retail**. Classic clients have not been validated.

This is an early version. Please include your CGA build, WoW version, steps to reproduce and any relevant error when reporting a problem in the project's comments or issue tracker when available. Keep private export codes out of public reports.

The bot receives messages in its configured channel to recognize CGA announcements. It stores the server/channel configuration, event details and submitted signup profiles, including Discord identifiers, character/realm, class, specialization, role and attendance. These profiles appear on the guild's signup cards; private exports contain the data needed for the manual transfer.

CGA is free to use and is licensed **All Rights Reserved**. It is an independent project, without an affiliation with Blizzard Entertainment or Discord.

---

# Présentation française

## CGA — Calendrier des Guildes d’Azeroth

**Organisez vos sorties dans WoW et permettez aux membres de répondre depuis Discord.**

Développé par Geekphenix.

CGA enrichit le calendrier de World of Warcraft Retail avec les personnages prévus pour une sortie, leurs classes, spécialisations et rôles. Son bot Discord propose des fiches d’inscription aux membres qui ne sont pas connectés au jeu.

### Dans le calendrier WoW

- Préparez vos raids, donjons, sorties Mythique+ et autres événements de guilde.
- Choisissez la date, l’heure du serveur, l’activité, le niveau d’objet conseillé et la composition souhaitée.
- Retrouvez la rotation de donjons Mythique+ fournie par votre client WoW.
- Indiquez le personnage prévu, sa spécialisation et son rôle.
- Consultez les participants avec leurs icônes de classe et de spécialisation, leurs rôles et leurs présences.
- Changez la langue de CGA avec **FR / EN**. Le choix est mémorisé. Les noms de personnages, vos textes et les noms fournis par WoW conservent leur contenu ou la langue du client.
- Retrouvez l’interface Blizzard depuis la fenêtre de l’événement.

### Avec le bot Discord

Vous commencez en jeu : créez l’événement et publiez son annonce de guilde. La liaison WoW–Discord existante transmet l’annonce dans le salon connecté. CGA la détecte et prépare la fiche d’inscription.

Vous commencez sur Discord : un responsable utilise `/cga_creer`, obtient une fiche et copie le code privé de l’événement. En jeu, ouvrez le calendrier puis CGA · Discord, collez le code, vérifiez-le et préparez le calendrier. Choisissez le raid ou donjon précis si nécessaire, puis cliquez sur **Créer l’événement**. L’annonce de guilde retrouve la fiche existante et conserve ses inscriptions.

Les joueurs connectés répondent dans le calendrier WoW. Les autres utilisent Présent,Incertain ou Absent sur Discord. Le responsable exporte ensuite ces réponses et importe le code dans l’événement correspondant en jeu.

Le transfert demande un code collé, une vérification et une validation. Les présences des deux systèmes restent indépendantes jusqu’au transfert manuel. Un choix de présence en jeu plus récent est conservé lors de l’import d’une réponse Discord plus ancienne.

Une réannonce met à jour la fiche existante. Une annonce de suppression confirmée en jeu permet au bot de retirer la fiche et ses inscriptions. Les exports privés sont réservés aux personnes autorisées. L’import vérifie le personnage et son serveur dans la guilde.

### Installation pour la guilde

1. Installez CalendarGuildsAzeroth et ouvrez le calendrier normalement ou avec `/cga`.
2. Un responsable Discord utilise le lien [Ajouter le bot CGA](https://discord.com/oauth2/authorize?client_id=1559156332442157207&scope=bot%20applications.commands&permissions=536955904&integration_type=0)
3. Lancez `/cga_configurer` et choisissez le salon textuel déjà relié au chat de votre guilde WoW.
4. Publiez une annonce depuis WoW ou créez un événement CGA directement sur Discord.

Le calendrier en jeu fonctionne aussi sans le bot. Pour Discord, le service est hébergé : les membres n’installent aucun programme de liaison sur leur ordinateur et ne créent pas leur propre hébergement. Les personnes qui répondent uniquement sur Discord n’ont pas besoin de l’addon.

La liaison WoW–Discord doit déjà être active : **[guide officiel de connexion](https://discord.com/blog/link-world-of-warcraft-with-discord)**. Dans cette version, les annonces sont lues et les fiches publiées dans le même salon configuré. L’import d’événements créés par un autre bot Discord n’est pas inclus.

Le bot propose actuellement ses commandes et fiches en français. L’interface de l’addon est disponible en français et en anglais. La détection des annonces est périodique ; `/cga_actualiser` lance une recherche pour votre serveur et `/cga_etat` indique la configuration.

### Version et retours

v0.2.0 — Build 0015**, destiné à **WoW Retail**. Les clients Classic n’ont pas été validés.

Cette première version continue d’évoluer. Pour un signalement, indiquez le build CGA, la version WoW, les étapes et l’erreur éventuelle dans les commentaires ou le suivi des problèmes du projet, lorsqu’il est disponible. Ne publiez pas vos codes privés d’export.

Le bot reçoit les messages du salon configuré pour reconnaître les annonces CGA. Il conserve la configuration serveur/salon, les événements et les inscriptions déclarées : identifiants Discord, personnage/serveur, classe, spécialisation, rôle et présence. Les profils apparaissent sur les fiches de la guilde ; les exports privés contiennent les données nécessaires au transfert manuel.

CGA est gratuit, sous licence **Tous droits réservés**. Ce projet est indépendant de Blizzard Entertainment et de Discord.