改変した3DS_JP.zip内の3DS_JP.xmlを例に解説。
xml宣言
<?xml version="1.0" encoding="Shift_JIS" standalone="no"?> <dat xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="datas.xsd">
DAT定義
<configuration> <datName>任天堂3DS</datName> <imFolder>任天堂 3DS</imFolder> <datVersion>9999</datVersion> <system>任天堂 3DS</system> <screenshotsWidth>268</screenshotsWidth> <screenshotsHeight>240</screenshotsHeight>
情報
<infos> <title visible="false" inNamingOption="true" default="false"/> <location visible="false" inNamingOption="true" default="true"/> <languages visible="false" inNamingOption="true" default="true"/> <romCRC visible="true" inNamingOption="true" default="true"/> <publisher visible="true" inNamingOption="true" default="true"/> <sourceRom visible="true" inNamingOption="true" default="true"/> <comment visible="true" inNamingOption="true" default="true"/> <saveType visible="true" inNamingOption="true" default="false"/> <romSize visible="true" inNamingOption="false" default="false"/> <releaseNumber visible="true" inNamingOption="true" default="false"/> <languageNumber visible="false" inNamingOption="true" default="false"/> <im1CRC visible="false" inNamingOption="false" default="false"/> <im2CRC visible="false" inNamingOption="false" default="false"/> </infos>
拡張子
<canOpen> <extension>.3ds</extension> </canOpen>
更新
<newDat> <datVersionURL> http://www.advanscene.com/offline/version/ADVANsCEne_3DS.txt </datVersionURL> <datURL fileName="ADVANsCEne_3DS.zip"> http://www.advanscene.com/offline/datas/ADVANsCEne_3DS.zip </datURL> <imURL> http://www.advanscene.com/offline/imgs/ADVANsCEne_3DS/ </imURL> </newDat>
検索
<search> <to value="location" default="true" auto="true"/> <to value="romSize" default="true" auto="false"> <find operation="=" value="134217728">1024Mbits</find> <find operation="=" value="268435456">2048Mbits</find> <find operation="=" value="536870912">4096Mbits</find> <find operation="=" value="1073741824">8192Mbits</find> <find operation="=" value="2147483646">16384Mbits</find> <find operation="=" value="2147483647">32768Mbits</find> </to> <to value="languages" default="true" auto="true"/> <to value="saveType" default="false" auto="false"> <find operation="inNoCase" value="TBC">TBC</find> </to> <to value="publisher" default="false" auto="false"/> <to value="sourceRom" default="false" auto="false"/> </search>
タイトル表示
<romTitle>%s - %n %o%m</romTitle> </configuration>
ゲーム情報
<games> <game> <imageNumber>25</imageNumber> <releaseNumber>25</releaseNumber> <title>リッジレーサー3D</title> <saveType>25</saveType> <romSize>1073741824</romSize> <publisher>バンダイナムコエンターテインメント</publisher> <location>7</location> <sourceRom>CONTRAST</sourceRom> <language>256</language> <files> <romCRC extension=".3ds">21923234</romCRC> </files> <im1CRC>E6233100</im1CRC> <im2CRC>4CA754CF</im2CRC> <comment>Ridge.Racer.3D.JPN.3DS-CONTRAST </comment> <duplicateID>5</duplicateID> </game> </games>
画像
<gui> <images width="475" height="242"> <image x="0" y="0" width="268" height="240"/> <image x="273" y="0" width="200" height="240"/> </images> </gui> </dat>
の9項目に分けて解説。
<?xml version="1.0" encoding="Shift_JIS" standalone="no"?> <dat xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="datas.xsd">
xmlファイルのお約束。
特に変更する箇所はなし。
DAT定義
<configuration> <datName>任天堂3DS</datName> <imFolder>任天堂 3DS</imFolder> <datVersion>9999</datVersion> <system>任天堂 3DS</system> <screenshotsWidth>268</screenshotsWidth> <screenshotsHeight>240</screenshotsHeight>
- datName:DATの名称。
- imFolder:画像ファイルのフォルダ名(offlinelist/img/内に作成)
- datVersion:このDATファイルのバージョン。詳しくは&更新で。
- system:DATファイルを対象とする機種の名称
- screenshotsWidth&screenshotsHeight
取り扱う画像ファイルの大きさ(Width=横、Height=縦のピクセル数)の指定...らしいけど、どうでもいい。
画像の設定は画像で。
<infos> <title visible="&color(Red){false};" inNamingOption="&color(Red){true};" default="&color(Red){false};"/> <location visible="false" inNamingOption="true" default="true"/> <languages visible="false" inNamingOption="true" default="true"/> <romCRC visible="true" inNamingOption="true" default="true"/> <publisher visible="true" inNamingOption="true" default="true"/> <sourceRom visible="true" inNamingOption="true" default="true"/> <comment visible="true" inNamingOption="true" default="true"/> <saveType visible="true" inNamingOption="true" default="false"/> <romSize visible="true" inNamingOption="false" default="false"/> <releaseNumber visible="true" inNamingOption="true" default="false"/> <languageNumber visible="false" inNamingOption="true" default="false"/> <im1CRC visible="false" inNamingOption="false" default="false"/> <im2CRC visible="false" inNamingOption="false" default="false"/> </infos>
infoタブ内ソフトの情報の表示(true)/非表示(false)の指定。
visible:右側の情報に表示するか否か。
inNamingOption:左側のタイトル部分に表示するか否か。
default:初期設定で有効にするか否か。(visible/inNamingOptionのがtrueでないと無意味)
- title:ソフト(rom)の名称
- location:国(地域)
- languages:言語
- romCRC:romのCRC32
- publisher:販売元
- sourceRom:romの公開元
- comment:コメント
- saveType:セーブの種類、方法
- romSize:romの容量(ただし値は2^10の数値で表示、昨今は10^3が使われていることもあり)
- releaseNumber:romのNo.(公開順?)
- languageNumber:言語の数
- im1CRC:画像aのCRC32
- im2CRC:画像bのCRC32
<canOpen> <extension>.3ds</extension> </canOpen>
romの拡張子の指定。
<newDat> <datVersionURL> http://www.advanscene.com/offline/version/ADVANsCEne_3DS.txt </datVersionURL> <datURL fileName="ADVANsCEne_3DS.zip"> http://www.advanscene.com/offline/datas/ADVANsCEne_3DS.zip </datURL> <imURL> http://www.advanscene.com/offline/imgs/ADVANsCEne_3DS/ </imURL> </newDat>
- datVersionURL:更新先のDATファイルのバージョンが書かれたtxtファイルの場所。
txtファイルにはただVer.の数値だけが書かれていれば良い。(小数点付数字はNG) アップデートの時に、この数値とdatVersionの数値を比べtxtの方が大きければDATファイルを更新する。
個人的にはVer.No.ではなく、作成日にすると管理が楽。(例:211128 ←21年11月28日) - datURL fileName="ADVANsCEne_3DS.zip":アップデートでダウンロードするDATファイルの名前。&その場所。
- imURL:画像ファイルの場所、画像ファイルはここからダウンロードする。
このアドレスの先に「1-500」などの500毎のフォルダがありその先に1a.png、1b.pngといった画像ファイルを作成者は用意する。
各ファイルのURLは「https」は暗号化されているためかNG。
ホームページのアドレスが「https」ならば「http」に変える事。
検索
<search> <to value="location" default="true" auto="true"/> <to value="romSize" default="true" auto="false"> <find operation="=" value="134217728">1024Mbits</find> <find operation="=" value="268435456">2048Mbits</find> <find operation="=" value="536870912">4096Mbits</find> <find operation="=" value="1073741824">8192Mbits</find> <find operation="=" value="2147483646">16384Mbits</find> <find operation="=" value="2147483647">32768Mbits</find> </to> <to value="languages" default="true" auto="true"/> <to value="saveType" default="false" auto="false"> <find operation="inNoCase" value="TBC">TBC</find> </to> <to value="publisher" default="false" auto="false"/> <to value="sourceRom" default="false" auto="false"/> </search>
検索用の各項目のプルダウンメニューを表示するか否か。
<romTitle>%s - %n %o%m</romTitle> </configuration>
<games> <game> <imageNumber>25</imageNumber> <releaseNumber>25</releaseNumber> <title>リッジレーサー3D</title> <saveType>25</saveType> <romSize>1073741824</romSize> <publisher>バンダイナムコエンターテインメント</publisher> <location>7</location> <sourceRom>CONTRAST</sourceRom> <language>256</language> <files> <romCRC extension=".3ds">21923234</romCRC> </files> <im1CRC>E6233100</im1CRC> <im2CRC>4CA754CF</im2CRC> <comment>Ridge.Racer.3D.JPN.3DS-CONTRAST </comment> <duplicateID>5</duplicateID> </game> </games>
ソフト(rom)の情報を記載する。
- imageNumber:対応する画像の番号。この場合25なので25a.png、25b.pngがあれば表示。
- releaseNumber:romのNo.(公開順?)、数字以外はNG。
- title:ソフト(rom)の名称。
使えない文字があるので注意!「&」など。詳細 - saveType:セーブの種類、方法。
英字も使えるので、大抵ここにrom No.を指定することも。
X番台=デモ、配布、機種専用rom(new3DS専用)
e番台=eshop専用 - romSize:romの容量
- publisher:販売元
- location:国(地域)
- sourceRom:romの公開元
- language:言語の数
- romCRC extension=".3ds":romの拡張子&CRC32の値。
どれかと被ってもNG、ケタ数が多くてもNG。
CRCの値は解凍されたromの値。圧縮された状態では無い。 - im1CRC:画像aのCRC32の値。
- im2CRC:画像bのCRC32の値。
- comment:コメント。
- duplicateID:Rev違いなど同名タイトルにつける番号。
<gui> <images width="475" height="242"> <image x="0" y="0" width="268" height="240"/> <image x="273" y="0" width="200" height="240"/> </images> </gui> </dat>
- images width="475" height="242":画像の表示領域の確保。
上記例だと数値は
475=268(画像aの横幅)+5(画像aとbの間の隙間)+200(bの横幅)+2(bの右側の隙間)
242=240(画像ab縦幅)+2(画像下の隙間) - image x="0" y="0" width="268" height="240:画像aの配置場所の指定&確保。
x="0" y="0"で配置場所の左上頂点座標を指定。
(xの値UP:値のピクセル数分右に、yの値UP:値のピクセル数分下に)
width="268" height="240"で画像aの表示する枠を指定。(画像aの大きさ)
(指定した枠以上の画像も扱えるが、その際は指定した大きさの分しか表示しない) - image x="273" y="0" width="200" height="240":画像bの配置場所の指定&確保。(詳細は画像aと同じ)
273=268(画像aの横幅)+5(aとbの間の隙間)