게임메이커/액션

1. 들어가기 전에

• 게임메이커: 스튜디오(GMS)를 우선하여 작성하였다.
• 액션의 이름은 액션을 갖다 놓았을 때 열리는 창 이름으로 한다. 별도의 창이 없을 경우 아이콘에 마우스를 올려놓았을 때의 툴팁 이름을 사용한다.
• 이 문서의 모든 액션 아이콘은 게임메이커 8.x(GM8) 아이콘이다.
• 액션별로 아이콘의 모양과 색상이 다르다.

	일반 액션. (이벤트의 조건이 충족됐을 경우) 아무 이벤트에서나 작동한다.
	if문 액션. 이 액션을 쓰고 바로 아래에 실행시킬 액션을 스타트/엔드 블록으로 감싸면 조건이 참일 때 작동한다. Else 액션으로 '바로 위의 조건이 거짓일 경우'도 넣을 수 있다.
	드로우 액션. 대부분 드로우 이벤트에서만 작동한다. 게임메이커: 스튜디오에서는 초록색 테두리로 드로우 액션을 구분할 수 있다.

• 현재 기준(Relative)이라는 것은 그 변수에 추가로 더한다는 의미이다. 예를 들어 변수 a에 1이라고 쓰고 현재 기준을 체크하면, a라는 변수에 1을 더한다. 빼려고 한다면 -1을 넣어주면 된다.
• 맥락에 따라 '현재 기준'의 의미는 조금씩 다른데, x/y가 있는 대부분의 액션에서는 자신의 위치를 기준으로 한다는 의미이고, 기타 변수가 있는 액션에서는 대입하지 않고 가/감산한다는 의미이다.
• if문 액션의 아닐 경우(NOT)이라는 것은 조건이 참이 아니라 거짓일 때 실행된다는 의미이다.
• 거의 모든 코드에는 '적용 대상'(Applies to) 설정이 있는데, 이는 해당 액션의 효과를 누구를 대상으로 적용시킬지 설정하는 메뉴이다. 기본값은 '자신'(Self)이고, 충돌 이벤트 등에서 '기타'(Other)로 설정하면 충돌한 인스턴스에 적용된다. '대상:'(Object:)에서 특정 오브젝트를 선택하면 해당하는 모든 인스턴스에 적용된다.
• 기울임체로 표기된 액션은 별도의 창이 뜨지 않고 액션 영역에 바로 추가된다.
• 대응하는 코드는 '현재 기준'과 '아닐 경우'를 모두 체크하지 않았을 때, GMS 1.x 문법(GM8 액션일 경우 GM8 문법)을 기준으로 한다.
• 4문장 이상의 긴 코드는 접기 문법을 사용하여 숨겨 두었다. 읽으려면 [ 코드 보기 ] 부분을 클릭하면 된다.
• 코드에 따옴표("...")가 있을 경우 따옴표를 반드시 포함해야 한다. 큰따옴표를 쓰든 작은따옴표를 쓰든 양쪽이 맞으면 상관 없다.
• GM8에서는 색상 관련 함수 이름에 color만 사용했지만, GMS부터 colour가 표준이 되었다. color로 바꾸어 써도 잘 동작한다.
• 코드 목록은 게임메이커: 스튜디오 1.x 도움말(영문)

2. Move 탭

2.1. Move

