Name

taQu_rule — taQu カスタムルール記述言語リファレンス (v1.6.0)

Synopsis

Description

taQu のカスタムルールを記述するためのインデントベース言語です。Python ライクな構文でクイズ早押しゲームのルールを定義します。

文字コード

UTF-8 推奨。

コメント

# 以降の文字はすべて無視されます。

インデント

半角スペースによるインデントでブロックを表現します。

文字列リテラル

"..." および '...' のどちらも使用できます。

Metadata

def の外側（ファイル先頭付近）に記述します。

const TARGET = 7
rule = "セブンス[TARGET]"
description = "[TARGET]ポイント先取で勝利"
maxAns = 1
x.label = "pts"

Variables

組み込み変数（表示用）

画面に表示できる変数は x, y, z の 3 つのみです。ラベル未設定の変数は非表示になります。

組み込み読み取り専用変数

カスタム変数

x, y, z 以外の任意の名前（例: hp, phase）も使用できます。def の外で代入すると初期値として扱われます。画面には表示されません。カスタム変数は各プレイヤーごとに独立して保持され、scope() 内での代入も正しく各プレイヤーに保存されます。

phase = 0   # 全プレイヤーの初期値を 0 に設定

def push():
  if phase == 0:
    phase = 1
    scope(my_mt == mt):
      phase = 1   # チームメンバーにも phase=1 が保存される

my_ プレフィックス

scope() の条件式・ブロック内、および othersAdd / othersSet / tAdd / tSet の値式の中で使います。

参照（読み取り）

コマンドを発行したプレイヤー自身の変数を参照します。

代入（書き込み）

scope() のブロック内で my_x = 式 と書くと、各対象プレイヤーへの処理中に発行者自身の変数へ書き込みます。+= / -= / *= も使用可能です。

othersSet(x, my_x)       # 自分以外全員のxに「自分のx値」をセット
scope(mt == my_mt):       # 自分と同じチームのプレイヤーに実行
    x += my_x             # 対象メンバーのxに自分のxを加算（参照）

scope(mt == my_mt and x >= 10):
    my_z += 1             # 条件を満たすチームメンバーの数を発行者のzに積算（代入）

チーム集計関数

全体集計関数

数学関数

Events

def イベント名(): の形式でイベントハンドラを定義します。def の外側に書いたコードは、プレイヤーが参加した時点の初期化処理として実行されます。

push() 内の処理順序

push() でキューに積んだコマンドは、ルール実行後に以下の順で処理されます。

1. scope() — 対象プレイヤーへの変数操作
2. giveAns() — 解答権の付与
3. throughAns() — 解答権の放棄（カーソル前進）
4. 解答者の決定（updateRoomAnswerState）

Operators

代入演算子

算術演算子

比較・論理演算子

条件分岐 (if / elif / else)

# 基本形
if x >= 10:
    win()
else:
    x += 1

# elif を使った多段分岐
if x >= 10:
    win()
elif x >= 5:
    z += 1
elif x >= 1:
    z += 0
else:
    lose()

# ネスト
if x > 0:
    if x == 5 and y == 0:
        z += 2
    else:
        z += 1

# 1行 if（インライン形式）
if x >= 10: win()

繰り返し (repeat)

repeat 3:
    x += 1   # x を 3 回加算 → x += 3 と等価

# 式も使用可能
repeat N:
    othersAdd(y, 1)

多分岐 (switch / case / default)

変数や式の値に応じて処理を切り替えます。マッチしたケースだけが実行され、以降のケースには処理が流れません（フォールスルーなし）。連続する if と異なり、あるケース内で変数を変更しても他のケースに影響しません。

switch phase:
    case 0:
        x += 3
        phase = 1
    case 1:
        x += 1
        phase = 0
    default:
        pass

Commands

状態変更コマンド

解答権操作コマンド

# push() でチームメンバーに解答権を渡し、自分は解答しない例
def push():
    if phase == 0:
        giveAns(my_mt == mt)   # 同チームのメンバーに解答権を渡す
        throughAns()            # 自分の解答権を放棄（isPressed は残る）
        scope(my_mt == mt):
            phase = 1

他プレイヤーへの操作コマンド

Team

プレイヤーは参加時の「フレーバーテキスト」でチーム分けされます。

変数の同期設定 (sync)

チーム内で変数を全メンバーに共有したい場合に def の外側に記述します。

sync(x)   # x はチーム内で同期（誰かが更新すると全員に反映）
          # y, z は同期されず個人の値として保持

Scope

scope(条件): は発行者を基準として、全プレイヤーに対して条件付きで処理を実行します。

