시나리오 에디터를 추가하면 빠른 템포의 아레나 슈터에서 여러 번 즐길 만한 전투를 더 많이 만들 수 있습니다. 다만 에디터가 별도의 전투 엔진이 되어서는 안 됩니다. 에디터는 전투 구성을 정의하고, 이동, 무기, 적의 행동, 피해 처리, 경기 진행은 계속 기존 게임이 담당하도록 하세요.

이 가이드는 기존 프로젝트에서 시나리오를 제작하는 작업 흐름을 설명합니다. 예시로 등장하는 Foundry Arena는 가상이며, 에디터 구현, 빌드 생성, 플레이 테스트 수행을 주장하지 않습니다. AI에 코드 수정을 요청하기 전에 정상 작동을 유지해야 할 시스템을 명시하고, 프로젝트가 현재 기본 제공 아레나를 어떻게 불러오는지 확인하세요.
조작 기능을 추가하기 전에 에디터의 범위 정하기
게임이 이미 지원하는 요소부터 살펴보세요. 현재 아레나에 고정된 경계, 플레이어 스폰 지점, 적 유형, 획득 가능한 탄약이 있다면 첫 버전의 에디터에서는 이런 항목을 선택할 수 있게 하면 됩니다. 스크립팅 언어, 자유로운 지형 편집 도구, 본격적인 모드 마켓플레이스까지 갖출 필요는 없습니다. 이런 기능을 추가하면 검증과 보안 요구사항이 크게 늘어납니다.
시나리오 데이터에 꼭 필요한 항목을 쉬운 말로 정의하세요. 어떤 아레나를 불러올지, 플레이어가 어디서 시작할지, 어떤 적 그룹이 등장하고 각 그룹이 언제 활성화될지, 탄약이나 방어구를 얼마나 제공할지, 어떤 조건에서 전투가 끝날지를 정합니다. 무기 수치 조정과 적 AI는 기존 시스템에서 계속 관리하세요. 에디터는 게임이 지원하는 옵션을 선택하는 역할을 맡고, 그 옵션을 실행하는 규칙은 기존 시스템에 두세요.
AI에 코드를 고치기 전에 현재 실행 흐름부터 파악해 달라고 하세요. 아레나를 시작하는 캠페인 또는 메뉴 경로, 적을 배치하는 함수, 승리 조건을 담당하는 코드를 찾아 달라고 요청하세요. 간단한 변경 계획과 수정할 파일의 정확한 목록도 요청하세요. 에디터를 단순화하려고 기존 전투 루프를 교체하자고 제안한다면 작업을 멈추고 범위를 좁히세요.
시나리오를 데이터로 표현하기
드롭다운에 표시되는 이름보다 변경되지 않는 식별자가 중요합니다. 각 필드는 기존 아레나 ID, 적 ID, 스폰 지점 ID 또는 획득 아이템 ID를 참조할 수 있습니다. 디자이너가 나중에 ‘주조소 입구’라는 표시 이름을 바꿔도 고정 ID인 foundry_gate_a를 참조하는 시나리오는 그대로 유효합니다.
시나리오 데이터에는 예를 들어 다음과 같은 필드를 넣을 수 있습니다.
{
"scenario_id": "foundry_arena_01",
"arena_id": "foundry_main",
"player_start_id": "west_platform",
"waves": [
{"delay": 0, "spawns": [{"enemy_id": "raider", "count": 3}]},
{"delay": 20, "spawns": [{"enemy_id": "brute", "count": 1}]}
],
"ammo_budget": 120,
"win_condition_id": "clear_all_waves"
}
위 코드는 설명용 예시이며, 테스트를 거친 스키마는 아닙니다. 단위와 시간은 프로젝트의 기존 규칙을 따르세요. 지연 시간을 초 단위로 측정한다면 그 단위를 일관되게 사용하세요. 이벤트가 웨이브를 시작시키는 구조라면 별도의 타이머를 추가하지 마세요. 프로젝트를 업데이트한 뒤에도 커스텀 시나리오를 계속 사용할 계획이라면 스키마 버전을 포함하고, 삭제된 적이나 아레나의 ID를 참조할 때 어떻게 알릴지 정하세요.
제작자가 시나리오를 만들고 배포하는 방식에 맞춰 데이터 형식을 선택하세요. Godot의 안정 버전 문서에서는 Inspector에서 편집하고 텍스트나 바이너리로 직렬화할 수 있는 커스텀 Resources를 설명합니다. Godot의 게임 저장 튜토리얼은 단순한 런타임 상태를 저장하는 데 JSON을 사용하고, 타입 변환이나 커스텀 인코딩 등 선택에 따른 장단점을 설명합니다. Unity 6.1 문서는 ScriptableObject를 클래스 인스턴스와 독립적인 에디터용 데이터 컨테이너로 설명합니다. 각 방식의 쓰임이 다르므로 기존 프로젝트가 데이터를 어떻게 패키징하고 불러오는지 확인하세요.

