first

book/issue/README.md

@@ -0,0 +1,9 @@
+# issue
+
+問題の解決を目指します。
+
+ゲーム開発をしていると、issue(問題)がたくさん発生します。特にueはbug(バグ)が多く、機能は実験的(pre releases)であることが多いです。
+
+また、開発者(dev)のフォーラム(forum)もあります。
+
+https://forums.unrealengine.com/

book/issue/SUMMARY.md

@@ -0,0 +1,22 @@
+# Summary
+
+* [ue](issue/ue/README.md)
+   * [error II-E1001](issue/ue/ue_01.md)
+* [game animation sample](issue/gasp/README.md)
+   * [GameplayCameraをdisableにする](issue/gasp/gasp_01.md)
+   * [cameraが急接近する](issue/gasp/gasp_02.md)
+   * [characterのcomponentが初期化される](issue/gasp/gasp_03.md)
+   * [IA_Sprintのダッシュができなくなる](issue/gasp/gasp_04.md)
+   * [traversableが機能しなくなる](issue/gasp/gasp_05.md)
+* [city sample](issue/city/README.md)
+   * [buildが遅い場合](issue/city/city_01.md)
+   * [ue5.5ではbuildが通らない](issue/city/city_02.md)
+   * [問題が起こったときにresetする](issue/city/city_03.md)
+   * [playerが地面に埋まってしまう](issue/city/city_04.md)
+   * [他のmapとの統合](issue/city/city_05.md)
+   * [BGMを変更する](issue/city/city_06.md)
+* [blender](issue/blender/README.md)
+   * [衣装の背後に黒いチラつきが発生する](issue/blender/blender_01.md)
+* [vrm4u](issue/vrm4u/README.md)
+   * [customで衣装の半分が灰色になる](issue/vrm4u/vrm4u_01.md)
+

book/issue/blender/README.md

@@ -0,0 +1,3 @@
+# blender
+
+https://projects.blender.org/blender/blender/issues

book/issue/blender/blender_01.md

@@ -0,0 +1,6 @@
+# 衣装の背後に黒いチラつきが発生する
+
+ueで読み込むと衣装の背後に黒いチラつきが発生する問題は、vrm-outlineが原因です。
+
+これはblenderの問題ではありませんが、勘違いしやすいので、ここに掲載します。
+

book/issue/blender/blender_02.md

@@ -0,0 +1,7 @@
+# ueで読み込むと一部のmaterialが正しく表示されない
+
+この現象はblenderで作った`.vrm`をvrm4uで読み込み、一旦、ueを終了するとその後、materialがおかしくなります。
+
+しかし、`vrm1`の出力は正常なので、それを読み込んで生成されたmaterialを`SK_${name}`にセットしています。
+
+

book/issue/blender/blender_03.md

@@ -0,0 +1,8 @@
+# 髪の毛が頭に追従しなくなる事がある
+
+激しく動いたときなど、髪の毛と頭が分離してしまうことがありますが、これはウェイトが正しく塗られていないことが原因です。
+
+armature(bone)を統合したとき、`head`,`neck`, `J_Bip_C_Head`, `J_Bip_C_Neck`に混在してウェイトが塗られていることがあります。
+
+例えば、赤く塗るのは`J_Bip_C_Head`だけにしましょう。`耳`と`後頭部の内部(髪色部分)`が重要です。
+

book/issue/city/README.md

@@ -0,0 +1 @@
+https://forums.unrealengine.com/search?q=city%20sample

book/issue/city/city_01.md

@@ -0,0 +1,14 @@
+## buildが遅い場合
+
+もしcity sampleのmapを使わない場合は、buildが遅くなってしまいます。
+
+ueのpackage化が遅い場合、使用するmap以外をbuildしないようにすることで、処理時間を短縮できます。以下の手順で設定を行います。
+
+1. `プロジェクト設定`を開きます。
+2. 「パッケージ化」セクションに移動します。
+3. 「マップのみをクック」オプションにチェックを入れます。
+4. 「パッケージ化されたビルドに含めるマップのリスト」に、必要なマップ（.umapファイル）を指定します。
+
+この設定により、指定したmapのみがpackage化され、データサイズが小さくなり、処理時間も短縮されます。
+
+

book/issue/city/city_02.md

