플레이어 밸런싱 도구 제작: 값 편집·결과 예측·플레이 중 확인

값을 고친 자리에서 결과까지 확인하는 조절 창

DCB에는 맨몸·지게 상태별 이동과 스태미너, 짐 적재율에 따른 배율, 배고픔·갈증의 단계별 효과가 있다. 이 값을 조정하려면 서로 연결된 결과를 함께 봐야 한다. 달리기 소모를 낮추면 달릴 수 있는 시간이 늘고, 회복 배율을 바꾸면 다음 이동을 준비하는 시간도 달라진다.

이를 위해 Unity에 플레이어 밸런스 조절 창을 만들었다. 맨몸과 지게 값을 나란히 편집하고, 적재 곡선과 계산 표를 확인한 뒤 플레이 중 수치와 비교하는 흐름이다. 고갈이나 갈증 2단계를 시험하려고 자원이 자연히 줄어들 때까지 기다리는 대신, 버튼으로 해당 조건에 바로 들어갈 수 있게 했다.

에디터 메뉴의 Deluge/Balance/플레이어 밸런스 조절에서 여는 JigeCarryBurdenTunerWindow다. 클래스 이름에는 지게가 남아 있지만 현재 화면은 이동·스태미너·체력·배고픔·갈증을 함께 다룬다.

2026년 10월 19일 도구·카탈로그·플레이어 적용 경로·검사 소스와 10월 1~2일 커밋을 대조했다. 글 날짜는 자원 조절까지 확장한 10월 2일의 대표 작업 작성일이다. 이번에 Unity 창을 열거나 Play Mode로 도구를 다시 실행하지는 않았다. 아래 흐름도는 코드 구조를 설명하며 실제 도구 화면을 촬영한 자료는 아니다.

원본 값과 임시 시험값의 책임을 나눈다

조절 값은 원본과 사용 목적에 따라 세 종류로 나눴다.

배고픔·갈증의 감소량과 문턱은 원래 플레이어 프리팹 컴포넌트에 있었다. 작업 기록에서 Play 중 고친 값이 종료 뒤 사라지는 문제를 확인했고, 해당 규칙을 카탈로그로 옮겼다. 반면 최대 자원 등의 시트 원본은 그대로 두고 시험 경로를 제공했다.

이 구분 덕분에 저장할 규칙을 편집하는 중인지, 현재 자원을 바꿔 특정 상황을 재현하는 중인지 알 수 있다. 원본 시트로 값을 보내는 일까지 자동화한 도구는 아니다.

비교하는 단위로 여섯 영역을 구성한다

단위와 조건도 표시한다. 이동 속도는 m/s, 지속 소모는 초당, 배고픔·갈증 감소는 10초당이다. 단계 문턱은 최대치 대비 비율이 아니라 현재 자원 수치 기준이다. 예를 들어 최대 갈증을 바꾸더라도 문턱 25가 자동으로 최대치의 25%가 되는 것은 아니다.

현재 지게 질주는 꺼져 있지만 속도 칸은 별도 공격 문턱에도 사용된다. 따라서 칸이 존재한다는 이유로 그 이동 상태를 플레이어가 선택할 수 있다고 설명하지 않고, 해당 조건을 툴팁으로 함께 적었다.

곡선 하나의 효과를 배율과 결과 표로 확인한다

적재 곡선은 속도·소모·회복을 각각 편집한다. 같은 그래프에 색을 나누어 그리고 예시 적재율의 세 배율을 함께 표시한다. 표는 적재율 0·25·50·75·100·150·200%를 비교한다.

프리셋은 무효과·완만·기본값·혹독으로 구성했다. 예를 들어 완만 프리셋의 100% 적재 지점은 속도 0.92배, 소모 1.25배, 회복 0.9배다. 버튼을 누르면 세 곡선의 속성값을 함께 바꾼다.

프리셋에 있는 값과 현재 저장된 값은 다르다. 이번에 확인한 카탈로그의 적재 속도·소모·회복 곡선은 모두 1배다. 프리셋을 제공한다는 사실을 실제 게임에 그 부담이 적용된 결과로 쓰지 않는다.

지게 부담 끄기 버튼도 범위가 정해져 있다. 지게 스태미너 모드를 맨몸 값으로 맞추고 적재 곡선을 무효과로 바꾼다. 이동 속도 영역의 맨몸·지게 기준 속도까지 모두 같은 값으로 만드는 버튼은 아니다.

계산 표는 플레이 결과의 대체물이 아니다

