프로젝트 소개
godot-fun/gai 저장소는 Godot 게임 개발자를 위한 두 가지 통합 도구 세트를 제공합니다. 첫째, CLI 및 GUI 인터페이스를 갖춘 에이전트 스킬 모음으로 일괄 에셋 처리를 지원합니다. 오디오(to-wav, trim, loudness, export), 이미지(to-png, split, 배경 제거, trim/resize), 비디오(mute, 60fps, 4K, merge, compress/OGV), 스토리보드(HTML 미리보기, 음성 오버, 비디오, AV 믹스, 퍼블리시), 그리고 이름 지정 및 커밋을 위한 유틸리티 스킬을 포함합니다. 이러한 스킬은 `.agents/skills/`에 정리되어 있고 스크립트는 `.ai/`에 있으며, OpenCode, DeepSeek, Codex, Cursor, Claude와 호환됩니다.
둘째, `zfoo/` Godot 프레임워크(`GodotFramework`라는 이름의 Autoload로 설치됨)는 다양한 프로덕션 준비 모듈을 제공합니다:
- **AI**: 다중 턴 대화를 지원하는 OpenAI 호환 비동기 채팅.
- **Alert**: 성공/오류 색상을 갖춘 플로팅 토스트 알림.
- **Audio**: 플레이리스트 크로스페이드가 있는 음악 재생, 원샷 음성, 전용 SoundEffect 버스에서의 다채널 SFX.
- **Animation**: 행/열, 스케일, FPS를 구성할 수 있는 원샷 스프라이트 시트 효과.
- **Testing**: 단위 테스트(`test`로 시작하거나 끝나는 메서드를 위해 `.gd` 파일 스캔) 및 통합 테스트(`test` 접두사/접미사가 붙은 `.tscn` 씬 실행).
- **HotUpdate**: PCK 기반 핫업데이트 워크플로(버전 확인, 다운로드, MD5 검증, 로드, 게임 진입).
- **Http**: 성공/오류 처리를 갖춘 비동기 GET 헬퍼.
- **Log**: `{user_data}/logs/godot.log`에 파일 로거를 제공하며 포맷된 info/error 호출을 지원.
- **Network**: TCP 및 WebSocket 클라이언트(스레드 및 비스레드)와, 코덱을 사용한 fire-and-forget 전송 및 요청-응답 await를 위한 라우터.
- **ResourceHelper**: 메인 스레드 차단을 피하기 위한 텍스처 및 씬의 비동기 로딩.
- **SceneHelper**: 페이드/슬라이드 전환이 있는 씬 전환, 안전한 인스턴스화, queue_free.
- **SchedulerBus**: 선택적 타이머 이름과 서브 스레드 실행을 지원하는 원샷 및 고정 레이트 지연 작업.
- **Setting**: 저장/로드를 지원하는 영구 사용자 설정(bool, string).
- **Utils**: StringUtils, TimeUtils, JsonUtils, FileUtils, RandomUtils, ThreadUtils(비동기 sleep), NodeUtils, 그리고 ArrayUtils, CollectionUtils, NumberUtils, NetUtils, HttpUtils, IdUtils, RateLimitUtils.
- **GodotFramework (gdf)**: 메인 스레드 호출 가능 지연 및 정상 종료를 제공하는 전역 autoload.
이 프레임워크는 Godot 4.x를 대상으로 하며 게임 프로젝트의 빠른 반복 개발을 위해 설계되었습니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.