@@ -0,0 +1,39 @@
+## ue5.5ではbuildが通らない
+
+`2024-11-18`時点ではcity sampleはue5.5でbuildが通りません。ue5.4では通ります。
+
+`Engine/Plugins/Performance/AutomatedPerfTestingにAutomatedPerfTestConfig.cs`, `AutomatedPerfTestNode.cs`が含まれていないため`${project}/Build/Script/CitySample.Automation.csproj`に記述されているcompileが通らないのです。`AutomatedPerfTesting`は5.5で追加されたpluginです。
+
+```html
+<Project Sdk="Microsoft.NET.Sdk">
+  <Import Project="CitySample.Automation.csproj.props" Condition="Exists('CitySample.Automation.csproj.props')"/>
+  
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Compile Include="$(EngineDir)\Plugins\Performance\AutomatedPerfTesting\Build\Scripts\AutomatedPerfTestConfig.cs" />
+    <Compile Include="$(EngineDir)\Plugins\Performance\AutomatedPerfTesting\Build\Scripts\AutomatedPerfTestNode.cs" />
+  </ItemGroup>
+
+</Project>
+```
+
+> Experimental release of Automated Perf Testing Plugin v0.1, providing Gauntlet Test Controllers, UAT Test Nodes, and BuildGraph macros for adding common automated performance tests to a project’s automated build and test.
+
+- https://dev.epicgames.com/documentation/ja-jp/unreal-engine/unreal-engine-5.5-release-notes
+- https://dev.epicgames.com/documentation/en-us/unreal-engine/API/Plugins/AutomatedPerfTesting
+
+これはgithubにあるsrcから持ってくるしかありません。アクセスするにはorgに参加します。
+
+https://github.com/EpicGames/UnrealEngine/tree/release/Engine/Plugins/Performance/AutomatedPerfTesting/Build/Scripts
+
+1. `$(EngineDir)\Plugins\Performance\AutomatedPerfTesting\Build\Scripts`フォルダを作ります。`$(EngineDir)`はueがインストールされているディレクトリです。
+2. githubの[src](https://github.com/EpicGames/UnrealEngine/tree/release/Engine/Plugins/Performance/AutomatedPerfTesting/Build/Scripts)から持ってきた`$(EngineDir)\Plugins\Performance\AutomatedPerfTesting\Build\Scripts\AutomatedPerfTestConfig.cs`, `$(EngineDir)\Plugins\Performance\AutomatedPerfTesting\Build\Scripts\AutomatedPerfTestNode.cs`を同ディレクトリに置きます。
+
+また、`CitySampleCookedEditor.Target.cs`を削除するとbuildが通ったという報告があります。
+
+https://forums.unrealengine.com/t/automatedperftesting-plugin-does-not-build-when-building-city-sample-in-ue5-5/2134722/9
+
+

book/issue/city/city_03.md

@@ -0,0 +1,7 @@
+## 問題が起こったときにresetする
+
+`/Content/Map/Small_City_LVL.umap`と`/Content/__ExternalActors__/Map/Small_City_LVL`を上書きします。copy元は`VaultCache`からでもいいですし、新しく作った`CitySample`のprojectからでもいいです。
+
+基本的に新しいprojectを作成するときは`VaultCache`からcopyされます。これがないとdownloadから`VaultCache`が生成されます。
+
+

book/issue/city/city_04.md

@@ -0,0 +1,29 @@
+## playerが地面に埋まってしまう
+
+GASPと統合するとcity sampleに置かれた物体に触れられません。collisionが発生しないのです。
+
+原因は`Gameplay Camera`というpluginです。`$project/Config/DefaultEngine.ini`に`DDCVar.NewGameplayCameraSystem.Enable`を追加し、関数である`Setup Camera`を実行している場合、characterのcollisionが機能せず地面に埋まってしまう問題があります。
+
+- Gameplay Camera
+- Setup Camera
+- `DDCVar.NewGameplayCameraSystem.Enable`
+
+```sh
+[/Script/Engine.DataDrivenConsoleVariableSettings]
++CVarsArray=(Type=CVarBool,Name="DDCVar.NewGameplayCameraSystem.Enable",ToolTip="",DefaultValueFloat=0.000000,DefaultValueInt=0,DefaultValueBool=True)
+```
+
+`Setup Camera`を実行しないようにするか、`DDCVar.NewGameplayCameraSystem.Enable`をfalseにします。
+
+### Collision Trace Channel
+
+`Collision Trace Channel`を設定するには、`Config/DefaultEngine.ini`を編集する必要があります。以下の手順で行います。GASPは`traversable`を追加します。これが追加されていないと動きません。
+
+`ECC_GameTraceChannel${n}`に注意してください。
+
+```sh
+[/Script/Engine.CollisionProfile] 
++DefaultChannelResponses=(Channel=ECC_GameTraceChannel11,DefaultResponse=ECR_Ignore,bTraceType=True,bStaticObject=False,Name="Traversable")
+```
+
+

book/issue/city/city_05.md

@@ -0,0 +1,7 @@
+## 他のmapとの統合
+
+mapにはactorがまとめられているものがあり、それはmapにくっついていません。移動できない場合があります。
+
+基本的にはmap[A]とmap[B]はある程度位置を完成させてからcopyしましょう。
+
+

book/issue/city/city_06.md

@@ -0,0 +1,22 @@
+# BGMを変更する
+
+例えば、BGMの一部を変更したい場合は、`プロジェクト設定 -> ゲーム -> World Audio Data`を見てください。
+
+私はmatrix(マトリックス)のテーマを消したかったので、`/Content/Audio/MetaSounds/Music/`にある`music_leavebehind_New_Mix_Meta`, `music_leavebehind_New_Mix_NHT_Meta`の音量を`0.0`にしました。
+
+## 音楽を作る
+
+ゲームには音楽が欠かせません。普段は中毒性のあるゆったりした音楽を流しながら、ここぞという場面では、場を盛り上げる音楽を流します。ポケモンの音楽が好きですね。
+
+このような演出は、ゲームの出来栄えの50%以上を占めると考えています。
+
+つまり、音楽のパワーはゲームでは特に重要になります。そして、音楽はそのゲームやキャラクターの印象を決定づける力があります。気をつけましょう。
+
+では、音楽を作るにはどうすればいいのでしょう。
+
+私は`suno`でBGMを自作しています。
+
+- https://suno.com/
+
+AIで作るとしても、そこには意味を込めなければなりません。キャラクターのテーマソングを思い浮かべください。その人はどんな人で、ここはどのような場所なのか。それがわかれば、プレイヤーの気持ちを思い浮かべることができるはずです。キャラクターや場所に合った曲を目指します。
+

book/issue/city/city_07.md

@@ -0,0 +1,32 @@
+# 表示されなくなったサイト
+
+昔は表示され操作もできたいくつかのサイトがweb browser pluginで操作も表示もされない現象が発生しています。ずっと待機中になります。
+
+- https://web.syu.is/profile/ai.syu.is
+- https://eyes.nasa.gov/apps/solar-system
+
+一つは自分が管理しているサイトですが、cloudflareを使用しています。おそらく、cloudflareのセキュリティが動作しているのだと思います。web browserのbrowser versionが低いことも要因の一つかもしれません。
+
+```json
+{
+  "time": "2024-10-20T08:00:00.00Z",
+  "id": "1",
+  "remote_ip": "ipv6",
+  "host": "web.syu.is",
+  "method": "GET",
+  "uri": "/",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) ++UE5+Release-5.4-CL Chrome/90.0.4430.212 Safari/537.36",
+  "status": 200,
+  "error": "",
+  "latency": 0,
+  "latency_human": "1.0ms",
+  "bytes_in": 0,
+  "bytes_out": 0
+}
+```
+
+## 今のところうまく表示されているサイト
+
+なぜか`solar-system`と同じものを使用している`asteroids`は表示されます。そのうち制限されるかもしれませんが。それともサイトの作りでしょうか。
+
+- https://eyes.nasa.gov/apps/asteroids/#/planets/earth

book/issue/gasp/README.md

@@ -0,0 +1 @@
+https://forums.unrealengine.com/search?q=gasp

book/issue/gasp/gasp_01.md

@@ -0,0 +1,18 @@
+## GameplayCameraをdisableにする
+
+GASPで使用されるGameplayCamera(plugin)が壊れているため、これを削除する人が多いです。
+
+削除方法は簡単で`/Content/Blueprints/CBP_SandboxCharacter`の`GameplayCamera`というcomponentを削除し、err箇所のnodeを修正すると完了です。
+
+仕組みを解説すると、このcomponentでCameraに`/Blueprints/Cameras/CameraAsset_SandboxCharacter`を指定しています。そして、`SetupCamera`という関数でenable(有効)にします。関数では`$project/Config/DefaultEngine.ini`にある`DDCVar.NewGameplayCameraSystem.Enable`の値がtrueなら使用されます。
+
+```sh
+[/Script/Engine.DataDrivenConsoleVariableSettings]
++CVarsArray=(Type=CVarBool,Name="DDCVar.NewGameplayCameraSystem.Enable",ToolTip="",DefaultValueFloat=0.000000,DefaultValueInt=0,DefaultValueBool=True)
+```
+
+`DDCVar.NewGameplayCameraSystem.Enable`をfalseにするか、あるいは`branch`の処理を削除し、false後の処理(Set View Target with Blend)につなげるかで機能をdisable(無効)にすることができます。
+
+私はなるべく最新機能を使用したいと思っています。ですが、先に述べたように色々と壊れているため、問題がたくさん発生します。原因が`GameplayCamera`にあることを突き止めるのも苦労しますから、disableにしておくのが正解かもしれません。
+
+

book/issue/gasp/gasp_02.md

@@ -0,0 +1,9 @@
+## cameraが急接近する
+
+よじ登ったり、柵を超えたりするとき、camera(カメラ)が急接近することがあります。
+
+これは`GameplayCamera`の`CameraRig_CollisionOffset`が原因です。`/Content/Blueprints/CBP_SandboxCharacter`の`SetupCamera`という関数で使われていますので、その部分だけ外しておきましょう。
+
+ただし、床が透けて映ってしまうようになります。
+
+

book/issue/gasp/gasp_03.md

@@ -0,0 +1,25 @@
+## characterのcomponentが初期化される
+
+buildすると動きやカメラがおかしくなっていることに気づくかもしれません。
+
+これはcomponentが初期化されていることが原因です。
+
+通常、`/Content/Blueprints/CBP_SandboxCharacter`にあるcomponentは`/Content/Blueprints/RetargetedCharacters/CBP_SandboxCharacter_${name}`と共通しますが、これが初期化されているのです。例えば、100という値が入れられていたとして、初期設定が1なら、1に戻されるということです。
+
+原因はわかりませんが、これが起こるとcameraがおかしくなったり、`IA_Sprint`でダッシュできなくなったりすることがあります。
+
+これを解決する方法は、`/Content/Blueprints/CBP_SandboxCharacter`の`Event BeginPlay`でcomponentの初期設定を追加することです。
+
+<iframe src="https://blueprintue.com/render/0lt9y0_u/1" scrolling="no" allowfullscreen style="width:100%;height:400px"></iframe>
+
+この方法でも解決しない場合があります。mapを開いて一度再生したあとにbuildするとうまくいくことがあります。
+
+また、それ以外の方法として、初期設定を全部`CBP_SandboxCharacter_${name}`の`Construction Script`ほうに書き出すことが考えられます。
+
+<iframe src="https://blueprintue.com/render/iikbmf9a/1" scrolling="no" allowfullscreen style="width:100%;height:400px"></iframe>
+
+1. mapを開いて、問題の動作を実行したあとにbuildする
+2. `CBP_SandboxCharacter`の`Event BeginPlay`に書いてみる
+3. `CBP_SandboxCharacter_${name}`の`Construction Script`に書いてみる
+
+

book/issue/gasp/gasp_04.md

@@ -0,0 +1,7 @@
+## IA_Sprintのダッシュができなくなる
+
+ダッシュは`/Content/Blueprints/RetargetedCharacters/CBP_SandboxCharacter_${name}`の`Event BeginPlay`を削除することで解消しました。
+
+nodeをつなげていなくてもevent自体を削除しなければなりません。
+
+

book/issue/gasp/gasp_05.md

@@ -0,0 +1,8 @@
+## traversableが機能しなくなる
+
+突然、traversable(トラバーサブル)、つまり、よじ登ったりする機能が使えなくなることがあります。
+
+いくつか原因が考えられますが、project設定の`collision > trace channel : Traversable`に問題があるのかもしれません。
+
+collision trace channelに問題が発生するときはけっこう大変です。色々とbugがあり、一度削除して同じ名前で作り直せば動作することもありますが、余計に壊れることもあります。例えば、削除したときにBPのnodeに他のtrace channelが自動で入ってしまうことも要因になります。
+

book/issue/gasp/gasp_06.md

@@ -0,0 +1,8 @@
+# キャラがカメラ視点で勝手に動く
+
+これは、`Update Rotation Pre CMC`にある`Use Controller Desired Rotation`, `Orient Rotation To Movement`の処理です。
+
+動かないようにするにはどちらも`ture`にします。
+
+不思議なことにいくら条件をつけ実行しないようにしても、ここの処理は貫通して実行されているようです。よくわかりませんでした。
+

book/issue/ue/README.md

@@ -0,0 +1 @@
+https://forums.unrealengine.com/categories?tag=unreal-engine

book/issue/ue/ue_01.md

@@ -0,0 +1,37 @@
+# error II-E1001
+
+`Epic Games Launcher`に非常によく出るerrorです。
+
+新しいassetをインストールする際に出ます。
+
+時間を待てば解消されることがあります。例えば、ゲームエンジンを読み込める段階で解消されます。
+
+それでも解消されない場合は、以下の方法を試してみてください。
+
+## 概要
+
+エラーコード「II-E1001」は、主にEpic Games LauncherまたはUnreal Engineでのプロジェクト作成やコンテンツダウンロード時に発生する問題です。このエラーの原因と解決策を以下にまとめます。`Epic Games Launcher`を再インストールすることでしか治らないこともあります。
+
+1. キャッシュの破損
+> Epic Games LauncherのVault Cacheに破損したデータが残っている場合、エラーが発生することがあります7。
+2. ダウンロード中のクラッシュ
+> コンテンツのダウンロード中にPCがクラッシュした場合、未完了のデータが原因でエラーが発生することがあります7。
+3. 外部ストレージの使用
+> ライブラリが外部ハードドライブ上にある場合、ランチャーが正しく認識できないことがあります7。
+
+## 解決策
+
+1. Vault Cacheフォルダを確認・削除
+> Epic Games Launcherの「設定」からVault Cacheの場所を確認します。
+> 対象コンテンツのフォルダを削除します（フォルダが空の場合も削除可能）。
+> 他のフォルダを選択して、元のフォルダに戻すと解消されることがあります。
+2. Vault Cacheフォルダの属性変更
+> Vault Cacheフォルダを右クリックし、「読み取り専用」のチェックを外して適用します。
+3. Epic Games Launcherの再起動
+> ランチャーを再起動し、問題が解消されるか確認します。
+> 必要であればPC自体も再起動してください。
+4. 外部ストレージの確認
+> ライブラリが外部ストレージ上にある場合、ランチャー設定で適切なキャッシュフォルダが指定されているか確認します7。
+5. Epic Games Launcherの再インストール
+> キャッシュをクリアした後、Epic Games Launcherを再インストールします。
+> これらの手順で解決しない場合は、Epic Gamesサポート（公式ヘルプページ）に問い合わせることをお勧めします。

book/issue/vrm4u/README.md

@@ -0,0 +1,3 @@
+# vrm4u
+
+https://github.com/ruyo/VRM4U/issues

book/issue/vrm4u/vrm4u_01.md

@@ -0,0 +1,8 @@
+# customで衣装の半分が灰色になる
+
+普段の衣装ではライトの加減で服に変な影がうっすら浮き上がる問題がありました。
+
+これを解消するために`type:custom(MI_PostToon)`を当てましたが、customにすると衣装の半分が灰色になる問題が出ました。
+
+これを解消するためにはcustomの`/custom/SK_${model}`に設定されているmaterialを編集し、`MI_PostToon`から`/Plugins/VRM4UContents/MaterialUtil/UE5/Material/MI_VrmMToonOptUnlitOpaque`に切り替えると解消されました。
+

book/issue/wsp/README.md

@@ -0,0 +1,3 @@
+# worldscape plugin
+
+https://iolacorp-1.gitbook.io/worldscape-plugin

book/issue/wsp/wsp_01.md

@@ -0,0 +1,12 @@
+# 地上のちらつき
+
+こちらを設定すると治りました。
+
+https://iolacorp-1.gitbook.io/worldscape-plugin/unreal-engine-5-setting-fixes
+
+> $project/Config/DefaultEngine.ini
+
+```
+r.VelocityOutputPass=1
+```
+