#Allies

Il roster dei membri di gilde partner che hanno fatto domanda come alleati alla tua gilda tramite la pipeline Alleanza. Vive sotto GUILD → Alleati, subito dopo #Membri.

Il canale appare automaticamente nella barra laterale quando almeno una di queste condizioni è vera:

• Un owner ha abilitato la funzionalità Alleanza su Impostazioni → Candidature → Alleato (esiste almeno una riga nella configurazione Alleato della gilda), OPPURE
• La gilda ha almeno un alleato attivo nel roster.

Se la tua gilda non gestisce un'alleanza, il canale è nascosto — nessun permesso da concedere, nessun toggle da attivare, semplicemente nessuna superficie.

Permessi

La visibilità è controllata dal predicato di auto-visualizzazione sopra + dalla normale visibilità di #Membri (qualsiasi membro della gilda può vederlo una volta che è mostrato).

Le azioni staff all'interno del dettaglio per-alleato (ricollega un alleato a un personaggio diverso, rimuovi un alleato) richiedono Gestisci gilda. I membri senza quel permesso vedono lo stesso roster ma nessun pulsante azione.

Cosa mostra la pagina

Quando il roster è vuoto, la pagina invita l'owner a generare un codice alleato o a configurare la pipeline Discord. Entrambi i percorsi portano a Impostazioni → Candidature (scheda esterna Alleato) o Impostazioni → Integrazione Discord (Integrations → sotto-pagina Alleato) rispettivamente.

Quando il roster ha alleati, lo stato vuoto è sostituito da una lista di righe alleato, ognuna che mostra:

• Personaggio Albion + username — il personaggio in-game del membro della gilda partner + il loro username AO Master. Gli alleati collegati a Discord portano anche un piccolo chip Discord.
• Gilda di origine — da quale gilda partner provengono (nome gilda Albion + link).
• Badge status — Linked (sono ancora nella loro gilda partner di origine) o Left alliance (hanno disertato — la loro gilda di origine ha lasciato la tua alleanza o si sono spostati a una gilda non partner).
• Entrato — quando la loro candidatura alleato è stata approvata.

L'intera riga è cliccabile — apre la modale Dettagli alleato dove lo staff può agire su questo alleato (vedi sotto).

Toolbar — filtro + ricerca + aggiornamento

3 controlli nella parte superiore della pagina:

• Filtro Status (multi-selezione) — scegli qualsiasi combinazione di Linked / Left alliance. Ogni opzione nel dropdown porta un punto colorato e un contatore per-status (es. Linked (15) / Left alliance (2)). Il contatore visibile accanto al chip si aggiorna mentre attivi/disattivi.
• Filtro Gilda di origine (multi-selezione con ricerca integrata) — scegli quali gilde partner includere. Utile quando hai stretto alleanze con più partner e vuoi concentrarti su una. Il dropdown elenca ogni gilda di origine distinta nel roster + un contatore per gilda.
• Campo di ricerca (lato destro) — corrispondenza stringa su nome personaggio, username e nome gilda di origine. Si combina con i due filtri sopra.
• Aggiornamento (pulsante icona, estrema destra) — recupera nuovamente il roster dal server. La pagina si sincronizza anche in tempo reale quando gli alleati fanno domanda, vengono approvati o cambiano status — l'aggiornamento manuale è raramente necessario.

Modale Dettagli alleato (azioni staff)

Cliccando qualsiasi riga alleato si apre la modale Dettagli alleato. La modale mostra il profilo alleato completo più 2 azioni staff (requisito Gestisci gilda):

• 🖉 Ricollega a un personaggio diverso — apre un selettore personaggio limitato ai tuoi partner dell'alleanza. Scegli un personaggio; la gilda di origine viene risolta in tempo reale dall'API di Albion; l'account utente rimane lo stesso. Utile quando un alleato è passato a un alt diverso in una gilda partner e vuoi che la sua riga nel roster lo segua.
• Rimuovi alleato — conferma scrivendo. La riga alleato viene eliminata in modo soft (il loro status passa a Left alliance), il ruolo alleato Discord collegato viene messo in coda per la revoca, e tutte le iscrizioni CTA Timer per questo personaggio nella tua gilda vengono cancellate. L'account utente non viene influenzato; possono fare nuovamente domanda tramite un codice alleato o il pulsante Discord [Apply as Ally].

Come gli alleati appaiono qui

Un alleato arriva in questo roster dopo che uno di questi 2 flussi si completa:

• Web — visitano https://ao-master.com/ally/<code>, accedono (o si registrano), scelgono il loro personaggio e inviano. La candidatura appare su #Richieste di accesso (lato Alleato). Lo staff con Approva candidature membri li approva; la riga appare su #Alleati e il chip Ally Role è ora allegato al loro personaggio ovunque appaia.
• Discord — cliccano il pulsante fissato [Apply as Ally] sul tuo canale #🤝-ally-here; il bot apre un ticket 🤝-ally-…; i revisori eseguono /ally review (e /ally done dopo l'approvazione). Stessa destinazione: la riga appare su #Alleati con il chip Ally Role attivo.

Per la prospettiva completa lato membro, vedi Membri — Alleanza. Per il lato Discord, vedi Discord — Flusso alleato.

Quando lo status passa a "Left alliance"

Un cron di defezione viene eseguito una volta al giorno. Per ogni alleato attivo, controlla:

1. Il loro personaggio collegato è ancora nella loro gilda partner di origine?
2. La gilda partner di origine è ancora nella tua alleanza (o l'ha lasciata)?

Se la risposta a una delle due è no, la riga alleato passa a Left alliance. Cosa succede dopo dipende dalla tua modalità Sincronizzazione Ruolo Alleato (impostata su Integrazione Discord → Integrations → Alleato):

• 🟢 Off — nessun auto-purge — il ruolo alleato Discord rimane. La riga continua ad apparire su #Alleati con il badge Left alliance finché non decidi di rimuoverli.
• 🟡 Revisione manuale — la riga si aggiunge a una lista di revisione Stale Ally Roles (visibile nella pagina Integrazione Discord). Scegli un sottoinsieme da rimuovere.
• 🔴 Strict — purge immediato — il bot rimuove il ruolo alleato Discord + invia DM all'ex alleato entro un minuto.

In ogni modalità, il roster #Alleati mostra il badge Left alliance non appena il controllo scatta. Il filtro status nella parte superiore ti permette di nascondere o concentrarti su quelle righe.

Cross-link

• Membri — Alleanza — la vista dal lato alleato di essere un alleato.
• Impostazioni → Candidature — configura le domande di candidatura alleato + chip Ally Role + genera codici alleato.
• Impostazioni → Integrazione Discord — Integrations → sotto-pagina Alleato (mapping canale, modalità Ally Role Sync, ruoli Discord partner).
• Discord — Flusso alleato — pipeline lato Discord (pannello bot Manage Ally, comandi slash, trascrizioni archiviate).
• #Richieste di accesso — dove lo staff approva / rifiuta le candidature alleato.