ゲームデータの作り方

このページでは、自力でゲームデータを作る方法を説明します。

はじめに

GameRandomizerのゲームデータは XML (extensible markup language) ファイルで構成されます。 XMLデータはテキストなので、ファイルはテキストエディターを使えば編集できます。

XMLファイルはゲーム毎に、複数個のファイル ― '__game.xml' (先頭は '_' 2つ) および1個以上の拡張セットファイル ― を用意する必要があります。

XMLファイルはすべてUTF-8で記述してなくてはなりません。

'__game.xml' ファイル

'__game.xml' では、ゲームの基本的な情報を定義します。以下は、'__game.xml' の記述例です。

<?xml version="1.0" encoding="UTF-8"?>
<game id="dominion"
      revision="1" format_version="1" language="ja" country="">
  <game_title>ドミニオン</game_title>
  <selection_size>10</selection_size>
</game>

行の先頭の空白文字は、省略可能です。 2行目は次のように書くこともできます。

<game id="dominion"
revision="1" format_version="1" language="en" country="">

空白文字が許されている箇所では、改行文字を挿入することもできます。

<game id="dominion"
      revision="1"
      format_version="1"
      language="en"
      country="">

'__game.xml' ファイルの1行目は、XML宣言でなくてはなりません。以下の行をそのまま書いて下さい。

<?xml version="1.0" encoding="UTF-8"?>

ファイルの残り部分は、<game>...</game> ブロックになっています。開始タグ <game> はいくつかの属性 (アトリビュート) を持っています。

<game id="dominion"
      revision="1" format_version="1" language="en" country="">

以下に、属性を簡単なまとめを載せます。

属性	説明
id	ゲームのID
revision	XMLの改版番号
format_version	XMLファイルの形式バージョン
language	言語コード
country	国コード

'id' 属性の値は、すべてのゲームで固有のものでなければなりません。

'revision' 属性は省略しても構いません。 GameRandomizerはこの属性を無視しますが、ゲームデータを管理するために、この属性には適切な値を入れておくべきです。始めは '1' とし、更新する度に一つずつ上げていって下さい。

'language' と 'country' 属性は、ゲームデータが指定した言語、指定した国向けに記述されたものであることを表します。 GameRandomizerは、Android deviceの言語・国の設定に適合したゲームデータだけを読み込みます。 (「設定」→「言語と入力」で、言語・国の設定を変更することができます。)

'language' の値は、ISO 639-1 言語コードの2文字形式を小文字で記述したものでなければなりません。この例で使用している言語コード 'ja' は日本語を意味します。言語コードの一覧は、次の場所で参照できます。

http://www.loc.gov/standards/iso639-2/php/code_list.php

'country' の値は、ISO 3166-1 言語/地域コードを大文字で表したものでなければなりません。国/地域コードの一覧は、以下の場所で参照できます。

http://www.iso.org/iso/iso-3166-1_decoding_table

'language' と異なり、'country' は空 ("") でも構いません。多くのケースで、'country' にセットする値で最も適しているのは、空です。もし、中国語 (zh) のゲームデータを作るなら、'country' に 'CN' (中国 = 簡体中文) もしくは 'TW' (台湾 = 繁体中文) をセットして下さい。

ゲームの基本情報は、<game>...</game> ブロックの中に記述します。

<game_title>Dominion</game_title>
<selection_size>10</selection_size>

<game_title>...</game_title> には、ゲームのタイトルを記します。

<selection_size>...</selection_size> には、GameRandomizerが何種類のカードを無作為に選ぶのかを記述して下さい。値は0より大きな整数でなければなりません。

gamerandomizer Fork

ゲームデータの作り方

はじめに

'__game.xml' ファイル

gamerandomizer
Fork