커스텀 룰셋 편집기는 카드 배틀 RPG에 다양성을 더할 수 있지만, 덱 구성 규칙, 캐릭터 역할, 카드 효과, 전투 처리, 진행도, 저장 데이터와 밀접하게 맞물립니다. 편집기는 게임이 지원하는 옵션을 정해진 방식으로 선택하는 도구로 설계하세요. 전투 로직 자체를 다시 작성할 수 있게 해서는 안 됩니다. 기능을 제한한 로컬 편집기부터 시작하고, 매치 전에 데이터를 검증하며, 출시 버전에 포함된 룰셋을 안전한 기본값으로 유지하세요.

이 가이드는 이미 작동하는 카드 RPG를 확장하는 경우를 다룹니다. 예시와 카드 풀, 캐릭터 역할, 테스트 결과는 모두 가상입니다. 확인할 수 있는 저장소, 전투 처리기, 덱 데이터, 빌드, 플레이테스트는 없었습니다. 아래에서 제안하는 테스트는 완료되었거나 성공한 테스트 결과로 해석해서는 안 됩니다.
편집 옵션을 추가하기 전에 현재 규칙 기록하기
작업을 시작하기 전에 변경 사항을 정리해 커밋하거나 별도의 프로젝트 사본에서 작업하세요. 내장 룰셋, 매치 시작 방식, 덱 검증 방식, 캐릭터 역할에 따라 카드 사용이 제한되는 방식, 턴과 효과를 처리하는 서비스를 기록하세요. 규칙과 진행도가 어디에 저장되는지도 적어 두세요. 게임을 로컬에서 실행할 수 없다면 검토한 코드를 문서화하고, 실행 시 동작은 미검증 상태로 남겨 두세요.
편집기를 추가한 뒤에도 반드시 지켜야 할 조건을 목록으로 정리하세요. 예를 들어 카드 비용은 0 이상이어야 하고, 캐릭터 역할별로 허용되는 카드 계열은 유지되어야 하며, 턴 순서는 동일한 조건에서 항상 같아야 하고, 출시 버전의 모드는 현재 설정을 유지해야 할 수 있습니다. 이런 조건은 대상 프로젝트에서 확인할 사항이며, 모든 카드 RPG에 공통으로 적용되는 것은 아닙니다.
| 시스템 | 현재 동작을 확인할 항목 | 기본적으로 유지할 사항 |
|---|---|---|
| 전투 처리기 | 턴과 효과를 담당하는 구성 요소, 이벤트 순서 | 전투 처리기를 중복 구현하거나 교체하지 않음 |
| 덱 규칙 | 덱 크기, 캐릭터 역할과의 호환성, 동일 카드 장수 제한 | 기존 덱 구성 검증 유지 |
| 카드 데이터 | 비용, 대상, 효과 관련 필드와 ID | 공용 카드 카탈로그를 수정하지 않음 |
| 모드 및 저장 데이터 | 내장 프리셋, 진행도, 저장 스키마 | 커스텀 룰셋 초안을 별도 보관 |
AI에는 실제로 제공한 파일만 검토하고 파일별 변경 계획을 작성하도록 요청하세요. 현재 규칙 검증과 전투 실행을 각각 어느 구성 요소가 담당하는지도 명시하게 하세요. 프로젝트의 규칙 적용 우선순위와 데이터 경계를 파악하기 전에는 광범위한 코드 재작성을 받아들이지 마세요.
편집할 룰셋의 범위 좁히기
매치 길이, 덱 제한 프리셋, 지원되는 카드 계열 규칙 한 가지처럼 기존 게임이 이미 안전하게 처리할 수 있는 옵션 몇 가지로 시작하세요. 각 옵션에는 명확한 이름과 허용값, 기본값이 있어야 하며, 캐릭터 역할과 함께 적용될 때 어떻게 동작하는지도 정해야 합니다. 첫 버전에서는 임의의 스크립트나 카드의 모든 숫자 필드를 편집할 수 있게 하지 마세요.
가상의 Ashen Archive 예시에서는 로컬 커스텀 프리셋으로 시작 시 자원 상한, 동일 카드의 최대 장수, 특정 카드 계열의 허용 여부를 설정합니다. 이는 설명을 위한 예시입니다. 실제 프로젝트에서는 이런 옵션을 지원하지 않을 수 있습니다. 전투 시스템에서 각 옵션이 어떤 의미를 갖는지 정의한 뒤에 추가하세요.

