ESKEES スクリプト言語 — リファレンス

アルファ版のため、予告なく変わる可能性があります。操作の手順は はじめてガイド、全体の仕組みは ESKEES の仕組み を参照してください。

.eskx（と旧形式の .emg）に、「クリックしたら表情が変わる」「夜になったら服が替わる」といった演出から、テトリスや パタパタ のような小さなゲームまでを記述するための言語です。Lua に似た構文で、ブロックは end で閉じます。

従来の書き方（repeat 3 … end・!=・+= など）と Lua の書き方（repeat … until・~=・for … do など）の両方を解析できます。

1. 字句

コメント

-- 行末までがコメント（Lua と同じ）

--[[ … ]] の複数行コメントはありません。

名前

パーツ名・フレーム名・クリック領域の名前・サウンドの名前はアセット内の名前そのもので、日本語や空白も使えます。

文字列

• "…" か '…' で書きます。エスケープできるのは \" \' \\ だけです。改行は含められません
• [[ … ]] の長い文字列はありません

数値

3 0.5 -2。指数表記（1e3）と 16 進数（0xff）はありません。true / false は 1 / 0 の別名です。

文の区切り

• 改行で区切ります（1 行に 1 文）。空行はいくつでも置けます。インデントは自由です
• 文の区切りとしての ; はありません（テーブル内の区切り {1; 2} にだけ使えます）
• 括弧・テーブル・引数の中では改行できます

予約語

文の先頭に来る語（関数名には使えません）: wait break scene if switch local return function loop while repeat frame cycle move turn size place ui say sound music tween spawn destroy for toggle show hide preset play stop poke reset var save on class end camera stage

文の中で意味を持つ語: then elseif else do in until case each at to by times forever nowait on self ease wait then destroy volume stop show hide click pairs ipairs and or not nil true false count touching in scene from save follow shake power off

予約済みの名前（同じ名前の変数を作っても、こちらが優先されます）: screen camera world

2. スクリプトの構成

スクリプトの最上位に書けるのは次の 5 つだけです（それ以外を書くと「var か save か on か function か class が必要です」というエラーになります）。

var score = 0 to 999999 save          -- 画面に表示でき、保存もできる数値の変数（§5.1）
save 記録 = { best = 0 }              -- セーブデータの構造（§5.2）

function add(a, b)                     -- 関数（§5.3）
  return a + b
end

class 鳥                               -- アクターのクラス（§5.4）
  vy = 0
  function update(dt)
    self.y += self.vy * dt
  end
end

on press 顔                            -- トリガー（§6）
  score = add(score, 1)
end

• 並び順は自由です（シリアライズすると var → save → function → class → on の順になります）
• function は最上位にだけ書けます（トリガーの中には書けません）

3. 値と型

真偽値

比較（== / ~=）

• 型が同じなら値で比較します。型が異なれば数値に変換して比較します（"3" == 3 は真）
• テーブルは同じテーブルかどうかで比較します（内容では比較しません）
• nil == nil は真、nil == 0 も真です（未定義の変数は 0 というルールのため）
• < <= > >= は、両方が文字列なら辞書順、それ以外は数値に変換して比較します

数値への変換

算術演算（+ - * / %）と数値の入力欄では、文字列を数値として解釈します（"3" → 3、解釈できなければ 0）。nil とテーブルは 0 です。

4. 変数とスコープ

名前を参照すると、次の順で探します（最初に見つかったものを使います）。

1. local 変数と関数の引数（現在のブロックと、その外側のブロック。呼び出した関数の中からは見えません）
2. var で宣言した変数（数値のみ）
3. スクリプト内のグローバル変数（var なしで代入したもの。任意の値を持てます）
4. 組み込みの名前（math dt time screen data。§9）
5. どれにも該当しなければ 0

「中断データ」は、Player を閉じても続きから再開するために自動で保存されるデータです（セーブデータとは別のものです）。

self

• 実行中のアクターを指します。spawn の直後・for each の中・on tap クラス の中・クラスのメソッドの中で決まります
• self.名前 で読み書きします（アクターがいない場合、読むと 0、書くと警告を出します）
• self に別名を付けることはできません（local me = self とは書けません）

5. 宣言

5.1 var — 宣言した変数

var 名前 [= 初期値] [to 上限] [save] [from 割り当て元]

• 数値しか持てません。 文字列は数値に変換し、テーブルは拒否します（警告を出します）
• 値が変わると on change 名前 が発火します（スクリプトで変更した場合も、外部から割り当てられた場合も）
• ESKEES の画面で作成した変数（interact.json の variables）と同じものです。両方にある場合は画面で作成したものが優先されます

