Hangul Message System XP

다운로드

XP (RGSS) : https://github.com/biud436/RGSS3/raw/master/XP/RS_HangulMessageSystemXP.rb

소개

텍스트 코드(제어 문자)를 영어 대신 한글로 대체합니다. 뿐만 아니라 한글로 된 색상 코드 사용, 이름 윈도우, 말풍선 모드, 텍스트 사운드 등 많은 기능을 추가로 제공합니다

사용 가능 텍스트 코드

색상 변경

한글 메시지 시스템에서는 기본 메시지 스크립트보다 훨씬 많은 색상을 기본적으로 지원합니다. 색상 타입은 한글이나 영어, 숫자, 그리고 HEX로 되어있는 웹색상까지도 사용할 수 있습니다.

 \색[빨강]    : "청록","검은색","파란색","짙은회색","자홍색","회색","녹색","밝은녹색",
             "밝은회색", "밤색","감청색","황록색","주황색","주황색","보라색","빨간색",
             "민트색","노란색", "기본색"

아래 색상 상수들은 게임메이커 8 에서 지원하는 기본 색상 값과 동일합니다.

\색[c_red]  : c_aqua, c_black, c_blue, c_dkgray, c_fuchsia, c_gray, c_green,
             c_lime, c_ltgray, c_maroon, c_navy, c_olive, c_orange, c_purple,
             c_red, c_silver, c_teal, c_white, c_yellow, c_normal

기본색 변경은 텍스트 코드 \C[0]과 의미가 같습니다.

\색[기본색]  : 텍스트 색상을 기본색으로 바꿉니다.

호환을 위하여 기본 텍스트 코드 명령어도 사용할 수 있습니다.

 \C[0-7]

16진수 헥스로 색상을 지정하려면 다음과 같이 하시면 됩니다. 색상 포맷은 각 색상을 16진수 0x00 (0)부터 0xFF (255)까지의 숫자로 표현하는 방법입니다. 알파값 설정은 지원하지 않습니다.

 \#FFFFFF!    : 웹 색상 변환입니다. (예제는 흰색이며 16진수 기준으로 RRGGBB 형식입니다)

변수

\V[I]과 동일한 텍스트 코드로 \변수[변수의 번호]로 표현할 수 있습니다. 변수의 번호를 괄호 안에 기입하면 변수 값이 텍스트 창에 표시됩니다.

\변수[변수의 번호]

액터와 파티원 이름 표시

액터 또는 파티원의 이름을 표시하려면 다음과 같은 명령을 사용하세요. 이름은 데이터베이스에서 가져오며 번호는 1부터 시작합니다.

\주인공[주인공 번호]
\파티원[파티원 번호]

RPG Maker VX Ace 텍스트 코드

RPG Maker VX Ace와 동일한 텍스트 코드를 사용할 수 있습니다. 게임 내 소지 금액을 표시하는 골드 윈도우를 표시할 수도 있고 텍스트를 빠르게 띄우거나 천천히 띄울 수도 있습니다.

\G      : 골드를 표시합니다.
\$      : 골드 윈도우를 띄웁니다.
\!      : 결정키 입력을 받는 퍼지 모드로 전환합니다.
\.      : 10 프레임을 대기합니다 (60프레임에선 15 프레임 대기)
\|      : 40 프레임을 대기합니다 (60프레임에선 60 프레임 대기)
\^       : 결정키 입력을 받지 않고 다음 텍스트로 넘깁니다.
\<      :  텍스트를 스킵 모드로 전환하여 대기 없이 빠르게 표시합니다.
\>      :  텍스트 스킵 모드를 끄고 원래 속도로 표시합니다.

데이터베이스

스킬, 무기구, 방어구, 아이템의 이름을 메시지 윈도우에 띄울 수 있습니다. 명색이 한글 메시지 시스템이라 한글을 사랑해야 하지만, 스팀판 RPG Maker XP는 메시지를 입력할 수 있는 지면이 너무 부족하여 약자로 입력할 수도 있게 하였습니다. 스아, 아아, 무아, 방아는 조금 어감이 좋지 않으므로 SI, II, WI, AI로 입력할 수 있게 하였습니다. I는 인덱스의 약자입니다.

