추가 변경) Evening Survivor 편지 오브젝트 오류(終了, 종료)

이 스크립트는 RPG Maker MV에서 특정 이벤트 ID를 가진 이벤트가 어느 맵에 존재하는지 검색 하는 코드입니다.

주로 전역 변수 나 공통 이벤트 안에서 사용되며, 변수 53번에 저장된 이벤트 ID를 기준으로 $dataIntel001 (또는 다른 $dataXXX 맵 데이터) 안을 순차 탐색해서 해당 ID를 가진 이벤트를 찾는 로직입니다.

코드 전체 분석 (줄 단위로 쉽게 설명)

JavaScript

var Scene = "Intel001";                     // 검색 대상 맵 데이터 이름 (여기서는 Intel001)
var FileName = window["$data" + Scene];     // $dataIntel001 을 동적으로 가져옴
var Event = $gameVariables._data[53]        // 변수 53번에 저장된 이벤트 ID를 가져옴

→ 검색 대상 맵 데이터와 찾고자 하는 이벤트 ID 준비

JavaScript

for (i = 1; i <= 1000; i++) {               // 이벤트 ID 1번부터 1000번까지 순차 탐색
    if (FileName[i]) {                      // 해당 ID에 이벤트 데이터가 존재하면
        // ID가 존재하므로 이벤트명(또는 실제로는 이벤트 객체)을 비교
        if (FileName[i].event == Event) {   // ★ 핵심 비교: 이벤트의 .event 값이 변수 53번과 같으면
            console.log('이벤트' + Event + '발견！：' + i);
            $gameVariables._data[54] = i;   // 발견한 이벤트가 있는 맵의 이벤트 ID를 변수 54번에 저장
            // $gameVariables._data[54] += 1;   ← 이 줄은 주석 처리되어 있음 (사용 안 함)
            break;                          // 찾았으니 루프 종료
        }
    } else {
        console.log('ID切れ');              // 더 이상 이벤트가 없으면 종료
        break;
    }
}

이 코드가 하는 일 요약 (한 문장)

“변수 53번에 저장된 이벤트 ID를 $dataIntel001 맵 데이터 안에서 찾아서, 그 이벤트가 존재하는 이벤트 번호(ID)를 변수 54번에 저장한다.”

실제 사용 예시 (추정되는 용도)

변수 53번에 특정 이벤트 ID 를 넣어둠 (예: 15)
이 스크립트를 실행 → $dataIntel001 맵(인텔리전스 맵? 정보 수집 맵?)에서 이벤트 ID가 15인 이벤트가 몇 번 이벤트인지 찾아서 변수 54번에 저장
이후 다른 이벤트에서 변수 54번 값을 읽어 그 이벤트로 강제 이동 하거나 그 이벤트를 호출 하거나 특정 처리 를 함

→ 정보 수집·퀘스트·히든 이벤트 탐색 시스템에서 자주 쓰이는 패턴입니다.

주의점 & 개선 포인트

FileName[i].event 비교가 비표준
- MV에서 이벤트 객체는 .name 이나 .note 를 주로 쓰는데, .event 라는 속성은 기본적으로 없음 → 커스텀으로 추가한 속성일 가능성 높음 (혹은 오타/잘못된 속성일 수 있음 → 실제로는 FileName[i].name === Event 일 가능성도)
for 루프 1~1000 은 비효율적
- 맵에 이벤트가 1000개 넘을 일 거의 없음 → 500 이하로 줄여도 충분
break 잘 사용했음
- 찾으면 바로 종료 → 성능상 문제 없음
console.log 는 테스트용
- 배포 시에는 지우거나 주석 처리하는 게 좋음

더 안전하고 깔끔한 버전 제안 (필요 시 사용)

JavaScript

var targetEventId = $gameVariables.value(53);  // 찾고자 하는 이벤트 ID
var mapData = $dataIntel001;                   // 검색 대상 맵 데이터

for (var i = 1; i < mapData.events.length; i++) {
    var event = mapData.events[i];
    if (event && event.id === targetEventId) {  // .id로 비교 (표준 속성)
        $gameVariables.setValue(54, i);         // 발견된 이벤트 번호 저장
        console.log("이벤트 ID " + targetEventId + " 발견: 이벤트 번호 " + i);
        break;
    }
}

이 버전이 더 안전합니다 (기본 속성 .id 사용).

필요하시면

“찾은 이벤트 번호로 그 이벤트가 있는 맵으로 이동하는 코드”
“여러 맵에서 동시에 검색하는 버전” 등 확장도 바로 만들어 드릴게요! 😊

이 스크립트는 RPG Maker MV에서 특정 맵 데이터($dataIntel001)에서 이벤트 ID를 기반으로 대사(텍스트)를 읽어와 메시지창에 표시 하는 코드입니다.