5.2 save — セーブデータ

save 記録 = { best = 0, stages = {}, options = { se = 1, bgm = 1 } }

• 初期値（テーブル）がデータ構造の宣言を兼ねます。スクリプトからは通常のテーブルとして読み書きします（記録.best = score）
• フレームの終わりに、変更があれば端末に保存します（まとめて 1 回。変更がなければ保存しません）
• 次回起動時は初期値とマージして復元します。保存されていた値のうち、初期値にあるキーで、同じ型のものだけを復元します。追加された項目は初期値、削除された項目は破棄します。配列（初期値が空のテーブルか、1 から連続するテーブル）は丸ごと復元します
• 保存先: Player・showcase・Screen はブラウザ（端末）です（キーはファイル名。エクスポートし直しても残ります）。テストプレイでは保存されません（「最初から」をまたいでは残ります。「セーブデータを表示」「セーブデータを削除して最初から」があります）
• ESKEES では、ロジックのワークスペースの「セーブデータの構造」で、項目・型（数値 / 文字列 / 配列 / テーブル）・初期値を表形式で編集できます
• JSON にできるもの（数値・文字列・テーブル）だけを保存できます。1 つあたり 100 万文字までです。循環参照のテーブルは保存できません（警告を出します）

5.3 function — 関数

function 名前(引数1, 引数2)
  …
  return 値
end

5.4 class — アクターのクラス

class 鳥
  vy = 0                  -- 初期値（生成したときに self.vy に設定される）
  function init()         -- 生成した直後に 1 回
  end
  function update(dt)     -- 毎フレーム、アクターごとに
  end
  function tap()          -- そのアクターがクリックされたとき
  end
  function flap()         -- 独自に名前を付けたメソッド
    self.vy = -300
  end
end

5.5 コンポーネントのロジック

ESKEES のコンポーネント（複数のアセットのレイヤーとテキストを組み合わせたもの）と同じ名前の class を書くと、キャンバスに配置したそのコンポーネントのインスタンスがすべて、再生開始時にアクターになります（ライブラリのコンポーネントの「…」→「ロジックを作成」）。

• 最初のフレームで on start より前に、配置したパーツを非表示にして同じ位置にクラスのアクターを生成し、初期値と init() を適用します
• アクターはクラス（コンポーネント名）と画像（そのインスタンスのパーツ）を別に持ちます。spawn クラス は最初のインスタンスの画像で生成します
• エクスポート時は game.json の adopt に保存します。スクリプトからクラスを削除すると、配置したものは静止した画像に戻ります

6. トリガー

on トリガー [対象]
  文…
end

• 「領域」は interact.json の shapes（ESKEES の「クリック領域」）の ID、旧形式の hit.json の領域の ID、UI のボタンの ID です
• on press / click / down / up / key / keyup の対象に any を使えます
• 同じトリガーのスクリプトが実行中の場合、新しく発火しても破棄します（§12）

7. 文

7.1 制御

7.2 代入

a, b = b, a のような多重代入はありません（local だけで使えます）。

7.3 パーツ（アセットのパーツ）

7.4 アニメーション（タイムライン）

「アニメーション」は actions[] の ID、なければ sprites[] の ID です。既定のクリップは名前で指定できません（自動で再生されているため）。

7.5 サウンド

• 名前は ESKEES のライブラリの「サウンド」の名前です（game.json の sounds）
• 最初のクリック・キー入力までは再生されません（ブラウザの自動再生の制限）。それより前の music は記録しておき、そのときに再生します。効果音は破棄します
• 一時停止中は停止します。Screen（壁紙）では、トレイの「音を鳴らす」がオンのときだけ再生します

7.6 画面のテキスト（UI）

7.7 アクター

tween のオプション（この順で指定できます）:

• 目標値はテーブル（名前 = 数値）で指定します。現在の値から目標値まで変化させます。同じアクターの同じ値に新しい tween が来たら、前の補間は破棄します
• 補間は毎フレーム、スクリプトより先に進みます。中断データには含まれません

アクターの描画に使う値: x y（オフセット）・turn（度）・size（倍率）・alpha（透明度 0..1）・frame（フレーム）。それ以外の名前は自由に使えます（hp など）。

キャラクターの設定（ESKEES でパーツを選んだときの「キャラクター」。game.json の actors）:

