Skip to content

Releases

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 13 Oct 19:59

Rimworld version 1.7.4977 rev926バージョンでのテストビルド
 →UnityStubsにてUnityEngine.VideoModuleが最新のもので取り込まれていた→なおWindows標準の機能のみで、mp4のみをサポート
 →Jsonは以前はUnityのものだったが1.7よりnugetのものを利用可能に(Newtonsoft.Json.dllを使用してください)

簡単な動作確認のみ。ただ、基本的なライフサイクルは変わってないため動作するはず。
一応いつか私が居なくなっても誰かがビルドできるように、参照だけ切り替えればできるようにはしておきます。

必要な参照はご自身の環境のUnityStubsとAssembly-CSharpです。(どっちもRimworldのフォルダにあるはずです)

必要な開発環境:
.NET 10 SDK がインストールされていること(Visual Studio または dotnet build コマンド)

その他のライブラリ:
Newtonsoft.Json (13.0.3) は NuGet から自動復元(ダウンロード)されるため、外部ファイルの配置は不要です。

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 24 Sep 14:32

<バグ修正・安全性向上>
・ゲームのカクつき等で動画再生が途中で停止し、次の動画へ進まなくなる問題を修正
敵の襲撃や処理落ち等でUnity VideoPlayer内部の再生同期が止まった場合、フレーム停止(デフォルト: 10描画フレームかつ0.5秒以上)を検知して自動的にステップモード(コマ送り)へ移行し、強制的にデコードを再開させる自動復旧機能を追加しました。
カクつきが解消した後は、既存のFPS監視ロジックによって20フレーム安定した時点で自動的に通常再生(PlayMode)へ復帰します。
また、ストール判定の閾値(判定フレーム数: video_stall_trigger_count / 判定秒数: video_stall_trigger_seconds)を Setting.json でカスタマイズ可能にしました。

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 12 Sep 15:34

<バグ修正>
・セーブデータのロード時やメインメニュー遷移時にゲーム(Unity)がクラッシュする問題を修正 (Patch_GameLifecycle)
RimWorldのセーブロード処理は非同期スレッドで実行されるため、Unityネイティブの動画停止処理(VideoPlayer.Stop)が呼ばれるとアクセス違反(0xC0000005)で強制終了していました。
ロード画面に入る直前のメインスレッド上で安全にリセット処理(ResetAll)を実行するようにフックを追加し、ロード中に前の動画や音声が再生され続ける問題も併せて解消しました。
また、VideoPlayerManager / CachedVideoPlayer の Stop() にも非同期呼び出し時のメインスレッド委託ガードを追加しました。
・非同期スレッド(ポートレート計算ワーカースレッド)における乱数生成の不具合を修正
RepeatRules(RandValue / LastContextAndRand)およびコンテキストの重み抽選(ConditionDrivenPortrait)で使用されていた UnityEngine.Random.Range を ThreadLocal<System.Random> に変更しました。
UnityEngine.Random はスレッドセーフではないため、非同期スレッドから実行された場合に発生し得た乱数値の破損・偏り・不具合を防止しました。
・PortraitCacheEx.Settings の null 安全性を向上しました。

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 06 Sep 01:20

<バグ修正>
save→load時にunityがクラッシュする問題を修正

<機能追加>
・低FPS時にmp4の再生方法をstep forwardにします。以前だと低FPS時にはカクつきが起きていた。音声なし+step fowardにて低FPSに合わせたRendere Textureの更新にてそれを防止する。
・低FPSから復帰した際はその途中からmp4を再生します。音声が遅れたりしますが、現段階ではどうしようもないです。見た目を優先します。
Setting.jsonにvideo_step_mode_trigger_count、video_play_mode_trigger_count、video_fps_history_size、double_step_forwardを追加していますが、こちらは特別記入しなくていいです。video_step_mode_fps_thresholdこちらは現在12FPS以下だとstepモードに移行(step foward)します。必要な方はvideo_step_mode_fps_threshold = 10.0みたいな感じでfloatで設定してください。

