Name

taQu_rule — taQu カスタムルール記述言語リファレンス (v1.5.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 / else)

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

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

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

多分岐 (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

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