CubrateName

서버를 운영하다 보면 유저를 꾸며줄 수단이 늘 아쉽습니다. 칭호 하나 붙이려고 플러그인을 서너 개 엮고, 이름표는 이름표대로 따로 관리하고요.

CubrateName은 그 세 가지 — 닉네임, 칭호, 머리 위 인장 — 를 한 플러그인으로 묶어서 관리합니다. 설치하고 서버를 켜면 샘플 칭호(VIP, MVP, Hello, Admin, Newbie)와 샘플 인장(트로피, 별, 왕관, 하트, 다이아)이 이미 들어가 있어서, 별도 세팅 없이 유저들이 바로 써볼 수 있습니다.

유저는 채팅창에 /이름표만 치면 됩니다. /닉네임, /칭호, /인장, /nametag 로도 열립니다.

메뉴가 열리면 슬롯이 세 개 보입니다.

• 닉네임 슬롯 — 내 이름을 원하는 걸로 변경
• 칭호 슬롯 — 이름 옆 대괄호에 붙는 문구 (예: [VIP])
• 인장 슬롯 — 머리 위에 뜨는 작은 아이콘 (예: ★, 👑)

닉네임 슬롯을 클릭하면 채팅 입력을 기다리는 상태가 됩니다. 원하는 이름을 그냥 채팅에 치면 끝입니다.

입력창에서 쓸 수 있는 말들:

• 아무 이름이나 → 그 이름으로 변경 (예: 민수)
• 취소 또는 cancel → 아무 변경 없이 종료
• 리셋 또는 reset → 원래 본명으로 되돌리기

더 빠른 방법 — 닉네임 변경권 아이템을 손에 들고 우클릭하면 메뉴를 열 필요 없이 바로 채팅 입력창이 뜹니다.

알아두면 좋은 것

• 서버 설정에 따라 닉네임 변경권 아이템이 필요할 수 있습니다. 없다면 운영진에게 문의하세요.
• 색깔 있는 닉네임(&a민수)은 별도 권한이 있어야 쓸 수 있습니다.
• 한글 닉네임은 기본으로 허용됩니다.

메뉴에서 칭호 슬롯이나 인장 슬롯을 클릭하면 내가 해금한 것들이 쭉 나옵니다.

• 원하는 걸 클릭 → 바로 장착
• 이미 낀 걸 다시 클릭 → 해제
• 목록에 없다면 → 아직 해금하지 않은 것 (운영진에게 문의)

장착하면 채팅, 탭리스트, 머리 위 이름표에 자동으로 붙습니다.

운영진에게 책 아이템을 받았을 때는 이렇게 합니다.

1. 책을 손에 들고
2. 우클릭
3. 바로 내 목록에 추가되고 책 1개가 사라집니다.

이미 가진 칭호 · 인장이라면 안내 메시지가 뜨고 책은 소모되지 않으니 걱정하지 마세요.

채팅을 치면 머리 위에 5초짜리 말풍선이 뜹니다. 정상 동작이며 다른 사람에게만 보입니다.

다른 사람 이름표가 안 보일 때 — 아래 중 하나입니다.

• 상대가 웅크리는 중 → 일어나면 다시 보입니다.
• 너무 멀리 있음 → 서버 설정 표시 거리 밖. 가까이 가면 보입니다.
• 상대가 사망 상태거나 부활 대기 중 → 부활하면 돌아옵니다.
• 내 이름표가 나한테 안 보이는 경우 → 3인칭(F5)에서 볼 수 있도록 서버가 설정돼 있어야 합니다.

관리자는 /이름표관리로 관리자 GUI를 엽니다. /nametagadmin, /칭호관리, /인장관리, /이름관리, /이름표설정로도 열립니다. 관리자 권한이 있는 사람만 사용할 수 있습니다.

기능 토글 — 각 아이콘을 클릭하면 켜기 / 끄기가 바뀝니다. 켜지면 초록, 꺼지면 회색입니다.

• 머리 위 이름표 표시 여부
• 채팅 말풍선 여부 (5초 유지)
• 채팅 포맷에 칭호 · 인장 자동 부착
• 탭리스트에 칭호 · 인장 자동 부착
• 내 이름표를 나에게도 보여줄지 (3인칭 F5)
• 닉네임 변경권 아이템 모드 (관리자는 항상 자유 변경)

관리자가 유저에게 칭호 · 인장을 지급하는 방법입니다.

1. 관리자 GUI에서 칭호 카탈로그 또는 인장 카탈로그 선택
2. 배포할 항목 클릭 → 편집 페이지 진입
3. 책 발급 버튼 클릭 (Shift 클릭 시 64개)
4. 인벤에 생긴 책을 유저에게 전달 (드랍 · 상자 · 상점 · 커맨드 등 자유)
5. 유저가 책을 우클릭 → 목록에 자동 추가

편집한 내용은 저장 즉시 반영되며, 이미 그 칭호를 장착한 유저 화면도 그 자리에서 새 텍스트로 갱신됩니다.

