INSTRUCTION

01게임과 제 역할

야간 경비원이 되어 태블릿의 근무수칙을 지키며 5일 동안 학교를 순찰합니다. 하루는 출근 → 회사 문자 지시 → 점검 → 몬스터 조우 → 판정 → 퇴근 · 근무일지 순서로 흐릅니다.

INSTRUCTION 플레이 영상 · YouTube

수칙을 어기면 보이지 않는 청각 · 조도 · 배치 축이 오르고, 오를수록 학교의 소리 · 조명 · 배치가 변합니다. 한 축이라도 끝까지 오르면 붙잡혀 그 밤을 다시 시작합니다. 수칙을 잘 지키면 신뢰가 오릅니다. 신뢰가 높을수록 수칙서 글자가 바뀌는 변조, 수칙과 반대로 시키는 회사 문자(역설), 두 수칙이 부딪히는 딜레마가 늘어나, 잘하는 플레이어일수록 수칙 자체를 의심하게 됩니다.

팀과 역할

프로그래머 둘은 판정 · 런타임 연동(저)과 조작 · UI · 컷신(김진선 님)으로 나눴습니다. 김진선 님은 연출 프리셋, 컷신, 화면 효과, UI처럼 화면에 보이는 부분을 만들었고, 저는 판정, 언제 어디서 어떤 연출을 부를지 정하는 디렉터 · 편성, 그리고 판정 결과에 따라 조명 · CCTV · 조우 몬스터를 움직이는 코드를 맡았습니다. 서로의 파일은 고치지 않기로 정하고, 두 파트는 이벤트(EventBus)와 공개 API로 연결했습니다. 다만 디버깅 모드를 하나로 합칠 때는 제 결정으로 김진선 님의 개발자 모드 파일에 직접 합쳤습니다.

• 고치지 않고 확장하기. 김진선 님의 사망 컷신 Timeline은 그대로 둔 채 재생되는 인스턴스만 보정했습니다.
• 씬 충돌 줄이기. 근무 씬 전용 컴포넌트를 씬 파일에 넣지 않고 실행할 때 코드로 붙였습니다(RuntimeInitializeOnLoadMethod). 덕분에 씬 병합 충돌과 Git LFS 잠금 대기가 줄었습니다.
• 아트와 병렬로. 모델이 확정되기 전에는 대역(임시 모델, Stand-in)으로 조우를 먼저 만들고, 모델이 오면 파일만 교체했습니다.

02구조 — 규칙(Core)과 화면(Flow)

판정 로직은 Unity에 의존하지 않는 일반 C#으로, 화면에 그리는 부분은 MonoBehaviour로 나눴습니다. asmdef로 Core가 Flow를 참조하지 못하게 막았고, Core에서 Flow로는 EventBus 이벤트로만 알립니다.

구조는 AI에게 여러 안을 받은 뒤, 판정 시스템이 없어도 밖에서 축 값을 넣어 볼 수 있는 안으로 골라 달라고 했습니다. 근무 씬이 저장소에 처음 올라온 9월 17일보다 먼저, 축 값을 읽는 인터페이스(IFearAxisReader)를 인스펙터 슬라이더로 구현해 테스트 씬에서 조도 · 청각 변화를 확인했습니다(커밋). 테스트 씬과 슬라이더는 10월 3일에 지웠고(커밋), 지금은 실제 축 시스템이 같은 인터페이스를 구현합니다.

Flow는 NightRun의 공개 정적 멤버로 밤을 시작 · 진행 · 종료하고 현재 상태를 읽습니다. 반대로 Core는 Flow를 직접 호출하지 않고, 구간 변화 같은 이벤트(BandChanged · DirectionEmitted · Captured)만 보냅니다. 연출은 축 수치가 아니라 구간을 보고 바뀝니다.

• 게임을 켜지 않고 검증. Core는 new만 하면 돌아가므로 자동 테스트와 밸런스 시뮬레이션을 에디터에서 바로 돌렸습니다. 테스트 폴더
• 의존 방향은 컴파일 단계에서 막기. asmdef로 Core가 Flow를 참조하지 못하게 해서, 축이 올랐다고 Core에서 바로 불을 끄는 코드는 아예 컴파일되지 않게 했습니다.
• 새 코드를 어디 둘지 정해 둠. 고르는 코드는 편성 · 디렉터, 판단하는 코드는 판정 · 점검, 수치를 올리는 코드는 축, 화면에 그리는 코드는 Flow에 둡니다.

03공포 디렉터 — 놀람을 배분하는 규칙

준비된 효과음과 연출이 많았습니다. 무작위로 내보내면 놀람이 너무 잦아져 금방 무뎌질 거라고 봤습니다. 따로 잰 것이 아니라 제 경험에 비춘 예상입니다. 그래서 규칙을 두고 간격을 조절해 내보내기로 했습니다. 아이디어는 레프트 4 데드 2의 좀비 호드 디렉터에서 얻었습니다.

