Discord Integration

Kênh #Discord Integration là nơi bạn ghép đôi Discord server với guild AO Master này, rồi cấu hình cách hai bên đồng bộ. Không giống hầu hết cài đặt, kênh này nằm trên channel riêng — #Discord Integration trong mục QUẢN LÝ trên sidebar — thay vì bên trong Settings modal.

Hầu hết chủ guild truy cập một lần khi onboarding (để ghép đôi) rồi thêm vài lần sau khi guild phát triển — để bật pipeline Ally, kết nối ping thông báo giao Regear, hoặc làm mới map role sau khi cơ cấu lại.

Để xem toàn bộ hướng dẫn mời bot và chạy wizard /guild pair, xem Discord — Install + pair.

Quyền

Kênh này yêu cầu quyền Manage Integrations để mở. Cấp quyền này cẩn thận — đây là đòn bẩy admin phía Discord. Nó kiểm soát ghép đôi, hủy ghép, map role + war role, các pipeline Enlist / Ally / Regear, và xây lại tin được pin.

Trước khi ghép đôi — card onboarding ba bước

Khi bot chưa được ghép đôi với Discord server của bạn, trang hiển thị card onboarding ba bước:

1. Mời bot vào Discord server — mở trang Discord OAuth. Chọn server, xác nhận cấp quyền Administrator. (Bot cần Administrator vì nó quản lý channel, role, quyền và webhook thay bạn.)
2. Chạy /guild pair trong Discord server — wizard ngắn chọn ngôn ngữ + khu vực, tìm guild Albion, và tạo channel #⚙️-guild-settings riêng tư dưới category 🛡 AO Master mới. Mất khoảng 2 phút.
3. Quay lại trang này — sau khi wizard hoàn tất, refresh và trang mở rộng thành dạng xem năm tab đầy đủ.

Hướng dẫn từng bước với ảnh chụp mọi prompt wizard nằm trên Discord — Install + pair.

Nếu bot bị xóa khỏi Discord server

Trang hiển thị card Bot was removed from your Discord server với một nút duy nhất Re-invite Bot. Click sẽ đưa bot qua lại luồng OAuth. Khi bot tham gia lại, trang tự động quay lại dạng xem năm tab khỏe mạnh. Không cần chạy lại /guild pair trừ khi dữ liệu phía Discord của bạn đã bị xóa.

Sau khi ghép đôi — năm tab

Khi bot đã ghép đôi, trang mở rộng thành năm tab phía trên cùng.

Tab	Nội dung
Dashboard	Năm status card — trạng thái kết nối, tên Discord server, ngày ghép đôi, số channel bot, số channel thành viên. Chỉ đọc.
Integrations	Ba pipeline phía Discord — Enlist, Ally, Regear. Xem mục tiếp theo.
Roles	Map mỗi AO Master role với một Discord role + sub-tab Discord Role Sync.
War Roles	Map mỗi war role với một Discord role + sub-tab War Role Sync.
Settings	Vùng nguy hiểm — Hủy ghép integration.

Thứ tự tab khớp với trình tự setup điển hình: xác nhận kết nối (Dashboard) → kết nối pipeline (Integrations) → map role (Roles + War Roles) → để Settings yên trừ khi bạn đang tháo dỡ.

Tab Integrations — Enlist, Ally, Regear

Tab Integrations dùng sub-nav dọc bên trái với một panel per pipeline bên phải. Mỗi dòng sub-nav có chấm xanh/đỏ nhỏ cho thấy pipeline đã cấu hình + đang hoạt động chưa.

Sub-page Enlist

Cấu hình pipeline Enlist — nút [Enlist] được pin trong #📋-apply-here (tên channel của bạn có thể khác). Thành viên click vào, bot mở channel ticket riêng 🎯-enlist-…, recruiter review cuộc hội thoại, và khi duyệt bot đồng bộ role + (tùy chọn) đổi tên applicant.

Phía trên panel là card Related settings với phím tắt một click đến cài đặt nằm ở nơi khác nhưng ảnh hưởng pipeline này:

• Receive new applicants — tạm dừng hoặc tiếp tục nhận.
• Web join codes — mở tab Recruitment trong modal bên để tạo mã cho applicant không qua Discord.
• Recruiter permission — mở tab Roles để cấp quyền Approve Enlist Members cho một role.
• Custom apply questions — mở tab Recruitment để chỉnh danh sách câu hỏi hiển thị cho mọi applicant.

