economy-flow

재화 흐름

재화가 어디서 얼마나 들어오고(수입), 무엇에 언제 쓰이며(지출), 판이 끝날 때 얼마나 남는지를 계산한다. 목적은 "보상을 올리면 상점 아이템을 몇 초 일찍 사나", "영구 강화 2단계는 몇 번째 판에 사나", "골드가 남아도나"를 감 대신 계산으로 답하는 것이다.

계산은 기대값이다. 처치 수·드랍 횟수는 "한 판을 평범하게 깬 경우"의 가정이며, 실제 체감이나 재미를 판정하지 않는다.

도구

공용 스킬 studio-data의 studio.py로 한다. 이 스킬과 함께 설치한다. 명령은 게임 프로젝트 폴더에서 Claude Code 설치 기준으로 적었다. Codex는 .agents/skills/…, Windows PowerShell은 python3 대신 py(실행 경로).

명령	하는 일
python3 .claude/skills/studio-data/scripts/studio.py check .	형식·참조 검사, 단계별·누적 수입, 구매 시점(판 안) 또는 판 수(판 사이 재화), 판 끝에 남는 재화
… check . --table economy	단계 수입 표와 구매 계획 표(마크다운)
… view .	재화 흐름 탭: 단계별 수입(출처별), 구매 계획(목표 이탈·살 수 없음 강조), 남는 재화

데이터는 data/economy.json 한 파일이다. 형식은 references/economy-format.md. 적 보상·드랍 테이블·아이템 가격은 progression-economy의 원본에서, 강화·합성 비용은 crafting-balance에서 그대로 가져온다. 프로젝트 폴더(check .)로 검사해야 참조를 확인한다. 쓰는 데이터를 함께 넘기지 않으면 INCOMPLETE다.

절차

1. 재화를 정한다

economy.currencies에 재화를 적는다. 판이 끝나면 사라지는 재화(골드 등)와 판 사이에 남는 재화(carry: true, 메타 재화)를 구분한다. 처치 보상(kill_reward, 적 데이터 reward의 재화는 여기서 정한다), 드랍을 팔 때의 재화와 비율(sell), 가격 출처별 재화(prices: 아이템·강화·합성·영구 강화)를 정한다.

메타 성장 시뮬레이터(simulate)의 설정 파일이 있으면 그 판 사이 재화에 meta_config로 이어 둔다. 시뮬레이터의 전투 계산 모델은 이 파일의 단계 수입과 구매 계획 순서를 그대로 읽을 수 있다(economy 연결, 구매 정책 economy). 한 판 수입과 영구 강화 구매 순서가 두 파일에서 다르면 경고한다.

2. 단계를 적는다

단계는 구역·레벨·웨이브·시간 구간 중 그 게임이 한 판을 나누는 단위다. 전투 계산의 단계와 같은 구간이면 combat_stage에 그 단계 id를 적어 잇는다(처치를 센 적이 그 전투 단계에 나오는지 확인한다). 단계마다:

• duration: 길이(time_unit, 기본 초). 방 단위 게임이면 방 수로 써도 된다.
• kills: 적 id별 기대 처치 수. 적 데이터의 reward를 곱한다.
• drops: 드랍 테이블별 기대 드랍 횟수. 아이템 가격 × 판매 비율의 기대값을 곱한다.
• income: 그 밖의 수입(상자, 퀘스트, 판 사이 재화 지급 등) {재화: 양}.

처치 수와 드랍 횟수는 에이전트가 정하면 가정이다. 사용자에게 "한 판을 평범하게 깨면 이 정도"가 맞는지 확인한다. 레벨을 조우로 적었으면(level-design) 조우로 센 처치 수와 맞춰 본다(kills_differ). 플레이 기록이 있으면 그 값으로 바꾸고 출처를 남긴다(playtest-verdict).

3. 구매 계획을 적는다

플레이어가 보통 사는 순서대로 purchases에 적는다. 가격은 직접 적거나(amount + currency) 원본에서 가져온다.

