GOKI2로 ADV 개발 마스터하기: Character Assets, Audio Paths, 그리고 Dialogues를 전문가처럼 관리하기

발행: (2026년 3월 14일 오전 07:16 GMT+9)
4 분 소요
원문: Dev.to

Source: Dev.to

HALO

다운로드

관심이 있으시면, 릴리스 페이지의 Assets에 있는 Avalanches‑Release2.x.y.z.zip에서 최신 환경을 다운로드할 수 있습니다:

https://github.com/halo1234/Avalanches/releases

전제 조건

구문 확장에 대한 자세한 내용은 다음 문서를 참고하십시오:

Getting started with ADV development in GOKI2 – System Architecture & Module Structure

ModADV

GOKI2에는 ModADV라는 모듈이 포함되어 있으며, 이는 ADV (Adventure)Visual Novel 게임을 위해 특별히 설계되었습니다.
ModADV는 ModMessage, ModImage, ModSound에 의존하므로, ModADV가 초기화될 때 해당 모듈들이 자동으로 로드됩니다.

Source:

캐릭터 정의

먼저 make_character 태그를 사용해 캐릭터를 정의합니다. 아래는 정의를 간소화한 확장 문법입니다.

@!make_character image=with_image->true,without_image->false
@!make_character voice=with_voice->true,without_voice->false

; Create mob tag (redirect)
@redirect alias=mob name=make_character
; If no variables are specified with a pattern, the specified values will always be expanded.
@!mob /mob=true

캐릭터 선언

@make_character name=halo with_image with_voice
@make_character name=halo sub_directory_name=images part_of_directory_path=A
@make_character name=halo voice_sub_directory_name=testcase
@make_character name=halo shadow_color=0x808080 edge_color=0xFF0000
@make_character name=halo history_shadow_color=0x808080 history_edge_color=0xFF0000
@make_character name=halo history_icon=history_icon_halo history_icon_left=18

설명

라인의미
@make_character name=halo with_image with_voice캐릭터 halo는 스탠딩 이미지와 음성을 가집니다.
@make_character name=halo sub_directory_name=images part_of_directory_path=A캐릭터 일러스트 경로를 images/A/CharacterIllustrationFileName.png 로 설정합니다.
@make_character name=halo voice_sub_directory_name=testcase음성 경로를 설정합니다. 실행 중인 시나리오 스크립트가 test.gs이면 음성 파일은 testcase/test/halo000.ogg 가 됩니다.
@make_character name=halo shadow_color=0x808080 edge_color=0xFF0000
@make_character name=halo history_shadow_color=0x808080 history_edge_color=0xFF0000
대사와 히스토리 텍스트의 색상을 정의합니다.
@make_character name=halo history_icon=history_icon_halo history_icon_left=18히스토리 텍스트 옆에 표시되는 아이콘을 지정합니다.

참고
캐릭터 일러스트를 하위 디렉터리에 넣는 경우, 배포 시 파일명을 변경해야 할 수 있습니다. /tools/make 도구가 이를 자동으로 처리하고 필요한 마스터 데이터를 생성합니다.

Character Tag

다음 확장자는 캐릭터 halo 를 정의합니다 (halo 태그를 이제 사용할 수 있습니다). 내부적으로 halocharacter 로 리다이렉트되므로 character에 적용된 확장도 halo에 적용됩니다. halo에만 적용된 확장은 character영향을 주지 않습니다.

@!character center_x=left->200,middle->400,right->600,middleleft->300,middleright->500,leftend->100,rightend->700
@!character gray_scale=sepia->true r_gamma=sepia->1.5 g_gamma=sepia->1.3
@!character visible=show->true,erase->false
@!character no_voice=nv->true

@!halo /storage=A__
@!halo face=expression1->face1,expression2->face2
@!halo target=pose1->*target
@!halo pose=pose1->pose1,pose2->pose2
; Handling Scenario Text with ModADV
; If you don't do this, you won't see any text
@using_mod_adv
; If you also want to omit the [r] and [p] tags, run the following tags:
@cr_handling !ignore

; Define a character "mob" that is only valid within this scenario
@mob name=mob without_image without_voice

@halo pose1 expression1 middle show
[halo] halo's line.

; Make the standing picture sepia and move it to the left
@halo pose1 expression2 left Sepia
[halo] The voice will play if configured.

[mob] This is the line of the mob. There are no standing pictures or voices.

@halo pose1 expression2 medium
[halo nv] does not play the voice.

@halo erase
[halo] erases

서 있는 사진

Enter fullscreen mode
Exit fullscreen mode

ModADV로 캐릭터 정의하기

만약 GOKI2를 시도하고 싶다면, 다음 링크에서 최신 환경을 다운로드할 수 있습니다:

https://github.com/halo1234/Avalanches/releases

관련 기사 목록

0 조회
Back to Blog

관련 글

더 보기 »