\SI[스킬 인덱스]
\스킬아이콘[스킬 인덱스]

\II[아이템 인덱스]
\아이템아이콘[아이템 인덱스]

\WI[아이템 인덱스]
\무기구아이콘[아이템 인덱스]

\AI[아이템 인덱스]
\방어구아이콘[아이템 인덱스]

텍스트 속도 조절

RPG Maker XP 바닐라 모드에서는 텍스트가 대기 없이 한 번에 그려져 바로 표시됩니다. 하지만 게임 연출에 따라 텍스트를 한 글자씩 표시하는 기능이 VX부터 도입되었습니다. 이러한 트렌드를 따라갈 수 있는 기능이 바로 텍스트 속도 조절 기능입니다. 대기 프레임을 0으로 설정하면 기존과 동일하게 텍스트를 한 번에 띄울 수 있고, 1-2프레임 정도 대기하는 게 텍스트 사운드 재생 시 듣기 좋습니다.

\속도![대기프레임]      : 대기 카운트를 설정합니다.
\S[대기프레임]          : 대기 카운트를 설정합니다.

텍스트 크기 변경

\크기![텍스트크기]      : 텍스트 크기를 변경합니다.
\H[텍스트크기]          : 텍스트 크기를 변경합니다.

굵은 꼴, 기울임 꼴 설정

굵은 꼴로 설정하려면 <B>아니, 물이 없는 곳에서 이 정도 수준의 수둔이라니?</B>와 같이 하시면 되고, 글자를 기울이려면 <I>화둔, 호화구의 술!!</I>과 같이 태그를 지정해야 합니다. 요즘에도 학교 컴퓨터 시간에 HTML를 배우는 지 모르겠지만, HTML를 배우신 분들이라면 익숙하실 겁니다. 그렇지 않은 분들이라면, 조금 기괴하게 느껴질 수도 있겠습니다.

<B>텍스트</B>           : 텍스트를 굵게 표시합니다.
<I>텍스트</I>           : 텍스트를 기울임꼴로 표시합니다.

이름 윈도우 설정

메시지 창 위에 이름 윈도우를 설정하려면 다음과 같은 텍스트 코드를 사용해야 합니다. 콜론(:)을 사용하여 초기 정렬 위치도 바꿀 수 있습니다.

\이름<러닝은빛>        : 이름 윈도우를 메시지 윈도우의 왼쪽에 정렬하여 표시합니다.
\이름<러닝은빛:left>    : 이름 윈도우를 메시지 윈도우의 왼쪽에 정렬하여 표시합니다.
\이름<러닝은빛:right>  : 이름 윈도우를 메시지 윈도우의 오른쪽에 정렬하여 표시합니다.
\이름<러닝은빛:center> : 이름 윈도우를 메시지 윈도우의 중앙에 정렬하여 표시합니다.

문장은 다음과 같이 적어야 합니다. \이름<나루토> 다음에 첫 줄의 문장을 같이 입력해야 첫 줄에 표시됩니다. 첫 줄을 띄워 놓으면 첫 줄에 아무것도 표시되지 않습니다.

\이름<나루토>친구니까.

조금 심화 과정을 보겠습니다. 이름 윈도우에서 이름 텍스트의 색상을 변경하려면 다음과 같이 해야 합니다. 내친김에 오른쪽에 표시하겠습니다. 이렇게 하려면 다음과 같이 해야 합니다.

\이름<\색[빨강]1대 호카게:right>\색[초록]목둔,\색[기본색] 수계 강탄!

말풍선 모드 전환

메시지 윈도우를 말풍선 모드로 전환하는 명령어입니다.

 \말풍선[-1] : 플레이어      :  플레이어 위에 말풍선을 띄웁니다.
 \말풍선[0] : 이 이벤트      :  이 이벤트 위에 말풍선을 띄웁니다.
 \말풍선[이벤트ID]           :  이벤트 ID에 해당하는 이벤트 위에 말풍선을 띄웁니다.