이름	인자	대응 코드	설명
Move Fixed	Directions (9방향 제한) Speed 현재 기준	'Move Free' 참조	9종류(정지 상태 포함)의 방향과 속도를 설정해 특정한 방향으로 이동시킨다.
Move Free	direction speed 현재 기준	direction = (direction); speed = (speed); 혹은 motion_set(direction, speed)	자유롭게 방향과 속도를 설정해 이동시킨다. 위의 Move Fixed와 달리 방향을 숫자로 지정하는데, 각도기의 방향을 생각하면 된다. 0은 오른쪽, 90은 위쪽, 180은 왼쪽, 270은 아래쪽으로, 이는 게임메이커의 다른 각도에도 똑같이 적용된다.
Move Towards	x y speed 현재 기준	move_towards_point(x, y, speed)	특정 좌표를 향해 이동시킨다.
Speed Horizontal	hor. speed 현재 기준	hspeed = (hor. speed);	가로 속도를 지정한다.
Speed Vertical	vert. speed 현재 기준	vspeed = (vert. speed);	세로 속도를 지정한다.
Set Gravity	direction gravity 현재 기준	gravity = (gravity); gravity_direction = (direction);	중력을 설정한다. 방향은 270, 중력은 0.2~0.3 정도가 무난하다.
Reverse Horizontal	-	hspeed = -hspeed;	가로 속도를 반전시킨다. 세로로 된 벽에 튕겨나가는 것을 생각하면 쉽다.
Reverse Vertical	-	vspeed = -vspeed;	세로 속도를 반전시킨다. 가로로 된 벽에 튕겨나가는 것을 생각하면 쉽다.
Set Friction	friction 현재 기준	friction = (friction);	마찰력을 설정한다. 속도가 서서히 떨어지게 할 수 있다. 보통 1 미만으로 설정한다.

2.2. Jump

이름	인자	대응 코드	설명
Jump to Position	x y 현재 기준	x = (x); y = (y);	특정 좌표로 이동한다.
Jump to Start	-	x = xstart; y = ystart;	인스턴스가 처음 생성되었을 때의 좌표로 돌아간다.
Jump to Random	snap hor snap vert	move_random(snap hor, snap vert)	룸 안에 특정한 간격대로 무작위 좌표를 찍어 이동한다.
Align to Grid	snap hor snap vert	move_snap(snap hor, snap vert)	인스턴스의 위치를 특정한 간격에 맞춘다.
Wrap Screen	direction (가로, 세로, 4방향 모두)	move_wrap(hor, vert, margin)[1]	인스턴스가 화면 밖으로 나갔을 경우 반대쪽에서 등장시킨다. 화면 밖으로 나가는 판정은 속도를 기반으로 하므로 좌표 이동만 할 경우 적용되지 않는다.
Move to Contact	direction maximum against (솔리드 오브젝트/아무 오브젝트)	move_contact_solid(direction, maximum) 혹은 move_contact_all(direction, maximum)	특정한 방향으로 솔리드 혹은 아무 객체와 충돌하기 직전의 위치까지 자동 이동시킨다. 이미 충돌했을 경우 움직이지 않는다. 최대치를 설정하면 그 이상 움직이지 않으며, -1 혹은 0(무제한. 내부적으로는 1000px로 설정됨)으로 두는 것을 권장한다.
Bounce	precise (정밀하지 않게/정밀하게) against (솔리드 오브젝트/아무 오브젝트)	move_bounce_solid(adv) 혹은 move_bounce_all(adv)[2]	솔리드 혹은 아무 객체와 충돌 시 튕기게 한다.

2.3. Paths

이름	인자	대응 코드	설명
Set Path	path speed at end relative(상대적 위치/절대적 위치)	path_start(path, speed, endaction, absolute)[3]	패스를 설정한다. 종료 후의 행동(at end)을 선택할 수 있는데 종류는 정지, 처음부터 다시, 여기서 다시, 역재생의 4가지가 있다. relative는 다른 액션의 현재 기준과 조금 다른데, 패스 에디터에서 정의한 좌표에서 시작할지 현재 인스턴스의 좌표에서 시작할지를 결정한다.
End Path	-	path_end()	진행 중인 패스를 강제로 끝낸다.
Path Position	position (0부터 1까지) 현재 기준	path_position = (position);	패스의 진행도를 변경한다. 예를 들어 0.5로 설정하면 패스의 정확히 중간부터 진행한다.
Path Speed	speed 현재 기준	path_speed = (speed);	패스의 속도를 재설정한다. 0을 입력하면 일시정지시킬 수 있으며, 음수를 입력하면 역재생할 수 있다.

2.4. Steps