공포 디렉터는 맵을 돌아다니는 몬스터가 아니라, 놀람의 간격을 조절하는 규칙 묶음으로 만들었습니다. 그날 나올 조우는 편성이 정하고, 디렉터는 언제 · 어디서 터뜨릴지를 고릅니다. 디렉터를 두자는 방향과 무엇을 기준으로 조절할지는 제가 정했습니다.

긴장도에 따라 놀람을 거른다

조우 한 번의 진행

1. 대기
2. 전조
3. 배치 후 목격 대기
4. 대면 · 대응
5. 끝 단서
6. 끝

정해진 시간 안에 시작 조건이 채워지지 않으면 놓침으로 끝납니다. 상태 이름은 코드(EncounterRunState)의 상태와 하나씩 대응합니다.

• 전조는 강도 3 이상 조우에만 1–8초 붙고, 전조만 주고 물러나는 헛예고도 섞습니다. 헛예고는 조우마다 한 번까지입니다.
• 대면하면 그 조우에 걸린 수칙을 기준으로, 플레이어가 수칙대로 대응했는지 판정합니다.
• 앞 조우가 끝나야 다음 조우를 엽니다.

플레이어를 그 자리로 부른다

점검 지시를 바꿀 때 이렇게 요구했습니다. 「점검이 한번에 떠있는게 아니라, 조절해서 메시지로 계속 업데이트 … 플레이어의 동선이나 위치, 긴장도를 계속해서 계산해서」

• 점검 지시를 밤 시작에 한꺼번에 주지 않고 공간 단위 문자로 하나씩 보냅니다. 다음 공간은 거리, 조우가 걸린 공간인지, 같은 동인지로 점수를 매겨 고르고, 조우 중 · 직후나 긴장이 높을 때는 미룹니다.
• 최종판은 날짜별 고정 편성이라(07절) 날짜표에 정한 조우를 하나씩 진행합니다. 앞 조우가 끝나고 15초 뒤에 다음 조우를 준비하고, 플레이어가 오지 않아 시작되지 않으면 「1-3 교실을 순찰하십시오」 같은 문자로 그 공간으로 부릅니다.
• 조우가 남은 채 03:30이 되면 시계를 붙들어, 그날의 조우를 모두 보기 전에는 밤이 끝나지 않습니다. 「이월은 없어. 의도한 날짜에 무조건 목격해야 해」

TensionDirector · TensionPacer · SurpriseBudget · InspectionDispatcherTensionDirector.cs

04수칙 · 지시 · 편성

하룻밤은 태블릿 수칙, 회사 문자 지시, 조우 세 층으로 짜입니다. 셋 다 밤 시작에 정하고, 재시작해도 다시 뽑지 않습니다.

수칙마다 판정기가 하나씩 붙어 센서 신호를 받고 준수 · 위반을 냅니다. 일반 수칙은 처음 어길 때 그 축이 +12(밤에 한 번), 위협 수칙은 조우마다 실패하면 +20이고, 단서가 왔는데 끝까지 지키면 밤 끝에 신뢰가 +2 오릅니다.

신뢰 구간(10 · 18 · 26 · 42)이 오를수록 수칙과 반대로 시키는 역설 문자, 수칙서 글자가 바뀌는 변조, 두 수칙이 부딪히는 회피 불가가 차례로 열립니다. 문자가 무엇을 시키든 판정은 늘 수칙서 원본으로 합니다.

수칙 수와 지시 비중은 제가 정했습니다. 경비실 수칙 K3를 매일 넣고, 장수가 넘치면 조우에 묶이지 않은 수칙부터 빼게 했으며, 점검 지시와 근무 지시의 비중을 맞추게 했습니다. 「물품 점검이 비중이 더 높은데, 지시 사항과 비중이 균일했으면」

난수와 시드

편성기가 난수를 밖에서 받도록 만들어, 게임에서는 회차마다 새 난수를 사용하고 테스트에서만 고정 시드를 넣습니다. 시드 값은 그대로 두었고, 개발 중에는 어떤 항목을 언제 뽑아 고정할지만 달라졌습니다.

테스트는 시드 30개로 4일차 편성을 만들어, 클라이맥스가 늘 맨 뒤에 오는지 확인합니다.

ProgramDirector · NightProgram · ParadoxPlanner · FinalRuleBookNightProgram.cs

05구현 하이라이트

판정 결과를 화면으로 옮기는 부분입니다. 화면에서 무엇이 바뀔지와 그 기준은 제가 정했습니다.

조우별 상태 패턴과 구현

조우는 제가 설계했습니다. 진행은 03절의 흐름을 공통으로 따르고, 시작 조건과 결과가 갈리는 조건은 조우마다 다릅니다.