이름 윈도우도 같이 표시하려면 다음과 같이 해야 합니다. -1을 전달하면 플레이어 머리 위에 말풍선이 표시됩니다.

\말풍선[-1]\이름<\색[빨강]센쥬 하시라마>\색[초록]목둔,\색[기본색] 화수계강림!

말풍선은 보통 머리 위에 표시되어야 정상이지만 대상이 세상의 끝인 맵의 가장 자리 부근에 위치한 경우, 창이 화면에 보이는 위치로 자동으로 바뀌게 됩니다.

들여쓰기

다음 텍스트 코드로 들여쓰기가 가능합니다.

 \들여쓰기[X] 

들여쓰기는 말 그대로 텍스트가 시작되는 X좌표를 변경하는 것입니다. X는 2차원 공간에서 X 좌표를 뜻합니다. 영점은 메시지 창의 가장 왼쪽 변에서 6픽셀 정도 떨어진 위치가 영점(0)입니다. 즉, \들여쓰기[1]을 입력하면 텍스트는 7픽셀부터 그려지게 됩니다. 값이 증가하면 텍스트가 점점 오른쪽에 그려지게 됩니다.

텍스트 정렬

텍스트 정렬 코드는 다음과 같습니다. 다시 태그가 나왔습니다. 학창 시절에 HTML 태그를 배우신 분들이라면 익숙하실 건데요. 익숙하지 않으신 분들에겐 죄송하지만 어렵지는 않습니다. 태그 사이에 작성한 문장이 가운데, 오른쪽, 왼쪽에 표시됩니다.

 <CENTER>가운데</CENTER>
 <RIGHT>오른쪽</RIGHT>
 <LEFT>왼쪽</LEFT>

일반 텍스트 모드에서 가장 잘 동작하며 \들여쓰기[X]를 사용하거나 말풍선 모드로 전환된 상태에서는 사용하지 마세요.

얼굴 이미지 표시

얼굴 이미지의 표시는 \얼굴[번호]과 \F[번호]라는 텍스트 코드를 지원합니다. 이 텍스트 코드는 다른 알만툴 시리즈와 차이를 둘 수 밖에 없었습니다. RPG Maker XP 스팀판은 문장의 표시에 스크롤 바를 지원하지 않고 허용 폭을 넘어가면 자동 줄바꿈 되기 때문에 텍스트 코드가 길면 문제가 생기게 됩니다.

다른 시리즈에서는 파일 이름과 인덱스까지 정할 수 있지만 스팀판 특유의 제한 탓에 정해진 규격의 얼굴 이미지만 불러오게 하였습니다. 얼굴 이미지는 반드시 Faces 폴더 안에 있어야 합니다. 텍스트 코드에 \얼굴[1]을 전달하면 Graphics/Faces/face_001.png 파일을 불러오게 됩니다.

\얼굴[번호]는 Graphics/Faces/face_xxx.png 파일을 얼굴 이미지에 설정합니다.

\F[번호]는 Graphics/Faces/face_xxx.png 파일을 얼굴 이미지에 설정합니다.

얼굴 이미지 기능은 다양한 얼굴 이미지의 집합인 스프라이트 시트 기능을 사용하지 않으며 개별 이미지를 하나의 얼굴로 취급합니다. 또한 별도의 스프라이트로 처리하지 않기 때문에 메시지 윈도우 내로 표시됩니다.

얼굴 이미지의 방향은 왼쪽과 오른쪽이며 처음에는 왼쪽에 표시됩니다. 텍스트 코드로 오른쪽으로 바꿀 수 있는 기능은 넣지 않았습니다. 넣는다면 \FL과 \FR이 될 가능성이 있습니다. 현재는 스크립트 호출로 RS::LIST["FACE_POSITION"]의 값을 각각 0과 1로 바꿈으로써 왼쪽과 오른쪽으로 변경이 가능합니다. 얼굴 이미지는 말풍선 모드와 일반 메시지 모드에서 사용이 가능하며 선택지가 있는 상태에서는 사용이 불가능합니다.