유효하지 않은 시나리오의 실행 막기
전투 씬이 시작되기 전에 데이터를 검증하세요. 선택한 아레나가 존재하는지, 플레이어 시작 지점이 해당 아레나에 속하는지, 모든 적 ID가 등록되어 있는지, 웨이브 수와 지연 시간이 유효한지, 전투를 끝낼 수 있는 조건이 있는지 확인하세요. 게임에서 자원 소모량을 계산한다면 명확한 예산 한도를 적용하세요. 획득 가능한 아이템으로 충족할 수 없는 값은 허용하지 마세요.
오류 메시지에는 문제가 있는 필드와 필요한 조치를 구체적으로 표시하세요. ‘2번 웨이브에 알 수 없는 적 ID가 있습니다’가 ‘유효하지 않은 시나리오입니다’보다 유용합니다. 스폰 지점이 플레이 가능 범위를 벗어났다면 어느 지점이 잘못됐는지 제작자에게 알려 주세요. 기본값으로 조용히 대체하는 방식은 피하세요. 정상적으로 저장된 것처럼 보이는데 실행하면 다른 적이 등장할 경우, 제작자의 시간을 낭비하고 데이터 오류를 가릴 수 있습니다.
현재 게임에 맞는 제약을 적용하세요. 매우 좁은 아레나가 규칙상 허용되더라도 플레이어에게 불리할 수 있습니다. 에디터는 공간이 프로젝트에서 정한 기준보다 좁을 때 경고할 수 있지만, 밸런스까지 자동으로 판단할 수 있는 것처럼 보여서는 안 됩니다. 적의 수, 시야, 탄약, 난이도는 서로 영향을 줍니다. 정적 검사는 잘못된 데이터를 찾아낼 수 있고, 전투가 재미있고 클리어할 수 있는지는 여전히 플레이 테스트를 통해 확인해야 합니다.
검증 로직은 전투 로직과 분리하세요. 간단한 검증기가 오류와 경고 목록을 반환하면 미리보기 화면에서 메시지를 표시하고, 실행을 막는 오류가 해결될 때까지 시작 버튼을 비활성화할 수 있습니다. 이렇게 하면 기존 아레나 로더가 일부만 유효한 데이터를 해석할 필요가 없습니다.
실제 전투 실행 경로에서 미리보기
미리보기는 일반 경기와 동일한 시나리오 로딩 경로를 사용할 때에만 유용합니다. 에디터에서 시나리오 데이터를 저장하거나 메모리에 유지한 다음, 기존 아레나 진입점을 통해 전달하세요. 실제 전투 씬과 다른 방식으로 적을 배치하는 모의 미리보기를 만들어 놓고 통합이 끝났다고 판단하지 마세요.
초기 구현 범위는 기본 제공 아레나 하나와 소수의 등록된 적 ID로 잡으세요. 웨이브 2개, 자원 예산 1개, 기존 클리어 조건을 사용하는 커스텀 전투를 추가하세요. 현재 캠페인 시나리오는 비교 기준으로 보존하세요. 에디터를 도입하기 전후로 이동, 무기, 적, 재시작의 동작을 같은 조건에서 비교하세요.