def push():
    # 発行者と同じチームのプレイヤーにだけ実行
    scope(mt == my_mt):
        x += 1

    # 全員に実行（条件を常に真にする）
    scope(1):
        y += my_x

Chat Commands

チャット欄にスラッシュで始まるコマンドを入力することで、ホストは各種操作を行えます。 コマンドはチャットには流れず、ホストのみに結果が返ります。

得点操作

ジングル

外部ストレージの音声 URL を登録し、参加者全員のブラウザで同時再生します。 サーバーは URL 文字列のみを中継し、音声バイナリは一切保持・転送しません。

/jingle load bgm1 https://dl.dropboxusercontent.com/s/xxxx/music.mp3
/jingle play bgm1
/jingle stop
/jingle list
/jingle remove bgm1

対応 URL 形式

Webhook

ゲームイベント（ボタン押下・正誤判定・勝ち抜け・失格）が発生したとき、 指定した URL に JSON で POST 通知を送ります。 スコア集計・外部連携・自動記録などに使えます。

/webhook https://script.google.com/macros/s/xxxx/exec
/webhook off

送信されるイベント一覧

POST ペイロード例

{
  "event": "judged",
  "roomId": 1,
  "roomName": "クイズ大会",
  "ts": 1710000000000,
  "data": {
    "action": "correct",
    "userId": "abc123",
    "name": "田中"
  }
}

Google スプレッドシートへの記録

Google Apps Script でウェブアプリを作成すると、無料でスプレッドシートに自動記録できます。

1. スプレッドシートを開き、拡張機能 → Apps Script
2. 以下のコードを貼り付け、デプロイ → 新しいデプロイ → 種類: ウェブアプリ
   アクセスできるユーザー: 全員 に設定
3. 発行された URL を /webhook <URL> で登録

function doPost(e) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const body  = JSON.parse(e.postData.contents);
  const row   = [
    new Date(body.ts),
    body.roomId + ': ' + body.roomName,
    body.event,
    (body.data.action || ''),
    (body.data.name   || ''),
    (body.data.rank   || '')
  ];
  sheet.appendRow(row);
  return ContentService.createTextOutput('ok');
}

Examples

Free — 正解で〇、誤答で×が増えるシンプルなルール

description = "正解で〇、誤答で×が増えるシンプルなルール。"
name="Free"
maxAns=1
x.label = "〇"
y.label = "×"

def correct():
  x += 1

def wrong():
  y += 1

def through():
  pass

M〇N× — 設定した回数で勝敗が決まるルール

rule="[M]〇[N]×"
description = "[M]回正解で勝ち抜け、[N]回誤答で失格"
maxAns=1
x.label = "〇"
y.label = "×"
const M = 7
const N = 3

def correct():
  x += 1

def wrong():
  y += 1

def through():
  pass

def next():
  if x >= M: win()
  if y >= N: lose()

Freeze N — n回目の誤答でnターン休み

rule="Freeze[N]"
description = "[N]回正解で勝ち抜け、n回目の誤答でn回休み"
maxAns=1
x.label = "〇"
y.label = "×"
z.label = "Lock"
const N = 10

def correct():
  x += 1

def wrong():
  y += 1
  z = y + 1
  lock()

def through():
  pass

def next():
  if z > 0:
    z -= 1
    if z == 0:
      unlock()

  if x >= N: win()

Attack Survival — 正解で相手を削り、誤答で自分が削られるサバイバル

rule="Attack Survival"
description = "持ち点[M]が無くなると失格、正解で他のプレイヤー-1pt、誤答で自身が-[N]pt"
const M = 20
const N = 1

x.label = "Pts"
x = M

def correct():
  othersAdd(x, -1)

def wrong():
  x -= N

def next():
  if x <= 0:
    x = 0
    lose()

10by10by10mini — チーム内の正解数の積が[N]以上で勝ち

description = "チーム内の正解数の積が[N]以上で勝ち。誤答でその人のPtsが1にリセット。2回誤答でロック。ただし誰かが2回誤答すると、他の全チームの2回目の誤答が1回に戻り、ロックも解除される。"
rule = "10by10by10mini"
x.label = "Pts"
y.label = "×"
z.label = "Prod"
const N = 200
x = 1
z = 1
sync(z)
def correct():
  x += 1
  z = tProd(x)
  if z >= N:
    win()

def wrong():
  x = 1
  y += 1
  z = tProd(x)
  if y >= 2:
    lock()
  scope(mt != my_mt):
    if y == 2:
      y = 1
      unlock()

AI Code Generation

下のプロンプトをコピーし、[要望] を書き換えてから、このページ全体（Ctrl+A で全選択）と一緒に AI に送信してください。

See Also

taQu ルールテスター — /rule_tester