{"id":28380243,"url":"https://github.com/zapabob/reactive-aura-fx","last_synced_at":"2025-07-01T16:08:20.585Z","repository":{"id":295816920,"uuid":"991333290","full_name":"zapabob/reactive-aura-fx","owner":"zapabob","description":"VRChatアバター向け魅力的エフェクトシステム。表情・視線・動作に連動してリアルタイムでエフェクトを発動し、自己表現力と没入感を向上させます。","archived":false,"fork":false,"pushed_at":"2025-05-27T15:08:50.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T05:58:23.865Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zapabob.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-27T13:19:46.000Z","updated_at":"2025-05-27T13:26:46.000Z","dependencies_parsed_at":"2025-05-27T14:40:36.139Z","dependency_job_id":"3fd76fb6-f514-4523-a6e9-23fc1d9ac939","html_url":"https://github.com/zapabob/reactive-aura-fx","commit_stats":null,"previous_names":["zapabob/reactive-aura-fx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zapabob/reactive-aura-fx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2Freactive-aura-fx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2Freactive-aura-fx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2Freactive-aura-fx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2Freactive-aura-fx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zapabob","download_url":"https://codeload.github.com/zapabob/reactive-aura-fx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapabob%2Freactive-aura-fx/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261742918,"owners_count":23203048,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-30T03:08:03.135Z","updated_at":"2025-06-24T19:32:35.829Z","avatar_url":"https://github.com/zapabob.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌟 Reactive Aura FX - 魅力拡張アバター\n\nVRChatアバター向け魅力的エフェクトシステム\n表情・視線・動作に連動してリアルタイムでエフェクトを発動し、自己表現力と没入感を向上\n\n![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)\n![Unity](https://img.shields.io/badge/Unity-2022.3_LTS-green.svg)\n![VRChat](https://img.shields.io/badge/VRChat-SDK3-orange.svg)\n\n## ✨ 主要機能\n\n### 💫 EmotionAura - 表情連動オーラ\n- **機能**: アバターの表情（笑顔・怒り・悲しみ）に応じたオーラ発光\n- **トリガー**: Animatorパラメータによる表情変化\n- **エフェクト**: 色と形が変化するオーラエフェクト\n- **設定可能項目**: オーラ色、強度、範囲、アニメーション速度\n\n### 💓 HeartbeatGlow - 鼓動波紋光\n- **機能**: 胸元に手を置く動作で鼓動のような波紋光が広がる\n- **トリガー**: 手と胸の位置関係検出\n- **エフェクト**: 波紋状の光エフェクト、鼓動音再生\n- **設定可能項目**: 鼓動速度、波紋強度、色、最大半径\n\n### 👁️ EyeFocusRay - 視線フォーカスビーム\n- **機能**: 視線がオブジェクトにフォーカスしたときに細いビーム状光を発生\n- **トリガー**: カメラ視線方向とRaycast判定\n- **エフェクト**: LineRendererによるビーム、フォーカス時パーティクル\n- **設定可能項目**: ビーム長さ、太さ、色、フォーカス感度\n\n### 💕 LovePulse - 愛情パーティクル\n- **機能**: 特定ユーザーとの距離と注視でハート型パーティクルとSE発生\n- **トリガー**: プレイヤー距離 + 視線角度判定\n- **エフェクト**: ハート型パーティクル、愛情ライト、鼓動音\n- **設定可能項目**: 検出距離、パーティクル数、色、蓄積時間\n\n### 🌸 IdleBloom - 静寂の花\n- **機能**: 静止状態が一定時間継続すると足元に花が咲く演出\n- **トリガー**: 位置変化の検出による静止判定\n- **エフェクト**: 3D花オブジェクト、パーティクル、環境ライト\n- **設定可能項目**: 静止時間閾値、花の成長速度、色、数\n\n## 🔧 システム要件\n\n- **Unity**: 2022.3.22f1 LTS以上\n- **VRChat SDK**: VRChat SDK3 (Avatar 3.0)\n- **対応プラットフォーム**: PCVR, Desktop VRChat\n- **必須**: Modular Avatar (完全統合対応)\n- **推奨**: VRChat Creator Companion (VCC)\n\n## 📦 インストール方法\n\n### 方法1: Unityパッケージインポート\n1. リリースページから最新のunitypackageをダウンロード\n2. Unity上で`Assets \u003e Import Package \u003e Custom Package`\n3. ダウンロードしたパッケージを選択してインポート\n\n### 方法2: GitHubからクローン\n```bash\ngit clone https://github.com/zapabob/ReactiveAuraFX.git\n```\n\n## 🚀 使用方法\n\n### 💡 超簡単！一発セットアップ（Modular Avatar完全統合）\n1. **Modular Avatarをインストール**（VCC推奨）\n2. **アバターのルートオブジェクト**（VRCAvatarDescriptorがあるオブジェクト）を選択\n3. Unityメニューから「**ReactiveAuraFX \u003e 🌟 アバターにReactiveAuraFXを追加**」をクリック\n4. **完了！** Modular Avatarが自動統合されます\n\n### 🔗 Modular Avatar統合内容\n- **Expression Parameters**: 全エフェクトのON/OFF制御\n- **Expression Menu**: 階層化されたメニュー自動生成\n- **Merge Animator**: AnimatorControllerの自動統合\n- **リアルタイム制御**: VRChat内での即座のエフェクト制御\n\n### 🛡️ AutoFIX対策済み\n- **オブジェクト名**: 自動的に「ReactiveAuraFX_System」に設定\n- **タグ**: 「EditorOnly」タグで保護\n- **Modular Avatar完全統合**: MA Parameters, Menu Installer, Merge Animator自動追加\n\n### 詳細設定\n\n#### EmotionAura設定\n```csharp\n// 表情変化の検出\nEmotionAuraEffect emotionAura = GetComponent\u003cEmotionAuraEffect\u003e();\nemotionAura.SetEmotion(EmotionType.Happy);\n```\n\n#### HeartbeatGlow設定\n```csharp\n// 手動でハートビート発動\nHeartbeatGlowEffect heartbeat = GetComponent\u003cHeartbeatGlowEffect\u003e();\nheartbeat.StartHeartbeatEffect();\n```\n\n#### EyeFocusRay設定\n```csharp\n// ビーム設定カスタマイズ\nEyeFocusRayEffect eyeRay = GetComponent\u003cEyeFocusRayEffect\u003e();\neyeRay.SetBeamColor(Color.cyan);\neyeRay.SetBeamLength(8f);\n```\n\n#### LovePulse設定\n```csharp\n// 愛情パルス手動発動\nLovePulseEffect lovePulse = GetComponent\u003cLovePulseEffect\u003e();\nlovePulse.ManualTriggerLovePulse();\n```\n\n#### IdleBloom設定\n```csharp\n// 花を手動で咲かせる\nIdleBloomEffect idleBloom = GetComponent\u003cIdleBloomEffect\u003e();\nidleBloom.ManualTriggerBloom();\n```\n\n## 🎨 カスタマイズ\n\n### カラーテーマの変更\n各エフェクトはInspectorから簡単に色を変更できます：\n\n```csharp\n// プログラムから色を変更\npublic void ChangeThemeColor(Color newColor)\n{\n    emotionAura.SetEmotionColor(newColor);\n    heartbeat.SetHeartbeatColor(newColor);\n    eyeRay.SetBeamColor(newColor);\n    lovePulse.SetLoveColor(newColor);\n}\n```\n\n### エフェクト強度の調整\n```csharp\n// 全体的な強度調整\npublic void SetGlobalIntensity(float intensity)\n{\n    emotionAura.SetIntensity(intensity);\n    heartbeat.SetHeartbeatIntensity(intensity);\n    eyeRay.SetBeamIntensity(intensity);\n    lovePulse.SetEffectIntensity(intensity);\n}\n```\n\n## 🔌 Modular Avatar完全統合機能\n\n### Expression Menu構造\n自動生成されるExpression Menu構造：\n```\n🌟 ReactiveAuraFX (Toggle) - システム全体ON/OFF\n└── ⚙️ エフェクト設定 (SubMenu)\n    ├── 💫 EmotionAura (Toggle)\n    ├── 💓 HeartbeatGlow (Toggle)  \n    ├── 💓 Heartbeat Trigger (Button) - 手動発動\n    ├── 👁️ EyeFocusRay (Toggle)\n    ├── 💕 LovePulse (Toggle)\n    └── 🌸 IdleBloom (Toggle)\n```\n\n### Expression Parameters\n自動生成されるAnimatorパラメータ：\n```csharp\n// システム制御\n\"ReactiveAuraFX/SystemEnabled\" (Bool)\n\"ReactiveAuraFX/EmotionAura\" (Bool)\n\"ReactiveAuraFX/HeartbeatGlow\" (Bool)\n\"ReactiveAuraFX/EyeFocusRay\" (Bool)\n\"ReactiveAuraFX/LovePulse\" (Bool)\n\"ReactiveAuraFX/IdleBloom\" (Bool)\n\n// エフェクト連動\n\"Emotion\" (Int) - 表情値 (0-7)\n\"HeartbeatTrigger\" (Bool) - 鼓動手動発動\n```\n\n### Animatorパラメータ連動\n表情に応じた自動エフェクト発動：\n```csharp\n// EmotionAura自動連動\n0: Neutral, 1: Happy, 2: Love, 3: Shy\n4: Angry, 5: Sad, 6: Excited, 7: Calm\n```\n\n## 📊 パフォーマンス最適化\n\n### LOD (Level of Detail) 設定\n- 距離に応じてエフェクトの詳細度を自動調整\n- VRChatのパフォーマンス基準に対応\n\n### GPU最適化\n- パーティクルシステムのGPU Instancing使用\n- シェーダーレベルでの最適化\n\n### メモリ使用量最適化\n- オブジェクトプールパターンの使用\n- 不要時のリソース自動解放\n\n## 🛠️ トラブルシューティング\n\n### 🚨 AutoFIXで消された場合\n1. Unityメニューから「**ReactiveAuraFX \u003e 🔧 設定とトラブルシューティング**」を開く\n2. 「**全ReactiveAuraFXオブジェクトを検索**」ボタンをクリック\n3. 見つからない場合は再インストール：「**ReactiveAuraFX \u003e 🌟 アバターにReactiveAuraFXを追加**」\n\n### よくある問題\n\n**Q: エフェクトが表示されない**\nA: 以下を確認してください：\n- ReactiveAuraFXSystemが有効になっているか\n- 対象のアバターにAnimatorが設定されているか\n- VRChat SDKが正しくインポートされているか\n- AutoFIX安全モードが有効になっているか\n\n**Q: AutoFIXで削除される**\nA: **対策済み！** 以下の保護機能があります：\n- オブジェクト名に「ReactiveAuraFX」を含む命名\n- 「EditorOnly」タグによる保護\n- Awakeでの自動安全設定\n\n**Q: パフォーマンスが重い**\nA: 以下を試してください：\n- パーティクル数を減らす\n- 不要なエフェクトを無効化\n- 「設定とトラブルシューティング」ウィンドウでパフォーマンス設定を確認\n\n**Q: VRChatでエフェクトが動作しない**\nA: 以下を確認してください：\n- VRChat互換性モードが有効になっているか\n- Modular Avatarが正しく統合されているか\n- アバターのパフォーマンスランクが適切か\n\n## 📝 変更履歴\n\n### v1.0.0 (2025-01-27)\n- 初回リリース\n- EmotionAura、HeartbeatGlow、EyeFocusRay、LovePulse、IdleBloom実装\n- **Modular Avatar完全統合**（Expression Parameters/Menu/Merge Animator）\n- リアルタイムAnimatorパラメータ監視機能\n- Unityカスタムエディタ実装（MA統合状態表示）\n- VRChat SDK3対応\n\n## 🤝 コントリビューション\n\nプルリクエストやイシューの報告を歓迎します！\n\n1. このリポジトリをフォーク\n2. 機能ブランチを作成 (`git checkout -b feature/amazing-feature`)\n3. 変更をコミット (`git commit -m 'Add amazing feature'`)\n4. ブランチにプッシュ (`git push origin feature/amazing-feature`)\n5. プルリクエストを作成\n\n## 📄 ライセンス\n\n### 商用利用について\n- **個人利用**: 自由に使用可能\n- **配信での使用**: 許可\n- **Boothでの再販**: 禁止\n- **改造・カスタマイズ**: 個人利用の範囲で許可\n\n### 必要表記\nプロジェクトを使用する際は、以下の表記を含めてください：\n```\nPowered by Reactive Aura FX\n```\n\n## 📞 サポート\n\n- **ドキュメント**: [Wiki](https://github.com/zapabob/reactive-aura-fx/wiki)\n- **Modular Avatar公式**: [https://modular-avatar.nadena.dev/](https://modular-avatar.nadena.dev/)\n- **Issues**: [GitHub Issues](https://github.com/zapabob/reactive-aura-fx/issues)\n- **VRChat Ask**: [Non-Destructive Workflows Guide](https://ask.vrchat.com/t/go-the-modular-way-a-guide-to-non-destructive-workflows-on-avatars/23084)\n\n## 🚀 今後の拡張予定\n\n### Phase 2: センサー連携\n- OSC Sensor Integration（心拍センサー等）\n- リアルタイム生体情報連携\n\n### Phase 3: AI機能\n- AI-driven Emotion Mapping\n- チャット内容からの自動エフェクト発動\n\n### Phase 4: マルチプラットフォーム\n- Cluster対応\n- VR以外のプラットフォーム対応\n\n---\n\n💖 **Reactive Aura FXで、あなたのアバターをもっと魅力的に！**\n\nMade with ❤️ for VRChat Community ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzapabob%2Freactive-aura-fx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzapabob%2Freactive-aura-fx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzapabob%2Freactive-aura-fx/lists"}