화장실 소녀

목격 전까지 문이 잠긴다

3번 칸 지시가 오면 칸 앞에 서 있고, 화장실에 들어서면 출입문이 잠깁니다. 소녀를 목격해야 문이 풀리고, 가까이 다가가면 덮칩니다.

• 코루틴으로 문 잠금 · 고정 자리까지 걷기
• 수칙 T4 「변기는 정상입니다」 — 이상이 보여도 [정상] 보고가 정답

Coroutine · StageAnchor

도서관 노란 얼굴

3초 이상 비추면 달아난다

책을 집으면 문간에서 고개로 따라보다가, 쳐다보면 다가옵니다. 손전등으로 3초 버티면 코앞에서 멈췄다 달아나고, 못 비추면 붙잡힙니다.

• 조우 직전 도서관 주변만 런타임 NavMesh 비동기 굽기 + NavMeshAgent
• 손전등 원뿔 판정 · 머리뼈만 돌리는 시선

NavMeshBuilder.UpdateNavMeshDataAsync · NavMeshAgent

교실 소년

교실을 나가려 하면 놀란다

화분을 보고하면, 자리가 시야 밖일 때 앉아 머리를 박기 시작합니다. 3초 넘게 바라보거나 교실을 나서면 덮치고, 아니면 잠시 뒤 사라집니다.

• 시야 밖 등장 판정(뷰포트 + 레이캐스트 가림)
• 바라볼수록 빨라지는 머리 박기(최대 ×3.2)

WorldToViewportPoint · Raycast · Legacy Animation

인체모형

빛을 받는 순간 급습한다

4일차엔 복도 끝에 서 있기만 하다가, 5일차에 손전등이 닿으면 고개를 돌려 돌진합니다. 불을 켜 두면 몸을 뚫고 넘어지고, 꺼 두면 어깨만 스칩니다.

• 손전등 원뿔 + Linecast 가림 판정
• 달리기 클립 없이 뼈를 직접 돌리는 절차적 달리기

Linecast · 절차적 애니메이션

사람나무

바라볼수록 끌려간다

보지 않는 사이 복도로 옮겨 오고, 가까이 갈수록 그쪽으로 끌려갑니다. 바라보면 화면이 울렁이고, 너무 다가가면 수칙 위반입니다.

• 복도 단면을 미리 스캔해 설 자리 탐색, 화면 밖에서만 이동
• 거리에 비례한 끌림(1.5m에서 멈춤) · 화면 울렁임은 팀원 작업

RaycastAll

CCTV 검은 남자

CCTV 화면 속에 나타난다

정해진 채널을 보고 있으면 남자가 화면을 가로지릅니다. 3초 넘게 지켜보면 얼굴이 튀어나오고, 10초 안에 채널을 넘기면 위반입니다.

• 카메라별 렌더러 토글로 CCTV에서만 보이게
• 걷기 속도에 맞춘 애니메이션 재생 속도

beginCameraRendering · Animator.speed

달려오는 발소리

6초 안에 방으로 피해야 한다

복도를 한참 걸으면 등 뒤에서 발소리가 달려옵니다. 6초 안에 방으로 피해 지나갈 때까지 머물면 무사하고, 아니면 검은 사람이 옆을 스쳐 달려갑니다.

• 걸은 거리를 쌓아 방아쇠로
• 수칙 정산 이벤트를 받아 SphereCast로 트인 거리를 재고 질주 연출

EventBus · SphereCastAll

멀리 보이는 몹

똑바로 보면 사각지대로 달아난다

곁눈에 멀리 서 있다가, 똑바로 보거나 다가가면 가려지는 곳으로 달려가 사라집니다.

• 24방향 고리로 사각지대 탐색 + 캡슐 가림 검사
• 수칙 · 판정 없이 긴장 조절에만 사용하는 놀람

Physics.CheckCapsule

구간이 오르면 화면에서 바뀌는 것

조도와 배치 변화는 제가 요구했습니다. 「조도 구간 3 변화에 구간 4 효과처럼 일부 조명만 빨개지거나 깜빡이는 현상」, 「축이 오를 때마다 벽이나 천장에 오브젝트가 생긴다던가, 복도에 가짜 문들이 늘어난다던가 하는 기괴한 변화」(개발 후반).

안 볼 때만 바꾼다

설계 문서(CLAUDE.md)에 「시야 규약은 예외가 없습니다.」라고 적어 둔 규칙입니다. 배치 변화와 등장은 플레이어가 보고 있지 않을 때만 일어나고, 보이는지 판단할 수 없으면 보이는 것으로 처리해 움직이지 않습니다.