규칙 적용 우선순위를 명확히 문서화하세요. 전역 프리셋이 특정 카드를 제한하고 캐릭터 역할에도 별도의 제한이 있다면, 어떤 규칙을 적용할지와 두 조건을 모두 충족해야 하는지를 정하세요. 카드별로 규칙 값을 덮어쓸 수 있다면 허용할 필드를 정의하고, 기존 카드 ID는 그대로 유지하세요. 편집기 화면에 표시되는 순서에 따라 매치 동작이 결정되어서는 안 됩니다.
규칙 데이터와 전투 처리 분리하기
기존 매치 설정 로직과 검증기가 읽을 수 있는 룰셋 값 객체를 사용하는 편이 좋습니다. 편집기는 그 데이터만 변경하고, 턴과 효과는 기존 전투 처리기가 계속 처리합니다. 이렇게 하면 룰셋을 작성하는 동작과 실제 전투 동작이 분리되어 커스텀 매치를 기본 프리셋으로 진행한 매치와 비교하기 쉬워집니다.
룰셋 데이터 레코드에는 스키마 버전, 룰셋 ID, 룰셋의 기반이 된 게임 버전, 지원되는 옵션의 값, 표시 이름 등을 담을 수 있습니다. 실행 가능한 표현식은 제외하고 데이터만 저장하세요. 검증된 옵션을 기존 규칙에 매핑하는 일은 게임이 맡습니다. 현재 전투 처리기가 어떤 값을 반영할 수 없다면, 편집기에서 그 값을 저장하는 것만으로 효과가 적용되는 것처럼 보여서는 안 됩니다.
Godot의 JSON 문서에서는 JSON 텍스트를 Variant로 파싱하고 데이터를 다시 JSON으로 직렬화하는 방법을 설명합니다. 런타임 파일 가이드에서는 FileAccess로 파일을 읽고 쓰는 방법을 사용자 제공 콘텐츠 예시와 함께 설명합니다. 이 문서들은 엔진에 해당 API가 있다는 근거입니다. 이 예시의 스키마를 권장하거나 안전성을 보장하거나, 실제로 작동하는 Ashen Archive 구현을 보여 주지는 않습니다.
플레이어가 작성한 데이터는 사용하기 전에 버전과 모든 필드를 검증하세요. 프로젝트에 상위 버전과의 호환을 위한 정책이 없다면 알 수 없는 규칙 ID는 거부하세요. 프로젝트에서 정한 최솟값과 최댓값을 적용하고, 알려진 카드 계열 식별자와 유효한 캐릭터 역할 키만 허용하세요. 규칙 파일을 바탕으로 임의의 리소스 인스턴스를 만들거나 파일의 텍스트를 코드로 실행하지 마세요. 게임이 콘텐츠 가져오기를 지원한다면 그 경로도 테스트하고 제약 사항을 별도로 문서화하세요.
내장 모드와 기존 저장 데이터 보존하기
커스텀 룰셋 초안은 공식 모드 및 진행도와 분리해 저장하세요. 플레이어가 프리셋을 편집하면 사본을 만들고, 원본을 알림 없이 덮어쓰지 않도록 하세요. 업적이나 랭크전, 캠페인 상태 저장 기능이 있는 게임이라면 커스텀 규칙으로 진행한 매치의 결과를 구분해 관리하세요. 커스텀 규칙으로 이런 기능을 이용할 수 있는지는 제품 정책으로 명확하게 정해야 합니다.
스키마에 버전을 부여하고 룰셋의 기반이 된 게임 버전도 기록하세요. 필드가 변경될 때는 데이터를 마이그레이션할지, 아니면 이유를 알리고 로드를 거부할지 정하세요. 기존 저장 데이터와 사용자 룰셋의 사본으로 두 경로를 모두 테스트하세요. 프로젝트 책임자가 기본값을 지정하지 않았다면 누락된 필드에 밸런스에 영향을 주는 값을 임의로 적용하지 마세요.
| 호환성 확인 사례 | 확인할 질문 | 확인 근거 |
|---|---|---|
| 이전 버전의 커스텀 파일 | 이 스키마 버전을 마이그레이션할 수 있나요? | 마이그레이션 전에 복사해 둔 테스트 데이터 |
| 누락된 옵션 | 문서에 명시된 기본값이 있나요? | 기본값 적용 동작을 검증한 결과 |
| 알 수 없는 카드 계열 | 로드를 거부해야 하나요, 아니면 경고를 표시해야 하나요? | 오류가 표시되고 알림 없이 다른 값으로 대체되지 않음 |
| 내장 프리셋 | 편집 시 출시 버전의 값이 바뀔 수 있나요? | 원본 프리셋의 해시 또는 사본 |
| 커스텀 매치 결과 | 캠페인이나 랭킹에 영향을 주나요? | 명시적인 모드 정책 |
첫 버전에 필요한 편집 기능만 구현하기
최소한의 편집 화면에는 지원하는 설정 목록, 실제 적용될 규칙의 미리보기, 검증 결과 요약, 다른 이름으로 저장, 복제, 기본값으로 되돌리기 기능이 필요합니다. 어떤 제약이 선택한 캐릭터 역할에서 비롯되는지 표시하세요. 선택한 옵션이 캐릭터 역할이나 카드 세트와 충돌한다면 전투 도중에 실패하게 두지 말고, 매치를 시작하기 전에 충돌 이유를 알려 주세요.
단위를 명확히 표시하고 입력 범위를 제한하세요. 프로젝트에 근거가 있을 때만 옵션에 ‘밸런스가 검증된’ 또는 ‘경쟁전용’ 같은 이름을 붙이세요. 현재 출시 버전의 동작과 동일한 기본 룰셋을 제공하고, 언제든 쉽게 돌아갈 수 있게 하세요. 고급 필드는 런타임, UI, 테스트가 모두 해당 필드를 지원할 수 있을 때 공개하세요.
생성된 일러스트 속 가상 인터페이스는 시각적 콘셉트입니다. 실제 룰셋 편집기, 실제 게임 데이터, 완료된 검증 결과를 보여 주는 것은 아닙니다. 실제 프로젝트에서는 기존 UI 패턴에 맞춰 편집기를 만들고, 별도의 규칙 서비스를 새로 만드는 대신 이미 있는 서비스를 재사용하세요.
최소 범위의 패치와 롤백 계획 세우기
코드 변경을 받아들이기 전에 수정해도 되는 파일을 적어 두세요. 첫 작업은 편집 화면 하나, 룰셋 모델이나 어댑터, 검증 진입점, 로컬 초안 저장 서비스, 해당 변경을 확인하는 테스트 정도로 제한할 수 있습니다. 프로젝트를 검토해 변경이 필수인 의존 관계가 확인된 경우를 제외하고는 전투 처리기, 전체 카드 데이터베이스, 캐릭터 역할 로직, 내장 프리셋, 캠페인 저장 데이터 읽기 로직을 그대로 유지하세요.
전체 diff를 검토하세요. AI에 변경된 파일을 하나씩 설명하고 기본값, 이벤트 순서, 카드 값, 진행도 관련 훅에 변경이 있는지 짚어 달라고 요청하세요. 코드 변경 사항을 허용 목록과 대조하세요. 작업이 전체 카드 풀의 밸런스 조정이나 전투 리팩터링으로 확대되면 일단 멈추고, 범위를 별도로 정한 변경 작업으로 나누세요.
작업은 브랜치나 변경 사항이 없는 사본에서 진행하세요. 마이그레이션 전에 기본 프리셋 샘플과 기존 규칙 파일의 사본을 보관하세요. 커스텀 룰셋이 기존 모드를 바꾸거나 정상적으로 쓰이던 덱이 예상치 않게 덱 구성 규칙을 위반하게 되면, 작업 전 기준 상태로 되돌린 뒤 패치 범위를 줄이세요. 롤백 방법은 실제로 수행할 수 있는 버전 관리 작업으로 정해 두세요.
사본에서 규칙 간 상호작용 테스트하기
각 옵션을 개별적으로 테스트한 다음 조합을 테스트하세요. 전역 제한, 역할별 덱 규칙, 동일 카드 장수 제한, 매치 설정이 겹칠 때 어떻게 동작하는지 확인하세요. 유효한 커스텀 매치, 규칙을 위반한 덱, 지원하지 않는 값, 이전 스키마, 누락된 필드, 내장 프리셋으로 되돌리는 동작을 검증하세요. 호환성이나 밸런스를 확인했다고 말하려면 실제 프로젝트에서 이 사례들을 테스트해야 합니다.

