fix
This commit is contained in:
1
.gitignore
vendored
1
.gitignore
vendored
@@ -1,3 +1,4 @@
|
||||
book/_book
|
||||
book/node_modules
|
||||
book/*-lock.json
|
||||
.claude
|
||||
|
||||
@@ -22,7 +22,7 @@
|
||||
|---|---|---|
|
||||
|[pixel streaming](https://github.com/EpicGamesExt/PixelStreamingInfrastructure/blob/master/Docs/pixel-streaming-2-migration-guide.md)|2|ゲームをserverにdeployしてwebからプレイ|
|
||||
|[twinmotion](https://www.twinmotion.com/ja)|20250101p|建造物をインポート|
|
||||
|[vrm4u](https://github.com/ruyo/VRM4U/releases/tag/20250206)|20250206|vrmモデルを動かす|
|
||||
|[vrm4u](https://github.com/ruyo/VRM4U/releases/)|20250206|vrmモデルを動かす|
|
||||
|[kawaiiphysics](https://github.com/pafuhana1213/KawaiiPhysics)|20241201|揺れものを設定|
|
||||
|[varest](https://github.com/ufna/VaRest)|20240828|curlのようなもの。supportが終了しているのでbuildが必要|
|
||||
|[tatools](https://www.fab.com/ja/listings/a5d3b60d-b886-4564-bf6d-15d46a8d27fe)|20241206|animを作る|
|
||||
|
||||
243
claude.md
Normal file
243
claude.md
Normal file
@@ -0,0 +1,243 @@
|
||||
# ai.verse UE5実装ガイド
|
||||
|
||||
## プロジェクト概要
|
||||
**ai.verse** - Unreal Engine 5.6で開発中の惑星規模3Dメタバース
|
||||
|
||||
### 基本情報
|
||||
- **エンジン**: Unreal Engine 5.6
|
||||
- **開発手法**: Blueprint中心、繰り返し再実装による改善
|
||||
- **特徴**: 惑星規模のシームレスワールド、atproto統合
|
||||
|
||||
## 現在の実装状況
|
||||
|
||||
### 完成済み機能
|
||||
- ✅ 惑星規模の地球・月・太陽（WorldScape + UDS）
|
||||
- ✅ シームレスな宇宙移動（大気圏→宇宙が一つのマップ）
|
||||
- ✅ 月面着陸・クレーター探索
|
||||
- ✅ キャラクターアクション（GASP + SFA統合）
|
||||
- ✅ 飛行システム
|
||||
|
||||
### 再実装予定機能（./book/に詳細記録）
|
||||
|
||||
#### atproto統合
|
||||
- **ログイン機能** (`/json/02_atproto.md`)
|
||||
- syui.ai (bsky.social) / syui.syu.is認証
|
||||
- PDSLSでの情報確認
|
||||
- **データ連携**
|
||||
- アイテム取得→レコード更新
|
||||
- カードシステム（画像URL管理）
|
||||
- ゲームデータ管理（ai.syui.game.system）
|
||||
|
||||
#### UI/UX
|
||||
- **タイトル画面** （実装ドキュメント未発見）
|
||||
- **ゲームUI** (`/ui/01_list.md`, `/crs/02_boss.md`)
|
||||
- ListView実装（WBP_player, WBP_text）
|
||||
- HPゲージ（ProgressBar 0.0-1.0）
|
||||
- ステータス表示
|
||||
|
||||
#### 戦闘システム
|
||||
- **ボスバトル** (`/crs/02_boss.md`)
|
||||
- Control Rig Sample Mech使用
|
||||
- Look At bone modifier
|
||||
- ダメージ処理（Event Any Damage）
|
||||
- Niagara破壊エフェクト
|
||||
- **武器システム** (`/gasp/12_weapon.md`)
|
||||
- Socket設定（武器装着）
|
||||
- 抜刀/納刀アニメーション
|
||||
- BP_WeaponSword実装
|
||||
- **剣技システム** ([Blueprint実装](https://blueprintue.com/blueprint/cu104wg0/))
|
||||
- Montage切り替えによる3段攻撃
|
||||
- 複雑なBranch処理で攻撃段階管理
|
||||
- Trail effectsのNiagara実装
|
||||
- **キャラスキル** ([Niagara Collision実装](https://blueprintue.com/blueprint/h2ktbf6-/))
|
||||
- Niagara CollisionでAoEダメージ
|
||||
- クールダウンシステム
|
||||
- レベル連動の変身システム（Lv1で飛行可能）
|
||||
- スキル習得アイテムドロップ
|
||||
|
||||
#### 移動・アクション
|
||||
- **基本移動** (`/gasp/README.md`)
|
||||
- WASD移動、Space跳躍、Shift疾走
|
||||
- **ジャンプシステム** (`/gasp/02_jump.md`)
|
||||
- TraversalAction高度変更（275→475）
|
||||
- **段階的移動** (`/gasp/11_run.md`)
|
||||
- スプリントアニメーション切替
|
||||
- Layered blend per bone実装
|
||||
|
||||
#### アイテムシステム
|
||||
- **ドロップシステム** (`/plan/04_item.md`, `/crs/02_boss.md`)
|
||||
- Nice Interaction System使用
|
||||
- AC_PC_Interaction / AC_GS_Interaction
|
||||
- "E"キーでのアイテム取得
|
||||
|
||||
## 技術スタック
|
||||
|
||||
### プラグイン
|
||||
- **WorldScape**: 惑星地形生成
|
||||
- **Ultra Dynamic Sky (UDS)**: 天候・時間システム
|
||||
- **GASP**: Game Animation Sample
|
||||
- **SFA**: SuperHero Flight Animation
|
||||
- **VRM4U**: VRMアバター統合（予定）
|
||||
|
||||
### 現在直面している課題
|
||||
|
||||
#### 1. 重力システム
|
||||
- **問題**: 惑星の横から入ると坂になり、反対側から進入不可
|
||||
- **原因**: 球体重力の実装が不完全
|
||||
|
||||
#### 2. 天候システム（UDS）
|
||||
- **Manual Rain**: 動作するが雲の上でも降り続ける
|
||||
- **Random Rain**: 惑星規模では機能しない
|
||||
- **惑星裏側**: Weather有効時にレンダリング異常
|
||||
- **回避策**: Weather無効化で解決するが、晴れ/曇り表現が失われる
|
||||
|
||||
##### 解決策：CharacterBPベースの雨エフェクト
|
||||
- **実装方法**: CharacterBPにSceneRain追加
|
||||
- **制御**: 高度とUDS天候状態で有効/無効切替
|
||||
- **利点**: UDSの雲表現を維持しつつ適切な雨表現
|
||||
- **実装済み**: [雨エフェクトBlueprint](https://blueprintue.com/blueprint/8kty-cvm/)
|
||||
- SceneRain子要素をForEachで制御
|
||||
- Niagara/PostProcessを個別判定
|
||||
- 機能するが実装に改善余地あり
|
||||
|
||||
#### 3. ビジュアルスタイル
|
||||
- **課題**: WorldScapeのデフォルト地形が現実的すぎる
|
||||
- **目標**: 原神のようなアニメ調スタイル
|
||||
- **検討**: So Stylized Environmentとの統合
|
||||
|
||||
## atproto統合アーキテクチャ
|
||||
|
||||
### 認証方式
|
||||
**WebAPI直接連携**を採用（PixelStreamingに依存しない）
|
||||
|
||||
### データ構造
|
||||
```
|
||||
GameInstance (BP_Config)
|
||||
├── 環境変数
|
||||
│ ├── API設定
|
||||
│ ├── 認証情報（Token等）
|
||||
│ └── システムデータ（JSON）
|
||||
│
|
||||
├── 管理者アカウント
|
||||
│ └── ai.syui.game.system
|
||||
│ ├── キャラクターステータス
|
||||
│ ├── アイテム効果
|
||||
│ └── カード情報（ID→画像URL）
|
||||
│
|
||||
└── プレイヤーデータ
|
||||
└── 個人レコード（atproto collection）
|
||||
```
|
||||
|
||||
### 実装フロー
|
||||
1. GameInstance起動時にシステムデータ一括取得
|
||||
2. Castによる都度参照・更新
|
||||
3. プレイヤーアクション→atprotoレコード更新
|
||||
|
||||
## Blueprint実装の課題と解決策
|
||||
|
||||
### JSON処理
|
||||
**課題**: UE5標準のJSON処理が複雑
|
||||
**解決策**:
|
||||
- VaRest Plugin（無料）を独自ビルドで使用
|
||||
- 公式はUE5.5/5.6非対応のため自前でビルド
|
||||
- メンテナンスされていないが動作は安定
|
||||
- JSON Parser Plugin（有料）も併用
|
||||
- UE5.6サポートは不明（更新が遅れる可能性）
|
||||
|
||||
**今後の課題**:
|
||||
- プラグイン依存のリスク（UEバージョンアップ時）
|
||||
- C++でのユーティリティクラス実装も検討必要
|
||||
|
||||
### Widget画像表示
|
||||
**実装**: Widget Browserで直接URL表示（キャッシュなし）
|
||||
|
||||
### 非同期処理
|
||||
**実装**: GameInstanceでの一元管理とCast利用
|
||||
|
||||
## ゲームデザイン哲学
|
||||
|
||||
### 開発方針
|
||||
- **作り直しの効果**: 1週間の実装→数時間で改善版完成
|
||||
- **積極的な再実装**: 動くコードがあっても、より良い実装のために作り直す
|
||||
- **学習重視**: UEへの理解を深めながら、段階的に改善
|
||||
- **技術的負債回避**: ゴチャゴチャしたコードは捨てる勇気
|
||||
- **シンプル重視**: 複雑なゲームより長く続く体験
|
||||
- **配信親和性**: 同じ画面でも個性が出る設計
|
||||
|
||||
### 作り直しのメリット
|
||||
- 新バージョンの機能を最大限活用
|
||||
- 以前の問題への解決策が見つかる
|
||||
- コードがスマートでシンプルになる
|
||||
- UEへの理解が深まるたびに品質向上
|
||||
|
||||
### 新機能案
|
||||
- **宇宙カジノ**: 移動中の暇つぶし要素
|
||||
- **釣りシステム**: レアドロップ（ドラゴン0.0001%）
|
||||
- **30秒投稿**: atproto自動投稿との連携
|
||||
|
||||
## UE5.6デモゲーム統合計画
|
||||
|
||||
### 発見されたUE5.6デモゲーム
|
||||
1. **Variant_Combat**: 格闘ゲーム、物理演算での吹っ飛び
|
||||
2. **Variant_Shooter**: 銃ゲーム、弾痕が残る、アイテム拾得
|
||||
3. **Variant_TwinStick**: 大爆発演出、スロー効果
|
||||
|
||||
### ai.verseへの活用方針
|
||||
- **Variant_Combat → ボスシステム**: 物理演算による自然な反応
|
||||
- **Variant_Shooter → アイテムシステム**: 武器収集、環境破壊
|
||||
- **Variant_TwinStick → スキル演出**: 大技の派手な演出
|
||||
|
||||
### City Sample統合の可能性
|
||||
- **自動で動く街**: Mass Entity Systemによる生きた都市
|
||||
- **車両物理演算**: Chaos Physicsによるリアルな挙動
|
||||
- **WorldScapeとの組み合わせ**: 惑星表面の都市環境
|
||||
|
||||
### 飛行システムの改良案
|
||||
- **泳ぐような操作感**: 常時微細な揺れ、左右上下の自然な動き
|
||||
- **加速システム**: 溜め動作による推進力、羽ばたき演出
|
||||
- **物理ベース**: Air Resistance、慣性重視の操作感
|
||||
|
||||
### 2Dステージ統合
|
||||
- **切り替えシステム**: 特定エリアで2D視点に変更
|
||||
- **横スクロール**: UE5.6の2Dデモベース
|
||||
- **3D世界復帰**: クリア後のポータルシステム
|
||||
|
||||
## 今後の実装予定
|
||||
|
||||
### 短期目標
|
||||
1. UE5.6での基本システム再構築
|
||||
2. atproto認証の再実装
|
||||
3. タイトル画面・ログインUI
|
||||
|
||||
### 中期目標
|
||||
1. OAuth認証への移行
|
||||
2. カード連携システム
|
||||
3. PixelStreaming統合（Web配信）
|
||||
|
||||
### 長期目標
|
||||
1. VTuber配信プラットフォーム化
|
||||
2. Play-to-Work経済システム
|
||||
3. ai.gpt NPCの統合
|
||||
|
||||
## 技術メモ
|
||||
|
||||
### UE5.6変更点
|
||||
- WorldScapeがEarthサイズ対応
|
||||
- GASPのBP構造変更
|
||||
- SFAのアニメーション改善
|
||||
|
||||
### パフォーマンス最適化
|
||||
- 惑星規模でのUDS維持設定
|
||||
- シームレス移動の最適化
|
||||
|
||||
### 参考リソース
|
||||
- [古い実装ドキュメント](https://syui.github.io/m/post/ue/)
|
||||
- [Blueprint実装記録](https://blueprintue.com/profile/ai/)
|
||||
- [剣技Blueprint](https://blueprintue.com/blueprint/cu104wg0/)
|
||||
- [スキルBlueprint](https://blueprintue.com/blueprint/h2ktbf6-/)
|
||||
- [WorldScape公式ドキュメント](https://iolacorp-1.gitbook.io/worldscape-plugin)
|
||||
- [So Stylized Environment](https://docs.google.com/document/d/147wCDvZg6-9jZNyqSxX-I_HQkE2tGINZIhyjc2QHirY)
|
||||
|
||||
---
|
||||
|
||||
*このドキュメントは開発の進捗に応じて随時更新されます*
|
||||
Reference in New Issue
Block a user