Codventure

VSCode 안에서 코딩하면 판타지 캐릭터가 모험을 떠나는 어드벤처 익스텐션.

캐릭터는 Explorer 사이드바 패널에서 스스로 움직이며 모험을 이어간다. 커맨드로 상호작용하거나 패널에서 직접 조작할 수 있다.

설치 (개발 모드)

1. 이 폴더를 VSCode에서 열기
2. F5 → Extension Development Host 창이 열림
3. 상태바 왼쪽 하단 =^･ω･^= 클릭하거나 커맨드 팔레트에서 "Codventure" 검색

커맨드

팔레트 단축키: Ctrl+Shift+P / Cmd+Shift+P
패널 내 버튼(/food, /sleep, /code)으로도 동일하게 조작 가능
캔버스 고양이 클릭 → 쓰다듬기 (♥ 파티클)

고양이 행동

• 자율 이동 — 패널을 열면 알아서 걷고, 앉고, 그루밍하고, 코딩함
• 코딩 모드 — 자동으로 20% 확률 전환. 맥북 앞에 앉아 타이핑하며 {} () <> 파티클 발사
• 캔버스 클릭 — 고양이를 직접 클릭하면 meow + happy 반응
• 파티클 — 상호작용 시 하트·반짝·Zzz·코드 이펙트
• 상태바 애니메이션 — =^･ω･^= / =^♥♥^= / =^･ー･^= 순환

스크린샷

준비 중

진화 단계

코딩을 하면 XP가 쌓이고 고양이가 성장한다. 속성은 최초 실행 시 알에서 선택한다.

속성 종류

개발

# 디버그 실행: F5 (launch.json 포함됨)

# 패키징 (vsce 필요)
npm run package
# → codventure-x.x.x.vsix 생성
# Extensions 패널 → ... → Install from VSIX 로 설치

• 언어: JavaScript (TypeScript 아님, 빌드 스텝 없음)
• 렌더링: HTML Canvas — zero dependencies
• VSCode API: ^1.80.0

버전 히스토리

v0.2.0 — 2026-04-30 · Elemental Evolution System

속성·레벨·진화 시스템 전체 구현. v0.2 주요 업데이트.

• 알 선택 화면 — 최초 실행 시 불/물/풀 알 3개 중 선택, 부화 연출 (파티클 폭발 + 줌인)
• 속성별 팔레트 시스템 — PALETTES 객체로 body/stripe/eye/particle 색상 분기
• 속성별 커맨드 파티클 — 🔥 불꽃 / 💧 물방울 / 🍃 잎사귀
• XP 누적 시스템 — 파일 편집 감지로 1분당 XP+1, /food·/pet 실행 시 XP+5
• 레벨 계산 함수 (calcLevel) — Lv.1~5 임계값 정의
• 레벨업 연출 — 파티클 폭발 + VSCode 알림 (🎉 Nabi가 Lv.N으로 성장했어요!)
• 레벨별 스프라이트 진화 — Lv.1 아기 → Lv.3 성묘 → Lv.4 악세서리 → Lv.5 오라
• 상태바 속성 이모지 + 레벨 표시 (🔴 =^･ω･^= Lv.3)
• 데이터 복원 — HTML 임베딩으로 재시작 후 catType·xp·level 즉시 복원, 타이밍 이슈 해결

v0.1.4 — 2026-04-24 · Sprite Overhaul + Coding Animation

스프라이트 전면 개선 + 맥북 코딩 애니메이션 추가.

• 고양이 스프라이트 전면 재설계 — 머리 2px 더 넓게, 뾰족한 삼각 귀, 2×2 초록 홍채 눈, 분홍 코
• 꼬리 두께 2px로 보강, 발 끝 발톱 구분선 추가
• 수염 서브픽셀 렌더링 (좌우 방향 자동 반전)
• code 상태 추가 — 맥북 앞에 앉아 앞발로 타이핑, 화면에 코드 줄 깜빡임
• 코드 파티클 ({} () <> // =>) 초록색으로 발사
• 자율 행동 확률 조정: walk 35% / sit 25% / groom 20% / code 20%
• 💻 /code 커맨드 + 버튼 추가
• 하단 버튼 UI 개선 — flex: 1 반응형으로 너비에 맞게 균등 배분, /pet 버튼 제거 (캔버스 클릭으로 대체)

v0.1.2 — 2026-04-16 · Sidebar Migration

WebviewPanel(에디터 탭) → Explorer 사이드바 WebviewView로 전환.

• WebviewPanel 제거, CatViewProvider (WebviewViewProvider) 도입
• Explorer 사이드바에 "🐱 Nabi" 패널 상시 표시
• package.json에 views.explorer 등록
• 상태바 클릭 시 사이드바 패널 포커스 (codventure.focus)
• 나머지 동작(커맨드·애니메이션·파티클)은 그대로 유지

v0.1.1 — 2026-04-16 · Prototype Integration

프로토타입 기반으로 전면 교체. 정적 스프라이트 → 자율 행동 고양이.

• 고양이 자율 행동: sit → walk → groom 자동 순환
• 배경: 별 + 바닥 타일 픽셀아트 룸
• 파티클 시스템: ♥ (pet), z (sleep), ✦ (food)
• 상태바 텍스트 애니메이션 (=^･ω･^= → =^♥♥^= → =^･ー･^=)
• 캔버스 내 버튼으로 직접 커맨드 실행
• /sleep 토글 (재실행 시 깨움)
• 캔버스 고양이 클릭 → meow + happy 상태
• 커맨드 ID codventure.* 로 통일
• .vscode/launch.json 추가 (F5 디버그 설정)

v0.1.0 — 2026-04-16 · MVP

기본 기능 전체 구현.

• 16×16 픽셀아트 스프라이트 (팔레트 7색)
• 6종 애니메이션: idle / walking / sitting / grooming / sleeping / eating
• /food /pet /sleep 커맨드 (커맨드 중복 방지 포함)
• 상태 영속성: ExtensionContext.globalState
• 상태별 상태바 이모지 자동 업데이트

v0.0.1 — 2026-04-16 · Project Scaffolding

초기 프로젝트 세팅. 코드 뼈대 + 문서 구조.

• package.json — VSCode 익스텐션 기본 구조
• extension.js — activate/deactivate 뼈대, placeholder Canvas
• CLAUDE.md — 프로젝트 개요·아키텍처·컨벤션·체크리스트
• docs/PLAN.md — v0.1~v0.3 로드맵
• docs/features/ — animation / commands / statusbar 설계 문서

라이선스

MIT © uwol-is-june