종합 기획서·개발 현황
상태: 구현 현황 정리·기획 기준 · 설명 확인일: 2026-10-28
모바일에서 젤리를 자르고, 얇게 썰고, 틀로 찍고, 날아가는 젤리를 베거나 곰 젤리를 눌러 즐기는 3D 촉감 게임이다. 짧은 판에서 명확한 조작과 결과를 경험하고, 별을 모아 장비 외관을 교체한다.
이 문서는 현재 저장소를 이해하는 팀원과 다음 개발을 함께하는 AI가 같은 용어·스테이지·완료 기준을 사용하기 위한 공통 문서다. 현재 구현 목록은 코드에서 생성하며, 구현과 실기기 검증·출시는 별개로 기록한다.
먼저 볼 문서
섹션 제목: “먼저 볼 문서”| 알아볼 내용 | 문서 |
|---|---|
| 조작·목표·채점과 모드별 차이 | 플레이 모드·규칙 |
| 구현된 종류와 실제 배치 여부 | 젤리 도감 |
| 장비 3분류·가격·실제 모델 | 장비·별 상점 |
| 현재 표시 번호·고정 ID·판별 목표 | 전체 스테이지 |
| 구현·검증 기록·출시 전 확인 | 개발 현황·남은 과제 |
| AI에게 전달할 문서와 갱신 방법 | AI 협업·문서 갱신 |
제품과 개발 방향
섹션 제목: “제품과 개발 방향”- 핵심 경험: 입력에 반응하는 젤리 변형·절단면·출렁임, 장비 움직임, 소리와 진동으로 손맛을 전달한다.
- 판 단위 목표: 정확도·균등 분할·타이밍·리듬·적은 휘두르기·압착 위치·다른 모양 찾기를 각각 다르게 제시한다.
- 진행: 판별 별 기록과 진행을 저장하고 History에서 재도전한다. 도감과 장비 상점은 플레이 결과를 모으는 동기다.
- 제작 방식: TypeScript + Three.js(WebGL2) + GLSL + Vite. 3D 젤리·장비는 절차 생성한다. 홈 로고와 Play에는 승인된 PNG, 절단음에는 승인된 WAV를 사용한다.
- 플랫폼: 같은 웹 코드를 Capacitor 8로 iOS·Android에 포함한다. 앱은 번들 콘텐츠를 사용하며
server.url이 없다. 폰은 세로, 태블릿은 회전·크기 변경을 지원한다.
이름·상태를 읽는 기준
섹션 제목: “이름·상태를 읽는 기준”홈 제목은 I Hate Jelly다. 저장소·기존 스펙에는 Jelly Slice / Jelly Cutting, 앱 식별에는 game.steadyloop.jelly가 남아 있다. 이번 문서 작성이 앱 이름 변경이나 스토어 출시를 의미하지 않는다.
확정/구현은 코드나 승인된 규칙이 있다는 뜻이다. 시제품은 동작이 있지만 체감·최종 규칙 확인이 남은 단계다. 검증 대기는 실기기·시각·권리 등 확인이 남았다는 뜻이며, 계획은 구현 완료와 구분한다.
문서 최초 작성은 로컬 검증까지 진행했고, 이후 별도 배포 요청으로 **jelly-docs.steadyloop.dev**에 공개했다. 운영 게임과 문서 사이트는 서로 다른 Worker다. 자동 배포의 반영·검증 상태는 개발 현황을 따른다.