TwoDTreasure ― OP・運営ガイド¶
TwoDTreasure の導入・地点設定・config・看板・権限・管理コマンドをまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | TwoDTreasure |
| バージョン | 1.3 |
| api-version | 26.1.2 |
| メインコマンド | /2dtreasure（エイリアス /2dt・/treasure2d） |
| 依存プラグイン | なし |
| 設定ファイル | plugins/TwoDTreasure/config.yml |
導入手順¶
- ビルドした
TwoDTreasure-1.3.jarをサーバーのplugins/フォルダに配置する。 - サーバーを起動すると
plugins/TwoDTreasure/config.ymlが自動生成される。 - 後述の手順でゲーム用ワールドに地点（spawn・lobby・area）を設定する。
/2dtreasure wandで設定ツールを受け取ると、コマンドなしで設定できます（後述）。 - ロビーに参加看板・退出看板を設置し、
/2dtreasure setsignで登録する（後述）。 - 設定を変更したら
/2dtreasure reloadで再読み込みする。
地点設定が未完了だと開始できません
spawn・lobby・area pos1・area pos2 の4地点がすべて設定されていないとゲームを開始できません。プラグイン有効化時のログにも設定状態が出力されます。
config.yml 設定項目¶
config.yml の各キーは下表の通りです。地点（locations）はゲーム内コマンドで設定するため、手動編集は不要です。
ゲーム設定（game）¶
| キー | 既定値 | 説明 |
|---|---|---|
min-players |
2 | ゲーム開始に必要な最低人数 |
max-players |
10 | 最大参加人数（参加看板の表示用） |
countdown-seconds |
20 | マップ確認タイムの秒数 |
ending-seconds |
20 | ゲーム終了後、ロビーに戻るまでの待機秒数 |
2D地形設定（terrain）¶
| キー | 既定値 | 説明 |
|---|---|---|
fixed-z |
0 | 2D平面のZ座標（プレイ面を固定する1マス） |
y-ground-level |
80 | 地面の高さ |
y-min |
1 | 会場の最下層。この高さに床（ベッドロック）が敷かれます |
y-max |
320 | 会場の最大Y座標 |
地形生成の仕様（更新）
マップ生成は会場の 外周のみをバリアブロックで囲い、内部を y-min（床のベッドロック）〜y-ground-level（地表）の範囲で土・石・鉱石（ダイヤ/金/鉄/銅/石炭）に上書きします。地表より上は空気にします。会場全体を大きく掘り抜く方式ではないため、会場サイズを変えて再設定した場合は旧会場のブロックが残ることがあります（専用ワールドでの新規会場を推奨）。y-min は既定で 1 のため、床はY=1に敷かれます。
ソロ（スコアアタック・solo）¶
| キー | 既定値 | 説明 |
|---|---|---|
solo.enabled |
true | false でソロを無効にする（ソロ看板・/2dtreasure solo から始められない） |
solo.menu-delay |
3 | 挑戦が終わってロビーに戻ってから、ソロメニューを開き直すまで（秒） |
solo.result-seconds |
5 | 結果を表示してからロビーへ戻すまで（秒） |
solo.broadcast-best |
true | 自己ベスト更新をサーバー全体に流す |
solo.ranking-size |
10 | /2dtreasure ranking に表示する人数 |
solo.animals |
false | ソロ中にも動物を出す |
solo.courses |
★1 | コースのリスト（下の「コースの調整」） |
地点設定（locations）¶
spawn / lobby / area.pos1 / area.pos2 の4地点を保持します。これらは後述の /2dtreasure setstartspawn / setlobby / setfield コマンドで設定され、自動的に config.yml に保存されます。手動で書き換える必要はありません。
設定変更後は /2dtreasure reload
config.yml を編集したら /2dtreasure reload で再読み込みしてください。ただしゲーム進行中はリロードできません（待機中のみ可）。
スコアアタック（ソロ）¶
1人で制限時間内に宝を掘り、価値の合計で競うモードです。遊び方は プレイヤー向けページ を見てください。
- 入口は ソロ看板 と
/2dtreasure solo。ソロで入った人は ソロ在籍 になり、通常戦には出場しません（/2dtreasure joinで通常在籍に戻れます）。通常戦の最低人数にも数えません。 - フィールドは通常戦と共用 です。どちらかが使用中なら、もう一方は始められません（理由を本人に表示）。
- 地形は通常戦と同じく毎回作り直します。宝は地形を作ったあとに、石・土・鉱石の位置へ置きます（ほかの宝と隣り合わない）。
- 残った宝は終了・中止のたびに石へ戻します。クラッシュに備えて座標を
config.ymlのruntime.solo-treasuresに保存し、次の起動時に石へ戻します。 - 記録は
solo-records.yml（データ用。ConfigUpdater の対象外）。 /2dtreasure stopはソロの挑戦も止めます（記録しない）。挑戦者はロビーへ戻り、ソロメニューが開きます。
コースの調整¶
コースは config の solo.courses（リスト）で決めます。上から順にソロメニューへ並びます。★2・★3 を作るときは、★1 の行をまるごとコピーして id と中身を変えてください。
| 項目 | 説明 |
|---|---|
id |
記録のキー。. と空白は使えない。変えると今までの記録とつながらない |
display / icon |
表示名とソロメニューのアイコン |
countdown-seconds |
マップ確認タイム（秒・最低3） |
time-seconds |
掘削タイム（秒・最低10） |
all-clear-bonus |
全回収したときの、残り1秒あたりの点 |
death-penalty |
死亡1回あたりに引く点（0点より下にはならない） |
treasures |
宝のリスト：id / display / block / value（点）/ count（数）/ min-depth・max-depth（地表からの深さ） |
rewards |
報酬：- {min-score: 600, item: DIAMOND, amount: 3}。自己ベストを更新したとき だけ、一番高いしきい値の1つを渡す（ロビー離脱後に受け取り）。既定は無し |
宝のブロックと深さ
blockは 地形に出てこないブロック にしてください（鉱石と見分けがつかなくなります）。固体で落下しないブロックだけ使えます（宝箱CHESTは可）。- 深さはフィールドの掘れる範囲（地表〜最下層の岩盤の上）に切り詰めます。既定の地形（地表 Y80・最下層 Y1）だと掘れる深さは約73です。浅いフィールドでは深い宝が置ききれず、満点は実際に置けた宝で計算 します（コンソールに警告が出ます）。
統合版（Geyser）
- ソロメニューはチェスト画面で表示・タップ操作できます。lore の改行や色の見え方は実機で確認してください。
- 統合版はネザースター（使う動作の無いアイテム）で空中をタップしてもサーバーに届かないため、空中タップ（腕振り） と 持ってスニーク でもメニューが開くようにしています。
- マップ確認の透視表示（
bedrock.map-preview）では、宝ブロックはガラスにせずそのまま見せます。
ロビーの持ち物退避を無効にしている場合
lobby-inventory.enabled: false のときは私物に混ざるため、ネザースターを配りません。メニューは /2dtreasure solo で開いてください。
設定ツール（ワンド）¶
ブレイズロッドの「2D宝探し 設定ツール」で、見ているブロック・看板に直接セットアップできます。受け取り時・使用時の両方で twodtreasure.admin を確認するため、OP以外が手に入れても使えません。
| 操作 | 動作 |
|---|---|
| 左クリック／長押し（ブロック） | そのブロックの X をフィールドの角1にする（setfield 1 相当）。枠を表示 |
| 右クリック／タップ（ブロック） | そのブロックの X をフィールドの角2にする（setfield 2 相当）。枠を表示 |
| 右クリック／タップ（看板） | 選んでいる看板モードで登録・解除する（モードなしなら登録状況を表示） |
| 右クリック／タップ（空中） | 設定状況の要約＋フィールドの枠を表示 |
| しゃがみ＋左クリック／長押し | フィールドの枠を表示 |
| しゃがみ＋右クリック／タップ | 設定メニューを開く |
フィールドの枠は本人にだけ粒で表示します（黄色＝フィールドの外枠、緑＝地面の高さ）。設定ツールでブロックを壊すことはありません。
設定メニューでできること（すべて即保存）：
- 地点：初期スポーン／ロビーを現在地に設定、フィールドの角1・角2を現在地の X に設定、2D平面の Z（
terrain.fixed-z）を現在地に、地面の高さ（terrain.y-ground-level）を足元の Y に、フィールドの枠を表示 - 看板モード：参加／離脱／開始／ソロ（スコアアタック）／登録解除／モード解除
- 数値：最低人数（通常戦）、最大人数、マップ確認の秒数（通常戦・5秒刻み）、終了後の待機秒数（通常戦）、ソロメニューを開くまでの秒数
- 切り替え：ソロ（スコアアタック）の有効／無効、自己ベストの全体通知、ソロ中の動物、統合版の透視表示
- 進行：試合の強制停止（スコアアタックを含む）、設定の再読み込み、設定ツールの回収
試合中は地形に関わる設定を変えられません
フィールドの角・2D平面の Z・地面の高さは、試合中（スコアアタックを含む）は変更できません。
統合版（Geyser）での操作
統合版はブレイズロッドで空中をタップしてもサーバーに届かないため、空中タップ（腕振り）で設定状況の表示になります。しゃがみ＋タップでメニューが開かないときは /2dtreasure menu を使ってください。
セットアップ手順¶
ゲーム用ワールドを用意し、OP権限で以下のコマンドを 設定したい場所に立って 実行します（実行位置の座標が保存されます）。
setfield 1とsetfield 2の2点で囲んだX軸の範囲が、マップが生成されるプレイエリアになります。- 4地点をすべて設定すると、コマンド実行時に「✓ 全ての設定が完了しています！」と表示されます。
- 設定状況は
/2dtreasure statusでいつでも確認できます。
ゲームエリアはX軸の幅で決まります
マップ生成はエリアの最小X〜最大X、固定Z（fixed-z）、Y軸（y-min〜y-ground-level）の範囲で行われます。プレイ面は fixed-z の1マスに固定され、setfield の X座標の範囲 がプレイエリアになります（pos1/pos2 の Y・Z は使われません）。X幅は最低でも5ブロック以上 離して設定してください（スポーン地点・宝箱の配置計算に余裕が必要で、極端に狭いと正しく生成されません）。
看板の登録¶
参加・退出はロビーの看板で行います。看板を設置し、看板を見ながら（5ブロック以内） 以下のコマンドで登録します（twodtreasure.admin 権限が必要）。
登録するとプラグインが看板テキストを自動で書き込み、位置が config.yml の signs.join / signs.leave / signs.start / signs.solo に保存されます（再起動後も有効）。手書きテキスト（[2DT]）による登録は廃止されています。setsign delete は視線先の看板の種別を自動判別して登録を解除し、テキストをクリアします。
| 種別 | 表示（自動書き込み） | 用途 |
|---|---|---|
| 参加看板 | [2DT] ／ lobby ／ クリックで参加 ／ 参加人数 |
クリックでロビーに参加。参加人数（現在/最大人数）が表示される |
| 退出看板 | [2DT] ／ leave ／ クリックで離脱 |
クリックでロビー／ゲームから離脱 |
| 開始看板 | 2D宝探し ／ ▶クリックで開始 |
クリックでゲームを開始（/2dtreasure start と同じ） |
| ソロ看板 | [2DT] ／ ソロ ／ スコアアタック ／ 空き・挑戦中: 名前・通常戦中 |
クリックでソロ在籍してソロメニューを開く（/2dtreasure solo と同じ） |
設定ツール（ワンド）でも、メニューで看板モードを選んで看板を右クリック／タップすれば登録・解除できます。
参加看板の人数表示
参加看板には現在のロビー参加人数が 現在/最大人数 の形式で表示され、参加・退出に応じて自動更新されます。最大人数は config.yml の game.max-players の値です。
管理コマンド¶
メインコマンドは /2dtreasure（エイリアス /2dt・/treasure2d）です。start はコマンドブロックやコンソールからも実行できます。
| コマンド | 説明 |
|---|---|
/2dtreasure wand |
設定ツール（ワンド）を受け取る（おすすめ） |
/2dtreasure menu |
設定メニュー（GUI）を開く |
/2dtreasure setstartspawn |
初期リスポーン地点を設定する |
/2dtreasure setlobby |
ロビー地点を設定する |
/2dtreasure setfield <1\|2> |
ゲームエリアの角1／角2を設定する |
/2dtreasure setsign <join\|leave\|start\|solo> |
視線先の看板を参加／退出／開始／ソロ看板として登録する |
/2dtreasure setsign delete |
視線先の看板の登録を解除する（種別は自動判別） |
/2dtreasure join |
ロビーに参加する（参加看板クリックと同じ。twodtreasure.play 権限で全員可） |
/2dtreasure leave |
ロビー／ゲームから離脱する（退出看板クリックと同じ。全員可） |
/2dtreasure start |
ゲームを開始する（コマンドブロック対応） |
/2dtreasure solo [コース] |
ソロ（スコアアタック）のメニューを開く。コースを付けるとすぐ開始（全員可） |
/2dtreasure ranking [コース] |
スコアアタックのランキング（全員可。コースが1つなら省略可） |
/2dtreasure ranking reset <プレイヤー\|all> [コース] |
スコアアタックの記録を消す（OP・コンソール可） |
/2dtreasure stop |
進行中のゲーム（スコアアタックを含む）を強制終了する |
/2dtreasure reload |
config.yml を再読み込みする（待機中のみ可） |
/2dtreasure status |
ゲーム状態・参加人数・地点設定状況・ソロの状況を表示する |
コマンドブロックでの自動開始
/2dtreasure start はコマンドブロックからも実行できます。ロビーのボタンや感圧板と連動させることで、運営がいなくてもプレイヤー主導でゲームを始められます。
権限ノード¶
plugin.yml で定義されている権限は以下の2つです。
| 権限 | 既定 | 用途 |
|---|---|---|
twodtreasure.admin |
OP | 管理コマンド（/2dtreasure ...）の使用、看板の設置、設定ツール／メニュー、強制停止、lobbyfix、記録の削除 |
twodtreasure.play |
全員 | ゲームに参加する（参加看板のクリック） |
トラブルシューティング¶
ゲームが開始できない
考えられる原因は次の通りです。
- 地点設定が未完了 — spawn・lobby・area pos1・area pos2 の4地点をすべて設定してください。
/2dtreasure statusで確認できます。 - 人数不足 — ロビー参加者が
game.min-players（既定2人）に達していません。 - 既にゲームが進行中 — 進行中は新たに開始できません（スコアアタックの挑戦中も含む）。
- ソロ在籍の人しかいない — ソロ在籍の人は通常戦の人数に数えません。
/2dtreasure joinで通常在籍に切り替えてもらってください。
プレイヤーが参加看板をクリックしても参加できない
参加には twodtreasure.play 権限（既定で全員付与）が必要です。ゲーム進行中に参加した人はロビーで待ち、次のゲームから参加します。看板が /2dtreasure setsign join で登録済みか確認してください（手書きの看板は機能しません）。
看板が反応しない／フォーマットされない
看板は /2dtreasure setsign <join|leave> での登録が必要です（twodtreasure.admin 権限）。登録したい看板を5ブロック以内で見ながら実行してください。手書きテキスト（[2DT]）による自動登録は廃止されています。
スコアアタックの宝が少ない／満点が低い
フィールドが狭い・浅いと、宝を置ききれないことがあります。コンソールの「ソロの宝を置ききれませんでした」を確認し、フィールドを広げるか、solo.courses の count・深さを調整してください。
ゲーム中に設定をリロードできない
/2dtreasure reload はゲーム待機中（WAITING）のみ実行できます。ゲーム進行中は /2dtreasure stop で終了してからリロードしてください。