플러그인: MPP_ChoiceEX.js

MPP_ChoiceEX.js 플러그인 분석 (RPG Maker MV 전용)

이 플러그인은 **木星ペンギン(목성펭귄)**이 만든 선택지 기능 대폭 확장 플러그인으로, 한국 RPG Maker 커뮤니티에서 **"최고의 선택지 플러그인"**으로 거의 만장일치로 꼽히는 명작 플러그인입니다. (현재 2025년 기준으로도 여전히 많은 프로젝트에서 필수로 사용되고 있어요)

1. 핵심 기능 요약 (한눈에 보기)

기능 분류	설명	실제 사용 예시 / 강점
선택지 합치기	연속된 [선택지 표시] 명령어를 자동으로 하나의 긴 선택지로 합침	10개 이상 선택지도 한 번에 표시 가능 (기본은 6개 제한)
조건에 따른 선택지 표시/숨김	if(조건) → 조건 false 시 해당 선택지 완전 숨김	if(v[20] >= 1999) → 변수 20이 1999 이상일 때만 선택지 보임
조건에 따른 선택지 비활성화	en(조건) → 조건 false 시 해당 선택지 회색(선택 불가)으로 표시	en(s[43]) → 스위치 43 ON일 때만 선택 가능
선택지 위치 자유 지정	플러그인 명령으로 x,y 좌표, 너비, 높이, 최대 행수 자유 설정	메시지창 아래에 붙이거나 화면 특정 위치에 고정 가능
선택지 위치 기억/불러오기	ChoiceVariableId n → 현재 선택지 커서 위치를 변수 n에 저장하고 다음에 불러옴	이전 선택지 위치 기억해서 편의성 극대화 (상점, 대화 등에서 유용)
선택지 헬프(도움말) 표시	선택지 아래에 주석으로 선택지헬프 쓰면 커서 올릴 때마다 도움말 표시	각 선택지에 설명 추가 가능 (아이템 선택, 퀘스트 분기 등에서 최고)
취소/기본값 동적 처리	여러 선택지 중 취소·기본값이 여러 번 나와도 가장 마지막 설정이 우선 적용	복잡한 분기에서도 안정적

2. 가장 많이 쓰이는 핵심 문법 (실전 예시)

1) 선택지 숨기기/보이기 (if 조건)

text

if(v[20] >= 1999)  →  변수 20이 1999 이상일 때만 이 선택지 표시
if(s[43])          →  스위치 43 ON일 때만 표시
if(!s[5])          →  스위치 5 OFF일 때만 표시
if(v[10] > 50 && s[7]) → 복합 조건 가능

2) 선택지 비활성화 (en 조건)

text

en(s[43])          → 스위치 43 ON일 때만 선택 가능 (OFF면 회색 처리)
en(v[30] >= 100)   → 변수 30이 100 이상일 때만 선택 가능

3) 플러그인 명령어 (위치 자유 지정)

text

ChoicePos 200 300 8    → x=200, y=300, 최대 8줄 표시
ChoiceRect 100 150 400 300   → 좌표(100,150), 크기 400×300
ChoiceUnderMessage     → 메시지창 바로 아래에 선택지 붙이기 (대화형 선택지 최고)
ChoiceVariableId 50    → 현재 커서 위치를 변수 50에 저장 & 다음에 불러옴

4) 선택지 도움말 (헬프 텍스트)

text

[선택지 표시]
  선택지1
  선택지2
[주석]
  선택지헬프
  이 선택지는 1번을 고르면
  특별한 이벤트가 발생합니다.
[선택지 표시]
  선택지3

→ 선택지2에 커서 올리면 메시지창에 "이 선택지는..." 도움말 표시

3. 실전에서 가장 강력한 조합 예시

text

◆플러그인 명령：ChoiceUnderMessage     ← 메시지창 아래에 붙임
◆플러그인 명령：ChoiceVariableId 50     ← 이전 선택 기억
◆플러그인 명령：ChoicePos 180 320 10    ← 위치·최대 10줄

◆선택지 표시：퀘스트 수락, 거절, 자세히 듣기, 취소
  if(v[20] >= 5000)                     ← 돈 5000 이상일 때만 수락 가능
  en(s[43])                             ← 스위치 43 ON일 때만 자세히 듣기 가능

  [주석] 선택지헬프
  수락하면 바로 퀘스트가 시작됩니다.