1. 개요
마인크래프트의 명령어 JSON 문법을 나열하는 문서이다.2. 참고
이 사이트를 참고하는 것을 추천한다.참고로 이 사이트를 이용해 쉽게 JSON 문법을 이용한 명령어를 만들 수 있다.
3. 문법
#!syntax json
["",{"객체":"내용","다음 객체":"다음 내용",...},{"객체":"내용","다음 객체":"다음 내용",...}]
이때 큰따옴표, 중괄호, 쉼표, 콜론(:)이 하나라도 빠지면 제대로 실행되지 않을 것이다. 내용이
true나 false가 아니면 항상 객체와 내용 양 옆에 큰따옴표를 붙여야 한다는 것을 잊어서는 안 된다.만약 큰따옴표 안에 큰따옴표나 콜론이나 역슬래시(\)를 쓰고 싶다면, 앞에 역슬래시를 두개 써서 이스케이프 하면 된다.
\uXXXX (유니코드 16진수 숫자 4자리)나 \n, \t 같은 것도 되긴 하지만 제대로 표시되지 않는 경우가 많다. 이때, 유니코드 16진수 숫자 4자리를 사용할 때는
\uXXXX 자체가 하나의 문자이기 때문에 앞에 역슬래시를 붙여서는 안된다.| 예 | 입력 | 결과 |
| 옳은 예 | "text": "안녕하세요 \u4e16" | 안녕하세요 世 |
| 틀린 예 | "text": "안녕하세요 \\u4e16" | 안녕하세요 \\u4e16 |
3.1. 자바 에디션
마인크래프트에서 tellraw, title 등의 명령어에서 사용한다. {"이름":"내용"}의 형식으로 작성한다.예) 빨간색의
hi라는 글{"text":"hi","color":"red"}
안녕!이라는 굵은 글자를 출력하고, 클릭하면 반가워!가 출력{"text":"안녕!","bold":true,"clickEvent":{"action":"run_command","value":"/tellraw @a {"text":"반가워!"}}
안녕 난위키러야! ["",{"text":"안녕 난 "},{"text":"위키러야!","color":"red"}] 혹은 {"text":"안녕 난 ","extra":[{"text":"위키러야!","color":"red"}]}
타이머 표시하기
["",{"text":"남은 시간:"},{"score":{"name":"<개체 이름>","objective":"<분을 나타내는 스코어보드>"}},{"text":":"},{"score":{"name":"<개체 이름>","objective":"<초를 나타내는 스코어보드>"}}]
3.1.1. 글씨 효과
- text: 문자열을 출력한다. \\n을 사용하면 줄바꿈을 할 수 있다.
- score: 스코어보드의 점수를 출력한다.
형식:{"score":{"name":"점수를 가진 대상","objective":"점수 아이디"}} - selector: 대상으로 지정된 개체들의 이름을 출력한다. 여러 개체인 경우 쉼표(,)를 사용하여 구분된다. text에서 사용할 수 없는 대상 선택 인자(@a, @p, @r, @e, @s)를 사용할 수 있다.
형식:{"selector":"대상 선택 인자"} - translate: 마인크래프트 게임 내의 번역 문자열을 출력한다. 번역 문자열의 목록은
.minecraft\versions\(버전)\(버전).jar\assets\minecraft\lang\en_us.json(영어)에 있다.
형식:{"translate":"번역 문자열","with":["변수1","변수2", ...]} - keybind : 마인크래프트에서 자신이 설정한 조작키를 출력한다.
형식:{"keybind":"key.sneak"}<-(왼쪽 Shift) [1] - nbt: 엔티티나 블록의 nbt를 출력한다. 참고로 storage의 값도 불러올 수 있다.
형식:{"nbt":"nbt경로","개체나 블록"}
예시: 자신의 체력을 표시하는 명령어/title @s title {"nbt":"Health","entity":"@s"}(단, 값은 20.0f 이런 식이다.) - font : 1.16부터 추가된 효과. 글꼴을 지정한다.
minecraft:uniform(유니코드 글꼴),minecraft:alt(마법부여대 글꼴),minecraft:default(기본 글꼴),minecraft:asciillager(던전스에서 나오는 룬 글꼴) 중에서 선택할 수 있다. 리소스팩으로 추가된 글꼴은 이외의 값을 가진다. - color: 텍스트의 색을 지정한다. 색깔로 가능한 것은 dark_red, red, gold, yellow, dark_green, green, aqua, dark_aqua, dark_blue, blue, light_purple, dark_purple, white, gray, dark_gray, black 그리고 #RRGGBB이다(JE 1.16+)[2]. 잘 보면 ANSI 이스케이프 코드 표준의 SGR 색상 설정 부분 특수화라고 볼 수 있다.
형식:{"color":"색깔"}black dark_gray dark_red red dark_green green gold yellow dark_blue blue dark_purple light_purple dark_aqua aqua gray white - bold: true, false로 설정할 수 있으며, 글씨의 굵음을 설정한다.
형식: {"bold":논리값} - italic: true, false로 설정할 수 있으며, 글씨의 기울어짐을 설정한다.
형식: {"italic":논리값} - underlined: true, false로 설정할 수 있으며, 글씨의 밑줄 여부를 설정한다.
형식: {"underlined":논리값} - strikethrough: true, false로 설정할 수 있으며, 글씨의 취소선 여부를 설정한다.
형식: {"strikethrough":논리값} - obfuscated: true, false로 설정할 수 있으며, 글씨를 읽을수 없게 난독화할 지를 설정한다.
형식: {"obfuscated":논리값}
3.1.2. 클릭 이벤트
클릭시 이벤트가 발생한다.식 구성:
{"clickEvent":{"action":"이벤트","value":"이벤트 값"}} run_command: 클릭시 이벤트 값에 있는 채팅을 입력한다. 무조건/가 있어야 하며 me, tell, msg, w, say, tm, teammsg 명령어는 실행할 수 없다. 최대 256자 까지만 된다. 책으로 클릭하면 창이 닫는다.suggest_command: 클릭시 이벤트 값에 있는것이 자동 타이핑 된다.open_url: 클릭시 이벤트 값에 있는 URL에 들어간다.copy_to_clipboard: value에 있는 클립보드에 복사한다.change_page: 책에서만 이용가능하다. 클릭시 이벤트 값에 있는 페이지로 이동한다.open_filetwitch_user_info
3.1.3. 호버 이벤트
글자에 마우스를 가까이 대면 이벤트가 발생한다.식 구성 : {"hoverEvent":{"action":"이벤트","value":"이벤트 값"}}
- show_text : 글자에 마우스를 가까이 대면 이벤트 값에 있는 글자가 뜬다
- show_item : 글자에 마우스를 가까이 대면 이벤트 값에 있는 아이템의 이름이 뜬다
- show_entity : 글자에 마우스를 가까이 대면 이벤트 값에 있는 엔티티의 이름이 뜬다
show_achievement: 1.12부터 제거되었다. 대신 show_text를 사용할 수 있다. 글자에 마우스를 가까이 대면 이벤트 값에 있는 도전과제의 이름이 뜬다.
이벤트 값에 있는 글자의 색상을 바꾸고 싶다면 "value":"이벤트 값" 대신에 "value":{"text":"이벤트 값","color":"색상"} 을 입력하면 된다.
3.2. 베드락 에디션
BE의 경우에는titleraw 명령어에서 JSON 문법을 사용하며, 객체 목록은 JE와 같다. *text *selector *score 등등이 가능해졌지만 여전히 클릭, 호버이벤트는 지원을 안하고 있다. 추후 업데이트때 나올가능성도 있다. 단, BE의 경우 JSON 문법에 다음과 같은 처리를 해야 한다.{"rawtext":[JSON]}
[1] https://www.minecraftjson.com/ 이 사이트에서 손쉽게 편집이 가능하다.[2] 16진수이다.