이름	인자	대응 코드	설명
Step Towards	x y speed stop at (솔리드 오브젝트/아무 오브젝트) 현재 기준	mp_linear_step(x, y, speed, checkall)[4]	특정한 좌표를 향해 특정한 속도대로 가다가 오브젝트와 충돌하면 멈춘다.
Step Avoiding	x y speed avoid (솔리드 오브젝트/아무 오브젝트) 현재 기준	mp_potential_step(x, y, speed, checkall)	솔리드 혹은 아무 객체를 피해 특정한 좌표로 이동한다. 스타크래프트처럼 길 찾을 때 쓰는 거라고 생각하면 편하다.

3. Main1 탭

3.1. Objects

이름	인자	대응 코드	설명
Create Instance	object x y 현재 기준	instance_create(x, y, object)	특정 좌표에 인스턴스를 생성한다. 현재 기준에 체크하면 이 액션을 실행하는 인스턴스의 위치에서 생성된다.
Create Moving	object x y speed direction 현재 기준	with(instance_create(x, y, object)) {speed = (speed); direction = (direction);}	특정한 좌표에 특정한 방향과 속도로 움직이는 인스턴스를 생성한다.
Create Random	object 1~4 x y 현재 기준	instance_create(x, y, choose(object 1, object 2, ...))	특정한 좌표에 오브젝트 1~4 중 하나를 무작위로 생성한다.
Change Instance	change into perform events (아니요/예)	instance_change(change into, perform events)	인스턴스를 다른 오브젝트의 인스턴스로 바꾼다. perform events를 '예'로 설정하면 기존 오브젝트의 Destroy 이벤트와 새 오브젝트의 Create 이벤트가 실행된다. 물리엔진이 켜져 있을 경우 기존 인스턴스의 물리적 성질은 새 인스턴스로 전달되지 않는다(GMS).
Instance Destroy	-	instance_destroy()[5]	자기 자신을 제거한다. 다른 인스턴스를 지우려면 위의 Applies to에서 Self(기본값, 자기 자신), Other(충돌 이벤트에서, 자신과 충돌한 인스턴스), Object(특정한 오브젝트) 중 하나를 선택해야 한다.
Destroy at Position	x y 현재 기준	position_destroy(x, y)	특정한 좌표 위에 있는 인스턴스를 모두 제거한다. 좌표 판정은 마스크를 기준으로 이루어지므로 판정박스가 없는 인스턴스는 지워지지 않는다.

3.2. Sprite

이름	인자	대응 코드	설명
Change Sprite	sprite subimage speed	sprite_index = (sprite); image_index = (subimage); image_speed = (speed);[6]	인스턴스의 스프라이트를 다른 스프라이트로 바꾼다. 서브이미지를 -1로 설정하면 애니메이션을 나타내며, 그렇지 않으면 특정한 서브이미지만 표시된다. 속도는 애니메이션의 속도를 의미하며, 기본값은 1이다.
Transform Sprite	xscale yscale angle mirror (뒤집기 없음, 가로, 세로, 가로세로)	image_xscale = (xscale); image_yscale = (yscale); image_angle = (angle);[7]	스프라이트를 늘리거나 돌린다. 각도는 0이 기본값이고, 시계 반대 방향으로 회전한다. x/y 비율에 음수를 넣으면 스프라이트를 뒤집을 수 있지만, x/y 계산이 꼬일 수 있다.
Color Sprite	color alpha	image_blend = (color); image_alpha = (alpha);[색상값]	스프라이트에 색상을 입힌다. 내부적으로는 곱연산으로 처리되며, 원래 색으로 돌리려면 흰색으로 설정하면 된다.

3.3. Sounds

이름	인자	대응 코드	설명
Play Sound	sound loop	audio_play_sound(sound, priority, loop)[9][레거시1]	사운드를 재생한다.
Stop Sound	sound	audio_stop_sound(sound)[레거시2]	해당 사운드를 정지한다.
Check Sound	sound 아닐 경우	audio_is_playing(sound)[레거시3]	해당 사운드가 실행 중인지 확인한다. 사운드가 실제 스피커로 재생 중인지가 판정 기준이기 때문에 게임 내에서 사운드를 껐더라도 잠시 동안 켜진 것처럼 실행될 수 있다.

