월드 로직 type 목록

이 문서는 등록부에서 자동으로 만듭니다. 손으로 고치지 않습니다.

트리거

구역

enter — 구역에 들어올 때

플레이어 발이 trigger 구역 밖 → 안

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger

이벤트 플러그인: core.zone

leave — 구역에서 나갈 때

안 → 밖

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger

이벤트 플러그인: core.zone

inside — 구역 안에 있는 동안

들어온 뒤 every 초마다(들어온 순간은 아님)

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger
every	Number		1	간격(초)

이벤트 플러그인: core.zone

액터

interact — 액터 우클릭

display·text 액터 또는 상호작용 컴포넌트(trigger 상자)를 우클릭(에디터 플레이: 바라보고 F 또는 우클릭)

필드	형식	필수	기본값	설명
actor	Actor	예		액터 — 액터: display · text · trigger

이벤트 플러그인: core.actor

anim_finished — 시퀀스가 끝나면

anim_play 로 재생한 클립이 끝까지 갔을 때(anim_stop 으로 멈추면 아님). 클립을 비우면 아무 클립이나 — 재생한 규칙의 트리거한 사람을 이어받음

필드	형식	필수	기본값	설명
anim	Anim			클립

이벤트 플러그인: core.actor

흐름

timer — 타이머(전역)

씬이 켜진 뒤 every 초마다 — 트리거한 사람 없음

필드	형식	필수	기본값	설명
every	Number		10	간격(초)

이벤트 플러그인: core.flow

start — 씬 시작

씬을 불러올 때 한 번(에디터: ▶ 플레이 시작)

이벤트 플러그인: core.flow

signal — 신호를 받을 때

다른 규칙의 signal 동작이 보냄(보낸 규칙의 플레이어를 이어받음)

필드	형식	필수	기본값	설명
name	Signal	예		신호 이름

이벤트 플러그인: core.flow

변수 · 함수

function — 함수

스스로 일어나지 않음 — call · sequence · branch · repeat · for_each_player 동작이 부름(부른 쪽의 플레이어를 이어받음). 조건이 거짓이면 그 함수는 건너뜀

필드	형식	필수	기본값	설명
name	Function	예		함수 이름
params	Text			인자 이름 — 쉼표로(예: amount, target) — 부를 때 준 값이 지역 변수 {amount} 로

이벤트 플러그인: core.vars

충돌

collide — 부딪힐 때

플레이어 몸(0.6×1.8)이 액터 상자에 닿을 때(틈 0.05 이하) — 플레이어마다, 떨어졌다 다시 닿으면 다시

필드	형식	필수	기본값	설명
actor	Actor	예		상자(blocker·trigger·display) — 액터: blocker · trigger · display
cooldown_ticks	Number		10	다시 발동까지(틱) — 20틱 = 1초. 닿음이 끝난 뒤 다시 닿아야 또 발동

이벤트 플러그인: np.collision

projectile_hit — 투사체가 맞을 때

플레이어가 쏜 투사체가 액터 상자 안 블록·엔티티에 맞을 때(트리거한 사람 = 쏜 사람). 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
actor	Actor	예		상자(blocker·trigger·display) — 액터: blocker · trigger · display
projectile	Enum		any	투사체 — 선택지: any · arrow · trident · snowball · egg · fireball · potion

이벤트 플러그인: np.collision

블록

block_break — 블록을 부술 때

플레이어가 구역 안(또는 고른 블록 · 어디서나)에서 맞는 블록을 부숨. 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
area	Enum		zone	어디서 — zone = 구역(trigger 액터) 안 · blocks = 고른 블록 칸만(선택 영역으로 지정) · anywhere = 어디서나(월드 전체) — 선택지: zone · blocks · anywhere
actor	Actor	예		구역 — 액터: trigger — area=zone 일 때만
cells	Cells	예		고른 블록 — 뷰포트에서 블록을 고른 뒤 「선택 영역으로」 — area=blocks 일 때만
block	Block			블록(비면 아무거나) — minecraft:oak_log 또는 #minecraft:logs

이벤트 플러그인: np.blocks

block_place — 블록을 놓을 때

플레이어가 구역 안(또는 고른 블록 · 어디서나)에 맞는 블록을 놓음. 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
area	Enum		zone	어디서 — zone = 구역(trigger 액터) 안 · blocks = 고른 블록 칸만(선택 영역으로 지정) · anywhere = 어디서나(월드 전체) — 선택지: zone · blocks · anywhere
actor	Actor	예		구역 — 액터: trigger — area=zone 일 때만
cells	Cells	예		고른 블록 — 뷰포트에서 블록을 고른 뒤 「선택 영역으로」 — area=blocks 일 때만
block	Block			블록(비면 아무거나) — minecraft:oak_log 또는 #minecraft:logs

