관리 기능 한눈에

채팅방 설정은 관리 페이지에서, 사람 관리는 채팅방 안에서 해요. 이 문서는 개발하면서 알아야 할 위치와 명령어만 모았어요.

관리 페이지

메뉴는 기본·설정·운영·보안 순서로 묶여 있어요. 유료는 유료 채팅방에서만 저장·사용할 수 있는 기능이에요(무료 채팅방에서도 화면은 보여요).

묶음	메뉴	하는 일
기본	채팅방 정보	회원 연동 토큰 확인, 관리자 비밀번호·접속 비밀번호 설정
기본	요금제·결제	유료 기간 확인과 결제
기본	설치 코드	설치 코드, 회원 연동 코드, 크기, 프레임워크·CMS별 코드 → 5분 설치
기본	통계	접속자·메시지 추이 (유료)
설정	상세 설정	중복 접속, 도배 감지, 글자 수, 자동 슬로우 모드 같은 세부 규칙
설정	스킨	스킨 고르기, 색·글자 크기·모양, 숨길 요소
설정	이모티콘	채팅방 전용 이모티콘 (유료)
설정	플러그인	플러그인 켜고 끄기, 플러그인별 설정과 경험치 상점 상품
설정	회원 연동	회원 연동·시간 연동 켜기, 입장 성공·실패 기록 보기 → 회원 연동
설정	API	서버 API 키 발급·수정·값 다시 발급·폐기, 키별 사용량, 호출 기록, 시험하기 → 서버 REST API
설정	권한 설정	세션·아이디·IP로 부관리자·관리자 권한 주기, 만료일 지정
설정	기능 조건	입장·채팅·귓속말 같은 기능을 권한·레벨·경험치로 제한
운영	방문자	들어왔던 사람 목록과 사람별 기록
운영	채팅로그	지난 대화
운영	경험치	경험치 규칙, 순위, 상점 이용권 회수와 구매 기록
운영	공지사항	입장 공지, 상단 고정 공지, 자동 공지
운영	외부 알림	신고·차단·입장 같은 일을 alrim 앱·웹훅·이메일로 받기, 보낸 기록과 일간 보고서. 무료 채팅방은 alrim으로 신고·관리자 호출·이의제기 알림만 (나머지 유료)
운영	투표	채팅방 투표 (유료)
보안	채팅 필터	단어 필터(금지어 가리기), AI 필터(유료), 감시 단어(유료)
보안	신고·제재	신고 목록과 자동 처리 규칙, AI 판사(유료) 판정 기록, 채팅금지·차단 목록과 해제, 제재 기록
위험	채팅방 삭제	채팅방과 모든 설정을 지워요. 되돌릴 수 없어요

자동 공지는 시간 간격, 채팅 수, 또는 두 조건 중 먼저 충족하는 방식으로 설정해요. 시간 공지의 최소 채팅 수를 정하면 대화가 없는 회차는 건너뛰어요. 한 공지에서 어느 조건으로든 발송하면 채팅 수는 다시 0부터 세요.

IP로 권한을 줄 때는 IPv4·IPv6 주소를 쓸 수 있어요. 차단·채팅금지는 IPv4 와일드카드(192.0.2.*)와 IPv6 범위(2001:db8::/64)도 받아요.

상세 설정 → IPv6 차단 범위에서 이 방의 IP 차단·채팅금지에 적용할 범위를 정해요. 기본은 대역 일치(/64)이고 주소 일치(/128), /56, /48도 고를 수 있어요. 숫자가 작을수록 더 넓은 범위를 검사해요. 기록에는 전체 주소를 보존하며, 설정을 저장하면 기존 제재도 새 범위로 검사해요. 범위를 직접 적어 둔 제재는 그 범위를 유지해요. 같은 대역의 다른 사람도 영향을 받을 수 있어요. 아이디·세션 차단과 IPv4에는 영향을 주지 않아요.

토큰과 API 키는 서버에서만 써요. 페이지 HTML이나 스크립트에 넣지 마세요(보안 체크리스트).

채팅방 안에서 관리하기

관리자·부관리자는 닉네임을 누르면 나오는 메뉴에서 채팅금지, 차단, IP 보기, 메시지 삭제를 할 수 있어요. 부관리자 권한 주기는 관리자만 할 수 있어요. 회원 연동을 쓰지 않는 채팅방에서는 채팅창에 /login 관리자비밀번호를 입력해 관리자가 돼요. 회원 연동 채팅방은 /login을 쓸 수 없으니 회원 연동 데이터의 권한(auth)이나 권한 설정으로 관리자를 정해요.

명령어	권한	하는 일
/login 비밀번호	누구나	관리자 비밀번호로 관리자 되기(회원 연동 채팅방 제외)
/logout	관리자	관리자 권한 내려놓기
/adminpage	관리자	관리 페이지 열기
/op 닉네임, /deop 닉네임	관리자	부관리자 등록·해제
/mute 닉네임 분	부관리자 이상	채팅금지
/unmute 닉네임	부관리자 이상	채팅금지 해제
/ban 닉네임 사유	부관리자 이상	IP 차단
/info 닉네임, /ip 닉네임	부관리자 이상	사용자 정보, IP 보기. 나와 같거나 낮은 권한만 볼 수 있어요. /info 내닉네임은 누구나 쓸 수 있어요
/notice 내용	부관리자 이상	공지 메시지 보내기
/freeze, /unfreeze	부관리자 이상	채팅방 얼리기·녹이기(얼리면 부관리자 이상만 말할 수 있음)
/slow 초	부관리자 이상	슬로우 모드 간격 설정(0~3600초, 0이면 끄기)
/clearlog	부관리자 이상	모두의 화면에서 대화 지우기(일반 사용자는 내 화면만)

채팅금지는 나보다 낮은 권한에게만, 차단은 회원·손님에게만 할 수 있어요. 채팅창에 /?를 입력하면 지금 권한으로 쓸 수 있는 명령어가 모두 나와요.

누구나 쓰는 명령어

명령어	하는 일
/w 닉네임 내용	귓속말(/ㅈ)
/r 내용	마지막 귓속말 상대에게 답장(/ㄱ)
/nick 닉네임	닉네임 바꾸기(회원 연동 채팅방 제외)
/call 닉네임	호출
/ignore 닉네임, /unignore 닉네임	무시하기와 해제
/report 닉네임 사유	신고
/invite 닉네임	개인채널 초대
/slow	슬로우 모드 상태 확인

채팅방 설정과 기능 조건에 따라 일부 명령어는 막혀 있을 수 있어요.

스크립트에서 명령 보내기

같은 명령은 페이지 스크립트에서 room.action.command(명령, ...인자)로 보낼 수 있어요. 권한 검사는 서버가 하므로 권한이 없으면 오류 이벤트가 와요. slow는 결과가 오류 이벤트 대신 control 이벤트(type: 'roomOptionsResult')로 오고, 권한이 없으면 결과 JSON의 status가 forbidden이에요.

/w, /r, /nick은 스킨이 바꿔 주는 채팅창 별칭이에요. 스크립트에서는 command('whisper', 닉네임, 내용), command('changeInfo', { nick: 닉네임 })을 써요.

U.chat('my-room').on('after.join#notice-demo', function (room) {
	if (room.my.auth >= 2) room.action.command('notice', '점검은 오후 6시에 시작합니다.');
});

인자와 반환값은 U.chat()과 room 객체를 보세요.