한글 닉네임

접속하는 인원은 아무것도 설치하지 않아도 그대로 이용할 수 있습니다. 머리 위 이름표까지 바닐라 기능(스코어보드 팀) 만으로 바꿉니다.

마인크래프트는 한글 조합 입력(IME)을 지원하지 않습니다. 이것은 이 모드의 문제가 아니라 게임 자체의 제약입니다. 채팅창에 한글을 그냥 치면 자음·모음이 따로 들어갑니다.

그래서 이렇게 입력합니다:

1. 붙여넣기: 메모장 등에 감나무 를 쓰고 복사한 뒤, 채팅창에 /닉네임 까지 치고 Ctrl+V 로 붙여 넣습니다. 가장 확실합니다.
2. 한글 입력을 지원하는 클라이언트 모드를 쓰는 인원은 바로 칠 수 있습니다.
3. 관리자가 대신 지정해 줄 수 있습니다 → /닉네임설정 <플레이어> <이름>

영문·숫자 닉네임은 아무 문제 없이 바로 칠 수 있습니다.

• 정한 이름이 채팅 · 탭 목록 · 머리 위 이름표 에 나옵니다.
• 정하는 순간 바뀝니다. 재접속이 필요 없습니다.
• Cobblemon 배틀 로그에도 닉네임이 나옵니다. (Cobblemon 이 있을 때)
• 규칙을 전부 정할 수 있습니다. 글자 수 · 쓸 수 있는 글자 · 금지어 · 중복 허용 · 변경 가능 여부 · 변경 쿨타임.
• 다른 인원의 계정 이름을 닉네임으로 쓰는 것을 막습니다 (사칭 방지).
• 닉네임을 정하지 않아도 플레이할 수 있습니다. 정하지 않은 인원은 계정 이름을 씁니다. (설정으로 "정해야만 플레이" 로 바꿀 수 있습니다)
• 접속하면 잠시 뒤에 안내가 나갑니다. 다른 모드의 접속 화면과 겹치지 않게 미룹니다.

바뀌는 것은 보여지는 이름뿐입니다. 명령어 대상 지정 · 권한(ops.json) · 저장 파일은 전부 계정 이름 그대로 돌아갑니다.

/tp <계정이름> ~ ~ ~       됩니다
/tp 감나무 ~ ~ ~           안 됩니다

서버 로그에도 계정 이름이 남습니다. 의도된 동작입니다. 닉네임까지 바꿔 버리면 관리가 불가능해집니다.

마인크래프트에서 머리 위 이름표는 클라이언트가 그립니다. 그래서 보통은 접속하는 인원 모두가 모드를 설치해야 합니다.

이 모드는 바닐라의 스코어보드 팀을 씁니다. 서버만으로 이름표를 바꿀 수 있는 유일한 길입니다.

머리 위에서는 계정 이름이 완전히 사라지지는 않습니다. 바닐라가 이름표 가운데에 반드시 계정 이름을 그리기 때문에, 서버는 그 앞뒤에만 글자를 붙일 수 있습니다. 기본 모양은 이렇습니다

감나무 (Pang3_)

모양은 nameplateFormat 으로 바꿀 수 있고, 계정 이름을 보이고 싶지 않다면

채팅과 탭 목록에만 나옵니다).

팀을 이미 쓰고 있는 서버라면 주의해 주세요. 한 인원은 팀 하나에만 들어갈 수 있습니다.

다른 팀에 들어 있는 인원의 이름표는 건드리지 않고 건너뜁니다 (채팅·탭의 닉네임은 그대로 나옵니다).

칭호·계급처럼 이름 앞에 무언가 붙이는 모드와 함께 쓸 수 있습니다. 이 모드는 그 모드가 붙여 둔 글자를 지우지 않고 그대로 살려서 닉네임과 합칩니다.

[새내기] 감나무          ← 채팅 · 탭 목록
[새내기] Pang3_          ← 머리 위 (이름표는 그 모드에 양보합니다)

머리 위 이름표는 한쪽만 쓸 수 있으므로, 기본값은 이 모드가 양보합니다. 반대로 하려면 yieldToNameMods 를 false 로 두세요 (그러면 머리 위에 닉네임이 나오는 대신, 그 모드가 붙이던 글자가 사라집니다).

