ゲームの規約

Gamenticのゲームとは、ふつうの自己完結型HTML5ゲームに、いくつかのマーカーコメントを加えたものです。これに従うと、ゲームはライブのInspector、サーバーから注入される画像・音声、エクスポートやRemixに対応するようになります。従わなくてもゲームとしては動作します — この規約はあくまで追加的なものです。

ⓘ

あなたのAIは、get_conventionを使ってサーバーからこの正式版を読み込みます。これはどんなゲームを書く前にも必須です。このページは人間向けの要約であり、AIが作った内容を確認するときや、自分の手でゲームを書くときに役立ちます。

マーカーコメント

5つのグローバル変数が、プラットフォームが参照・変更できるすべてを保持します。それぞれは game.html の中で一度だけ宣言され、代入のたびに末尾には正確なマーカーコメントを付けます。サーバーはこれらのマーカーをテキストとして検索し、生成した画像・音声・モデルを注入します。Inspectorは GAME_CONFIG を見つけて調整パネルを構築します。

グローバル変数マーカー内容
window.GAME_CONFIG// __GI_CONFIG__調整可能な数値・色・トグル・レベル配置のすべて
window.GAME_ASSETS// __GI_ASSETS__生成された画像(名前ごと)
window.GAME_AUDIO// __GI_AUDIO__生成された音楽・ボイス・効果音
window.GAME_MODELS// __GI_MODELS__共有3Dライブラリからインポートした3Dモデル
window.GAME_DATA// __GI_DATA__コードに触れずにAIが編集できる内容 — セリフ、レベル、アイテム表

1. 設定オブジェクトはひとつ

調整可能なものはすべて単一のグローバル変数にまとめます。右辺は 正しいJSONでなければなりません — キーはダブルクォートで囲み、末尾カンマなし、関数・コメント・式は使えません。

window.GAME_CONFIG = {
  "gravity": 0.6,
  "playerSpeed": 4.5,
  "enemyColor": "#ff4757",
  "hardMode": false,
  "level": [[1,1,0],[0,1,0],[0,1,1]]
}; // __GI_CONFIG__
⚠

マーカー行に防御的なフォールバックを書いてはいけません。これがもっとも多い間違いです。

window.GAME_ASSETS = {};                          // __GI_ASSETS__   correct
window.GAME_ASSETS = window.GAME_ASSETS || {};    // __GI_ASSETS__   breaks injection

||、??、三項演算子、Object.assign(...) を使うと、右辺はJSONではなくなります。そのためサーバーはそのブロックを書き換えられなくなり — 生成された画像はいつまでも届きません。エラーは一切出ません。そもそもこのガードは不要です — これらのグローバル変数はここで、一度だけ定義されているからです。

各マーカーはファイル全体で一度しか出現できません。また、ゲームループは毎フレーム window.GAME_CONFIG を直接読み込む必要があります。起動時に値をローカル変数へコピーしてしまうと、パネルでの変更は次の再読み込みまで反映されません。

2. ハーネス

この5行によって、Inspectorは実行中のゲームに変更を送り込めます。そのままコピーしてください。

window.__GI_SET = function (patch) {
  Object.assign(window.GAME_CONFIG, patch);
  if (typeof window.__giOnChange === 'function') window.__giOnChange(patch);
};
console.log('__GI__' + JSON.stringify({ type: 'ready', config: window.GAME_CONFIG }));

任意で使える2つのフック:

3. スキーマ

スキーマはパネルの構成を記述します。create_game に渡されるものであり、ゲームのHTMLに埋め込まれることは決してありません — だからこそ、Inspectorでゲームを編集してもスキーマが壊れることはありません。

{
  "groups": [
    { "label": "Feel", "fields": [
      { "key": "gravity", "type": "float", "min": 0.1, "max": 2, "step": 0.05, "label": "Gravity" }
    ]},
    { "label": "Controls", "fields": [
      { "key": "restart", "type": "action", "label": "Restart" }
    ]}
  ]
}
型コントロール必要な項目
int / floatスライダーmin、max、step
boolトグル—
enumドロップダウンoptions
colorカラーピッカー値は #rrggbb
stringテキスト欄—
grid2dグリッドエディターrows、cols、palette(値は数値の2次元配列)
actionボタン__giOnAction(key) を発火

action を除くすべてのフィールドには、GAME_CONFIG 側に対応するデフォルト値が必要です。グループは意味のある単位にしてください — 手触り(Feel)、難易度(Difficulty)、見た目(Appearance)、操作(Controls)のように。ひとまとめに詰め込むのは避けます。難易度の数値が公開されていないゲームは、プレイヤー自身が調整できません — それこそがこの仕組みの一番の目的です。

4. 自己完結したパッケージ

他のドメインから何かを読み込むことは一切できません — CDNスクリプト、外部フォント、外部画像、インターネットへの fetch()、どれも不可です。グラフィックはcanvasに描画し、音はWebAudioで合成するか、生成された音声として注入します。これは単なる社内のスタイルではありません — これらのゲームが動くサンドボックスは、外部リソースをそもそもブロックしています。

「自己完結」が指すのは単一ファイルではなく、パッケージ全体です。ゲームは1つのフォルダーです。

game.html          the shell: markers, boot, <script src="src/..."> in load order
src/**.js          your code, split by responsibility
media/**           images and audio (the server puts them here)
⚠

マーカーブロックとハーネスは game.html の中に置いたままにしてください。どちらかを src/ に移してもエラーは出ません — ただ、生成された画像や音声がひっそりと届かなくなるだけです。サーバーはこれらのマーカーを game.html の中だけで探すからです。

game.html は必ず </html> で終わっていなければなりません。途中で切れたアップロードは、書きかけのまま保存されるのではなく拒否されます。エクスポート、Remix、itch.ioやNewgroundsへの公開は、どれも src/ と media/ をシェルと一緒に持ち出します。

次のステップ