Community코딩 & 개발github.com

포토리얼 3D 게임 코드 생성

코드로 사실적인 3D 게임(WebGL, WebGPU, Three.js, Unity, Unreal 등 모든 엔진)을 제작할 때 사용합니다. 슈팅 장르뿐만 아니라 운송, 수리, 잠입, 탐험, 운전, 경영 등 모든 장르에 적용 가능합니다.

포토리얼 3D 게임 코드 생성란 무엇인가요?

이 스킬은 저비용 AI 모델이 실행 가능한 검증 절차를 통해 코드로 생성된 3D 장면을 플레이 가능한 사실적인 게임으로 완성하는 방법을 제공합니다. 이는 Claude Fable 5.2로 제작된 1.4MB 단일 파일 슈터 게임 'Saltline'의 제작 규율을 패키징하여, DeepSeek V4.1 Flash와 같은 저비용 모델도 동일한 수준의 결과물을 낼 수 있도록 설계되었습니다. 스킬은 특정 엔진이나 라이브러리에 의존하지 않으며, 제품(product)→인구조사(census)→조명(lights)→충돌(collide)→플레이테스트(playtest)→모바일(mobile)→외관(look) 순서의 게이트를 통해 각 라운드의 품질을 보장합니다. 핵심은 모델이 아키텍처를 새로 설계하지 않고 미리 준비된 스켈레톤에서 테이블을 채우는 방식으로 작업하며, 모든 판단을 게이트에 위임하여 일관된 품질을 유지하는 것입니다. 또한 포토리얼한 결과물을 위한 5가지 레버(조명, 재질, 구성, 이미지 형성, 지오메트리)를 우선순위대로 적용하는 방법을 제시합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NorwinYu/photoreal-game/tree/HEAD

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

코드로 만드는 포토리얼 3D 게임

코드로 생성된 3D 장면을 플레이 가능하고 사진처럼 보이는 짧은 게임으로 만드는 절차입니다. 목표는 게임입니다. 정적인 이미지, 기술 데모, 또는 연습장이 아닙니다. 플레이어는 동사를 가지고 있고, 그에 응답하는 시스템이 있으며, 승리하는 방법과 패배하는 방법이 있습니다.

이 절차는 특정 장르를 가정하지 않습니다. 주제가 동사를 결정합니다. 컨테이너 야적장은 교대 시간이 끝나기 전에 짐을 운반하는 것을 제안하고, 작업장은 기계를 수리하는 것을 제안하며, 계단통은 발각되지 않고 빠져나가는 것을 제안합니다. 슈터는 많은 구현 중 하나일 뿐이며, 동일한 절차는 주제가 요청할 때만 슈터를 생성합니다.

이 절차는 도구에 구애받지 않습니다. 파일을 편집하고, 명령을 실행하고, 이미지를 검사할 수 있는 에이전트를 가정합니다. 아래 내용은 특정 엔진, 라이브러리 버전 또는 벤더 제품에 의존하지 않습니다.

기원과 중요성. 이 스킬은 Saltline이 제기한 질문에 답하기 위해 존재합니다. Saltline은 Claude Fable 5.2로 제작된 1,423,668바이트 단일 파일 브라우저 슈터로, 외부 에셋이 전혀 없습니다. 흥미로운 점은 크기가 아니라 모델이 생성기를 작성했다는 것입니다. 이 스킬은 그 제작 규율을 실행 가능한 게이트로 패키징하여, 저비용 모델(예: DeepSeek V4.1 Flash)도 동일한 기준을 충족하도록 합니다. 결과는 동일한 게임이 아니라 동일한 규율입니다. 그리고 그 증거는 저장소의 사례 연구에 기록되어 있습니다.

번들된 검증 도구는 선택 사항이지만 권장됩니다. 게이트를 실행 가능하게 만듭니다. Node.js 22+, Pillow가 포함된 Python 3.10+, 그리고 Chrome/Chromium 바이너리가 필요합니다(표준 위치에 없으면 CHROME_PATH 설정). 스킬 텍스트 자체에는 종속성이 없습니다.