이벤트 플러그인: np.blocks

block_interact — 블록을 우클릭할 때

플레이어가 구역 안(또는 고른 블록 · 어디서나) 맞는 블록을 우클릭(버튼·레버·상자 …). 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
area	Enum		zone	어디서 — zone = 구역(trigger 액터) 안 · blocks = 고른 블록 칸만(선택 영역으로 지정) · anywhere = 어디서나(월드 전체) — 선택지: zone · blocks · anywhere
actor	Actor	예		구역 — 액터: trigger — area=zone 일 때만
cells	Cells	예		고른 블록 — 뷰포트에서 블록을 고른 뒤 「선택 영역으로」 — area=blocks 일 때만
block	Block			블록(비면 아무거나) — minecraft:oak_log 또는 #minecraft:logs

이벤트 플러그인: np.blocks

redstone — 레드스톤 신호

구역 안 블록의 레드스톤 세기가 0↔0보다 큼으로 바뀜 — 트리거한 사람 없음. 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger
edge	Enum		rising	언제 — rising = 켜질 때 · falling = 꺼질 때 · both = 바뀔 때 — 선택지: rising · falling · both

이벤트 플러그인: np.blocks

전투

death — 플레이어가 죽을 때

플레이어가 죽음(구역을 주면 그 안에서) — 트리거한 사람 = 죽은 사람. 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
actor	Actor			구역(비면 어디서나) — 액터: trigger

이벤트 플러그인: np.combat

damage — 피해를 입을 때

플레이어가 그 원인으로 min 이상 피해를 입음(구역을 주면 그 안에서). 에디터 플레이: 「발동」 버튼

플레이 미리보기에서 스스로 일어나지 않음 — 「발동」 버튼으로 일으킵니다.

필드	형식	필수	기본값	설명
actor	Actor			구역(비면 어디서나) — 액터: trigger
cause	Enum		any	원인 — 선택지: any · fall · fire · lava · drown · entity · projectile · void
min	Number		0	최소 피해(HP)

이벤트 플러그인: np.combat

조건

월드

time — 시간대

낮 = 06~18시

필드	형식	필수	기본값	설명
value	Enum		day	때 — 선택지: day · night

이벤트 플러그인: core.world

weather — 날씨

필드	형식	필수	기본값	설명
value	Enum		clear	날씨 — 선택지: clear · rain · thunder

이벤트 플러그인: core.world

permission — 권한

필드	형식	필수	기본값	설명
node	Text	예		권한 노드

이벤트 플러그인: core.world

흐름

flag — 플래그

필드	형식	필수	기본값	설명
name	Flag	예		플래그
value	FlagValue		true	값 — 없는 플래그 = false

이벤트 플러그인: core.flow

chance — 확률

필드	형식	필수	기본값	설명
value	Number		0.5	확률(0~1)

이벤트 플러그인: core.flow

구역

players_inside — 구역 안 인원

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger
min	Number		1	최소
max	Number		-1	최대(-1 = 끝없음)

이벤트 플러그인: core.zone

변수 · 함수

compare — 비교

필드	형식	필수	기본값	설명
left	Text	예	{score}	왼쪽 — 식 — {변수} · 수 · + - * / %
op	Enum		==	비교 — == != < <= > >= (수) · contains · starts_with (글) — 선택지: == · != · < · <= · > · >= · contains · starts_with
right	Text		10	오른쪽 — 식

이벤트 플러그인: core.vars

전투

holding — 손에 든 것

트리거한 사람이 그 아이템을 들고 있음(에디터 플레이: 「가짜 플레이어」의 손)

필드	형식	필수	기본값	설명
item	Item	예		아이템 — minecraft:diamond_sword 또는 #minecraft:swords
hand	Enum		main	손 — main = 오른손 · off = 왼손 · any = 아무 손 — 선택지: main · off · any

이벤트 플러그인: np.combat

gamemode — 게임 모드

트리거한 사람의 게임 모드

필드	형식	필수	기본값	설명
value	Enum	예	survival	모드 — 선택지: survival · adventure · creative · spectator

이벤트 플러그인: np.combat

동작

월드

sound — 소리

필드	형식	필수	기본값	설명
event	SoundEvent	예		소리 이벤트
at	Actor			자리(액터) — 비면 트리거한 사람 자리
volume	Number		1	크기
pitch	Number		1	높낮이
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: core.world

particle — 파티클

필드	형식	필수	기본값	설명
particle	Particle	예	minecraft:happy_villager	파티클
at	Actor			자리(액터) — 비면 트리거한 사람 자리
count	Number		10	개수

