1. 개요
| <colbgcolor=#47A0FF> scoreboard | |
scoreboard <objectives|players> ...
|
|
| <colcolor=#fff> 역사 |
JE | [ruby(1.5,ruby=추가)] / [ruby(1.13, ruby=변경)] / [ruby(1.20.3, ruby=변경)] BE | [ruby(Bata 1.7.0.2,ruby=추가)] EE | ? |
| 기능 | 스코어보드를 관리한다. |
| 관련 명령어 |
trigger |
team
|
| 단축 명령어 | - |
| 기본값 | - |
| <rowcolor=#fff> 싱글 사용 | 권한 |
| 가능 | 2(JE), 1(BE) |
scoreboard players ... 문법은 스코어보드의 점수를 조작할 때 사용하는 명령어이며, scoreboard objectives ... 문법은 점수가 아닌 스코어보드 자체를 조작할 때 사용하는 명령어이다.
execute와 함께 명령어의 양대산맥이다.[1]2. JE
문법은 크게 두가지로 나눈다. 점수는유형이므로 -2,147,483,648 ~ 2,147,483,647 값만 사용할 수 있다.
2.1. objectives(목표)
모든 문법은/scoreboard objectives ...로 시작한다.-
... add <목표> <기준> [보이는 목표(JSON)] -
<목표>를<기준>에 따라 추가한다.<기준>에 대한 설명은 기준 문단에 따로 설명한다. -
... list - 생성된 모든 스코어보드를 채팅창에 표시한다.
-
... modify <목표> ... -
... <displayautoupdate> <값> -
점수가 업데이트될 때마다 표시 이름이 자동으로 업데이트되는지 여부. 기본값은
false이다. -
... <displayname> <JSON> - 보이는 목표를 설정한다. raw JSON 형식으로 작성한다.
-
... <numberformat> [blank|fixed|styled] -
빨간색 숫자의 표시를 결정한다.
[blank|fixed|styled]을 생략하면styled {"color":"red"}로 지정한다. -
[blank] - 모든 숫자를 숨긴다.
-
[fixed] <JSON> - 모든 숫자를 고정한다. raw JSON 형식으로 작성한다.
-
[styled] <JSON> - 모든 숫자를 스타일에 따라 작성한다. text JSON 형식으로 작성한다.
-
... <rendertype> <hearts|integer> -
... setdisplay list <이름>으로 설정할 경우 상태가 변한다. 그렇지 않을 경우 아무 일도 일어나지 않는다. -
hearts로 할 경우 플레이어 리스트에 하트가 보이게 하고,integer로 할 경우 숫자로 보여지게 한다. -
... remove <목표> -
존재하는 스코어보드 중에서
<목표>스코어보드를 삭제한다.[2] 만약setdisplay를 통해 화면에 스코어보드가 보이는 상태였을 경우, 해당 스코어보드는 더 이상 보이지 않게 된다.[3] -
... setdisplay <슬롯> [목표] -
[목표]를 해당<슬롯>에 보이게 한다.[목표]를 비워두면 슬롯을 숨기게 된다.
2.1.1. 기준
- dummy
- 명령어로만 변경할 수 있다.
- trigger
-
명령어와
trigger명령어로만 변경할 수 있다. - air
-
모든 플레이어의
숨을 참고 있는 시간(
Air)을 반영한다. - armor
- 모든 플레이어의 방어력 수치를 반영한다.
- deathCount
- 플레이어가 사망할 때마다 1씩 증가한다.
- food
-
모든 플레이어의
허기 수치(
foodLevel)를 반영한다. - health
-
모든 플레이어의
체력(
Health)과 흡수(AbsorptionAmount)를 더해 반영한다. - killedByTeam.<색>
- 같은 팀에게 살해당했을 때 증가한다. 즉 팀킬당한 횟수이다.
- level
-
모든 플레이어의
레벨 수치(
XpLevel)를 반영한다. - minecraft.<기준>:minecraft.<하위 기준>
- <기준>
-
broken:
<하위 기준>아이템이 파괴될 때마다 값이 증가한다.<하위 기준>아이템은 모든 아이템에 사용할 수 있으나 실질적으로 내구도가 있는 모든 아이템만 가능하다. -
crafted:
<하위 기준>아이템이 제작, 재련, 주민 거래로 얻을 때마다 값이 증가한다. -
custom:
<하위 기준>은 통계에 있는 어떠한 행동에 따라 값이 증가한다. -
dropped:
<하위 기준>아이템이 버릴 때마다 값이 증가한다. -
killed:
<하위 기준>개체가 죽일 때마다 값이 증가한다. -
killed_by:
<하위 기준>개체에 의해 사망할 때마다 값이 증가한다. -
mined:
<하위 기준>블록을 파괴될 때마다 값이 증가한다. 크리에이티브 모드인 플레이어는 이 값이 절대로 증가하지 않는다. -
picked_up:
<하위 기준>아이템을 주울 때마다 값이 증가한다. -
used:
<하위 기준>아이템이 사용될 때마다 값이 증가한다. - playerKillCount
- 플레이어가 다른 플레이어를 처치할 때마다 값이 증가한다.
- teamkill.<색>
- 각각의 색을 가진 팀원이 다른 팀원을 죽이면 값이 증가한다.
- xp
- 플레이어가 마지막 사망 이후 총 획득한 경험치(즉, 사망할 때 나오는 점수)를 반영한다.
2.1.2. 슬롯
마인크래프트 화면 상에<목표>을 표시할 곳(슬롯)은 3곳이 있다.- below_name
- 플레이어 위에 있는 이름 밑에 점수가 표시된다. 플레이어가 10블록 너머에 있거나 은신(웅크리기)할 시 보이지 않는다.
- list
-
tab키를 누르면 나오는 리스트. 플레이어 이름 오른쪽에 노란 글씨로 숫자가 표시된다. - sidebar
- 화면 오른쪽에 표시된다. 플레이어가 오프라인이라도 표시된다.
- sidebar.team.<색>
-
sidebar와 같지만 색깔 별로 정해진 팀을 표시한다. 예를 들어
sidebar.team.red라 쓰면 red 팀에 소속된 플레이어들의 점수가 표시된다.
2.2. players(플레이어)
모든 문법은/scoreboard players ...로 시작한다.-
... get <대상> <목표> -
<목표>에 있는<대상>의 점수를 확인한다. -
... add <대상> <목표> <수> -
<목표>에 있는<대상>의 점수를<수>만큼 증가시킨다. -
... set <대상> <목표> <수> -
<목표>에 있는<대상>의 점수를<수>로 설정한다. -
... remove <대상> <목표> <수> -
<목표>에 있는<대상>의 점수를<수>만큼 감소시킨다. -
... enable <대상> <기준이_trigger로_설정된_목표> -
<대상>이trigger명령을 통해 점수를 수정할 수 있도록 한번 허락한다. -
... list [대상] -
스코어보드에 의해 영향을 받는 개체를 모두 표시한다.
[대상]을 쓰면 특정[대상]의 점수를 확인할 수 있다. -
... reset <대상> [목표] -
<대상>의 모든 점수를 삭제한다.[목표]를 쓰면 그[목표]의 점수만 삭제한다. 0으로 만드는 것이 아니다. -
... operation <대상이름> <대상목표> <연산> <선택자> <목표> -
<목표>에 있는<선택자>의 점수를 이용해서,<대상목표>에 있는<대상이름>의 점수에 대해<연산>을 실행시킨다. -
<연산>은 아래와 같다. - "+=": 선택자의 점수를 대상의 점수에 더한다.
- "-=": 뺀다.
- "*=": 곱한다.
- "/=": 나눈다. 나머지는 버린다.
- "%=": 나눗셈 결과의 나머지를 대상의 점수로 한다.
- "=": 대상의 점수를 선택자의 점수와 같게 한다.
- "<": 만약 선택자의 점수가 대상보다 작으면, 대상의 점수를 선택자 점수로 만든다.
- ">": 만약 선택자의 점수가 대상보다 크면, 대상의 점수를 선택자 점수로 만든다.
- "><": 대상과 선택자의 점수를 바꾼다.
-
... display <name|numberformat> ... -
... name <대상> <목표> [이름] -
<목표>에 있는<대상>의 이름을[이름]으로 설정한다. JSON 형식으로 작성한다.[이름]을 비워두면 되돌린다. -
... numberformat <대상> <목표> [blank|fixed|styled] ... -
<목표>에 있는<대상>의 숫자 표시를 수정한다.[blank|fixed|styled]을 생략하면/scoreboard objectives modify <목표> numberformat에 지정된 값으로 되돌린다. -
[blank] -
<대상>의 숫자를 숨긴다. -
[fixed] <JSON> -
<대상>의 숫자를 고정한다. raw JSON 형식으로 작성한다. -
[styled] <JSON> -
<대상>의 숫자를 스타일에 따라 작성한다. text JSON 형식으로 작성한다.
2.3. 예시
2.3.1. 체력 표시
플레이어의 이름 밑에 체력을 표시한다. 멀티 플레이 시 상대방 체력을 확인할 수 있게 만들 수 있으며,[4] 전투 서버라면 팀끼리만 보이고 적은 보이지 않게 추가적으로 설정할 수도 있다./scoreboard objectives add <이름> health/scoreboard objectives setdisplay below_name <이름>2.3.2. 살인 횟수
호전적인 플레이어를 시스템적으로 가려낼 수 있다. 플레이어 외의 다른 동물들을 기준으로 하면 얼마나 사냥을 열심히 했는지 지표로 사용할 수 있다. 아래 명령어는 탭(Tab) 키를 눌렀을 때 나오는 리스트에 숫자가 표시되게 하였으나, 기준만 만들고 나서 필요할 때만 불러올 수도 있다.[5] 아예 리스트가 번갈아 나오게 할 수도 있다./scoreboard objectives add <이름> playerKillCount/scoreboard objectives setdisplay list <이름>모든 플레이어의 수치를 초기화할 시
/scoreboard players reset @a[6] <이름> [7]2.3.3. 사망 횟수
사망 횟수를 사용해 죽을 시 관전자 모드가 되게 하거나 죽은 횟수를 볼 수 있다./scoreboard objectives add <이름> deathCount관전자 모드로 변경할 시:
/gamemode spectator @a[scores={<이름>=1}]모든 플레이어의 수치를 초기화할 시
/scoreboard players reset @a <이름>2.3.4. 당근 낚싯대로 텔레포트
당근 낚싯대를 우클릭했을 시 점수가 올라간다. 이것을 이용해서 지정된 장소로 텔레포트할 수 있다./scoreboard objectives add <이름> minecraft.used:minecraft.carrot_on_a_stick/execute as @a[scores={<이름>=1..}] at @s run tp @s <좌표>/scoreboard players set @a[scores={<이름>=1..}] <이름> 0[8]좌표에 ^ ^ ^15를 넣을 시 자신이 바라보는 방향으로 15칸 이동해 먼 거리를 편하게 이동할 수 있다.
3. BE
3.1. objectives(목표)
모든 문법은/scoreboard objectives ...로 시작한다.-
... add <목표> dummy [보이는 목표(JSON)] -
<목표>를 추가한다. -
... remove <목표> -
<목표>스코어보드를 삭제한다. 삭제하려는 스코어보드가 있어야 한다. -
... setdisplay <list|sidebar> [목표] [ascending|descending] -
<리스트|사이드바>로 표시하고, [오름차순|내림차순]으로 [목표]를 표시한다. -
... setdisplay belowname [목표]
3.2. players(플레이어)
모든 문법은/scoreboard players ...로 시작한다.-
... add <대상> <목표> <수> -
<목표>에 있는<대상>의 점수를<수>만큼 증가시킨다. -
... set <대상> <목표> <수> -
<목표>에 있는<대상>의 점수를<수>로 설정한다. -
... remove <대상> <목표> <수> -
<목표>에 있는<대상>의 점수를<수>만큼 감소시킨다. -
... random <대상> <목표> <최소값> <최대값> -
<목표>에 있는<대상>의 점수를<최소값>과<최대값>(둘 다 포함) 사이의 임의의 숫자로 설정한다. -
... list [대상] -
스코어보드에 의해 영향을 받는 개체를 모두 표시한다.
[대상]을 쓰면 특정[대상]의 점수를 확인할 수 있다.
3.3. team(팀)
3.4. 예시
3.4.1. 임의의 좌표에 다이아몬드 광석 배치하기
/scoreboard players random을 이용해 갑옷 거치대를 임의의 좌표로 이동시킨 다음, 해당 위치에 다이아몬드 광석을 배치한다. 단, BE에서는 NBT 태그를 다룰 수 없으므로, 갑옷 거치대를 이동시키는데 약간의 노가다가 필요하다.먼저
random의 결과를 저장할 목표 하나를 생성한다. /scoreboard objectives add r dummy그 다음, 갑옷 거치대를 원하는 위치에 소환한 후
random을 실행하고 그 결과에 따라 갑옷 거치대를 텔레포트시키는 과정을 반복한다. /summon armor_stand <spawnPos: x y z> /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~1 ~ ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~2 ~ ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~4 ~ ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~8 ~ ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~1 ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~2 ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~4 ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~8 ~ /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~ ~1 /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~ ~2 /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~ ~4 /scoreboard players @e[type=armor_stand] random r 0 1 /execute as @e[type=armor_stand, scores={r=1}] at @s run tp ~ ~ ~8다이아몬드 광석을 놓을 범위에 따라
/scoreboard players random과 /execute tp를 반복 실행한다. 한 번 실행할 때마다 범위가 2배가 된다.마지막으로 해당 위치에 다이아몬드 광석을 놓고 갑옷 거치대를 없앤다.
/fill의 [replace] 옵션을 이용해 심층암 다이아몬드 광석도 생성하거나, /structure의 [integrity] 옵션을 이용해 다이아몬드 원석의 개수를 조절할 수 있다./execute as @e[type=armor_stand] at @s run fill ~ ~ ~ ~1 ~1 ~1 diamond_ore/kill @e[type=armor_stand]
[1]
과장이 아니라, scoreboard 하나 만으로도 점수, 아이템 수, 죽은 횟수, 타이머 등 유동수치와 관련된 모든 것들을 구현할 수 있다.
[2]
해당 스코어보드에 있었던 모든 점수는 다 사라지므로 주의.
[3]
해당 스코어보드의 목록이 비어 있게 보이는 게 아니라, 아예 해당 스코어보드 자체가 보이지 않게 된다.
[4]
은신(웅크리기, 기본 키는 Shift 키) 시 숨겨진다.
[5]
혹은 tellraw, title 명령어와 혼합하여 더 깔끔하게 만들 수도 있지만 그건 커맨드에 숙련되지 않고서는 힘들다.
[6]
특정 플레이어 수치만 초기화시키려면 플레이어 닉네임을 쓰면 된다.
[7]
단순히 0으로만 만들 것이라면 /scoreboard players set @a <이름> 0 으로 해도 된다.
[8]
연쇄, 무조건적. 이 커맨드가 빠질 시 재사용이 불가하다.