AI를 활용해 검토하기 쉽게 구현하기
AI 어시스턴트에 지켜야 할 조건을 간결하게 전달하세요. 기존 이동 및 전투 스크립트를 유지하고, 아레나, 스폰, 적, 진행 타이밍, 자원은 이미 지원하는 옵션만 노출하세요. 시작 전에 데이터를 검증하고 기본 제공 시나리오는 기존 경로로 계속 불러오도록 하세요. 데이터 형식에 관한 가정, 변경한 파일, 마이그레이션에 미치는 영향, 롤백 절차도 알려 달라고 요청하세요.
변경 사항은 작은 단위로 나눠 검토하세요. 시나리오 ID가 그대로 유지되는지, 참조 대상이 없을 때 문제를 파악할 수 있는 오류 메시지가 표시되는지, 에디터가 기본 제공 콘텐츠를 덮어쓰지 않는지 확인하세요. 사용자가 만든 시나리오를 별도로 저장한다면 저장 영역을 명확히 구분하세요. 로딩 동작을 비교할 수 있도록 원본 프로젝트 사본과 기존 시나리오 파일을 하나 이상 보관하세요.
AI가 생성한 코드가 그럴듯해 보여도 전투 로직을 중복 구현하거나 에디터 전용 에셋에 알게 모르게 의존할 수 있습니다. 대상 구성으로 프로젝트를 빌드하고 런타임 로그를 확인하세요. 에디터에서 미리보기가 성공했다는 사실만으로는 내보낸 콘텐츠가 제대로 로드되거나 전투 밸런스가 적절하다고 판단할 수 없습니다.
에디터 화면과 콘텐츠 로딩 경로 모두 테스트하기
간단한 테스트 표를 만들고 프로젝트 버전, 시나리오 ID, 실행 절차, 예상 결과, 실제 결과를 기록하세요. 아래 표는 권장 점검 항목이며, 가상의 아레나가 이 테스트를 통과했다는 뜻은 아닙니다.
| 테스트 사례 | 확인 방법 | 예상 동작 |
|---|---|---|
| 기본 제공 시나리오 | 기존 메뉴에서 원래 아레나를 시작합니다. | 캠페인과 전투가 기존대로 동작합니다. |
| 유효한 커스텀 데이터 | 등록된 적으로 구성된 웨이브 2개와 허용 범위 내의 예산으로 시나리오를 불러옵니다. | 플레이어 배치, 스폰, 진행 타이밍, 클리어 조건이 데이터와 일치합니다. |
| 알 수 없는 참조 | 적 ID가 누락된 테스트용 복사본을 사용합니다. | 검증 과정에서 누락된 필드를 알려 주고 실행을 차단합니다. |
| 경계 사례 | 스폰 지점을 아레나 경계 근처나 바깥에 배치합니다. | 프로젝트 규칙에 따라 에디터가 경고하거나 해당 배치를 거부합니다. |
| 반복 재시작 | 같은 시나리오를 여러 번 재시작합니다. | 스폰 상태와 자원 수량이 매번 일관되게 초기화됩니다. |
내보낸 빌드가 출시 대상에 포함된다면 해당 빌드도 테스트하세요. 사용자 시나리오가 빌드에 포함되어 있거나 의도한 위치에서 로드되는지, 기본 제공 콘텐츠가 계속 작동하는지, 지원하지 않는 데이터를 게임이 임의로 바꾸지 않고 알려 주는지 확인하세요. 테스트 결과는 설계 권장 사항 및 콘셉트 아트와 구분해 보관하세요.
자주 묻는 질문
커스텀 전투 시나리오 에디터에서 어떤 항목을 설정해야 하나요?
현재 게임이 이미 지원하며 제작자가 설정할 수 있는 항목부터 시작하세요. 아레나 경계, 플레이어 시작 지점, 적 스폰 그룹, 웨이브 지연 시간, 자원 예산, 클리어 조건이 여기에 해당합니다. 무기 동작과 적 AI는 해당 시스템에서 이미 안전하게 조정할 수 있는 매개변수를 제공하는 경우에만 에디터에 노출하세요.
시나리오 데이터는 JSON으로 저장해야 하나요, 엔진 리소스로 저장해야 하나요?
프로젝트와 시나리오 제작 방식에 맞는 형식을 선택하세요. Godot 문서는 커스텀 Resources를 편집 가능한 데이터 에셋으로 설명합니다. Godot의 저장 튜토리얼에서는 단순한 런타임 상태에 JSON을 사용하고 그 한계를 설명합니다. Unity는 ScriptableObject를 프로젝트 데이터 컨테이너로 설명하며, 이를 사용한다고 해서 런타임 저장 시스템이 자동으로 갖춰지는 것은 아닙니다.
유효하지 않은 커스텀 아레나가 실행되는 것을 어떻게 막나요?
미리보기를 시작하기 전에 필수 항목을 검증하세요. 등록된 아레나, 경계 안에 있는 플레이어 시작 지점, 유효한 스폰 그룹 1개 이상, 0 이상의 지연 시간, 등록된 적 ID, 도달할 수 있는 출구 또는 달성 가능한 승리 조건이 필요합니다. 문제가 있는 필드를 조용히 무시하지 말고 어떤 필드를 수정해야 하는지 표시하세요.
에디터를 추가하면서 기존 슈터의 동작을 어떻게 유지하나요?
에디터는 시나리오 데이터를 생성하는 역할만 맡고, 기존 전투 시스템이 범위를 제한한 진입점을 통해 그 데이터를 사용하도록 하세요. 이동, 무기, 적의 행동, 캠페인 로딩은 그대로 유지하고 AI가 만든 변경 사항을 적용하기 전에 파일별 차이를 검토하세요.
커스텀 시나리오를 공유하기 전에 무엇을 테스트해야 하나요?
기본 제공 시나리오, 유효한 커스텀 시나리오, 필드가 누락되거나 유효하지 않은 경우, 일부러 좁게 만든 아레나, 반복 재시작을 테스트하세요. 프로젝트 버전과 실행 절차도 기록하세요. 화면으로 미리 보기만 해서는 전투의 밸런스가 적절한지, 클리어할 수 있는지 확인할 수 없습니다.
데이터 처리 경로를 안정화한 뒤 에디터 확장하기
아레나 하나와 이미 지원하는 값 몇 가지로 시작하세요. 시나리오 데이터 처리, 검증, 런타임 로딩에 안정적인 경로가 마련된 뒤에 더 세밀한 배치 기능이나 공유 기능을 추가하세요. 이렇게 하면 기능을 이해하고 롤백하기가 쉬워지며, 기존 슈터의 플레이 감각에 영향을 줄 가능성도 낮아집니다.
브라우저에서 플레이할 별도의 프로토타입을 구상 중이라면 SEELE AI Game Maker를 사용해 보세요. 이 링크는 별도의 프로토타입을 만드는 용도이며, 기존 슈터 프로젝트를 편집하는 기능을 안내하는 링크는 아닙니다.


