Discord 멤버 작업

이 페이지는 Discord 봇의 멤버 측 내용을 다룹니다 — 본인 상태 확인, Discord에서 길드에 가입, AO Master와 Discord 간 role 할당 동기화에 대한 이해. 동일한 면의 스태프 측 내용은 Settings → Discord Integration에 있습니다.

간단 요약

언제든 **/whoami**를 실행해 이 서버에서의 본인 상태를 확인하십시오.
Discord에서 길드에 가입하는 과정은 참가 신청 흐름을 통합니다 — #📋-enlist-here에서 [Enlist]를 클릭하면 모집자가 이어서 처리합니다.
AO Master 계정 연결/연결 해제는 웹에서 이루어집니다 — 이를 위한 Discord 측 슬래시 명령어는 없습니다.
스태프가 AO Master 웹에서 role을 변경하면 봇이 자동으로 Discord role에 반영합니다.

`/whoami` — 한 메시지로 보는 본인 상태

봇이 볼 수 있는 채널 어디서나 /whoami를 입력하십시오. 봇은 이 Discord 서버에서의 본인 위치를 설명하는 비공개 메시지(본인에게만 보임)로 응답합니다.

응답은 본인의 상태에 따라 달라집니다.

상태	응답 내용
서버가 AO Master와 연결되지 않음	"Server not set up" — 관리자에게 `/guild pair` 실행을 요청.
봇이 이 서버에서 추방됨	"Bot was removed" — 관리자에게 재초대를 요청.
서버는 연결되었지만 AO Master 길드 멤버가 아직 아님	"You're not a member of this guild yet — please contact a staff member to be linked."
Albion 캐릭터가 연결된 멤버	길드 이름 + 지역, 본인 캐릭터, role(Member / Staff / Owner), Active 상태를 표시.
캐릭터가 연결되지 않은 멤버	동일한 카드이지만 Character가 "not linked"로 표시됨. 소유자와 스태프는 업무 수행에 캐릭터 연결이 반드시 필요하지는 않지만 — 연결하면 명단에 추가되고 다른 멤버와 마찬가지로 리기어를 신청할 수 있습니다.

