Godot VFX Library

License: MIT

Version

중국어 버전 | English

Metroidvania나 플랫포머 같은 액션 게임을 위해 특별히 설계된 Godot 4용 35개 이상의 파티클 이펙트와 17개 이상의 셰이더를 포함하는 종합적인 모음입니다.

제작 사례: Land of Oblivion — 다크 판타지 2D 액션 어드벤처 게임을 좋아한다면, 위시리스트 추가가 큰 도움이 됩니다.

✨ 기능 (Features)

🎆 파티클 이펙트 (Particle Effects) (35개 이상)

• 전투 효과: 피 튀김(Blood splash), 에너지 폭발(energy burst), 방패 파괴(shield break), 스파크, 콤보 링
• 이동 효과: 대시 트레일(Dash trails), 점프 먼지(jump dust), 벽 미끄러짐 스파크(wall slide sparks)
• 마법/스킬 효과: 포털 소용돌이(Portal vortex), 번개 체인(lightning chain), 얼음 서리(ice frost), 화염구 트레일(fireball trails)
• 환경 효과: 횃불 불꽃(Torch fire), 반딧불이, 증기(steam), 물 튀김(water splash), 떨어지는 나뭇잎(falling leaves), 비(rain), 눈(snow)

🎨 셰이더 이펙트 (Shader Effects) (17개 이상)

• 캐릭터 상태: 흰색 플래시(Flash white), 깜빡임(blink), 용해(dissolve), 동결(frozen), 독(poison), 연소(burning), 석화(petrify)
• 환경: 물 표면(Water surface), 열 왜곡(heat distortion), 포털 소용돌이(portal vortex), 에너지 장벽(energy barrier)
• 후처리 (Post-Processing): 윤곽선 빛(Outline glow), 방사형 블러(radial blur), 색수차(chromatic aberration), 그레이스케일(grayscale)

🎮 사용하기 쉬운 매니저 (Managers)

• VFX Manager: 간단한 API를 갖춘 전역 전투 및 UI 효과
• EnvVFX Manager: 환경 및 대기 효과
• 화면 효과 (Screen Effects): 카메라 흔들림(Camera shake), 정지 화면(freeze frame), 데미지 숫자(damage numbers)
• 자동 정리 (Auto-cleanup): 일회성 효과를 위한 스마트 메모리 관리

🎮 제작 사례 (Production Showcase)

**Land of Oblivion**은 Godot으로 제작된 2D 액션 어드벤처입니다.

이 VFX 라이브러리는 다음 프로젝트에서 사용되었습니다:

• 전투 피드백 및 충격 VFX
• 주문 시각 효과 및 상태 효과
• 화면 흔들림 / 히트 스톱 스타일 화면 효과
• 환경 분위기(Environmental ambience)

👉 Steam에서 위시리스트에 추가하는 것을 고려해 주세요 (가시성 확보에 직접적인 도움이 됩니다):

Follow on Steam

🚀 빠른 시작 (Quick Start)

설치 (Installation)

1. 수동 설치 (Manual Installation)

   • 최신 버전을 다운로드합니다.
   • 프로젝트의 addons/ 폴더에 압축을 해제합니다.
   • 프로젝트 설정(Project Settings) → 플러그인(Plugins)에서 "VFX Library"를 활성화합니다.

2. Git Clone (권장)

   복사

   cd your-project/addons/
   git clone https://github.com/haowg/GODOT-VFX-LIBRARY.git vfx_library
   

   1

   2

   3

   중요: addons/vfx_library에 클론하세요 (절대 GODOT-VFX-LIBRARY가 아닙니다)

3. 심볼릭 링크 (Symbolic Link) (개발에 가장 좋음)

   복사

   # 중앙 위치에 한 번만 클론합니다
   git clone https://github.com/haowg/GODOT-VFX-LIBRARY.git ~/godot-plugins/GODOT-VFX-LIBRARY
   

   1

   2

   3

...