이벤트 플러그인: core.world

command — 서버 명령

콘솔 명령 — 서버 설정에서 운영자가 켜야 실행됨(기본 꺼짐). 에디터는 실행하지 않고 기록만

필드	형식	필수	기본값	설명
command	Text	예		명령(/ 없이)

이벤트 플러그인: core.world

액터

anim_play — 애니메이션 재생

필드	형식	필수	기본값	설명
anim	Anim	예		클립
audience	Enum		player	컷신 보는 사람 — 시퀀서 칸(카메라 컷·제목·소리·페이드)을 볼 사람: player = 트리거한 사람(없으면 월드 전부) · inside · world · radius. 액터 움직임은 늘 모두에게 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만
wait	Bool		false	끝날 때까지 기다림 — 켜면 다음 동작은 클립이 끝난 뒤(반복 클립이면 한 바퀴)

이벤트 플러그인: core.actor

anim_stop — 애니메이션 멈춤

그 자리에 멈춤(이벤트 키 · 끝남 신호도 멈춤)

필드	형식	필수	기본값	설명
anim	Anim	예		클립

이벤트 플러그인: core.actor

actor_show — 액터 보이기

필드	형식	필수	기본값	설명
actor	Actor	예		액터 — 액터: display · text · light · sound

이벤트 플러그인: core.actor

actor_hide — 액터 숨기기

필드	형식	필수	기본값	설명
actor	Actor	예		액터 — 액터: display · text · light · sound

이벤트 플러그인: core.actor

teleport — 순간이동

트리거한 사람을 그 액터 자리·방향으로

필드	형식	필수	기본값	설명
to	Actor	예		도착(spawn·camera) — 액터: spawn · camera

이벤트 플러그인: core.actor

checkpoint — 체크포인트

v1 추가: 트리거한 사람의 되살아날 자리를 그 spawn 액터 자리·방향으로(서버가 플레이어별로 기억). 에디터 플레이는 기록만

필드	형식	필수	기본값	설명
to	Actor	예		되살아날 자리(spawn) — 액터: spawn

이벤트 플러그인: core.actor

cinematic — 시네마틱 카메라

보는 사람을 잠시 관전 모드로 카메라에 태워 카메라 액터들(또는 path)을 차례로 지남 — Shift 로 끝냄. 에디터 ▶ 플레이·시뮬레이트: 뷰포트 카메라로 미리보기(끝나면 원래 시점)

필드	형식	필수	기본값	설명
cameras	ActorList			카메라들(차례로) — camera 액터 id 목록 — 비면 씬의 camera 액터 전부(목록 순서). path 가 있으면 무시 — 액터: camera
path	Actor			경로(path) — 있으면 카메라 대신 — path 액터 점을 따라(눈 높이 = props eye_height 1.6, pitch = props pitch 10, 진행 방향을 봄) — 머묾 0 — 액터: path
hold	Number		2	지점마다 머묾(초) — 비면 서버 설정 cinematic.hold-seconds(기본 2)
travel	Number		4	다음 지점까지(초) — 비면 서버 설정 cinematic.travel-seconds(기본 4) — smoothstep
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: core.actor

화면

title — 화면 제목

필드	형식	필수	기본값	설명
title	Text			제목
subtitle	Text			부제목
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: core.ui

message — 채팅 메시지

필드	형식	필수	기본값	설명
text	Text	예		글
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: core.ui

actionbar — 액션바 글

필드	형식	필수	기본값	설명
text	Text	예		글
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: core.ui

흐름

set_flag — 플래그 정하기

필드	형식	필수	기본값	설명
name	Flag	예		플래그
value	FlagValue		true	값

이벤트 플러그인: core.flow

signal — 신호 보내기

필드	형식	필수	기본값	설명
name	Signal	예		신호 이름

이벤트 플러그인: core.flow

wait — 기다리기

다음 동작을 이만큼 늦춤

필드	형식	필수	기본값	설명
seconds	Number		1	초

이벤트 플러그인: core.flow

구역

place_blocks — 블록 채우기

trigger 구역 상자를 그 블록으로(서버가 원래 블록을 기억 — restore_blocks 로 되돌림)

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger
block	Block	예	minecraft:stone	블록

이벤트 플러그인: core.zone

restore_blocks — 블록 되돌리기

필드	형식	필수	기본값	설명
actor	Actor	예		구역 — 액터: trigger

이벤트 플러그인: core.zone

변수 · 함수

set_var — 변수 정하기

