Pref ファイル
デフォルトのレンダリング設定がスプライトに適さない場合があります。そのようなときは .pref ファイルを作成してカスタマイズしましょう。
スプライト、影、住人掲示板の NPC アバター用小アイコン、冒険者ランキングのアイコンなどの微調整に使用できます。
.pref ファイルを作成するには、.txt ファイルを作成し、ファイル名を id.pref に変更します（拡張子を .txt から .pref に変更し、id にはキャラクターまたはアイテムのスプライト ID を指定します）。メモ帳などのテキストエディタで編集できます。
TIP
.pref ファイルはホットロードされます。つまり、値を変更した後、ゲームを再起動せずにリアルタイムで効果をプレビューできます。
そのため、まず .pref ファイルを作成し、ゲーム内での表示効果を確認しながら値を繰り返しテストできます。
ファイル内容
完全なファイルは以下の通りですが、使用しない行は省略できます。
INI 形式で記述し、値は整数のみ使用可能です。; によるコメントも使用できます。
x = 0
y = 0
z = 0
pivotX = 0
pivotY = 0
shadow = 0
shadowX = 0
shadowY = 0
shadowRX = 0
shadowRY = 0
shadowBX = 0
shadowBY = 0
shadowBRX = 0
shadowBRY = 0
height = 0
heightFix = 0
scaleIcon = -40
scaleTex = 100
liquidMod = 0
liquidModMax = 0
hatY = 0
equipX = 0
equipY = 0
stackX = 0各行の説明は、下記の詳細説明セクションを参照してください。
詳細説明
x,y,z位置オフセットpivotX,pivotYピボットオフセット。住人掲示板のアバターなどの小さいスプライトで使用shadow影データ ID （下記セクション参照）shadowX,shadowY影の位置オフセットshadowRX,shadowRY影の反転shadowBX,shadowBY影の背面shadowBRX,shadowBRY影の背面反転heightタイルの高さ補正値heightFixテキストコンポーネントの高さオフセット（浮遊ウィジェット用）scaleIconアイコンのサイズ倍率scaleTexテクスチャのピクセル密度。デフォルトに対する百分率で指定（下記セクション参照）。0と100はどちらもデフォルトを意味するliquidModタイルの液体レベル補正値（負の値も可）liquidModMaxタイルの液体レベル上限hatY帽子レンダラーの Y 位置オフセットequipX,equipY手持ちアイテムの位置オフセットstackXタイル積み重ねの X 位置オフセット
高解像度スプライト
デフォルトではスプライトは 1 ワールドユニットあたり 100 ピクセルで描画されるため、ピクセル数の多いテクスチャは鮮明になるのではなく単に大きく描画されます。scaleTex はテクスチャの密度をゲームに伝えるための項目で、これにより高解像度のスプライトをゲーム内で全く同じ大きさのまま使用できます。
ルールは次の式ひとつだけです。ワールドサイズを変えないようにします。
ワールドサイズ = キャンバスのピクセル数 / scaleTex * 100| 元の素材 | 高解像度版 | scaleTex | ワールド高さ | 結果 |
|---|---|---|---|---|
| 128x256 | 256x512 | 200 | 2.56 | サイズ同一、鮮明さ 2 倍 |
| 128x256 | 512x1024 | 400 | 2.56 | サイズ同一、鮮明さ 4 倍 |
| 128x128 | 384x384 | 300 | 1.28 | サイズ同一、鮮明さ 3 倍 |
.pref 内のその他の値（y、heightFix、pivotY、shadowX、equipY など）はすべてワールドユニットで表されています。ワールドサイズが変わらない限り、それらはそのまま有効で、調整し直す必要はありません。これが scaleTex の目的です。より鮮明なテクスチャに差し替えても、調整済みの位置設定が無駄になることはありません。
WARNING
scaleTex は実際に拡大したテクスチャと対応させる必要があります。元のテクスチャのまま scaleTex = 200 を設定すると、ワールドサイズが半分になり、スプライトが小さくなるうえに地面から浮いて見えます。スプライトは中心を基準点としているため、縮小すると下端が持ち上がるためです。
scaleTex を設定して浮いてしまう場合、ほぼ必ずテクスチャが拡大されていないことが原因です。
TIP
倍率は整数（200、300、400）を推奨します。テクスチャはニアレストネイバー補間で描画されるため、scaleTex = 80 のような非整数の密度では、あるピクセル行が画面上 1 ピクセル、別の行が 2 ピクセルとなり、輪郭が不均一になります。
なお、タイルとオブジェクトは 1 ワールドユニットあたり 50 ピクセルで描かれており、現状 2 倍に拡大表示されています。これらの素材では scaleTex = 200 により画面上で真の 1:1 ピクセル対応が得られ、リサンプリングが一切ない最も鮮明な結果になります。
影データ ID
| id | name |
|---|---|
| 0 | default |
| 1 | no shadow |
| 17 | pillar |
| 18 | altar |
| 19 | cabinet |
| 20 | bed |
| 21 | counter |
| 22 | gacha |
| 23 | tree |
| 24 | screen |
| 25 | safe |
| 26 | vendor |
| 27 | straw |
| 28 | grave |
| 29 | thin |
| 30 | tree0 |
| 31 | tree1 |
| 32 | tree2 |
| 33 | tree3 |
| 34 | tree4 |
| 35 | tree5 |
| 36 | tree6 |
| 37 | pillar |
| 38 | big table |
| 39 | big table2 |
| 40 | counter2 |
| 41 | door |
| 42 | thin2 |
| 43 | square |
| 44 | boss1 |
| 45 | boss2 |
| 47 | corner |
| 48 | ceil |
| 49 | big |
| 50 | bridge |
| 51 | long |
| 52 | long2 |
サンプル Mod
影の修正
この Mod は .pref ファイルの shadow を使用して影を修正しています。
小アイコン
この Mod は住人掲示板と冒険者ランキングでのキャラクターアイコンの表示を変更します。.pref ファイルの pivotX と pivotY を使用しています。
キャラクターアイコン修正前：
左が住人掲示板、右が冒険者ランキング
.pref ファイルでキャラクターアイコン修正後：
左が住人掲示板、右が冒険者ランキング
この Mod でこのキャラクターに使用されている pref の値：
pivotX=0
pivotY=-37注意点：
.prefのファイル名、スプライトのファイル名、Mod 読み込み用 Excel の id 列は、すべて完全に一致している必要があります。pivotXとpivotYは住人掲示板と冒険者ランキングの両方に同時に影響するため、値をテストする際は両方を考慮してください。.prefファイルはホットロードされるため、ゲームを再起動する必要はなく、リアルタイムで効果をプレビューしながら微調整できます。