Bên dưới card Related settings, các cài đặt chỉ dành cho Discord:

• Trạng thái — đang nhận hoặc tạm dừng, cùng channel nút được pin.
• Archive transcripts — trước khi xóa ticket khi Approve hoặc Reject, bot mirror mọi tin nhắn (với tên + avatar tác giả gốc) và mọi file đính kèm vào channel forum riêng tư. Forum + webhook bot dùng để đăng tự được tạo lần đầu tiên bạn duyệt ai đó.
• Tự đặt tên hiển thị Discord theo tên nhân vật — khi recruiter duyệt applicant, bot cũng đổi nickname Discord của họ theo nhân vật Albion đã chọn. Im lặng bỏ qua khi Discord chặn (ví dụ khi applicant là chủ server).
• Mẫu tên channel ticket — mẫu cho mỗi channel 🎯-enlist-… mới. Placeholder: {user} (Discord username), {number} (bộ đếm tuần tự — và nút Reset counter bên cạnh).
• Discord role của recruiter — các Discord role thấy và trả lời trong mọi ticket. Cũng là gate cho /enlist review và /enlist reject.
• Map channel Enlist — trỏ nút [Enlist] được pin tới channel Discord có sẵn.
• Map category Ticket — trỏ ticket mới tới category Discord có sẵn.
• Label nút Enlist + Nội dung tin pinned + Tin chào mừng trong mỗi ticket — văn bản bạn kiểm soát với hỗ trợ Discord-markdown đầy đủ.
• Hành động — ba dòng: Làm mới tin pinned (re-render nút được pin), Xây lại cấu trúc (tự động reject mọi applicant đang chờ, xóa channel + category, tạo lại mới — giữ nguyên role + tin nhắn tùy chỉnh), Tắt Enlist (xóa toàn bộ config và giải phóng channel).

Toàn bộ luồng từ applicant đến duyệt được mô tả trên Discord — Enlist flow.

Sub-page Ally

Cấu hình pipeline Ally — phiên bản Discord tương tự Enlist cho applicant từ guild đối tác. Cấu trúc gương với Enlist, với hai phần riêng cho ally.

Card Related settings có cùng cấu trúc — toggle nhận, web ally code, quyền reviewer, câu hỏi đơn tùy chỉnh — cộng thêm một dòng chỉ dành cho Ally:

• Chip Ally Role — chip hiển thị trên mọi dòng ally và slot đăng ký (xem trước màu trực tiếp).

Các cài đặt chỉ dành cho Discord bao gồm mọi thứ Enlist có — Trạng thái, Archive transcripts, Tự đặt tên hiển thị Discord, Mẫu tên channel ticket (nhóm 🤝-ally-…), Discord role của reviewer, Map channel Ally, Map category Ticket, Label nút Ally, Nội dung tin pinned, Tin chào mừng — cộng thêm hai card chỉ dành cho Ally:

• Role cấp khi duyệt — Discord role được thêm cho mọi ally được duyệt sau khi đổi tên. Mặc định là AO Ally (tự tạo lần đầu bạn bật pipeline, màu khớp với chip Ally Role). Chọn role khác nếu bạn đã có, hoặc để trống để bỏ qua cấp role.
• Đồng bộ Ally Role — picker ba chế độ cho điều gì xảy ra khi nhân vật của ally đào tẩu (rời mọi guild đối tác):
  • 🟢 Tắt — không tự purge — bot không bao giờ strip Discord ally role. Trạng thái roster vẫn chuyển sang Left alliance; chỉ Discord role giữ nguyên. Hữu ích khi ally là khách lâu dài và bạn muốn kiểm soát thủ công.
  • 🟡 Review thủ công — trạng thái roster chuyển + dòng vào danh sách review Stale Ally Roles. Bạn chọn subset để strip; Discord role giữ nguyên cho đến khi bạn xác nhận.
  • 🔴 Strict — purge ngay — cron defection chuyển roster VÀ ngay lập tức strip Discord ally role + DM cựu ally. Mặc định. Giữ roster + Discord role liên kết chặt mà không cần admin làm gì.
• Discord role đối tác — map mỗi guild đối tác trong alliance của bạn với một Discord role. Ally được duyệt nhận role này NGOÀI role AO Ally chung để nguồn partner của họ hiện rõ ngay. Tên trùng với Discord role có sẵn sẽ tự liên kết.

Card Hành động có cùng ba dòng như Enlist (Làm mới tin pinned, Xây lại cấu trúc, Tắt Ally), chỉ áp dụng cho pipeline Ally.