| 권장 확인 항목 | 수행 작업 | 기록할 내용 |
|---|---|---|
| 기본 룰셋 회귀 테스트 | 출시 버전의 규칙으로 동작이 알려진 매치 시작 | 빌드, 프리셋, 덱, 관찰한 전투 처리 흐름 |
| 역할 호환성 | 각 캐릭터 역할로 제한이 적용되는 카드 사용 | 검증 결과와 그 이유 |
| 허용 범위 | 허용 범위를 벗어난 값 입력 | 입력 거부와 수정 여부, 알림 없이 값을 범위 안으로 조정하지 않는지 여부 |
| 잘못된 형식의 콘텐츠 | 필드가 누락되었거나 유효하지 않거나 이후 버전의 필드가 포함된 데이터 로드 | 안전한 로드 거부와 해결 방법을 알 수 있는 오류 메시지 |
| 저장 데이터 마이그레이션 | 이전 커스텀 룰셋의 사본 로드 | 마이그레이션 결과 또는 문서에 명시된 로드 거부 |
| 롤백 | 변경 사항이 없는 기준 브랜치로 복원 | 기본 모드가 이전과 동일하게 작동하는지 여부 |
이 표는 테스트 계획이며, 테스트를 완료한 기록이 아닙니다. 테스트할 때는 게임 버전, 룰셋 버전, 캐릭터 역할, 덱 ID, 수행한 동작, 예상 동작, 실제 동작, 차이가 있다면 그 내용까지 기록하세요. 목업만으로는 규칙 조합이 공정한지, 이전 저장 데이터가 여전히 로드되는지 확인할 수 없습니다.
자주 묻는 질문
커스텀 룰셋 편집기에서 어떤 항목을 설정할 수 있어야 하나요?
턴 수 제한이나 문서화된 카드 제한 몇 가지처럼 기존 전투 시스템이 안전하게 처리할 수 있는 매치 옵션만 제공하세요. 규칙 값에는 허용 범위를 정하고 쉽게 이해할 수 있도록 표시하세요. 첫 버전에서 핵심 전투 처리기, 캐릭터 성장 방식, 카드 효과 전반을 다시 작성할 수 있게 해서는 안 됩니다.
커스텀 규칙 때문에 카드 전투가 제대로 작동하지 않는 일을 어떻게 막을 수 있나요?
전투에 관한 최종 판단은 기존 전투 처리기에 맡기고, 검증된 룰셋 객체를 전달하세요. 전역 규칙, 캐릭터 역할, 카드 텍스트가 맞물릴 때 어떤 규칙이 우선하는지 정의하세요. 기본 규칙으로 동작이 알려진 매치를 테스트하고, 편집기를 추가한 뒤 결과를 비교하세요.
플레이어가 카드의 모든 값을 편집할 수 있게 해야 하나요?
피해량이나 비용을 임의로 바꾸거나 효과 스크립트를 편집하게 하기보다, 지원하는 옵션 몇 가지를 허용 목록으로 정해 시작하세요. 숫자 값에는 허용 범위를 두고, 지원하지 않는 조합은 거부하세요. 게임에서 해당 규칙의 동작이 명확히 정의되어 있고 다른 규칙과의 상호작용을 확인할 테스트 사례가 있을 때만 설정 항목을 추가하세요.
커스텀 룰셋은 어떻게 저장하고 업데이트해야 하나요?
버전이 명시된 데이터 형식을 사용하고, 룰셋의 기반이 된 게임 버전을 기록하며, 사용자가 만든 규칙은 내장 프리셋과 분리하세요. 로드 전에 각 필드를 검증하고 이전 데이터는 마이그레이션하거나 명확한 이유와 함께 로드를 거부할 수 있게 하세요. 기존 저장 데이터와 공식 모드를 보존할 수 있도록 사본에서 변경 사항을 테스트하세요.
AI로 내 게임의 커스텀 카드 룰셋 밸런스를 맞출 수 있나요?
AI는 제공된 규칙을 검토하고 상호작용을 나열하며 테스트 사례 초안을 만드는 데 도움을 줄 수 있습니다. 하지만 실제 카드 풀, 전투 로직, 플레이 데이터 없이는 밸런스를 입증할 수 없습니다. AI가 생성한 수치는 제안으로 다루세요. 룰셋을 공유하기 전에 전체 diff를 검토하고 대표적인 매치를 실행하세요.
기존 전투를 유지하면서 규칙 옵션 추가하기
내장 규칙의 동작을 기록하고, 허용 목록에 있는 소수의 설정을 제공하고, 버전이 명시된 데이터 레코드를 검증한 뒤 지원되는 값만 기존 전투 처리기에 전달하세요. 커스텀 룰셋 초안은 출시 버전에 포함된 프리셋 및 기존 저장 데이터와 분리해 보관하세요. 편집기가 작동한다고 말하기 전에 전체 diff를 검토하고 사본에서 테스트하며, 변경 전 상태로 되돌릴 수 있는 지점을 확보하세요.
별도의 카드 배틀 RPG 콘셉트를 구상해 보고 싶다면 SEELE AI Game Maker를 사용해 보세요. 콘셉트를 구상하는 도구이며 기존 프로젝트를 편집하는 도구는 아닙니다.