• 当たり判定の形（画像の矩形・それより小さい矩形・円）は、touching・self:overlapping・self:overlaps・self:moveBy のすべてで使います
• 操作（8 方向・左右だけ・左右とジャンプ）を設定したクラスは、矢印・WASD・ゲームパッドで動きます（毎フレーム、update の前）。値はアクターの変数にも入るので、スクリプトから変えられます: self.speed（速さ）・self.jump / self.gravity（左右とジャンプのとき）・self.control = 0 で止める。動いた結果は self.vy・self.grounded（着地していれば 1）・self.moving・self.dir（-1 / 1）で読めます。クラスの変数に同じ名前があれば、そちらが優先されます

7.8 シーン

7.9 カメラ

キャンバスは画面（表示範囲）です。ワールド（world.w / world.h）をキャンバスより広くすると、カメラを動かしてワールドの一部を表示できます（横スクロールなど）。ワールドのサイズとカメラの初期位置は、ESKEES の「カメラとワールド」で設定します（.eskx の game.json）。スクリプトからも変更できます。

on start
  world.w = 3000
  spawn 鳥 at 100, 200
  camera.lag = 0.15
  camera follow self
end

on key Space
  camera shake 0.2
end

• ワールドの端で止まります。 表示範囲がワールドの外に出ないように、描画時に位置を補正します（代入した camera.x はそのまま残ります）。表示範囲がワールドより大きい場合（ズームアウト）は中央に配置します
• ワールドのサイズがキャンバスと同じなら、カメラは動けません（既定）。スクリプトだけで使う場合は、先に world.w = … を設定してください
• 揺れは camera.x / camera.y を変更しません（読み取った値が揺れないように）。時刻だけで決まるため、同じ時刻なら同じ揺れになります
• UI（画面に重ねるテキスト）はカメラの影響を受けず、画面に固定されます。クリック判定は、UI は画面座標、画像とアクターはワールド座標に変換してから行います
• パーツも画面に固定できます（ESKEES の「カメラとワールド」の「画面に固定するパーツ」。背景・スコア表示など）。カメラを適用せずに描画し、クリック判定も画面座標で行います
• 追従中のアクターが削除されたら、追従をやめます
• カメラ（位置・倍率・遅れ・追従対象）は中断データに含まれます
• EMG に対応した他のソフトは、カメラに対応していません。 キャンバスの範囲（カメラが (0, 0)・等倍のときの表示）がそのまま表示されます

7.10 ステージ

ステージはタイルのレイヤー（グリッド）とオブジェクトで構成されます（.eskx の game.json の stages）。ESKEES のライブラリの「＋ ステージ」で作成します。タイル 1 つのサイズ（px）とタイル数を持ち、ワールドのサイズはその積になります。

class 鳥
  vy = 0
  function update(dt)
    self.vy += 900 * dt
    local hit = self:moveBy(120 * dt, self.vy * dt)
    if hit.y == 1 then
      self.vy = 0
    end
  end
end

on start
  stage "1-1"
  spawn 鳥 at 100, 0
  camera follow self
end

• タイルはアクターではありません（数が多く、毎フレームスクリプトで処理すると重いため）。描画するのは表示範囲のタイルだけです
• タイルの値から画像への対応は、レイヤーのパレット（ライブラリの「データ」の名前）の「パーツ」で決まります。画像はタイルのサイズに引き伸ばして描画します。パレットのないレイヤーは描画しません（衝突判定のみ）
• タイルに使っているパーツは、ステージを配置すると非表示になります（アセットの位置に元の画像が表示されたままにならないように）
• 描画順は、アセットの画像 → タイル（レイヤーの順） → アクターです
• オブジェクトはクラスのアクターとして生成します（位置は画像の中心）。クラスの初期値 → オブジェクトごとの値 → init() の順に適用します
• 当たり判定の形はタイルの矩形だけです（斜面・半分の高さは未対応）
• 現在のステージ・書き換えたタイル・オブジェクトは、中断データに含まれます

7.11 スコア（ランキング）

score total as タイム lower      -- 合計タイムを「タイム」のボードへ。小さいほど上位
score score as 点                -- 点を「点」のボードへ。大きいほど上位
score score                     -- as を省略すると「score」のボード

• スクリプトは値を出力するだけです。 送信するかどうか・送信先は、実行環境が決めます
  • showcase … ランキングに送信する（ログインしていれば会員、していなければゲスト）
  • Player（スタンドアロン）… 送信する前に確認する（名前・「次回から確認せずに送信」）。常にゲストとして掲載される
  • ESKEES のテストプレイ … ログに表示するだけ（送信しない）
• 出力するのはリザルト画面で 1 回にしてください（ステージごと・毎フレームには出力しない）。サーバーには自己ベストしか残らないため、何度出力してもボードは壊れませんが、そのたびに通信が発生します
• lower（小さいほど上位）は最初に送信されたときにボードごとに決まり、以後は変更できません
• score = 0 / score += 10 は代入です（直後が = += -= なら変数として解析します）。スコアを変数 score に持つスクリプトもそのまま動作します
• 数値でない値・無限大は出力しません
• ランキングの API と、会員とゲストの区別は ESKEES Studio のページ を参照してください