필드	형식	필수	기본값	설명
name	Flag	예		변수
scope	Enum		auto	범위 — auto = 선언대로(없으면 지역 변수가 있으면 지역, 아니면 전역) · player = 트리거한 사람마다 · local = 이 실행 안에서만 — 선택지: auto · global · player · local
op	Enum		set	계산 — set = 값 · add/sub/mul/div/mod/min/max = 수 계산 · append = 글 붙이기 · toggle = 참거짓 뒤집기 — 선택지: set · add · sub · mul · div · mod · min · max · append · toggle
value	Text		1	값 — 식 — {변수} · {player} · 수 · + - * / %

이벤트 플러그인: core.vars

call — 함수 부르기

함수 규칙을 실행하고 끝나면(wait 포함) 다음 동작

필드	형식	필수	기본값	설명
function	Function	예		함수
args	Text			인자 — 이름=식, 쉼표로(예: amount=5, who={player})

이벤트 플러그인: core.vars

sequence — 순서대로(시퀀스)

블루프린트의 Sequence: 함수 여러 개를 차례로

필드	형식	필수	기본값	설명
functions	Function	예		함수들 — 쉼표로 — 앞 함수가 끝나면(wait 포함) 다음 함수

이벤트 플러그인: core.vars

branch — 갈림(만약)

비교해서 함수 하나를 부름(끝나면 다음 동작)

필드	형식	필수	기본값	설명
left	Text	예	{score}	왼쪽 — 식
op	Enum		>=	비교 — 선택지: == · != · < · <= · > · >= · contains · starts_with
right	Text		10	오른쪽 — 식
then	Function			참이면 — 부를 함수(비면 아무것도 안 함)
else	Function			거짓이면 — 부를 함수(비면 아무것도 안 함)

이벤트 플러그인: core.vars

repeat — 되풀이

함수를 횟수만큼 차례로(앞 번이 끝나면 다음 번)

필드	형식	필수	기본값	설명
count	Number		3	횟수
function	Function	예		함수 — 지역 변수 {index} = 0, 1, 2 …

이벤트 플러그인: core.vars

for_each_player — 플레이어마다

받는 사람마다 함수를 차례로

필드	형식	필수	기본값	설명
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만
function	Function	예		함수 — 그 플레이어가 트리거한 사람 — {player}

이벤트 플러그인: core.vars

충돌

knockback — 밀쳐내기

트리거한 사람을 기준 액터 가운데에서 먼 쪽으로 밈

필드	형식	필수	기본값	설명
strength	Number		1	세기 — 수평 속도(블록/틱 — Bukkit velocity). 1 ≈ 2~3블록
from	Actor			기준 액터 — 비면 트리거 액터 가운데
up	Number		0.4	위로 — 위 속도(블록/틱)
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: np.collision

블록

cancel — 이벤트 취소

부수기·놓기·우클릭·피해·투사체를 없던 일로(그 규칙의 맨 앞 동작일 때만 — wait 전). 그 밖에는 아무 일도 안 함

이벤트 플러그인: np.blocks

set_block — 블록 하나 놓기

필드	형식	필수	기본값	설명
at	Actor			자리(액터) — 그 액터 가운데 칸 — 비면 pos
pos	Vec3			자리(좌표) — [x,y,z] — scene.json 기준(건물 최소 모서리) 좌표, at 이 없을 때
block	Block	예	minecraft:stone	블록

이벤트 플러그인: np.blocks

전투

damage — 피해 주기

트리거한 사람에게 피해(creative·spectator 는 안 받음)

필드	형식	필수	기본값	설명
amount	Number	예	2	피해(HP, 하트 1 = 2)
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: np.combat

heal — 회복

필드	형식	필수	기본값	설명
amount	Number		20	회복(HP)
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: np.combat

effect — 포션 효과

필드	형식	필수	기본값	설명
effect	Effect	예	minecraft:speed	효과 — minecraft:speed · minecraft:jump_boost · minecraft:regeneration …
seconds	Number		10	초
amplifier	Number		0	세기(0 = I)
particles	Bool		true	입자 보임
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: np.combat

give — 아이템 주기

필드	형식	필수	기본값	설명
item	Item	예		아이템 — minecraft:diamond
count	Number		1	개수
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: np.combat

kill — 죽이기

트리거한 사람을 죽임

필드	형식	필수	기본값	설명
audience	Enum		player	누구에게 — player = 트리거한 사람 · inside = 구역 안 전부 · world = 월드 전부 · radius = at 에서 r 블록 안 — 선택지: player · inside · world · radius
at	Actor			기준 액터 — 비면 트리거한 사람 자리 — audience=radius 일 때만
r	Number		16	반경(r) — audience=radius 일 때만

이벤트 플러그인: np.combat

관련 문서

• 월드 로직
• 로직 그래프
• 변수 · 함수 · 데이터타입
• scene.json 형식
• 월드 로직 type 추가