3.4. Rooms

이름	인자	대응 코드	설명
Previous Room	transition (GM8)	room_goto_previous()	이전 룸으로 이동한다.
Next Room	transition (GM8)	room_goto_next()	다음 룸으로 이동한다.
Restart Room	transition (GM8)	room_restart()	해당 룸을 재시작한다.
Different Room	new room transition (GM8)	room_goto(new room)	특정한 룸으로 이동한다.
Check Previous	-	room_exists(room_previous(room)) 혹은 room != room_first	이전 룸이 있는지 확인한다. 이전 룸이 없을 때 Previous Room 액션을 쓰면 오류가 나기 때문에 꼭 필요하다.
Check Next	-	room_exists(room_next(room)) 혹은 room != room_last	다음 룸이 있는지 확인한다.

4. Main2 탭

4.1. Timing

이름	인자	대응 코드	설명
Set Alarm	number of steps in alarm no 현재 기준	alarm[in alarm no] = (number of steps);	특정한 알람을 특정한 시간 뒤에 실행한다. 1초의 단위가 룸의 스텝 설정에 따라 다르며, 기본값인 30스텝으로 설정했을 경우 30이 1초가 된다.
Sleep (GM8)	milliseconds redraw	sleep(milliseconds)[* GMS에서 같은 동작을 실행하려면 다음과 같은 코드를 써야 한다. current_time 대신 마이크로초(100만 마이크로초가 1초) 단위를 쓰는 get_timer() 함수를 쓸 수도 있다. var t = current_time; while(current_time < t + (milliseconds)) {} ]	특정한 시간 동안 게임을 강제로 멈춘다. 프레임 갱신(redraw)에 체크했을 경우 멈추기 직전에 프레임을 한 번 갱신하고 멈춘다.
Set Time Line	time line position start (바로 시작/설정만 하기) loop (반복/1회)	[ 코드 보기 ] timeline_index = (time line); timeline_position = (position); timeline_loop = (loop); timeline_running = (start);	타임라인을 설정한다. 위치는 해당 타임라인의 몇 스텝 위치부터 시작할지를 결정한다.
파일:external/gamemaker.info/action_timelineset.gif Time Line Position	position 현재 기준	timeline_position = (position);	타임라인의 진행도를 변경한다.
Time Line Speed	speed 현재 기준	timeline_speed = (speed);	타임라인의 실행 속도를 변경한다. 기본값은 1(배속)이다.
Start Time Line	-	timeline_running = true;	설정된 타임라인을 시작한다.
Pause Time Line	-	timeline_running = false;	타임라인을 일시정지한다.
Stop Time Line	-	timeline_running = false; timeline_position = 0;	타임라인을 종료한다.

4.2. Info

이름	인자	대응 코드	설명
Display Message	message	show_message("(message)")[비동기]	새 창으로 메시지를 띄운다.
Open URL (GMS)	URL	url_open("(URL)")	브라우저로 웹페이지를 띄운다.
Show Info (GM8)	-	show_info()	게임 창에 게임 설명을 띄운다. 게임 설명은 좌측 메뉴의 'Game Information'에서 작성할 수 있다.
Splash Text (GM8)	file name	splash_show_text("(file name)", delay)[14]	게임 창에 텍스트 파일(.txt/.rtf)의 내용을 띄운다. 스크롤이 되지 않으므로 내용이 게임 창 안에 들어가야 한다.
Splash Image (GM8)	file name	splash_show_image("(file name)", delay)	게임 창에 이미지(.bmp, .jpg, .tif, .wmf 등, 움직이는 .gif는 미지원)를 띄운다.
Splash Webpage (GM8)	webpage open in (게임 창/브라우저)	splash_show_web("(webpage)", delay)[15]	게임 창이나 브라우저로 웹페이지를 띄운다. 2019년 현재 게임 창의 경우 대부분의 사이트에서 레이아웃이 깨지고 스크립트 오류를 남발하며, 브라우저의 경우 아예 작동하지 않는다(...).
Splash Video (GM8)	file name loop (반복/1회)	splash_show_video("(file name)", loop)	게임 창에 동영상(.avi, .mpg, .wmv 등, 일부 코덱 미지원)을 띄운다.
Splash Settings (GM8)	caption open in (게임 창/새 창/전체화면) close button (보이기/숨기기) on escape on mouse	[ 코드 보기 ] splash_set_caption(caption); splash_set_main(main); splash_set_fullscreen(full); splash_set_close_button(close button); splash_set_stop_key(on escape); splash_set_stop_mouse(on mouse); [16]	스플래시 화면을 어떻게 출력할지 설정한다. close button이 켜져 있으면 게임 창에 원래의 닫기 버튼 외에도 스플래시 창을 닫는 버튼이 생기며, on escape와 on mouse는 각각 Esc 키를 누르거나 마우스 클릭을 했을 때 창을 닫을지의 여부이다.

