#Allies

Danh sách thành viên guild đối tác đã nộp đơn ally vào guild của bạn qua pipeline Alliance. Nằm dưới GUILD → Allies, ngay sau #Thành viên.

Channel tự hiển thị trong sidebar khi một trong các điều kiện sau là đúng:

• Một owner đã bật tính năng Alliance tại Settings → Recruitment → Ally (đã có một dòng trong Ally config của guild), HOẶC
• Guild có ít nhất một ally đang hoạt động trong danh sách.

Nếu guild của bạn không chạy alliance, channel bị ẩn — không có quyền nào cần cấp, không có toggle nào cần bật, không có giao diện nào xuất hiện.

Quyền hạn

Khả năng hiển thị được kiểm soát bởi điều kiện tự hiện ở trên + khả năng hiển thị #Thành viên thông thường của bạn (bất kỳ thành viên nào của guild đều có thể xem khi đã hiển thị).

Hành động của staff bên trong chi tiết từng ally (relink ally sang nhân vật khác, xóa ally) yêu cầu Manage Guild. Thành viên không có quyền đó thấy cùng danh sách nhưng không có nút hành động.

Nội dung trang hiển thị

Khi danh sách trống, trang mời owner tạo ally code hoặc cài đặt pipeline Discord. Cả hai con đường đều dẫn đến Settings → Recruitment (tab ngoài Ally) hoặc Discord Integration (Integrations → trang con Ally) tương ứng.

Khi danh sách có ally, empty state được thay thế bằng danh sách các dòng ally, mỗi dòng hiển thị:

• Nhân vật Albion + username — nhân vật trong game của thành viên guild đối tác + username AO Master của họ. Ally đã liên kết Discord cũng mang chip Discord nhỏ.
• Home guild — họ đến từ guild đối tác nào (tên Albion guild + link).
• Badge trạng thái — Linked (họ vẫn trong home partner guild của mình) hoặc Left alliance (họ đã đào tẩu — home guild của họ rời alliance hoặc họ chuyển sang guild không phải partner).
• Tham gia — khi đơn ally của họ được duyệt.

Toàn bộ dòng có thể click — mở modal Ally Details nơi staff có thể thực hiện hành động với ally này (xem bên dưới).

Toolbar — lọc + tìm kiếm + làm mới

Ba điều khiển ở đầu trang:

• Lọc trạng thái (chọn nhiều) — chọn bất kỳ kết hợp Linked / Left alliance. Mỗi tùy chọn trong dropdown có chấm màu và số đếm theo trạng thái (ví dụ Linked (15) / Left alliance (2)). Số đếm hiển thị bên cạnh chip cập nhật khi bạn chuyển đổi.
• Lọc Home Guild (chọn nhiều với tìm kiếm tích hợp) — chọn guild đối tác nào để hiển thị. Hữu ích khi bạn liên minh với nhiều partner và muốn tập trung vào một. Dropdown liệt kê mọi home guild khác nhau trong danh sách + số đếm mỗi guild.
• Ô tìm kiếm (bên phải) — khớp chuỗi với tên nhân vật, username, và tên home guild. Kết hợp với hai bộ lọc ở trên.
• Làm mới (nút icon, ngoài cùng bên phải) — tải lại danh sách từ server. Trang cũng tự đồng bộ qua channel realtime khi ally nộp đơn, được duyệt, hoặc thay đổi trạng thái — hiếm khi cần làm mới thủ công.

Modal Ally Details (hành động của staff)

Click bất kỳ dòng ally nào để mở modal Ally Details. Modal hiện hồ sơ ally đầy đủ cùng hai hành động của staff (yêu cầu Manage Guild):

• 🖉 Relink sang nhân vật khác — mở character picker giới hạn trong alliance partner của bạn. Chọn nhân vật; home guild được resolve trực tiếp từ Albion; tài khoản user giữ nguyên. Hữu ích khi ally chuyển sang alt khác trong guild đối tác và bạn muốn dòng trong danh sách theo dõi theo.
• Xóa Ally — nhập để xác nhận. Dòng ally bị soft-delete (trạng thái chuyển sang Left alliance), Discord ally role được queue để thu hồi, và mọi đăng ký CTA Timer cho nhân vật này trong guild của bạn bị xóa. Tài khoản user không bị ảnh hưởng; họ có thể nộp đơn lại qua ally code hoặc nút Discord [Apply as Ally].

Cách ally xuất hiện ở đây

Một ally vào danh sách này sau khi một trong hai luồng hoàn tất:

• Web — họ truy cập https://ao-master.com/ally/<code>, đăng nhập (hoặc đăng ký), chọn nhân vật, và submit. Đơn xuất hiện trên #Đơn xin gia nhập (phía Ally). Staff có quyền Approve Enlist Members duyệt; dòng xuất hiện trên #Allies và Ally Role chip được gắn vào nhân vật của họ ở mọi nơi.
• Discord — họ click nút [Apply as Ally] được ghim trên channel #🤝-ally-here của bạn; bot mở ticket 🤝-ally-…; reviewer chạy /ally review (và /ally done sau khi duyệt). Điểm đến giống nhau: dòng xuất hiện trên #Allies với Ally Role chip.

Để xem góc độ của thành viên, xem Members — Alliance. Về phía Discord, xem Discord — Luồng Ally.

Khi trạng thái chuyển sang "Left alliance"

Cron defection chạy mỗi ngày một lần. Với mỗi ally đang hoạt động, cron kiểm tra:

1. Nhân vật đã liên kết của họ còn trong home partner guild không?
2. Home partner guild còn trong alliance của bạn không (hay đã rời)?

Nếu một trong hai câu trả lời là không, dòng ally chuyển sang Left alliance. Điều gì xảy ra tiếp theo phụ thuộc vào chế độ Ally Role Sync của bạn (đặt tại Discord Integration → Integrations → Ally):

• 🟢 Tắt — không tự purge — Discord ally role vẫn còn. Dòng tiếp tục xuất hiện trên #Allies với badge Left alliance cho đến khi bạn quyết định xóa họ.
• 🟡 Review thủ công — dòng vào danh sách review Stale Ally Roles (thấy được trên trang Discord Integration). Chọn subset để strip.
• 🔴 Strict — purge ngay — bot strip Discord ally role + DM cựu ally trong vòng một phút.

Ở mọi chế độ, danh sách #Allies hiện badge Left alliance ngay khi kiểm tra chạy. Bộ lọc trạng thái ở trên cho phép bạn ẩn hoặc tập trung vào những dòng đó.

Liên kết liên quan

• Members — Alliance — góc độ ally của việc là một ally.
• Settings → Recruitment — cấu hình câu hỏi nộp đơn ally + Ally Role chip + tạo ally code.
• Discord Integration — Integrations → trang con Ally (map channel, chế độ Ally Role Sync, Discord role đối tác).
• Discord — Luồng Ally — pipeline phía Discord (panel bot Manage Ally, slash command, archive transcript).
• #Đơn xin gia nhập — nơi staff duyệt / từ chối đơn ally.