저비용 모델로 실행하는 방법

이 스킬은 약한 모델도 실행할 수 있도록 작성되었습니다: 모든 중요한 판단은 검사에 위임되고, 모델의 작업은 테이블을 채우고 최고 순위의 수정 사항을 적용하는 것입니다. 다음 규칙을 문자 그대로 따르십시오.

  1. 아키텍처를 설계하지 마십시오. 이미 다음을 포함하는 스켈레톤에서 시작하십시오: 렌더 검증 도구, 페이지 계약(__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __PRODUCT), 포스트 체인, 완성된 게임 셸(타이틀, 설정, 일시정지, 저장, 터치, HUD 마커) 및 빈 키트 테이블. 복사한 다음 테이블을 채우십시오. 실행마다 아키텍처를 발명하는 것은 약한 모델이 실패하는 지점입니다.
  2. 발명하지 말고 채우십시오. 작업 산출물은 여섯 개의 테이블입니다: 제품(셸 + 콘텐츠), 아트 디렉션, 키트(치수 + 부품 + 데칼), 표면(알베도/러프니스/노멀), 조명(위치 + 고정 장치), 루프(동사/시스템/피드백/실패/테스트).
  3. 제품 먼저, 그 다음 외관. 제품 → 인구조사 → 조명 → 충돌 → 플레이테스트 → 모바일 → 외관. 설정이 없고, 두 번째 적 역할이 없고, 목표 마커가 없거나 터치 경로가 없는 아름다운 프레임은 완성된 라운드가 아닙니다.
  4. 라운드당 하나의 변경, 그런 다음 모든 게이트 실행. 어떤 게이트도 퇴보하지 않는 경우에만 라운드가 유효합니다. 제품이나 루프를 깨는 시각적 개선은 되돌려집니다.
  5. 절대 스스로 평가하지 마십시오. 게이트가 당신의 의견에 동의하지 않으면 게이트가 이깁니다. 게이트가 잘못된 경우, 반례를 사용하여 게이트를 수정하십시오. 절대 게이트를 우회하지 마십시오.
  6. 예산 또는 정체 상태 중 먼저 도달하는 지점에서 중단하고 최악의 카메라와 실패한 게이트 목록을 보고하십시오.

이 여섯 가지 규칙을 따르는 모델은 훨씬 적은 비용으로 비교 가능한 출력을 생성합니다. 규칙 5를 건너뛰는 모델은 그럴듯해 보이는 퇴보를 생성합니다.

전달물 계약

다음이 존재하고 모든 게이트가 녹색일 때만 실행이 완료됩니다:

산출물확인 사항
하나의 자체 포함된 HTML, 네트워크 요청 없음네트워크를 비활성화하고 로드
페이지 계약 노출 (__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __GAME, __PRODUCT)검증 도구가 읽음
완성된 게임 셸메뉴, 설정, 일시정지, 저장, 터치, HUD 계층, 종료/재시작
콘텐츠 범위≥2개의 적/상호작용 가능 역할, ≥2개의 도구, ≥1개의 목표 체인, ≥3개의 비트
인구조사 보고서커버리지 = 100%, 실패 0건
조명 감사모든 조명이 고정 장치에 고정됨
충돌 보고서침투 0건, 경계 이탈 0건, 충돌체 일치율 100%
플레이테스트루프 완료 가능, 실패 경로 도달 가능, 재시작 작동
모바일 보고서390×844 레이아웃, 가로 오버플로우 없음, 터치 컨트롤 존재
3~6개의 주제 객체에 대한 박스 보고서각 지표 >= 참조치의 0.8
프레임 점수보고되지만 게이트를 재정의하는 데 사용되지 않음

완제품 계약

플레이 가능한 프레임은 완성된 게임이 아닙니다. 루프 게이트는 행동을 보호하고, 제품 게이트는 셸, 콘텐츠 범위 및 첫인상을 보호합니다. 검증 도구 harness/product.mjs가 모델의 의도를 읽지 않고 확인할 수 있도록 페이지에 다음을 선언하십시오.