지속 소모량이 일정하다고 가정하면 예상 시간과 거리는 다음처럼 계산한다.

가상의 최대 스태미너 120, 초당 소모 10, 속도 4m/s라면 예상 시간은 12초, 거리는 48m다. 이 숫자는 식을 설명하는 독립 예시이며 DCB의 현재 설정이나 실제 이동 측정값이 아니다. 소모가 0에 가까우면 이 표는 무한대로 표시한다.

회복 시간은 회복 지연에 기본 회복 시간 ÷ 회복 배율을 더한다. 소모가 있는 걸음은 회복하지 않는다고 표시한다. 배고픔·갈증 표는 지정 최대치에서 1단계·2단계·0까지 걸리는 시간과 자원 0 이후 체력 감소 시간을 계산한다.

이 표는 인벤토리 무게·갈증·물속 감속, 배고픔·갈증의 회복 패널티 등을 제외한다. 환경과 상태 이상으로 더해지는 감소도 별도다. 따라서 표의 거리는 충돌·경사·공격 중단을 포함해 실제로 달린 거리가 아니다. 기본 설정의 관계를 먼저 보고 실제 상태에서 차이를 확인하는 용도다.

현재 배고픔·갈증이 적용하는 문턱과 회복 시간·운반 한도·이동·체력의 실제 보정 경로는 행동 비용과 회복 분석에 추가했다. 도구의 단순 예상 표와 두 자원의 회복 패널티까지 반영한 계산을 구분해 볼 수 있다.

편집한 값이 플레이어에 도달하는 경로

창은 SerializedObject.Update()로 값을 읽고, SerializedProperty를 편집한 뒤 ApplyModifiedProperties()로 반영한다. 변경이 적용된 경우 런타임 전달 경로를 호출한다. 속성 반영과 Undo 기록의 의미는 Unity의 ApplyModifiedProperties 문서와 대조했다.

flowchart TD
    A[조절 창의 속성 편집] --> B[카탈로그 변경과 Undo 기록]
    B --> C{플레이 중 카탈로그 연결}
    C -->|같은 에셋| D[기존 런타임 참조]
    C -->|별도 인스턴스| E[편집 카탈로그를 런타임에 복사]
    C -->|미로드| F[기본값 사용 경고]
    D --> G[이동과 행동 설정 재적용]
    E --> G
    G --> H[상태별 속도와 적재 보정 갱신]
    B --> I[저장 버튼으로 에셋 기록]

런타임이 같은 에셋을 참조하면 그 값을 사용한다. 다른 카탈로그 인스턴스를 사용하면 에디터 JSON 직렬화로 편집값을 덮어쓴다. 이후 ReapplyBalanceCatalog()가 이동 컨트롤러·행동 설정·현재 이동 상태의 속도와 적재 보정을 다시 적용한다. 배고픔·갈증 시스템은 각 고정 스텝에서 카탈로그를 읽으며, 이미 같은 단계에 있더라도 적용했던 패널티 값과 비교해 달라진 배율을 다시 건다.

카탈로그를 로드하지 않은 씬은 코드 기본값으로 움직이므로 창의 편집이 플레이에 반영되지 않는다고 경고한다. 에디터에서 값을 바꾼 사실과 실제 실행이 읽는 원본을 구분하기 위한 표시다.

플레이 중에는 재현 조건과 관찰값을 함께 둔다

실측 영역은 현재 이동 상태와 지게 착용·적재량, 상태 속도와 MeasuredGroundSpeed, 이동 소모·회복·행동 비용 배율을 표시한다. 체력·스태미너·배고픔·갈증은 현재값과 최대값을 막대로 보여 준다. 체력의 마지막 감소 원인·양·지난 시간도 확인하는 경로가 있다.

속도 계측은 이동한 양에서 다리 같은 표면에 실려 간 몫을 빼고 지면 방향에 투영해 평활한다. 자원 변화량 역시 표본 사이의 차분에 평활을 적용한 표시다. 프레임별 원시 계측 로그나 정밀한 성능 측정기로 소개하지 않는다.

재현 버튼은 적재율 0·50·100·150%, 스태미너 가득·절반·바닥, 배고픔·갈증 가득·1단계·2단계·0 등을 제공한다. 현재값을 바로 맞춘 뒤 입력과 행동을 반복할 수 있는 구성이다. 시뮬레이션 입력을 현재 플레이어의 최대 자원·회복 시간·용량·적재율에서 가져오는 버튼도 둔다.

시트 값을 시험하되 원본 저장은 분리한다