여러 프로젝트에서 동일한 플러그인을 사용하는 데 매우 유용합니다!

자세한 설치 지침 및 문제 해결 방법은 [INSTALLATION.md](INSTALLATION.md)를 참조하세요.

### 기본 사용법 (Basic Usage)

```gdscript
# 충격 시 화면 흔들림 효과
VFX.screen_shake(10.0, 0.2)

...

📖 문서 (Documentation)

• 설치 가이드 - 상세 설정 지침
• API 참조 - 전체 함수 설명서
• 데모 예제 - 인터랙티브 데모 씬

🎯 사용 사례 (Use Cases)

전투 시스템 (Combat Systems) - 피 튀김, 화면 흔들림, 피해 수치(damage numbers), 치명타 효과
이동 메커니즘 (Movement Mechanics) - 대시 트레일, 점프 먼지, 벽 미끄러짐 스파크
환경 디자인 (Environmental Design) - 화염원, 날씨 효과, 주변 입자(ambient particles)
주문 & 마법 (Spell & Magic) - 포털 소용돌이, 번개 체인, 소환 원
상태 효과 (Status Effects) - 동결, 독, 화상 상태에 대한 시각적 피드백

자세한 코드 예제는 API_REFERENCE.md를 참조하세요.

🎮 인터랙티브 데모

모든 효과를 인터랙티브 데모 씬에서 경험해 보세요:

1. Godot에서 addons/vfx_library/demo/vfx_demo.tscn을 엽니다.
2. Play Scene (F6)을 누릅니다.
3. UI 목록에서 효과를 선택하고 마우스 오른쪽 버튼을 클릭하여 생성합니다.
4. 35개 이상의 파티클 효과와 17개 이상의 셰이더를 실시간으로 테스트해 보세요.

주요 기능:

• 📋 카테고리별(전투, 날씨, 환경 등) 효과 탐색
• 🎨 애니메이션 미리보기로 셰이더 효과 테스트
• 🧪 여러 동시 효과를 이용한 성능 테스트
• 🎯 커서 위치에서 마우스 오른쪽 버튼으로 생성

완벽한 효과 목록과 사용 지침은 View Demo Guide →를 참고하세요.

🎨 사용자 정의 (Customization)

모든 효과는 시각적 편집이 용이하도록 씬 기반(.tscn 파일)입니다:

addons/vfx_library/
├── effects/          # 파티클 효과 씬
├── shaders/          # 셰이더 파일
...

• 파티클 효과: Godot 에디터에서 .tscn 파일을 직접 편집합니다.
• 셰이더: .gdshader 파일을 수정하거나 변형을 만듭니다.
• 색상 및 타이밍: GDScript 파라미터를 통해 조정합니다.
• 매니저 API: 사용자 정의 효과를 위해 vfx.gd와 env_vfx.gd를 확장합니다.

🤝 기여 (Contributing)

기여를 환영합니다! 지침은 CONTRIBUTING.md를 참고하세요.

기여 방법

• 🐛 GitHub Issues를 통해 버그 보고
• 💡 새로운 효과나 개선 사항에 대한 기능 제안
• 🎨 효과 제출 - 새로운 파티클, 셰이더 또는 프리셋
• 📖 문서 개선 - 예제, 튜토리얼, 번역

📝 라이선스 (License)

본 프로젝트는 MIT License에 따라 라이선스가 부여되었으며, 자세한 내용은 LICENSE 파일을 참고하세요.

🙏 감사의 말씀 (Acknowledgments)

• **Godot 4.5+**용으로 제작됨
• 클래식 메트로배니아 및 액션 게임에서 영감 받음
• 커뮤니티 피드백 및 기여
• 우수한 문서화에 대한 Godot 커뮤니티에 특별 감사

⭐ 프로젝트에 도움이 되었다면 이 저장소를 별표(Star) 표시해 주세요!

질문이 있나요? 이슈를 열거나 documentation을 확인하세요.