산출물최소 사항
화면메뉴, 플레이 중, 일시정지, 설정, 패배, 승리
타이틀 화면로드 시 표시, HUD 숨김, 타이틀, 프리미스, 시작, 설정/컨트롤
설정감도, 볼륨, FOV, Y축 반전, 품질 (또는 동등한 세트)
지속성하나의 키가 새로고침 후에도 유지됨 (최고 점수/진행/설정)
입력키보드 + 마우스 + 터치, 포인터 잠금 실패 시 대체 조준
목표≥3개의 비트와 월드 마커/나침반이 있는 ≥1개의 체인
역할≥2개의 적/장애물/상호작용 가능 역할, 단순한 색상 변경 아님
도구≥2개: 기본 및 보조 동사 (무기/도구/능력)
HUD목표+진행, 생존, 무기/탄약, 컨텍스트 프롬프트, 나침반/마커, 자막
오디오음소거 + ≥6개의 상태 변경 이벤트
카메라__PRODUCT.cameras에 히어로 + 클로즈업 스틸 카메라
성능시작 후 측정된 호출/삼각형/조명에 대한 선언된 예산
모바일가로 오버플로우 없는 390×844, 터치 컨트롤 도달 가능

수직 슬라이스 콘텐츠 예산

아트 작업 전에 이것을 채우십시오. 수직 슬라이스는 하나의 완전한 목표 체인, 두 개의 역할, 하나의 시그니처 시스템 및 설계된 셸을 갖춘 3-8분 세션입니다. 데모 릴보다 작고 기술 데모보다 큽니다.

항목수직 슬라이스완성된 소규모 게임
목표1개 체인, 3개 비트1-3개 체인, 5-8개 비트
적/상호작용 가능 역할2개3-5개 + 클라이맥스
무기/도구2개 (기본 + 보조)3-5개
플레이어 동사이동, 조준, 발사, 재장전+ 웅크리기/점프/상호작용/능력
세계한 장소, 3개 깊이 레이어2-3개의 연결된 공간
셸타이틀, 일시정지, 설정, 종료+ 저장, 품질, 터치
세션3-8분10-30분

매니페스트는 주장입니다. 게이트는 DOM 동작과 선언된 개수를 확인합니다. 페이지가 수행하지 않는 것을 선언하지 마십시오.

window.__PRODUCT = {
  title: { name: '게임 타이틀', start: '#start', hud: '#hud', hudHiddenOnTitle: true },
  screens: ['menu', 'playing', 'paused', 'settings', 'lost', 'won'],
  ui: { start: '#start', hud: '#hud', pause: '#pause', settings: '#settings', end: '#end', touch: '#touch' },
  settings: ['sensitivity', 'volume', 'fov', 'invertY', 'quality'],
  persistence: ['game.best'],
  input: { keyboard: true, mouse: true, touch: true },
  content: {
    objectives: [{ id: 'objective-1', title: '목표', steps: 3 }],
    roles: ['role-a', 'role-b'],
    tools: ['tool-a', 'tool-b'],
    beats: ['intro', 'contact', 'mid', 'climax', 'win'],
  },
  hud: ['objective', 'compass', 'health', 'ammo', 'prompt', 'subtitles'],
  audio: { events: 10, mute: true },
  perf: { maxCalls: 700, maxTris: 400000, maxLights: 14 },
  cameras: [
    { name: 'hero', cam: [0.5, 1.7, 10, -2.6, 1.3, -10] },
    { name: 'close', cam: [-6.4, 1.4, 5.2, -9.9, 1.0, 2.2] },
  ],
  test: { start: 'start', pause: 'pause', resume: 'resume', settings: 'openSettings', save: 'save' },
};

표준 __TEST 액션 (추가 액션 허용): start, pause, resume, openSettings, closeSettings, save, state. 포인터 잠금 없이 작동해야 하며 JSON 안전 스냅샷을 반환해야 합니다. 타이틀 화면은 HUD를 숨겨야 합니다. 시작은 HUD를 표시해야 합니다. 설정, 일시정지 및 종료 화면은 DOM 검사가 가능해야 합니다.