최대 체력·스태미너는 시트 바닥값에 능력치 보너스가 더해진다. 조절 창은 현재 최대치를 그대로 덮는 대신 바닥값 B0를 바꾸고 능력치 계산을 다시 실행한다. 최대 자원을 낮추면 현재 자원도 그 범위로 제한하고, 올렸다고 현재 자원을 자동으로 가득 채우지는 않는다.

시트 시험 영역에는 현재값·비교 시작값·계산 결과를 나란히 둔다. Play 시작값으로 버튼은 저장해 둔 비교값을 다시 적용한다. 다만 이 비교값은 창이 해당 플레이어의 시트 값을 처음 읽을 때 잡는다. Play 첫 프레임을 항상 보관하는 별도 기록 기능으로 설명하지 않는다.

마음에 드는 값은 시트에 붙일 값 복사로 hp, stamina, staminaRegen, thirst, hunger 다섯 값을 탭으로 이어 클립보드에 넣는다. 원본 시트 반영과 재다운로드는 별도로 진행한다. 이 버튼이 외부 시트에 직접 쓰거나 배포 데이터를 자동 확정하지는 않는다.

저장·되돌리기와 입력 검증의 경계

카탈로그를 편집하면 Play 중에도 에셋 값이 함께 바뀔 수 있다. 창은 이를 안내하고, 변경된 에셋에 저장 *을 표시해 SaveAssetIfDirty()로 기록한다. Undo/Redo 후에는 런타임에도 다시 반영한다. 저장 API의 동작은 Unity 문서를 참고했다.

값 편집에는 하한을 두고, 속도 순서·단계 문턱·패널티 범위 등은 카탈로그의 검증 오류로 보여 준다. 로딩 시 PresetManager는 잘못된 카탈로그를 거절한다. 기존 카탈로그를 만들기/검증 메뉴로 열 때 이미 조정한 값을 기본값으로 덮지 않는 경로도 확인했다.

다만 창의 검증 메시지가 모든 잘못된 편집을 적용 전에 차단하는 것은 아니다. ApplyModifiedProperties() 뒤의 런타임 전달 앞에는 오류 목록으로 중단하는 조건이 없다. 잘못된 관계를 편집한 상태의 적용·복구는 별도 재현이 필요하다. 실험용 카탈로그 자동 복제, 변경 전후 실험 이력 저장과 모든 런타임 시험값의 Undo까지 구현됐다고 확대하지 않는다.

작업 기록과 기여

담당한 부분은 조정 대상을 비교 단위로 모으고, 편집값을 런타임에 전달하며, 계산 예상과 현재 상태를 함께 확인할 수 있게 연결한 도구다. 코드와 검사 작성에는 AI 보조를 사용했으며 관련 커밋에 공동 작성 기록이 있다.

도구가 제공하는 편의는 값을 찾는 위치를 모으고, 같은 조건의 비교와 자원 단계 재현을 바로 할 수 있는 데 있다. 반복 조작이 쉬워진다는 구조적 이점을 설명하는 것이며, 작업 시간 절감률이나 더 좋은 게임 밸런스를 얻었다는 비교 실험은 수행하지 않았다.

확인한 범위와 다음 실행

TunerWindowPathsResolveOnCatalog와 TunerWindowNeedPathsResolveOnCatalog는 도구의 속성 경로가 카탈로그에서 해석되는지 검사한다. 관련 검사에는 계산·곡선·범위 검증과 에셋의 자원 규칙 직렬화 확인도 있다. 이것이 버튼 클릭·Undo·복사·실제 자원 변화를 모두 재현한 GUI 검사라는 뜻은 아니다.

이번에는 해당 코드와 저장값·커밋을 읽어 대조했다. Unity 컴파일·EditMode·Play Mode·도구 화면 촬영·시트 반영·새 밸런스 비교를 실행하지 않았다. DCB 파일과 기존 작업 중 변경도 수정하지 않았다.

다음 실행에서는 카탈로그 미로드·같은 참조·별도 인스턴스를 나눠 적용을 확인한다. 곡선 변경과 Undo/저장/Play 종료 후 유지, 자원 단계 버튼, 시트 바닥값 재계산·복사·재로드를 각각 확인해야 한다. 같은 동선·시작 자원·입력에서 계산 표와 실측값을 대조하고, 제외된 보정 때문에 생기는 차이도 기록한다.

실제 속도·비용 계산은 지게 운반 규칙 분석, 후속 제어 요소는 게임플레이 밸런싱과 제어에서 이어서 볼 수 있다.