7.12 呼び出し

7.13 その他

8. 式

8.1 書き方

8.2 演算子と優先順位

優先順位（大きいほど先に結合）。同じ優先順位は左から結合します。

9. 組み込み

9.1 名前

9.2 関数

9.3 使えないもの

string.format string.find string.gsub os.* io.* require setmetatable pcall などの Lua の標準ライブラリはありません。存在しない関数を呼ぶと「関数 f がありません」という警告を出し、nil を返します。

9.4 イージングの名前（tween … ease）

ESKEES のタイムラインのイージングと同じ 34 種です。

9.5 データ（data）

ESKEES のライブラリの「＋ データ」で作成したグリッドです。読み取り専用です（書き込むと警告を出し、値は変わりません。書き換えたい場合は grid.copy を使います）。

data.名前 と data.名前.グリッド名 の名前の誤りは、ワークスペースが書いた時点で警告します。

10. キーとゲームパッドの名前

on key / on keyup / key() / wait click で使う名前です。

• スクリプトからは、コントローラーの入力か画面上のボタンの入力かを区別しません
• 仮想パッドはタッチ画面で、スクリプトが PadUp 〜 PadY を使っているときだけ表示されます（十字キーは 1 つでも使えば 4 方向すべて）。スクリプトがスワイプ（SwipeUp など）を使っている場合、十字キーは表示しません（ゲームパッドの十字キーはそのまま使えます）
• スワイプを使っても、押した瞬間の on press などは今までどおり発火します（スワイプかどうかは離すまで分からないため）
• ウィンドウからフォーカスが外れたら、押し続けているキーはすべて離したものとして扱います

11. 値の割り当て元とテキストへの埋め込み

var … from で割り当てられるもの（1 秒に 1 回。端末のローカル時刻）

say と UI のテキストに埋め込めるもの（{…}。描画時に置き換わる）

不明な名前は置き換えません。

12. 実行のルールと上限

1 フレームの処理順

1. （最初のフレームのみ）セーブデータを読み込む → ロジックを持つコンポーネントをアクターに変換する → on start → 開始シーンの on scene
2. dt を決める → 補間（tween）を進める
3. on frame → クラスの update(dt)（アクターごと） → on every
4. 待機中のスクリプトの再開（wait の時刻が来たもの・アニメーションが終了したもの）
5. 変化した変数の on change（値が落ち着くまで。最大 8 回）
6. カメラの追従（camera follow self）を 1 回進める
7. 変更されたセーブデータを保存する

クリック・キー入力などのトリガーは、発生した時点で実行します（最後に 5・7 も行います）。

ルール

上限

13. 実行時のメッセージと構文エラー

構文エラー（読み込み時に停止し、行と桁を表示する）

エラーは N 行 M 列: 内容 の形式です。ESKEES のワークスペースでは、その行に赤い印が表示され、修正するまでプロジェクトのスクリプトは変更されません。

書いた時点で検出できる警告（ESKEES のワークスペースの「問題」）

実行せずに、名前の一覧と照合して検出します: パーツ・フレーム・クリック領域・アニメーション・プリセット・シーン・UI パネルとテキスト要素・サウンド・データとグリッド・関数・メソッド・イージング。

実行時のメッセージ（ESKEES の「ログ」に表示。同じメッセージは 1 回だけ表示）

14. 実行環境ごとの違い

15. Lua との違い

16. コード例

撫でると変わる

var nade = 0 to 8 save

on press head
  nade += 1
  play "wave"
  wait 0.5
  if nade >= 8 then
    frame face = "照れ"
  elseif nade >= 4 then
    cycle toach
  else
    toggle EF
  end
end

時刻で着替える

var hour from clock.hour

on change hour
  switch hour
    case 22, 23 then frame face = "夜"
    case 6 then frame face = "朝"
    else frame face = "通常"
  end
end

紙芝居

on click 開始
  ui 会話 show
  say 本文 = "むかしむかし"
  wait click any
  say 本文 = "{clock.time} になりました"
  wait click any
  ui 会話 hide
end

降ってくる星をクリックする

var score = 0

on start
  loop
    spawn 星 at 100, 0
    self.vy = 3
    wait 1
  end
end

on every 0.05
  for each in 星
    self.y += self.vy
    if self.y > 1080 then
      destroy self
    end
  end
end

on tap 星
  score += 1
  destroy self
end

テトリス