もし気になる場合は
・video_step_mode_trigger_count→step forwardに移行するカウント数です
video_fps_history_sizeと合わせて修正してください。
・video_play_mode_trigger_count→playに移行するカウント数です。mp4再生みたいな感じの状態。
・video_fps_history_size→低FPS時と高FPS時の記録数です。スパイクする可能性があるため複数回記録するためのカウントです。
・double_step_forward→基本mp4は24FPS~30FPSで作成されている想定です。そのため低FPS時には10FPSとなると期待結果よりスローモーションとなるのでstep数を2倍進める設定です。

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 22 Aug 14:37

<バグ修正>
・RepeatEventのmin以下で同じコンテキストが来た時operationの評価がされていなかったので修正
・RepeatEventのlast_context_nameの一つ前のコンテキストが非同期処理と同期処理の間でnullのタイミングがありエラーにはならないが、last_context_nameの動作に支障をきたしていたので修正。
・setting.jsonの読み込みタイミングとpreset類のjsonの読み込みタイミングが逆転しており、videoのキャッシュ設定が反映されていなかったので修正

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 21 Aug 10:58

ver 1.3.7
<機能追加>
・mp4動画のキャッシュをするようにしました。Setting.jsonに各プリセットごとにキャッシュする量を定義し、その分だけVRAMに残します。ただしデコードは実際に再生するタイミングでのみです。
・RepeatEventのパチンコ機能の機能見直し、max_countを以前からoperation部分でいじれなかったため演出の分岐ができなかった。
・RepeatEventにlastContextNameを追加しました。これで以前何が選ばれたら次これを表示と言った風にできるようになりました。特定の演出中はほかのコンテキストに移行しないようにしたい場合はoperation部分でoverride_max_count,reset_max_count,override_min_countを使ってください。
・RepeatEventのoperation部分にinterrupt_contextを定義可能にしました。min~max条件以外で抜けるための定義です。
・RepeatEvent機能にlast_context_and_randを追加

<バグ修正>
operationに不正なoverride_contextを定義した際に、その内容でポートレートを切り替えれないのにoverride_min_countなどを設定してしまっていたので修正

<改善>
・MP4画像のRendereTextureが256×256だったので512×512に変更
ーーーーーーーーーーーー
ver 1.3.7
New Features

MP4 Video Caching: MP4 videos are now cached. The cache amount per preset is defined in Setting.json and retained in VRAM. Note that decoding occurs only at the exact moment of playback.

RepeatEvent Pachinko Feature Overhaul: Revised the functionality, as max_count could not previously be modified in the operation section, which prevented branching director scripts/effects.

lastContextName added to RepeatEvent: You can now trigger specific content based on prior selections (e.g., "if X was selected last time, display Y next"). To prevent transitioning to other contexts during a specific effect, use override_max_count, reset_max_count, and override_min_count in the operation section.

interrupt_context Support in RepeatEvent Operations: interrupt_context can now be defined within the operation section of RepeatEvent, allowing exits based on conditions other than min–max.

last_context_and_rand added to RepeatEvent

Bug Fixes

Fixed an issue where defining an invalid override_context in operation still applied settings like override_min_count, even though the portrait could not be switched.

Improvements

Increased the RenderTexture resolution for MP4 images from 256×256 to 512×512.

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 24 Jul 12:35

ver 1.3.6
<機能追加>
MP4動画のポートレートをサポートしました。
従来のアニメーション表示は複数のDDSテクスチャを順番に切り替える方式で、フレーム数が増えるほどRAM・VRAMの使用量が比例して増加していました。
MP4ではUnityのVideoPlayerを介してフレームを逐次デコードしRenderTextureに描画するため、フレーム数に関わらずVRAMの使用量は固定(RenderTexture1枚分)に抑えられます。その代わりデコード処理にCPUを使用します。

設定方法は「使い方.txt」を見てください。

Repeat機能の追加
主にパチンコのように確率分岐や、直前に選択されたもの次第で次これを表示してみたいなことができるように