4.3. Game

이름	인자	대응 코드	설명
Restart Game	-	game_restart()	게임을 재시작한다.
End Game	-	game_end()	게임을 종료한다. 안드로이드, iOS, HTML5에서는 작동하지 않는다(GMS). 1.4.1788 업데이트 기록에서는 안드로이드와 iOS의 경우 메모리 손상을 일으키는 버그 때문이라고 한다.
Save Game	file name	game_save("(file name)")[파일시스템]	게임을 저장한다. 버전 간(게임메이커 자체든, 그걸로 만든 게임이든) 호환성이 매우 떨어지고, 일부 코드로 추가할 수 있는 데이터가 저장되지 않는 등 여러 문제 때문에 웬만하면 코드를 배워서 직접 세이브 파일을 만드는 것을 추천한다.
Load Game	file name	game_load("(file name)")[파일시스템]	Save Game으로 저장한 게임을 불러온다.

4.4. Resources

이름	인자	대응 코드	설명
Replace Sprite	sprite filename images		특정 스프라이트를 다른 이미지 파일(.png, .jpg, .tif 등, 움직이는 .gif도 지원)로 갈아치운다. 텍스처 팩 등을 구현할 때 유용하다.
Replace Sound (GM8)	sound filename	sound_replace(sound, "(filename)", kind, preload)[19]	특정 사운드를 다른 사운드 파일(.wav, .mid, .mp3)로 갈아치운다. GMS에서는 함수 자체는 남아있지만 레거시 엔진 전용이며, 비권장(deprecated)이 되었다.
Replace Background	background filename		특정 백그라운드를 다른 이미지 파일(.png, .jpg, .tif, .gif 등)로 갈아치운다.

5. Control 탭

5.1. Questions

5.2. Other

5.3. Code

5.4. Variables

6. Score 탭

6.1. Score

6.2. Lives

6.3. Health

7. Extra 탭

7.1. Particles

• 파티클 시스템(Particle System): 아래의 파티클 타입과 이미터를 담는 틀로 생각하면 된다. 액션으로는 1개만 만들 수 있다.
• 파티클 타입(Particle Type): 파티클이 눈에 보이는 모양, 즉 그래픽을 정의한 것. 모양, 방향, 속도, 중력, 색상, 투명도, 수명 등 여러 속성을 부여할 수 있지만 파티클 하나하나를 통제할 수는 없다. 액션으로는 16개만 만들 수 있다.
  엔진에 기본으로 정의된 파티클 모양은 14종류[41]가 있으며, 이외에도 직접 만든 스프라이트를 적용할 수 있다.
• 파티클 이미터(Particle Emitter): 파티클을 화면에 생성하는 생성기와 같은 것. 코드를 사용할 경우 이미터가 없어도 파티클을 소환할 수 있다. 액션으로는 8개만 만들 수 있다.
• 파티클: 실제로 파티클 이미터에서 생성되는 시각적 효과. 게임메이커 도움말에서는 파티클과 파티클 이미터를 섞어 쓰는 경향이 있지만, 해당 문서에서는 두 단어를 엄격히 구분한다.

7.2. CD (GM8)

7.3. Other

8. Draw 탭

8.1. Drawing

8.2. Settings

8.3. Other