각 응답에는 다음 단계에 적절한 위치(멤버 작업은 웹 대시보드, 소유자 컨트롤은 #⚙️-guild-settings)에 대한 안내도 포함됩니다.

Discord에서 길드 가입하기

/join 슬래시 명령어는 없습니다. Discord 측 표준 경로는 참가 신청입니다.

길드 소유자가 #⚙️-guild-settings에서 봇을 활성화하고 참가 신청 파이프라인을 구성했습니다(이로써 #📋-enlist-here + 🎯 Enlist 카테고리가 생성됨).
#📋-enlist-here에서 **[Enlist]**를 클릭합니다.
봇이 기본적으로 #enlist-{your-username} 이름의 비공개 검토 티켓을 만듭니다 — 본인 + 길드 모집자만 게시할 수 있습니다.
모집자가 티켓 안에서 /enlist review를 실행해 본인의 Albion 캐릭터를 선택하고(Albion의 실시간 API 검색), 초기 워롤을 할당한 뒤 Approve를 클릭합니다. 웹 길드 명단에 본인이 캐릭터와 함께 표시되고, 봇이 매칭되는 Discord role(들)을 부여합니다.
채널은 유지됩니다 — 모집자는 승인 후에도 계속 대화하는 경우가 많습니다. 끝나면 /enlist done을 실행하면 기록이 아카이브 포럼으로 미러링되고 실 채널은 삭제됩니다.

모집자 관점을 포함한 전체 안내: Discord 참가 신청 흐름.

길드에 참가 신청이 구성되어 있지 않다면, 소유자/스태프 멤버에게 설정을 요청하거나 웹 가입 코드를 통해 가입하십시오(Settings → Enlists 참고).

계정 연결/연결 해제

연결은 웹 전용입니다.

첫 연결은 모집자가 /enlist review를 통해 승인할 때 자동으로 이루어집니다(본인 캐릭터 + Discord 계정이 새로 생성된 AO Master 사용자 레코드에 묶임).
기존 AO Master 계정을 본인의 Discord 신원에 연결하는 작업은 https://ao-master.com/login에서 "Sign in with Discord"가 있는 웹 가입 흐름을 사용합니다.

연결 해제도 웹 전용입니다. AO Master 웹 대시보드를 열고 #Members 명단에서 본인을 찾은 뒤 멤버별 Unlink 작업을 누르십시오. 봇은 본인과 연결된 Discord 측 작업을 더 이상 게시하지 않으며 AO Master 계정은 그대로 유지됩니다.

Discord 측 /link 또는 /unlink가 없는 이유

슬래시 형태는 모집자의 /enlist review 흐름과 연결을 묶는 방식으로 대체되었습니다(이 흐름은 이미 지원자의 Albion 캐릭터를 실시간 게임 API와 대조해 검증합니다). 웹으로 일원화하면 휴대전화 등 다른 기기에서도 연결을 관리할 수 있어, Discord 안에서만 가능한 작업이 아닙니다.

role 동기화 — Discord role이 AO Master role을 따라가는 방식

캐릭터가 연결된 상태에서 AO Master 웹 role이 변경되면(스태프 멤버가 role을 추가/제거하거나, 참가 신청을 통해 가입해 기본 Member role을 받는 경우), 봇이 자동으로 Discord 측에 그 변경을 반영합니다.

웹 → Discord: 웹 role 할당이 봇을 트리거해 매칭되는 Discord role을 Discord 사용자에게 추가합니다.
Discord → 웹(역방향): 소유자/Discord 관리자가 봇이 관리하는 role을 Discord에서 직접 떼어내면, 봇은 기본적으로 다시 적용해 양쪽을 정렬합니다(웹이 진실의 원천). 소유자는 Settings → Discord Integration → Roles → Sync mode에서 이 동작을 변경할 수 있습니다(모드: Soft / Strict / Off).
본인이 멤버십을 완전히 잃는 경우: 스태프 멤버가 본인을 AO Master 길드에서 추방하면 봇은 매핑된 모든 Discord role도 본인의 계정에서 제거합니다.

길드의 role 페어링은 스태프가 웹에서 구성하므로 — 멤버로서 별도로 설정할 것은 없습니다.

봇이 망가져 보일 때

봇의 복구 체크리스트는 #⚙️-guild-settings의 고정 메시지에 있는 🆘 Help 버튼 뒤에 있습니다(Discord 채널 개요 — §2). 가장 흔한 해결 방법:

봇이 /whoami에 응답하지 않음 — 봇이 오프라인이거나 서버가 연결되지 않았을 수 있습니다. /whoami를 한 번 더 실행하고, 그래도 응답이 없다면 소유자에게 웹의 #Discord Integration 페이지를 확인해 달라고 요청하십시오.
봇 응답이 "Bot was removed" — 관리자가 웹의 Invite Bot 버튼으로 다시 초대해야 합니다. 재초대 후에도 다시 연결할 필요는 없습니다 — 기존 AO Master ↔ Discord 페어링은 보존됩니다.
본인 Discord role이 AO Master role과 맞지 않음 — #⚙️-guild-settings를 열고, 소유자가 🔄 Force Re-sync All을 클릭하면 연결된 모든 멤버의 role이 한 번에 정합됩니다(본인 계정에서 변경 사항이 있다면 DM으로 통지됩니다).

Discord 멤버 작업 ​

/whoami — 한 메시지로 보는 본인 상태 ​

Discord에서 길드 가입하기 ​

계정 연결/연결 해제 ​

role 동기화 — Discord role이 AO Master role을 따라가는 방식 ​

봇이 망가져 보일 때 ​

관련 링크 ​