ゲームの規約
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つのフック:
window.__giOnChange = (patch) => {...}— 毎フレーム再読み込みされない派生状態のためのフックです。たとえば数量が変わったときに敵プールを再構築する場合などに使います。window.__giOnAction = (key) => {...}— リスタートや盤面クリアなど、パネルのボタン用のフックです。
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/ をシェルと一緒に持ち出します。