가격	적는 법
아이템	{"item": "iron_sword"} → 아이템 price
강화	{"enhance": "weapon_plus", "level": 3, "from": 2} → +2에서 +3까지의 기대 비용(from 기본 0)
합성	{"recipe": "forge_iron"} → 합성 비용 ÷ 성공률(재료는 빼고 재화만)
영구 강화	{"upgrade": "weapon_1"} → 영구 강화 cost

구매마다 target([최소, 최대])으로 의도한 시점을 적을 수 있다. 판 안 재화는 시간(time_unit), 판 사이 재화는 판 수다. 상점이나 제작대가 특정 단계부터 열리면 after에 그 단계를 적고, 단계 중간에 열리면 그 시각을 적는다. 그 전에는 돈이 있어도 사지 않는다.

4. 계산하고 읽는다

python3 .claude/skills/studio-data/scripts/studio.py check . --table economy

• 구매 시점: 판 안 재화는 누적 수입이 (앞선 구매 + 이 구매)에 닿는 시점, after의 단계나 시각, 앞 구매 시점 중 가장 늦은 때. 단계 안에서는 고르게 들어온다고 본다.
• requirement_missing: 영구 강화를 선행 조건보다 먼저 사는 계획이다. 순서를 고친다.
• duplicate_purchase·enhance_gap: 같은 영구 강화를 두 번 사거나, 같은 강화의 단계를 건너뛰거나 겹쳐 사는 계획이다.
• 시점이 "앞 구매를 계산하지 못해 미확인"이면 앞의 오류·미확인 구매부터 고친다. 그 재화는 남는 양도 내지 않는다.
• 판 수: 판 사이 재화는 (앞선 구매 + 이 구매) ÷ 한 판 수입을 올림한 값. 한 판을 끝까지 깬다고 가정한 최소값이다. 중간에 지는 판을 반영한 판 수는 메타 성장 시뮬레이터(simulate)로 본다. 두 결과를 비교하기 전에 meta_income_differs·meta_order_differs가 없는지 본다. 있으면 차이의 원인은 지는 판이 아니라 수입·순서 정의다.
• unaffordable: 한 판 수입으로 살 수 없다. 구매 순서·가격·수입을 사용자와 정한다.
• target_out_of_range: 의도한 시점을 벗어났다.
• currency_piles_up: 판 끝에 남는 재화가 leftover_max(수입 대비 비율)를 넘는다. 쓸 곳이 모자라거나 수입이 많다.
• 숫자를 손으로 맞춰 경고를 없애지 않는다. 한 번에 하나만 바꾸고 전·후 표를 남긴다.

보고

• 단계별 수입과 출처(처치·드랍 판매·기타), 한 판 총수입
• 구매별 시점이나 판 수, 목표 이탈과 살 수 없는 구매
• 판 끝에 남는 재화와 그 비율
• 오류·경고 수, INCOMPLETE 여부
• 사용자가 정해야 할 것: 처치 수·드랍 횟수 가정, 구매 순서, 목표 시점

한계

• 기대값만 낸다. 운에 따른 분산(드랍이 몰리거나 안 나오는 판)은 없다.
• 판 사이 재화의 판 수는 매 판을 끝까지 깬다고 본 최소값이다.
• 합성 가격은 재화 비용만 센다. 재료 아이템을 사는 비용은 따로 구매로 적는다.
• 드랍 판매 기대값은 희귀도 칸이면 그 희귀도 아이템 가격의 평균이다(천장은 반영하지 않는다).
• 단계 안에서는 수입이 고르게 들어온다고 본다. 라운드 사이에만 사는 게임은 purchase_timing: "stage_end"를 적는다. 구매가 돈이 모인 단계의 끝으로 옮겨지고 그 장비는 다음 단계부터 쓴다.
• 단계의 누적은 적은 순서대로 지난다고 본다. 스테이지를 골라서 하는 게임은 대표 경로 하나를 순서로 적는다. 어려움 등급을 전투 단계로 나눈 게임도 대표 등급 하나만 적는다.

예시: studio-data/assets/sample-project/data/economy.json (실제 게임 수치가 아니다).