참고로 큰 얼굴 이미지 기능은 다중 얼굴 표시 기능을 넣으려는 욕심 탓에 버그가 많아 애드온으로 분리하였습니다. 그러나 버그가 있기 때문에 사용을 금합니다. 그냥 그림의 표시로 구현하세요.

숫자 값 표시 형태

숫자를 100,000,000과 같은 형태로 표시하려면 다음과 같은 텍스트 코드를 사용하십시오.

\숫자[100000000]

테두리 색, 그림자 색, 배경색, 테두리 굵기 설정

아래 텍스트 코드들은 다음 페이지에선 기본값으로 재설정됩니다.

\테두리색[색상명]
\그림자색[색상명]
\배경색[색상명]
\테두리굵기[크기]

예를 들면, \배경색[빨강]이라고 하면 텍스트의 배경색이 빨강색으로 변하게 됩니다.

다음 명령들도 현재 페이지에만 유효합니다.

\테두리켜
\테두리꺼 
\그림자켜
\그림자꺼
\배경색켜
\배경색꺼

다음 페이지로 넘어갈 땐 다시 기본값으로 설정되므로, 원천적으로 기능을 OFF 하려면 설정을 false로 바꾸거나 스크립트 호출을 사용하십시오.

RS::LIST["배경색 그리기"] = false
RS::LIST["테두리"] = false
RS::LIST["그림자"] = false

멀티 라인

문장의 표시를 사용하기 전에 다음과 같이 스크립트를 호출하여 라인을 8줄로 설정합니다.

RS::LIST["라인"] = 8

4줄짜리 문장의 표시 두개를 나란히 배치합니다.

라인1
라인2
라인3
라인4

라인5
라인6
라인7
라인8

그리고 스크립트 커맨드를 추가하여 다시 4줄 또는 원래 라인으로 설정해줍니다.

설계상 다시 원래 라인으로 돌려놓지 않으면 문제가 생길 가능성이 있습니다.

RS::LIST["라인"] = 4

스크립트 호출

한글 메시지 시스템에서 불러오는 기본 설정 값들은 스크립트를 통해 변경이 가능합니다. 루비의 해시로 구성하였기 때문에 키 값만 적으면 값을 Read하고 Write 할 수 있습니다. 예를 들면, RS::LIST["라인"] = 8은 라인을 8줄로 변경합니다. RS::LIST["텍스트 사운드 사용"] = false는 텍스트 사운드 사용을 중단합니다.

기본 설정