이전 스크립트(이벤트 검색)에서 찾은 이벤트 ID(변수 54번)를 사용해 해당 이벤트의 이름 과 텍스트 를 추출해서 대화창 으로 출력하는 후속 처리입니다.

코드 전체 분석 (줄 단위로 쉽게 설명)

JavaScript

var Scene = "Intel001";                          // 검색 대상 맵 데이터 이름 (Intel001)
var Id = $gameVariables._data[54];               // 변수 54번 = 이전 스크립트에서 찾은 이벤트 ID
var FileName = window["$data" + Scene];          // $dataIntel001 데이터를 가져옴
var CharaName = FileName[Id].name;               // 해당 이벤트의 'name' 속성 (캐릭터 이름)
var Text = FileName[Id].text;                    // 해당 이벤트의 'text' 속성 (대사 내용)
var Mode = 0;                                    // 기본 배경 모드 (0 = 일반)

→ 변수 54번에 저장된 ID로 $dataIntel001 맵의 해당 이벤트 데이터를 읽음

JavaScript

if (FileName[Id].event) {                        // 만약 이벤트에 .event 속성이 있으면
    Mode = 1;                                    // 배경 모드를 1 (특수 모드, 예: 어두운 배경 등)로 변경
}

→ .event 속성이 존재하면 배경 모드를 변경 (커스텀 설정으로 보임)

JavaScript

if (Text != "終了") {                            // 텍스트가 "終了" (종료)가 아닐 때
    // 텍스트 내용이 존재하는 경우
    if (Text) {
        if (CharaName) {                         // 캐릭터 이름이 있으면
            $gameMessage.setBackground(Mode);    // 배경 모드 적용
            $gameMessage.setSpeakerName("　" + FileName[Id].name + "　"); // 이름 양쪽에 공백 넣어 표시
            $gameMessage.add(Text);              // 대사 추가
            this.setWaitMode('message');         // 메시지 대기 모드 설정 (다음 명령어까지 기다림)
        } else {                                 // 이름이 없으면 이름 없이 대사만
            $gameMessage.setBackground(Mode);
            $gameMessage.add(Text);
            this.setWaitMode('message');
        }
    }
}

→ 텍스트가 "終了"가 아니면 → 대화창에 이름 + 대사 표시

JavaScript

// 텍스트가 "終了"였을 경우
else {
    $gameSwitches._data[15] = true;              // 스위치 15번 ON (종료 플래그)
}

→ 텍스트가 "終了"이면 → 스위치 15번을 켜서 종료 처리

이 코드가 하는 일 요약 (한 문장)

“변수 54번에 저장된 이벤트 ID를 $dataIntel001 맵에서 찾아, 그 이벤트의 이름과 텍스트를 읽어와 메시지창에 표시한다. 텍스트가 '終了'이면 스위치 15번을 켜고 종료한다.”

실제 사용 예시 (추정되는 전체 흐름)

이전 스크립트 → 변수 53번에 찾고 싶은 이벤트 ID 입력 → 변수 54번에 실제 이벤트 번호 저장
이 스크립트 실행 → 변수 54번의 이벤트에서 이름과 대사를 읽어 대화창 출력
대사가 "終了"이면 → 스위치 15 ON → 다음 이벤트로 진행 (예: 정보 수집 종료, 퀘스트 완료 등)

→ 정보 수집·도감·히든 이벤트·NPC 대화 로그 시스템에서 자주 쓰이는 패턴

특징 & 주의점

커스텀 데이터 구조
- $dataIntel001.events[i].name
- $dataIntel001.events[i].text
- $dataIntel001.events[i].event (존재 여부 체크용) → 기본 MV 데이터 구조가 아님 → 데이터베이스나 외부 툴로 미리 만들어야 함
배경 모드(Mode)
- Mode=1 → $gameMessage.setBackground(1) → 어두운 배경이나 특수 창 (RPG Maker 기본)
이름 표시 시 공백 추가
- "　" + 이름 + "　" → 이름 양쪽에 공백 넣어 보기 좋게 함
"終了" 문자열
- 텍스트가 정확히 "終了"이면 종료 처리 → 일본어로 되어 있으니 한국어 프로젝트라면 "종료"로 바꿔야 함

개선 제안 (필요 시 사용)

JavaScript

var targetId = $gameVariables.value(54);
var mapData = $dataIntel001;

if (mapData && mapData.events && mapData.events[targetId]) {
    var eventData = mapData.events[targetId];
    var charaName = eventData.name || "";
    var text = eventData.text || "";

    if (text !== "종료") {  // 한국어로 변경
        $gameMessage.setBackground(eventData.event ? 1 : 0);
        if (charaName) {
            $gameMessage.setSpeakerName("　" + charaName + "　");
        }
        $gameMessage.add(text);
        this.setWaitMode('message');
    } else {
        $gameSwitches.setValue(15, true);
    }
} else {
    console.log("이벤트 ID " + targetId + " 데이터 없음");
}