서버를 한 번 실행하면 config/pang_nickname.json 이 자동으로 생성됩니다.

이름 규칙

minLength           가장 짧은 글자 수 (기본 2)
maxLength           가장 긴 글자 수 (기본 12)
allowedPattern      쓸 수 있는 글자 (자바 정규식 · 기본 "^[가-힣A-Za-z0-9]+$")
allowedHint         규칙을 어겼을 때 보여줄 문장  allowedPattern 을 바꾸면 같이 바꾸세요
forbidden            금지어 목록 (대소문자·공백을 무시하고 "포함" 으로 검사)
allowDuplicates     같은 닉네임을 여러 인원이 써도 되는지 (기본 false)
blockAccountNames   다른 인원의 계정 이름을 막을지 (기본 true · 사칭 방지)
                        접속 중인 인원의 계정 이름만 검사합니다
                          (전체 검사는 외부 조회가 필요해 서버가 느려집니다)

언제 정하나 · 바꿀 수 있나

requireNickname      정해야만 플레이할 수 있게 할지 (기본 false)
joinDelayTicks      접속하고 몇 틱 뒤에 안내할지 (기본 40 = 2초)
joinHint            접속할 때 안내를 보낼지 (기본 true)
repromptTicks       requireNickname 일 때 안내를 다시 띄우는 주기 (기본 100)
allowChange         본인이 직접 바꿀 수 있는지 (기본 false · OP 만 변경)
changeCooldownHours 바꾸고 나서 다시 바꾸기까지 기다릴 시간 (기본 24 · 0 이면 제한 없음)

어떻게 보이나

useScoreboardTeam   머리 위 이름표를 바꿀지 (기본 true)
nameplateFormat      이름표 모양: %nick% 은 닉네임, %name% 은 계정 이름
                       기본 "%nick% §7(%name%§7)"  →  감나무 (Pang3_)
teamNamePrefix      모드가 만드는 팀 이름의 앞머리 (영문·숫자 1~8자)
yieldToNameMods     다른 이름 꾸미기 모드에 이름표를 양보할지 (기본 true)

설정을 고칠 때는 서버를 끄고 고쳐 주세요. (다시 읽는 명령은 없습니다)

값이 잘못되어도 서버는 뜹니다. 경고를 한 줄 남기고 기본값으로 되돌립니다.

1. 서버의 mods 폴더에 제공받은 .jar 파일을 넣습니다.
2. 서버를 실행하면 적용이 완료됩니다.
3. 접속하는 인원은 아무것도 설치하지 않아도 이용할 수 있습니다.

저장 실패에 대비해 .bak 백업을 함께 만듭니다.

다른 서버로 옮길 때는 config 파일만 옮기세요.

• 지원 버전과 다른 Minecraft 버전에서는 정상 작동하지 않을 수 있습니다.
• 한글은 붙여넣기(Ctrl+V)로 입력해 주세요. 마인크래프트가 한글 조합 입력을 지원하지 않습니다 (게임 자체의 제약입니다).
• 머리 위 이름표에는 계정 이름이 함께 나옵니다. 바닐라가 반드시 그리는 자리라 서버에서 지울 수 없습니다 (감추려면 useScoreboardTeam 을 false 로).
• 스코어보드 팀을 쓰는 다른 모드·플러그인과 함께 쓰면 그 인원의 이름표는 바뀌지 않습니다 (채팅·탭의 닉네임은 그대로입니다).
• /닉네임설정 은 접속 중인 인원에게만 쓸 수 있습니다.
• 명령어·권한·저장 파일은 계정 이름으로 돌아갑니다 (닉네임으로는 대상 지정이 안 됩니다).
• 구매한 파일의 무단 배포 및 재판매를 금지합니다.
• 서버에서 함께 플레이하는 인원에게만 설치 목적으로 파일을 공유할 수 있습니다.
• 공유받은 인원은 해당 서버 이용 목적 외에 파일을 사용하거나 재배포할 수 없습니다.
• 구매 시 안내된 이용 약관에 동의한 것으로 간주됩니다.