상위 문서: 마인크래프트/명령어
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: 글꼴을 지정한다.
minecraft:uniform
(유니코드 글꼴),minecraft:alt
(마법부여대 글꼴),minecraft:default
(기본 글꼴),minecraft:asciillager
(던전스에서 나오는 룬 글꼴) 중에서 선택할 수 있다. 리소스팩으로 추가된 글꼴은 이외의 값을 가진다. - shadow_color: 글자의 그림자 색을 변경한다. RGBA 배열을 따른다.
형식:{"shadow_color":[1.0, 1.0, 1.0, 1.0]}
- 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+). 잘 보면 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
: 책에서만 이용가능하다. 클릭시 이벤트 값에 있는 페이지로 이동한다.: 보안 상 이유로 1.8부터 제거되었다. 기능 자체는 남아있어 스크린샷을 찍고 파일명을 클릭하면 나타나는 것이 이것이다.open_file
: 1.9부터 Twitch 지원이 제거되었다. 클릭시 트위치 사용자 정보 GUI 화면이 열린다.twitch_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/ 이 사이트에서 손쉽게 편집이 가능하다.