• 배치 소품 — 소품이 완전히 화면 밖에 가려졌을 때 등장합니다.
• 교실 소년 — 플레이어가 교실 안에 있고, 소년 자리가 보이지 않을 때 등장합니다.
• CCTV 속 사람 — CCTV 화면 밖에서 걸어 들어와 화면 밖으로 걸어 나간 뒤 사라집니다.

경비실 버티기 방지

• 플레이테스트에서 「경비실에 오래 있으면 파훼되지 않느냐, 밤을 그냥 넘기거나 연출을 안 보고 넘어갈 수 있다」는 피드백을 받아 넣었습니다.
• 수치를 정해 지시했습니다. 「약 30초 형광등 깜빡임·무전 잡음(문구 없음) · 약 60초 CCTV가 검은 남자 얼굴 · 약 90초 정전, 그래도 남으면 붙잡힘 …」

[Test] public void 머문_시간에_따라_깜빡임_CCTV_얼굴_정전으로_간다()
{
    var g = new GuardRoomLoiter();          // 씬 없이 new로 생성
    Stay(g, 29f); Assert.AreEqual(LoiterStage.None,     g.Stage);
    Stay(g, 2f);  Assert.AreEqual(LoiterStage.Flicker,  g.Stage);
    Stay(g, 30f); Assert.AreEqual(LoiterStage.CctvFace, g.Stage);
    Stay(g, 30f); Assert.AreEqual(LoiterStage.Blackout, g.Stage);
    Stay(g, GuardRoomLoiter.CaptureGraceSeconds);
    Assert.IsTrue(g.ConsumeCapture());      // 정전 뒤에도 남으면 붙잡힘
}

GuardRoomLoiter (Core) · GuardRoomCamp (Flow)

06AI와 일한 방식

Unity 에디터를 띄워 둔 채 Claude 데스크톱 앱(Opus 5.5)을 Unity CLI의 MCP 서버로 연결해 명령을 내렸습니다. 코드 · 씬 수정, 테스트 · 디버깅, 밤새 자동으로 돌린 QA 플레이까지 에디터 작업은 대부분 AI가 했습니다.

에이전트를 나눠 쓴 방식

조사 · 회의, QA 플레이, 구현 뒤 검토는 한 세션에 몰지 않고 따로 맡겼습니다. 에이전트는 고친 것과 판단이 필요한 것을 나눠 보고했고, 받아들일지 말지는 제가 정해 CLAUDE.md 개정 기록에 남겼습니다.

AI 제안에 대한 판단 기록

AI 결과물에서 잡은 오류

• 먼저 적용된 컬링 끄기 — 창가가 밝아지는 문제에 AI가 플레이어 카메라의 컬링 끄기를 먼저 적용했습니다. 성능 영향을 묻고 달빛 끄기와 같은 조건에서 비교하게 해, 컬링 끄기를 되돌렸습니다(07절 ③).
• 세는 기준 바꾸기 — 배정만 세면 76%였지만, 실제로 마주쳤는지로 다시 세게 하니 33%였습니다(07절 ①).

도서관 노란 얼굴이 벽과 책장을 뚫고 다니는 것은 제가 찾았고, 원인(벽이 반영되지 않은 옛 NavMesh)은 AI가 찾아 실행 중에 NavMesh를 다시 굽도록 고쳤습니다.

07문제 해결 사례

① 조우 편성 — 다시 세어 보고 고정 날짜로

플레이테스트에서 공포 이벤트(조우)가 의도대로 나오지 않았습니다. 시뮬레이터에서는 미숙한 플레이어 판의 76%에 13종이 모두 배정됐지만, 실제로 마주쳤는지로 다시 세어 보게 하자 33%뿐이었습니다. AI는 이월 보정을 제안했습니다. 저는 모든 플레이어가 조우를 다 보게 하려면 확률에 맡기면 안 된다고 판단해, 조우를 날짜별로 고정하고 남은 조우가 있으면 밤이 끝나지 않게 바꿨습니다.

붙잡힘 원인이 배치 축에 쏠리던 문제는, 점검 항목의 벌칙 축을 실제 원인 축과 맞추고 밤마다 세 축의 수칙이 한 장 이상 나오게 해서 바로잡았습니다. 미숙한 플레이어 기준 배치 축 비율이 67%에서 34%로 내려갔습니다(시뮬레이션).

② 구운 조명이라 정전이 되지 않던 문제

③ 시야를 돌리면 창가가 밝아지던 문제

④ 빌드에서만 난 문제

두 건 모두 에디터에서는 보이지 않았습니다. 소년 건은 제가 빌드를 플레이하다 발견해 릴리스 · 개발자 빌드 모두에서 안 나온다고 좁혀 보고했고, 셰이더 건은 빌드 전 점검에서 AI가 찾았습니다.

에디터와 빌드가 다르게 동작하면, 이번처럼 작은 빌드로 재현해 수치로 확인합니다.

08한계와 다시 만든다면