카탈로그 안에서 빈 슬롯 또는 새로 만들기 아이템을 클릭하면 마법사가 시작됩니다. 채워야 할 항목은 다음과 같습니다.

1. ID — 내부 식별자 (영문 소문자 권장, 예: vip, winter_2026)
2. 표시 텍스트 — 실제로 보이는 문구. 색상 코드(&a&l[VIP])와 글리프 토큰(:crown:) 사용 가능. 저장에는 이 값이 필수입니다.
3. 아이콘 — GUI 안에서 이 항목을 나타낼 재료 블록
4. 설명 — 선택

기본 인장은 유니코드 문자(★, ♥, 🏆)만 쓸 수 있어서 표현이 제한적입니다. 서버만의 고유한 그림을 인장으로 쓰고 싶다면 CubrateGlyph 플러그인 + 데스크탑 도구 Glyph Maker를 함께 사용합니다.

Glyph Maker는 서버에 접속하지 않고 PC에서 실행하는 별도 프로그램입니다. PNG 이미지를 넣으면 서버가 이해할 수 있는 리소스팩과 정의 파일 한 세트를 만들어 줍니다.

작업 순서

1. Glyph Maker 실행
2. 좌측 PNG 추가 클릭 (또는 창 가운데로 PNG 드래그)
3. 격자에서 카드를 선택 → 우측 인스펙터에서 이름(코드), 높이, 어센트 조정
4. 채팅 미리보기로 실제 채팅 모양 확인
5. 좌측 하단 출력하기 클릭 → resourcepack.zip + glyphs.yml 두 파일 생성
6. 두 파일을 서버의 plugins/CubrateGlyph/import/ 에 넣기
7. 서버 안에서 /글리프 재로드 실행 (또는 서버 재시작)

새 이미지를 인장으로 쓰기 — 이미지를 등록하면 각각 :code: 형태의 토큰이 생깁니다. 예를 들어 crown.png를 넣었다면 :crown: 이 됩니다. CubrateName 관리자 GUI의 인장 카탈로그에서 새 인장을 만들 때 표시 텍스트에 이 토큰을 그대로 넣으면 됩니다.

표시 텍스트: :crown:
표시 텍스트: &6:crown:            (금색)
표시 텍스트: :crown: :star:        (이미지 두 개 나란히)

plugins/CubrateName/config.yml에서 조정할 수 있는 항목:

• 닉네임 최소 / 최대 길이
• 한글 닉네임 허용 여부 (nickname.allow-korean)
• 채팅 포맷 (칭호 · 인장 · 닉네임 · 메시지 위치 자유 배치)
• 탭리스트 포맷
• 머리 위 이름표의 줄 구성 · 위치 · 갱신 주기 · 표시 거리
• 채팅 말풍선의 유지 시간 · 최대 길이 · 스타일
• 신규 유저에게 기본 지급되는 칭호 · 인장

설정 파일 수정 후에는 /reload가 아닌 서버 재시작이 필요합니다. 언어 파일(lang/ko_KR.yml)만 고쳤다면 /cubratelocale reload로 즉시 반영할 수 있습니다.

• CubrateCore (필수) — 명령어 등록 · 설정 관리 · GUI 유틸
• CubrateLocale (필수) — 한국어 / 영어 언어 시스템
• CubrateGlyph (선택) — 커스텀 이미지 인장 지원
• PlaceholderAPI (선택) — 외부 플러그인의 변수 삽입

Q. 서버를 껐다 켜지 않고 설정을 반영할 수 있나요? 닉네임 · 칭호 · 인장 편집은 저장 즉시 반영됩니다. config.yml 자체를 수정한 경우에는 /stop 후 재시작이 필요합니다.

Q. 관리자인데 닉네임 변경권이 소모되지 않아요. 의도된 동작입니다. 관리자는 변경권 모드와 상관없이 자유롭게 닉을 바꿉니다. 일반 계정으로 테스트해야 정상 소모가 확인됩니다.

Q. 다른 이름표 플러그인이 있는데 함께 쓸 수 있나요? 권장하지 않습니다. 두 플러그인이 서로의 팀 설정을 덮어써서 본명이 가려지지 않거나 이름표가 깜빡이는 문제가 생깁니다. 다른 이름표 플러그인의 이름표 기능은 꺼주세요.

Q. 한글 닉네임이 안 되는데요. config.yml의 nickname.allow-korean 값이 true여야 합니다. 기본값은 true입니다.

Q. 유저마다 다른 언어를 쓰게 하려면? 현재 CubrateLocale은 서버 전역 언어만 지원합니다. 유저별 언어는 지원하지 않습니다.

Q. 문제가 생기면 어디를 봐야 하나요? 서버 콘솔에 CubrateName 이름으로 로그가 남습니다. 이 로그가 뜨지 않는다면 CubrateCore 또는 CubrateLocale 설치 상태를 먼저 점검하세요.

Cubrate Free-Use License

• 무료 사용 가능
• 수정 / 재배포 / 리버스 엔지니어링 금지
• 다운로드 · 업데이트 · 지원 · 의뢰는 Cubrate Discord에서