Name

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

Synopsis

Description

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

関連資料: tanakata-ro/taQu_algorithm

文字コード

UTF-8 推奨。

コメント

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

インデント

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

文字列リテラル

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

Metadata

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

const TARGET = 7
rule = "セブンス[TARGET]"
description = "[TARGET]ポイント先取で勝利"
maxAns = 1
x.label = "pts"
x.color = "#ef4444"
y.label = ""
y.color = "rgb(59,130,246)"
w.label = "bonus"
w.size = small

rule と description は、トップレベルの if の中でも変更できます。

const TARGET = 10
rule = "Freeze" + TARGET
description = "勝ち抜け: " + TARGET + "問"

if TARGET >= 10:
    rule += " hard"
    desc += " / 高難度"

Variables

組み込み変数（表示用）

数値欄として画面に表示できる変数は x, y, z, w の 4 つです。ラベル未設定の変数は非表示になります。4 つすべてを表示する場合は、プレイヤーカードが 1 変数分だけ横に広がります。miss は数値欄ではなく、カード上の × 表示専用変数です。

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

早押し遅延変数

buttonDelay は各プレイヤーの早押し遅延をミリ秒単位で表します。参照と代入が可能で、値は 0～60000 の整数に丸められます。変更は実際の早押しボタンと設定画面に同期されます。

buttonDelay = 200

def correct():
  buttonDelay += 50

def next():
  scope(x >= 3):
    buttonDelay = 500
  scope(x == 0):
    my_buttonDelay = 0

カスタム変数

x, y, z, miss 以外の任意の名前（例: 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 の外側に書いたコードは、プレイヤーが参加した時点の初期化処理として実行されます。

Custom Functions

def name(): で引数なしの自作関数を定義し、name() で呼び出せます。 イベント名や組み込み関数名など、予約済みの名前は自作関数として定義できません。

def addCorrectPoint():
  x += 1
  if x >= 3:
    win()

def correct():
  addCorrectPoint()

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

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

得点への対他コマンドは記述順に反映され、その後の行は反映後の値を参照します。初期化用のトップレベルでは使用できません。 scope の内側からさらに対他コマンドや解答権操作を呼び出す場合も、読み込み時にエラーになります。 得点更新は保存済みの不在プレイヤーにも適用されますが、司会・観戦者は対象外です。

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 status
/webhook secret
/webhook off

送信されるイベント一覧

• buttonPressed は、そのターンで最初に押した瞬間にだけ送信されます。観戦者・勝ち抜け／失格済み・ロック中のプレイヤーは対象外です。
• judged の action は correct / incorrect / through の 3 種類です。Undo / Redo では送信されません。
• 解答者がいない状態で判定した場合、judged の userId と name は null になります。
• playerWon / playerLost は、カスタムルールによる自動判定でも /win /lose による手動判定でも送信されます。
• ts は送信を開始した時刻（UNIX ミリ秒）です。

POST ペイロード例

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

送信の仕様

受信側は、まず即座に 2xx を返し、重い処理は非同期に行ってください。

配信結果の確認

送信のたびに結果が部屋に 1 件記録され、/webhook status で確認できます。

[webhook] 設定中: https://example.com/taqu
最終送信: 2026/08/24 21:03:11 JST / judged
結果: 成功 200 OK（132 ms）

[webhook] 設定中: https://example.com/taqu
最終送信: 2026/08/24 21:03:11 JST / buttonPressed
結果: 失敗 HTTP 500 Internal Server Error（214 ms）

まだ一度も送信していない場合は 最終送信: なし と表示されます。失敗時の「原因」は次のいずれかです。

失敗したときの通知

送信に失敗すると、その部屋のホストにだけチャット欄で通知されます。参加者には表示されません。

[webhook] 送信失敗: 2026/08/24 21:03:11 JST / judged
原因: タイムアウト（5秒）

• 連続失敗で画面が埋まらないよう、通知は最大 1 分に 1 回です。抑制された分の失敗も /webhook status の記録には反映されます。
• 途中で送信に成功すると抑制はリセットされ、次の失敗はすぐに通知されます。
• 通知はホストの現在の接続に送られます。通知時に部屋を離れていた場合は届かないため、/webhook status で確認してください。

リクエスト署名

Webhook の POST リクエストには X-Taqu-Signature ヘッダが付与されます。 受信側でこのヘッダを検証することで、taQu サーバーからの正規リクエストであることを確認できます。

アルゴリズム

HMAC-SHA256。リクエストボディ（JSON 文字列）をシークレットで署名した hex ダイジェストを sha256= プレフィックス付きで送ります。

シークレットの取得

/webhook <URL> 設定時にチャットに表示されます。/webhook secret で再確認できます。

X-Taqu-Signature: sha256=a3f2c1...（64文字の hex）

検証の実装例（Python）:

import hmac, hashlib

SECRET = b"your_secret_here"

def is_valid(request):
    body = request.body          # raw bytes
    given = request.headers.get("X-Taqu-Signature", "")
    expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, given)

検証の実装例（Node.js）:

const crypto = require("crypto");
const SECRET = "your_secret_here";

function isValid(rawBody, signature) {
  const expected = "sha256=" + crypto
    .createHmac("sha256", SECRET)
    .update(rawBody)
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(signature || "");
  if (a.length !== b.length) return false;   // 長さが違うと timingSafeEqual は例外を投げる
  return crypto.timingSafeEqual(a, b);
}

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
  miss += 1

def through():
  pass

色変化とmiss表示

description = "正解数が偶数なら赤、奇数なら黒。誤答で×表示も増える。"
x.label = "〇"
y.label = "×"

def correct():
  x += 1
  if x % 2 == 0:
    x.color = "red"
  else:
    x.color = "black"

def wrong():
  y += 1
  miss += 1   # 0〜5の範囲で×表示が増える

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 に送信してください。

Const Descriptions

A const value shown in the GUI can have help text. Write it as a trailing comment, as the comment immediately before the const, or as the comment immediately after it. These comments are only UI metadata and do not affect rule execution.

const N = 3 # Number of correct answers needed to win

# Number of wrong answers before losing
const W = 2

const P = 1
# P: Points added on a correct answer

See Also

taQu ルールテスター — /rule_tester