사용 시기

  • 장면이 기하학적으로는 올바르지만 평평하거나, 플라스틱처럼 보이거나, "생성된" 느낌이 날 때
  • 렌더링이 참조 사진, 컨셉 또는 아트 디렉션과 일치해야 할 때
  • 조명, 재질 또는 구성을 제어된 방식으로 개선해야 할 때
  • 긴 생성 과정에서 여러 반복에 걸쳐 일관성을 유지해야 할 때

사용하지 않을 시기

  • 의도적으로 양식화된 출력 (플랫 셰이딩, 셀, 다이어그램, UI 스타일). 일관된 추상화가 필요하며 물리적 개연성은 필요하지 않습니다. 절차는 이전되지만, 포토리얼 프로필과 외관 게이트를 스타일 일관성 게이트로 교체하십시오. 사진 프로필에 대해 측정된 양식화된 장면은 품질이 아니라 구성상 손실됩니다.
  • 정밀 작업 (CAD, 엔지니어링 도면) 가독성이 사실성보다 중요할 때
  • 카메라가 없는 장면: 데이터 시각화, 노드 그래프, UI

문제 모델

인지된 사실성은 다섯 가지 레버에서 비롯됩니다. 이 순서대로 적용하십시오. 목록 아래로 갈수록 노력 대비 효과가 급격히 감소합니다.

  1. 조명 — 정의된 방향, 색상 및 고도를 가진 단일 지배적인 광원과 반사 및 필용 환경
  2. 재질 — 색상만이 아닌 거칠기, 노멀 및 때의 변화
  3. 구성 및 밀도 — 여러 스케일과 깊이의 객체, 명확한 초점 및 읽을 수 있는 스케일 단서
  4. 이미지 형성 — 안티에일리어싱, 톤매핑, 블룸, 그레인, 비네트
  5. 지오메트리 세부 묘사 — 최후의 수단이며 화면에서 여러 픽셀로 살아남는 곳에만 적용

명시적으로 언급할 가치가 있는 두 가지 결과:

  • 대략 2픽셀보다 작은 세부 사항은 안티에일리어싱에 의해 제거되며 이미지에 기여하지 않습니다. 그 스케일에서 폴리곤 수를 추가하는 것은 낭비입니다.
  • 장면은 올바른 노출을 가질 수 있지만 여전히 비어 보일 수 있습니다. 공허함은 밀도 문제이지 그레이딩 문제가 아닙니다.

완성된 게임에 대한 세 가지 추가 결과:

  • 프레임은 필요 조건이지만 충분 조건은 아닙니다. 제품 레이어(타이틀 키 아트, 설정, 일시정지, 저장, 터치, 목표 마커, 라디오/자막, 콘텐츠 범위)는 플레이어가 조명을 알아채기 전에 판단됩니다.
  • 다섯 가지 레버는 주제와 무관합니다. 햇빛이 비치는 항구, 밝은 실내, 눈 덮인 들판 또는 양식화된 경기장에 적용됩니다. 밤/비/안개는 하나의 시나리오이지 기본값이 아닙니다.
  • 프레임 점수는 하나의 참조 외관을 위한 나침반입니다. 완성된 게임과 아름다운 데모를 구분할 수 없습니다.

워크플로우

각 단계에는 출력이 있습니다. 다음 단계를 시작하지 마십시오.

1단계 — 렌더링을 관찰 가능하게 만들기 (장면 작업 전에 권장)

프레임을 캡처하고 검사하는 반복 가능한 방법을 만드십시오.

출력: 이미지와 이상적으로 몇 가지 숫자를 반환하는 하나의 명령.

환경에 이미 스크린샷 도구가 있다면 사용하십시오. 그렇지 않으면 작동하는 가장 작은 도구를 만드십시오:

  • 로컬 정적 서버에 대해 헤드리스 브라우저를 실행합니다.
  • 페이지의 준비 신호를 기다린 후(아래 계약 참조) 캡처합니다.
  • 선택적으로 이미지 통계(노출 히스토그램, 클리핑, 색상 수, 가장자리 밀도)를 계산합니다.