• ブロックの形は「データ」のグリッドです（grid.cells(data.ミノ[name])）。盤面は 2 次元のテーブル（board[y][x]）で、ブロックは色ごとのパーツをアクターとして生成し直して描画します（移動したときだけ）
• 揃った行は「光」のアクターを tween … then destroy で縮めながら透明にし、sound 消える を再生し、wait 0.3 の間は落下と操作を止めてから消します
• 3 ステージで、消す行数の目標（5 / 10 / 15）と落下速度が上がります。目標の行数を消すまでのタイムを計測し、3 ステージを終えるとリザルト（ステージごと・合計・ベスト）を表示します

シーンはタイトル → ゲーム → リザルトです（2026-09-26）。タイトルとリザルトの背景は画像要素（パーツ「タイトルの地」「リザルトの地」）で、ESKEES で選択して「画像を差し替え」を使うだけで別の画像にできます。途中で表示するパネル（ミス・クリア・新記録）はどのシーンにも追加せず、ui で表示を切り替えます。ESKEES Studio では、showcase の公式サンプルの「これを改造してみる」から開けます（サンプルを改造する）。

パタパタ（ステージ版）

• 土管と地面はステージ「コース1」〜「コース3」のタイル（衝突判定のあるレイヤー）です。鳥は self:moveBy で進み、衝突した軸が返ったらミス（そのステージをやり直し）になります
• ステージが進むごとに、コースが長く・隙間が狭く・速くなります。ゴールまでのタイムを計測し、3 ステージを終えるとリザルト（ステージごと・合計・ベスト・新記録）を表示します
• カメラが鳥を追従し（camera follow self）、衝突すると camera shake します。合計のベストはセーブデータ（save 記録 = { bestTotal = 0 }）に残ります
• 空は画面に固定したパーツ（カメラが動いても流れない）で、雲はタイルで描画して流します

シーンはタイトル → ゲーム → リザルトです（テトリスと同じ構成）。タイトルの背景は地面だけのステージ「タイトル」です（ステージのタイルはパーツより手前に描画されるため、雲や土管がタイトルのパネルに重ならないようにしています）。ESKEES Studio では、showcase の公式サンプルの「これを改造してみる」から開けます（サンプルを改造する）。

数値を長さで表示したい場合はゲージを使います（UI の矩形か画像要素に「変数で長さを変える」を設定。HP バーなど）。テキストの {hp} と違い、画像に置き換えても値に追従します（画像はパーツのマスクとして、変数に合わせて伸縮します）。

GUI で編集できる形にしてください: 画面に表示するもの（タイトル・ボタン・スコア・結果）は UI パネルに置き、シーンで表示を切り替え、背景の矩形は画像要素にします。スクリプトの中で描画しないでください（ESKEES の階層にもキャンバスにも表示されず、編集できなくなります）。

3 ステージとタイムの書き方（テトリスと同じ構成）: phase（0 プレイ中 / 1 ミス / 2 ステージクリア / 3 全ステージクリア）とstageNo を変数に持ち、ステージの開始時に startT = time、毎フレーム elapsed = round2(time - startT) とします。クリアしたら t1〜t3 に記録し、最後に合計とベストを表示します。UI パネル（ミス クリア リザルト きろく）を ui … show / hide で切り替え、クリックしたら phase に応じて次へ進めます。

パタパタ（スクリプトのみ）

var score = 0
var over = 0

class 鳥
  vy = 0
  function update(dt)
    self.vy += 900 * dt
    self.y += self.vy * dt
    if self.y > screen.h or touching 土管 then
      over = 1
    end
  end
  function flap()
    self.vy = -280
  end
end

on every 1.5
  local gap = math.random(160, screen.h - 160)
  spawn 土管 at screen.w + 40, gap - 390
  spawn 土管 at screen.w + 40, gap + 70
end

on press any
  for each in 鳥
    self:flap()
  end
end

テーブルで盤面を持つ（テトリスの行消し）

function clearLines(board, w, h)
  local cleared = 0
  local y = h
  while y >= 1 do
    local full = 1
    for x = 1, w do
      if board[y][x] == 0 then
        full = 0
      end
    end
    if full == 1 then
      table.remove(board, y)
      local row = {}
      for x = 1, w do
        row[x] = 0
      end
      table.insert(board, 1, row)
      cleared += 1       -- 消した行には上の行が来るので、同じ y をもう一度確認する
    else
      y -= 1
    end
  end
  return cleared
end

ドラッグ＆ドロップ

on drag 鍵 to 扉
  move 扉 by 0, -40
  play 開く
  place 鍵
end

17. 今後の予定（未実装）