設定方法は「Repeat機能.txt」を見てください。
----------------
Ver 1.3.6

Added support for MP4 video portraits.
The traditional animation display method cycles through multiple DDS textures in sequence, meaning RAM and VRAM usage increased proportionally with the number of frames. With MP4, frames are decoded sequentially via Unity's VideoPlayer and drawn to a RenderTexture, so VRAM usage stays fixed (equivalent to a single RenderTexture) regardless of the number of frames. In exchange, decoding uses CPU resources.
See "使い方.txt" (How to Use.txt) for setup instructions.

Added the Repeat feature.
This allows things like probability-based branching (similar to pachinko machines) or displaying a specific portrait next based on what was selected immediately before.
See "Repeat機能.txt" (Repeat Feature.txt) for setup instructions.

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 21 Jun 08:50

<パフォーマンス改善>
フィルタリング、優先度計算を別スレッドで行うようにしました。28項目の時1フレーム内に収まらない場合があった+Rimworldのメインスレッドはそうでもなくても詰まる場合があるので別スレッドで計算するように修正

<バグ修正>
プリセットの再読み込み時に古い画像が残りメモリリークするので修正

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 22 Feb 04:23

ver 1.3.3
【仕様変更】
①今までJsonのGroupに書いてなくて、Priority_Weightにキーを指定していれば
その画像にポートレートを切り替えていましたがこのVersionからGroupに書かれたキーに対してのみになります。
例)
省略
"group": {
"死亡した": [
".*が死んだ"
]
},
"priority_weights": {
"CombatContext": {
"category": 0,
"weight": 100
},
"死亡した": {
"category": 0,
"weight": 20
},
"喪失": {
"category": 0,
"weight": 20
}
省略
この時ポーンが心情で「~が死んだ」とあった時「死亡した」は20%でポートレート切り替えが起きますが
「喪失」や「CombatContext」はgroup側に定義がないため選ばれません。そのため以下のようにする必要があります。
"group": {
"死亡した": [
".*が死んだ"
],
"喪失": [
"喪失"
],
"CombatContext":{["CombatContext"]}
}
上記より、priority weightとrefsの箇所で正規表現のサポートを辞め、groupでのみ正規表現をサポートするように変更しました。

【パフォーマンス改善】
・ワイルドカード(.*)パターンを専用処理に分離し、マッチング処理を高速化
・テクスチャ読み込み時、エラーが発生した場合メモリ解放処理を追加

【機能追加】
エイリアスの追加を行いました。これは"@"+groupのキー名で定義することにより、そのキー名がパターン一致した場合定義箇所も成立したとみなします。
使いどころは、世間話が成立したら世間話Aのポートレートと世間話Bのポートレートのどちらかに切り替えたいという場合に使用します。
今まではgroupの値箇所の重複が認められなかったので世間話のポートレートは指定されたものにしか切り替えられませんでしたが、複数用意していずれかが選択されるようになります。

"group": {
  "死亡した": [
    ".*が死んだ"
  ],
  "死亡した2":[
   "@死亡した" ←ここがエイリアス指定("@"+groupのキー名で指定してください)
  ]

RW CustomPortraits Ex

Choose a tag to compare

@ccccd333 ccccd333 released this 10 Feb 17:08

ver 1.3.2
【パフォーマンス改善】
ポートレート切替機能を利用しているポーンに対してだけ、相互インタラクトを記録するように修正。

【ログ】
デバッグログを一部非表示にしました。
対象は相互インタラクトの表示です。
もし、ONにしたい場合は
Option→Modオプション→Really Custom Portraits→Files debugをONにしてください(1.5はないです。引き続き表示し続けます)


ver 1.3.2

[Performance Improvement]
Modified so that mutual interactions are recorded only for pawns that use the portrait switching feature.

[Log]
Some debug logs have been hidden.
This applies to logs related to mutual interaction display.

If you want to enable them, go to:
Options → Mod Options → Really Custom Portraits → Enable “Files debug”

(This option is not available in 1.5; logs will continue to be shown there.)