最終更新日時: 2010年04月18日 (日) 23時15分40秒

コントリビューション



コントリビューションの概要


コントリビューションとは


FreeTrain EX Avでは、プラグインからゲームに新しい機能/建物/列車などを追加することができます。
この時、追加される「何か」をコントリビューションといいます。

コントリビューションの書式


すべてのコントリビューションに共通する書式です。
<contribution type="コントリビューションの種類" id="コントリビューションID">
  コントリビューションの内容――コントリビューションによって異なる
</contribution>
コントリビューションの種類とIDについては後述しています。

コントリビューションは、プラグイン定義の内部で記述します。
<plug-in>
  <title>タイトル</title>
  <author>制作者</author>
  <homepage>http://author/site/</homepage>
  <contribution type="contributiontype" id="contribution ID">
    ...
  </contribution>
  <contribution type="contributiontype" id="othercontribution ID">
    ...
  </contribution>
    ...
</plug-in>

コントリビューションの種類


コントリビューションの種類は、定義するコントリビューションが、どの種類であるかを指定するものです。
コントリビューションの種類ごとに1つの名前が定義されています。
どのような種類のコントリビューションがあるかは、コントリビューション一覧を参照してください。

コントリビューションID


それぞれのコントリビューションを一意に識別するために、他のコントリビューションと絶対に重複しないID値を設定します。

IDは、他と重複しなければどのような文字列でもよいですが、人間の目で見て理解しやすい、可読性のある文字列がFreeTrain EX Avでは推奨されています。
重複しないことが保証されているとはいえ、GUIDをそのまま使用することは推奨されません。

詳細についてはプラグイン作成のマナーをご覧下さい。

コントリビューションの追加


ContribContribを使って、プラグインから新しいコントリビューションの種類を定義することもできます。