캡처를 결정론적으로 유지하는 페이지 계약:

window.__READY = true;                      // 몇 프레임 렌더링 후 설정
window.__STATS = { calls, triangles };      // 선택적 렌더러 카운터
// 선택적 쿼리 매개변수
// ?shot=1            UI 숨기기
// ?cam=x,y,z,tx,ty,tz 고정 카메라
// ?seed=N            고정 랜덤 시드

규칙:

  • 모든 비교에 대해 고정 카메라, 고정 시드, 고정 뷰포트를 사용합니다.
  • 각 캡처를 버전화된 이름으로 저장합니다. 이전 캡처를 덮어쓰지 마십시오.
  • 메트릭을 사용할 수 없는 경우 이미지를 보관하고 나란히 비교하십시오. 시각적 비교로 충분합니다. 메트릭은 속성 확인 속도를 높일 뿐입니다.

2단계 — 아트 디렉션 브리프 작성

출력: 짧은 테이블. 모든 행은 구현할 수 있을 만큼 구체적이어야 합니다.

결정내용
주제프레임이 무엇에 관한 것인지, 어떤 스케일인지
시간과 날씨안개, 반사 강도, 대비 결정
키 라이트방향, 고도, 색온도, 강도
하늘과 앰비언트그림자 채우기 색상
재질 패밀리어떤 표면이 존재하는지, 거친 정도, 젖은 정도
초점눈이 가장 먼저 닿아야 할 곳
제약 조건나타나지 않아야 할 것 (예: 순백색, 평평한 지면, 맑은 하늘)

지침:

  • 하나의 지배적인 조명 스토리를 선택하십시오. 추가 광원은 필, 바운스 또는 실용 조명이며 종속적이어야 합니다.
  • 세부 사항을 추가하기 전에 주제를 제한하십시오. 가시적 복잡성을 줄이는 조건(밤, 비, 안개, 먼지, 역광, 산업 또는 실내 설정)은 합법적이고 효과적인 선택이며 지름길이 아닙니다.
  • 키 고도를 의도적으로 선택하십시오. 그림자 길이는 height / tan(elevation)에 비례합니다. 낮은 키는 긴 그림자를 만들어 전체 전경을 그늘지게 할 수 있으며, 이는 "그림자 없음"으로 읽힙니다. 중간 고도(약 20-30°)는 일반적으로 형태와 대비를 위한 조명 영역을 모두 제공합니다.
  • 키트 전에 조명 시나리오를 선택하십시오. 누락된 세부 사항을 숨기기 때문에 밤, 비 또는 산업 실내를 기본값으로 사용하지 마십시오. 밤은 하나의 옵션입니다. 역광의 새벽이나 밝은 실내는 더 어렵고 종종 더 설득력이 있습니다.
시나리오키필 / IBL공기시그니처 재질
야간 산업차가운 중저음 키, 실용 조명하늘 환경, 따뜻한 웅덩이지수적, 하늘색젖은 지면, 발광 고정 장치
흐린 주간넓은 하늘 키, 35-60°강한 IBL얇은 공중 원근무광 콘크리트, 웅덩이
골든 아워 / 역광주제 뒤 낮고 따뜻한 키차가운 하늘 필긴 헤이즈, 림젖은 아스팔트, 유리, 금속
맑은 정오높은 키, 단단한 그림자하늘 필 + 바운스최소모래, 돌, 페인트
실내 실용 조명창문 + 몇 개의 따뜻한 광원창문/하늘 환경광선, 먼지나무, 직물, 금속
지하 / 인공 조명실용 조명 + 발광체낮은 앰비언트체적젖은 콘크리트, 표지판

역광 장면은 "더 쉽지 않습니다": 클리핑된 하이라이트, 색조 및 약한 실루엣을 드러냅니다. 노출과 하이라이트 롤오프를 수정하십시오.

…

[잘림: 번역 대상]

관련 스킬