마인크래프트/명령어/JSON 문법

분류

마인크래프트/명령어

상위 문서: 마인크래프트/명령어

1. 개요

2. 참고

3. 문법

3.1. JE

3.1.1. 글씨 효과

3.1.2. 클릭 이벤트

3.1.3. 호버 이벤트

3.2. BE

2 . 참고[편집]

이 사이트를 참고하는 것을 추천한다.

참고로 이 사이트를 이용해 쉽게 JSON 문법을 이용한 명령어를 만들 수 있다.

3 . 문법[편집]

["",{"객체":"내용","다음 객체":"다음 내용",...},{"객체":"내용","다음 객체":"다음 내용",...}]

이때 큰따옴표, 중괄호, 쉼표, 콜론(:)이 하나라도 빠지면 제대로 실행되지 않을 것이다. 내용이

true

나

false

가 아니면 항상 객체와 내용 양 옆에 큰따옴표를 붙여야 한다는 것을 잊어서는 안 된다.

만약 큰따옴표 안에 큰따옴표나 콜론이나 역슬래시(\\)를 쓰고 싶다면, 앞에 역슬래시를 써줘 이스케이프 하면 된다.

\uXXXX

(유니코드 16진수 숫자 4자리)나

\n

,

\t

같은 것도 되긴 하지만 제대로 표시되지 않는 경우가 많다.

이때, 유니코드 16진수 숫자 4자리를 사용할 때는

\uXXXX

자체가 하나의 문자이기 때문에 앞에 역슬래시를 붙여서는 안된다.

예	입력	결과
옳은 예	`"text": "안녕하세요 \u4e16"`	안녕하세요 世
틀린 예	`"text": "안녕하세요 \\u4e16"`	안녕하세요 \\u4e16

3.1 . JE[편집]

마인크래프트에서 tellraw, title 등의 명령어에서 사용한다.
{"이름":"내용"}의 형식으로 작성한다.

예) 빨간색의

hi

라는 글
{"text":"hi","color":"red"}

안녕!

이라는 굵은 글자를 출력하고, 클릭하면

반가워!

가 출력
{"text":"안녕!","bold":true,"clickEvent":{"action":"run_command","value":"/say 반가워!"}}

안녕

난

위키러야!

["",{"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: 마인크래프트 게임 내의 번역 문자열을 출력한다. 번역 문자열의 목록은
```
assets\minecraft\lang\en_us.json
```
에 있다.

형식:

{"translate":"번역 문자열"}

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(기본 글꼴) 중에서 선택할 수 있다. 리소스팩으로 추가된 글꼴은 이외의 값을 가진다.
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]
16진수이다.
. 잘 보면 ANSI 이스케이프 코드 표준의 SGR 색상 설정 부분 특수화라고 볼 수 있다. 어쩌면 마인크래프트의 텍스트 출력이라는 것이 터미널과 유사성을 가지고 있기도 하다.

형식:

{"color":"색깔"}

어두운 색상 이름

밝은 색상 이름

black

gray

dark_red

red

dark_green

green

gold

yellow

dark_blue

blue

dark_purple

light_purple

dark_aqua

aqua

dark_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_file~~: 보안 상 이유로 1.8부터 제거되었다. 코드 자체는 최신 버전까지 남아있어 스크린샷 찍고 클릭하면 나타나는 것이 이것이다.
~~twitch_user_info~~: 1.9부터 Twitch 지원이 제거되었다. 클릭시 트위치 사용자 정보 GUI 화면이 열린다.

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[편집]

BE의 경우에는

titleraw

명령어에서 JSON 문법을 사용하며, 객체 목록은 JE와 같다. *text *selector *score 등등이 가능해졌지만 여전히 클릭, 호버이벤트는 지원을 안하고 있다. 추후 업데이트때 나올가능성도 있다. 단, BE의 경우 JSON 문법에 다음과 같은 처리를 해야 한다.

{"rawtext":[JSON]}

이 문서의 내용 중 전체 또는 일부는 2023-11-27 00:54:03에 나무위키 마인크래프트/명령어/JSON 문법 문서에서 가져왔습니다.

[1] https://www.minecraftjson.com/ 이 사이트에서 손쉽게 편집이 가능하다.[2] 16진수이다.

마인크래프트/명령어/JSON 문법

분류

1 . 개요[편집]

2 . 참고[편집]

3 . 문법[편집]

3.1 . JE[편집]

3.1.1 . 글씨 효과[편집]

3.1.2 . 클릭 이벤트[편집]

3.1.3 . 호버 이벤트[편집]

3.2 . BE[편집]

관련 문서

마인크래프트/명령어/JSON 문법

분류

1. 개요[편집]

2. 참고[편집]

3. 문법[편집]

3.1. JE[편집]

3.1.1. 글씨 효과[편집]

3.1.2. 클릭 이벤트[편집]

3.1.3. 호버 이벤트[편집]

3.2. BE[편집]

관련 문서

1 . 개요[편집]

2 . 참고[편집]

3 . 문법[편집]

3.1 . JE[편집]

3.1.1 . 글씨 효과[편집]

3.1.2 . 클릭 이벤트[편집]

3.1.3 . 호버 이벤트[편집]

3.2 . BE[편집]