Toàn bộ luồng từ ally đến duyệt được mô tả trên Discord — Ally flow.

Sub-page Regear

Cấu hình thông báo giao Regear — ping Discord kích hoạt khi staff đánh dấu Cut-off Task hoàn thành.

• Thông báo giao Regear — toggle trên cùng. Bật hoặc tắt; tắt giữ nguyên channel + template bạn đã cấu hình cho lần sau.

• Channel thông báo — chọn channel Discord bot sẽ đăng. Bot cần quyền Send Messages trong channel đó.

• Mẫu tin nhắn — viết nội dung bài đăng dùng bốn placeholder bot điền lúc gửi:

  • {staff} — Discord mention của người click Complete Task.
  • {recipients} — Discord mention của mỗi người nhận, phân tách bằng dấu phẩy.
  • {task_name} — tên hiển thị trên thẻ Cut-off task.
  • {count} — số người nhận trong task.

  Block Preview ở dưới cùng của card render mẫu với giá trị mẫu để bạn thấy định dạng trước khi lưu.

• Vùng nguy hiểm — Tắt thông báo Regear — xóa channel + template. Channel Discord vẫn còn. Bật lại bất cứ lúc nào.

Bề mặt kích hoạt thông báo: nút Complete Task trên #Cut-off Tasks. Xem Item mode — cut-off + locker để biết quy trình đó.

Tab Roles

Ghép mỗi AO Master role với một Discord role. Khi role của thành viên thay đổi ở bất kỳ phía nào, bot đồng bộ sang phía kia.

Hai sub-tab ở đầu panel:

• Map roles — editor map per-role như trên. Mỗi dòng có AO Master role bên trái, dropdown Discord-role bên phải, và ✕ nhỏ để bỏ liên kết. Chỉnh sửa được lưu tạm local — thanh unsaved xuất hiện ở cuối trang khi có dòng thay đổi, với nút Lưu và Hủy bỏ. Chuyển tab giữ draft của bạn; đóng trang sẽ cảnh báo.

  Nút Refresh from Discord buộc bot lấy lại danh sách Discord role mới nhất (hữu ích ngay sau khi bạn tạo hoặc đổi tên Discord role và muốn map mà không chờ refresh hàng giờ của bot).

• Discord Role Sync — chọn cách bot phản ứng khi thành viên mất web role hoặc rời guild. Cùng ba chế độ như Đồng bộ Ally Role: Tắt — không tự purge / Review thủ công (với nút Run Manual Purge mở danh sách review) / Strict — purge ngay (mặc định).

  Bên dưới picker chế độ, Log hoạt động đồng bộ liệt kê mọi thay đổi Discord role mà bot đã thực hiện — cấp và thu hồi do thay đổi web, revert các chỉnh sửa thủ công phía Discord, lịch re-check, và click Run Manual Purge. Thay đổi role phía web nằm trong Audit Log chính thay thế.

Tab War Roles

Cùng layout như Roles, nhưng cho war role. Sub-tab Map war roles ghép mỗi war role với một Discord role; sub-tab War Role Sync có picker ba chế độ độc lập chỉ áp dụng cho assignment war role. Chúng tách biệt để bạn có thể strict với role thường và thoải mái với war role, hoặc ngược lại.

Tab Settings — Vùng nguy hiểm

Một card với một nút duy nhất.

• Hủy ghép Discord integration — xóa category 🛡 AO Master của bot, channel thành viên, và map role. Có thể hoàn tác bằng cách chạy lại /guild pair.

Dữ liệu guild AO Master của bạn (thành viên, role, bank, lịch sử regear) giữ nguyên qua hủy ghép. Chỉ liên kết trực tiếp đến Discord server bị ngắt.

Liên kết liên quan

• Discord — Install + pair — hướng dẫn chi tiết mời bot + chạy wizard.
• Discord — Channels overview — category 🛡 AO Master, hub #⚙️-guild-settings, category 🎯 Enlist và 🤝 Ally.
• Discord — Enlist flow — luồng từ applicant đến duyệt phía Discord.
• Discord — Ally flow — luồng nộp đơn + duyệt ally phía Discord.
• Settings → Recruitment — cài đặt cross-surface Thành viên + Ally trên tab Recruitment (câu hỏi đơn, web join/ally code, chip Ally Role).
• Item mode — cut-off + locker — quy trình Cut-off Tasks kích hoạt thông báo giao Regear.