Whistling Arrow

마이크로 감지한 휘파람 음정을 세 가지 명령으로 분류하여, 하나의 지속형 화살을 귀환·부유·자동추적 상태로 제어하는 2D 게임 프로토타입입니다.

현재 구현

• 기준 구현은 whistling_arrow.html에 들어 있는 브라우저용 단일 파일 프로토타입입니다.
• ghs.docx는 기획 및 개발 기록입니다.
• godot/에는 Godot 4.7.1 Compatibility 기반 3D 프로젝트가 있습니다. 3D 아레나가 기본 실행 장면이며 최초 2D 포트와 4.6.1 기록은 비교 가능한 역사적 마일스톤으로 보존합니다.

기준 Git 이력은 최초 커밋 7eb0ec0(2026-04-20)부터 기준 HEAD 003046e(2026-06-15)까지입니다. 파일 식별값과 기록의 한계는 창작·출처 기록에 정리되어 있습니다.

핵심 조작

입력	명령	화살 동작
기준보다 낮은 유효 음정	RETURN	홈을 향해 선회하고 접근하면서 감속
무음, 불확실한 입력, 기준 주변 음정	FLOAT	기존 속도를 감쇠하며 완만하게 부유
기준보다 높은 유효 음정	ATTACK	가장 가까운 살아 있는 적을 자동 선택하여 추적

플레이어가 화살의 좌표를 직접 지정하지 않는다는 점, 그리고 공격할 때마다 새 발사체를 만드는 대신 동일한 화살이 세 상태 사이를 계속 오간다는 점이 핵심입니다. 정확한 분류식과 기준 수치는 기믹 명세를 참고하세요.

브라우저에서 실행

마이크 API를 사용하므로 파일을 직접 여는 것보다 localhost 또는 HTTPS 환경에서 제공하는 편이 안전합니다. 예를 들어 저장소 루트에서 다음과 같이 정적 서버를 실행한 뒤 http://localhost:8000/whistling_arrow.html을 엽니다.

python -m http.server 8000

브라우저에서 마이크 사용을 허용해야 합니다. 구현은 에코 제거, 소음 억제, 자동 이득 조절을 끈 원시 입력을 요청하므로 장치와 주변 소음에 따라 기준 음정을 조절해야 할 수 있습니다.

문서

• 기믹 명세: 구현에 종속되지 않은 핵심 구조와 HTML 기준값
• 창작·출처 기록: Git 이력, 파일 SHA-256, 재검증 절차와 증거상 한계
• Godot 포트 v1 기록: 엔진 버전, 구현 차이와 자동·브라우저 검증 결과
• Godot 포트 소스 해시: 마일스톤 핵심 파일 SHA-256
• Godot 4.7.1 업그레이드 기록: 활성 프로젝트 버전 전환과 헤드리스 검증 결과
• Godot 3D 수직 슬라이스 기록: 3D 확장 설계, 구현 범위와 검증 결과
• Godot 성능 최적화 기록: 피치 분석과 3D 렌더링 병목의 측정·개선 결과
• 권리 및 사용 안내: 보호 범위와 라이선스 상태

권리와 기록의 의미

이 저장소의 이력과 해시는 특정 내용의 파일이 존재했다는 사실을 식별하고 변경 계보를 설명하기 위한 자료입니다. 이것만으로 추상적인 게임 아이디어에 대한 독점권, 특허성, 최초 창작자 지위 또는 법적 우선권이 자동으로 확정되지는 않습니다. 별도 라이선스가 명시되지 않은 원 저작물에는 일반적인 저작권이 유보됩니다. 자세한 내용은 RIGHTS.md를 확인하세요.