module RS
  LIST = {}
  CODE = {}
  
  # 폰트 리스트 예:) ["나눔고딕, "굴림"]
  # 폰트가 시스템에 설치되어있거나 Fonts 폴더에 있어야 합니다.
  # 폰트 파일과 글꼴명은 다를 수 있습니다.
  # 여기에 적는 것은 해당 폰트의 실제 글꼴명입니다.
  LIST["폰트명"] = Font.default_name
  
  # 폰트 크기를 변경합니다. 예:) Font.default_size는 기본 폰트 사이즈입니다.
  LIST["폰트크기"] = $NEKO_RUBY ? 16 : Font.default_size
  
  # 자동 개행 설정
  # true이면 창의 폭을 넘겼을 때 자동으로 개행합니다.
  # 사용 시 정렬 기능이 제대로 동작하지 않을 수 있으니 주의 바랍니다.
  LIST["자동개행"] = false
  
  # 기본 라인 갯수
  LIST["라인"] = 4
  
  # 대화창의 전체 투명도를 설정합니다.
  # 투명도의 경우, 배경 창의 투명도, 텍스트의 투명도가 따로 나뉘지만
  # 여기에서는 그 둘을 포함한 전체 투명도를 조절합니다.
  LIST["투명도"] = 255
  LIST["배경투명도"] = 160
  
  # 이름 윈도우의 X좌표는 얼굴 이미지가 왼쪽에 표시되면 왼쪽에 표시되고,
  # 오른쪽에 표시되면 오른쪽에 표시합니다.
  # 스크립트 커맨드에서 RS::LIST["이름윈도우X1"] = 10 등으로 수정이 가능합니다.
  LIST["이름윈도우X1"] = 10
  LIST["이름윈도우X2"] = 210
  
  # 이름 윈도우 Y. 
  # 메시지 윈도우 Y좌표 값을 기준으로 위(+) 또는 아래(-)로 내릴 수 있습니다.
  # 위는 메시지 박스의 위쪽을 말하며, 아래는 메시지 박스와 겹쳐지는 방향을 말합니다.
  LIST["이름윈도우Y"] = 0
  
  # 텍스트 속도 조절 텍스트 코드를 사용하실 때의 최소, 최대 속도입니다.
  # 텍스트 속도가 1이라면 일반 글자 묘화 처리 후, 1프레임을 대기합니다.
  # 대기는 메시지 처리를 중단하고 나머지 업데이트 함수를 실행합니다.
  LIST["텍스트속도-최소"] = 0
  LIST["텍스트속도-최대"] = 8
  
  # 기본 텍스트 속도 (기본값 : 1)
  LIST["기본 텍스트 속도"] = 1
  
  # 말풍선을 화면 영역 안으로 자동 조절하여 표시합니다.
  # 이 옵션을 설정하면 캐릭터가 가장 자리에 있을 경우, 
  # 말풍선의 중앙 지점(anchor)이 옮겨질 수 있습니다.
  LIST["화면영역내표시"] = true
  
  # 크기 및 오프셋 설정
  LIST["가로"] = (Graphics.width * 0.75).floor
  LIST["오프셋X"] = 0
  LIST["오프셋Y"] = -10
  
  # 텍스트 사운드 설정
  LIST["텍스트 사운드 사용"] = true
  LIST["텍스트 사운드"] = ["032-Switch01", "032-Switch01"]
  LIST["텍스트 사운드 볼륨"] = [70, 70]
  LIST["텍스트 사운드 피치"] = [100, 100]
  LIST["텍스트 사운드 주기"] = 3

  # 얼굴
  LIST["FACE_NEW_LINE_X"] = 112
  LIST["FACE_RECT"] = Rect.new(0, 0, 112, 112)

  # 얼굴 위치
  # 0 이면 왼쪽
  # 1 이면 오른쪽
  LIST["FACE_POSITION"] = 0 
  
  # 폰트 옵션
  LIST["배경색 그리기"] = false
  LIST["테두리"] = true
  LIST["그림자"] = true
  LIST["그림자 거리"] = 2
  LIST["테두리 굵기"] = 1
  LIST["배경색"] = ::Color.new(128, 128, 128, 200)
  LIST["테두리 색상"] = ::Color.new(0, 0, 0, 255)
  LIST["그림자 색상"] = ::Color.new(0, 0, 0, 200)  

  # 정규 표현식 (잘 아시는 분들만 건드리십시오)
  CODE["16진수"] = /#([a-zA-Z^\d]*)/i
  CODE["색상추출"] = /^[가-힣]+|c_[a-zA-z]+$/
  CODE["명령어"] = /^[\$#\.\|\^!><\{\}\\]|^[A-Z가-힣ㄱ-ㅎ]+[!]*/i
  CODE["이름색상코드"] = /\[([가-힣]+[\d]*|c_[a-zA-Z]+)\]/
  CODE["웹색상"] = /([a-zA-Z\d]+)!/
  CODE["추출"] = /^([가-힣ㄱ-ㅎ]+)/
  CODE["큰페이스칩"] = /^큰\_+/
  CODE["효과음"] = /^\[(.+?)\]/i
  CODE["처리!"] = /^([가-힣]+)!/
  CODE["이름"] = /\e이름\<(.+?)\>/
  CODE["말풍선"] = /\e말풍선\[(\d+|-\d+)\]/i
  CODE["이름추출"] = /\[(.*)\]/
  CODE["이름색상변경1"] = /\eC\[(.+)\]/
  CODE["이름색상변경2"] = /\e색\[(.+)\]/
    
end