FishingPointBattle ― OP・運営ガイド¶
FishingPointBattle の導入・エリア設定・config・権限・管理コマンドをまとめます。
基本情報¶
| 項目 | 値 |
|---|---|
| プラグイン名 | FishingPointBattle |
| メインコマンド | /fpb（エイリアス /fishingpointbattle、/fishing） |
| 設定ツール | /fpb wand（ブレイズロッド）・/fpb menu（設定メニュー） |
| 依存プラグイン | なし（単独で動作） |
| 設定ファイル | plugins/FishingPointBattle/config.yml |
| api-version | 26.1.2 |
導入手順¶
- ビルドした
FishingPointBattleの jar をサーバーのplugins/フォルダに配置する。 - サーバーを起動すると
plugins/FishingPointBattle/config.ymlが自動生成される。 - 後述の「セットアップ手順」でゲームエリアの座標を設定する（
/fpb wandの 設定ツール を使うとコマンドなしで設定できます）。 - ロビーに参加・退出用の看板を設置する（後述）。
- 設定を変更したら
/fpb reloadで再読み込みする。
設定ツール（おすすめ）¶
コマンドを打たずに、見ているブロック・看板へ直接セットアップできる OP用ツール（ブレイズロッド）と GUI メニューを用意しています。いずれも fpb.admin 権限が必要で、非OPが入手しても使えません（受け取り時・使用時・メニューを開く時・クリック時のすべてで権限を確認します）。
設定ツールの操作¶
| 操作 | 内容 |
|---|---|
| 左クリック/長押し（ブロック） | 釣り場（ゲームエリア）の角1 |
| 右クリック/タップ（ブロック） | 釣り場（ゲームエリア）の角2 |
| 右クリック/タップ（看板） | 選んでいる看板モードで登録・解除（モードなしなら登録状況を表示） |
| 右クリック/タップ（空中） | 設定状況の要約を表示（統合版は空中タップ） |
| しゃがみ＋左クリック/長押し | 釣り場の外枠・開始地点（角1と角2の中心）・高ポイントゾーンの円を10秒間パーティクルで表示（自分だけに見える） |
| しゃがみ＋右クリック/タップ | 設定メニューを開く |
- 角は クリックしたブロックの上（プレイヤーが立てる位置）で記録します。試合開始時は角1と角2の中心へ移動するので、釣り場の床のブロックをクリックしてください（
/fpb setfieldと同じく、立てる場所が中心になるようにします）。 - 試合中（大会のカウントダウン・試合・集計中、ソロ挑戦中）は釣り場・高ポイントゾーンを変更できません。
- 設定ツールで登録する開始看板の識別子は
mainです。別の識別子にしたいときは/fpb setsign start <識別子>を使ってください。 - 釣り大会に参加中（大会のロビー・ソロ在籍中）は受け取れません。持ち物が退室時の復元で上書きされるためです。
- 設定ツールを持って登録看板を触っても、参加・退出・ソロにはなりません（看板モードの操作だけになります）。
設定メニューの中身¶
| 区分 | ボタン |
|---|---|
| 地点 | 初期スポーン／ロビー／高ポイントゾーンを 現在地 に設定／高ポイントゾーンを解除／範囲を表示／釣り場の設定状況 |
| 看板 | 参加・退出・開始・ソロ・登録解除の看板モード／看板モードの解除（各ボタンに登録数を表示） |
| 切り替え | ゴールデンタイム ON/OFF（golden-time.enabled）／ソロ「今日の大物」有効/無効（solo.enabled） |
| 数値（−/＋） | 制限時間（game.default-duration・1〜60分）／定員（game.max-players・0=無制限）／最小人数（game.min-players）／カウントダウン（game.countdown-seconds）／高ポイントゾーン半径（fish-spot.radius）／ソロの制限時間 30秒刻み（solo.duration-seconds）／ソロの1日の回数（solo.daily.max-tries・0=無制限） |
| 進行 | 大会を開始（/fpb start と同じ）／強制停止（大会、またはソロ挑戦全員）／設定の再読み込み／閉じる／設定ツールを回収 |
- メニューで変えた値は すぐに config.yml へ保存 されます（
/fpb reloadは不要）。ソロの設定はその場で読み直し、挑戦中の人はそのまま続けられます。大会の値は次の試合から反映されます。 - 統合版でも開けます（開く処理を1tick遅らせています）。ボタンの説明（lore）の見え方は実機で確認してください。統合版でしゃがみ＋タップでメニューが開かないときは
/fpb menuを使ってください。
セットアップ手順¶
ゲームに使うワールドを用意し、OP権限で以下のコマンドを 設定したい場所に立って 実行します（実行位置・向きが座標として保存されます）。
看板は複数設置できます（v更新）
setsign は join / leave / start の3種類 に対応し、いずれも 複数設置 できるようになりました。参加（join）・退出（leave）は何枚でも設置でき、開始（start）は 識別子ごと（/fpb setsign start <識別子>、省略時は main）に、同じ識別子でも何枚でも設置できます。登録は上書きではなく追記され、/fpb setsign delete は視線先の1枚だけ解除します。開始看板を右クリックするだけでゲームを開始できます。旧形式（単一座標）は起動時に自動でリストへ移行されます。設定のやり直しは不要です。識別子は半角英数字・ハイフン・アンダースコアのみ使用できます。
開始看板のクリックは全員可
/fpb setsign start で登録した 開始看板は、誰がクリックしても（権限不要で）ゲームを開始できます。コマンドの /fpb start [分] も同様に権限不要（全員可）です。最小参加人数（min-players）を満たしていれば、一般プレイヤーも看板・コマンドのどちらからでも開始できます。
必須の座標と任意の座標
初期リスポーン（setstartspawn）・ロビー（setlobby）・ゲームエリアの角1/2（setfield 1・setfield 2）の4点はゲーム開始に 必須 です。すべて設定されていないと /fpb start を実行できません。fishspot（高ポイントゾーン）は 任意 で、未設定でもゲームは開始できます。設定した座標は config.yml の locations セクションに自動保存されます。
看板での参加導線を設置
プレイヤーの参加・退出・開始は看板で行えます。看板を設置し、看板を見ながら（5ブロック以内） /fpb setsign join（参加看板）・/fpb setsign leave（退出看板）・/fpb setsign start（開始看板）を実行して登録してください。
- 看板テキストはプラグインが自動で書き込みます（1行目
[釣り大会]、2行目クリック/タップで参加／クリック/タップで退出／クリック/タップで開始。ソロ看板はソロ：今日の大物。開始看板は3行目に識別子を表示）。 - 位置は config.yml の
signs.join/signs.leave/signs.startに保存され、再起動後も有効です。 - クリック判定は 登録された位置との一致 で行われるため、手書きで同じ文字を書いた看板は機能しません（手書き登録は廃止）。
- 登録を解除するには、対象の看板を見ながら
/fpb setsign deleteを実行します。 - 登録状況は
/fpb statusの「参加看板／退出看板／開始看板」欄で確認できます。
参加看板を使うには fpb.play 権限（既定で全員に付与）が必要です。開始看板のクリックは権限不要で、誰でも開始できます。
ソロモード「今日の大物」¶
1人で遊べるデイリーチャレンジです。遊び方は プレイヤー向けページ を見てください。
- 入口は ソロ看板 と
/fpb solo。ソロで入った人は ソロ在籍 になり、大会には出場しません（大会の人数表示・定員にも数えません）。/fpb joinで大会の待機に、待機中に/fpb soloでソロに切り替えられます。 - 釣り場（エリア）は大会と共用 です。大会が待機中でないとソロは始められず、ソロ挑戦中の人がいると大会は始められません（開始看板・
/fpb startに理由が出ます）。ソロどうしは干渉しないので、solo.max-concurrent（既定4人）まで同時に挑戦できます。 - 必要な設定は大会と同じ4点（初期スポーン・ロビー・エリア角1/2）だけです。挑戦はエリアの中心から始まります。
- 今日の大物は日付から抽選し、
solo-records.ymlに保存します（その日のうちは再起動しても変わりません）。 - 記録は
solo-records.yml（データ用。ConfigUpdater の対象外）。日ごとの記録はsolo.daily.keep-days日分だけ残し、魚ごとの最大サイズ・クリア日数・連続クリアは残し続けます。 - 報酬は大会の入賞報酬と同じ受け取り待ちリスト（
pending-rewards.yml）に積み、ロビーを出た後に渡します。
reset・rerollは、挑戦中の人がいるとできません（先に/fpb stop solo）。報酬の受け取り済みは消えないので、同じ日に報酬を二重に受け取ることはありません。- config から今日の魚の行を消して
/fpb reloadすると、今日の大物を選び直し、今日の記録をリセットします（別の魚のサイズを同じ順位で比べないため）。
魚の調整¶
出題する魚は solo.daily.fish（リスト）で決めます。行を足す・消すと候補が変わります（消した行が次の起動で戻ることはありません）。
| 項目 | 説明 |
|---|---|
id |
記録のキー。半角英数字・ハイフン・アンダースコア。変えると今までの記録とつながらない |
material |
釣れるアイテム（例：SALMON） |
display |
表示名 |
weight |
出題されやすさ（大きいほど出やすい） |
hit-chance |
1回釣り上げたときに大物がかかる確率（0.01〜1.0） |
min / max |
サイズの範囲（cm。min は 0 より大きく、max は min より大きく） |
skew |
大きいサイズの出にくさ。1.0 で一様、大きいほど出にくい（既定 2.0） |
big-line |
大物ライン（cm）。これ以上で「大物！」演出と大物ボーナス |
既定値の目安（シミュレーション）
- 既定の4種は、10年分の抽選で出題回数がほぼ 3:3:2:1 になり、前日と同じ魚は出ませんでした。
- 1匹あたり大物ラインを超える確率は、タラ約12%・サケ約10%・フグ約11%・熱帯魚約7%です。
- 3分の挑戦で10〜15回ほど釣り上げると考えると、1日3回挑戦すればタラ・サケ・フグは大物ボーナスを取れることが多く、熱帯魚の日は難しめです。
- 難しすぎると感じたら
hit-chanceを上げるか、big-lineを下げてください。
solo-records.yml が壊れたとき
手で編集して書式が壊れるなどで solo-records.yml が読めないときは、記録を消さないよう ソロの記録を保存しなくなります（コンソールと /fpb status に表示）。壊れたファイルの控えを solo-records.yml.broken-数字 に残すので、元のファイルを直して /fpb reload してください。
統合版（Geyser）
ソロメニューはチェスト画面で表示・タップ操作できます。ネザースター（ソロメニュー）と時計（挑戦を終える）は使う動作の無いアイテムで、統合版の空中タップがサーバーに届かないため、空中タップ（腕振り） でも使えるようにしています（bedrock.swing-to-use）。ネザースターは 持ってスニーク でも開きます。lore の改行や色の見え方は実機で確認してください。
config.yml 設定項目¶
ゲーム基本設定（game）¶
| キー | 既定値 | 説明 |
|---|---|---|
default-duration |
5 | デフォルト制限時間（分） |
min-players |
1 | 開始に必要な最小参加人数（既定 1 で一人開催が可能。0人開始は常に不可） |
max-players |
20 | ロビー定員（0 以下で無制限） |
countdown-seconds |
5 | 開始前カウントダウン（秒） |
コンボ設定（combo）¶
| キー | 既定値 | 説明 |
|---|---|---|
timeout-seconds |
10 | コンボ継続判定時間（秒）。前回の釣りからこの時間内に釣るとコンボ継続 |
multipliers |
下記 | コンボ数ごとのポイント倍率 |
コンボ倍率（combo.multipliers）の既定値:
| コンボ数 | 倍率 |
|---|---|
| 3 | 1.2 |
| 5 | 1.5 |
| 7 | 1.8 |
| 10 | 2.0 |
ゴールデンタイム設定（golden-time）¶
| キー | 既定値 | 説明 |
|---|---|---|
enabled |
true | ゴールデンタイムを有効化するか |
duration-seconds |
30 | 持続時間（秒） |
multiplier |
2.0 | ポイント倍率 |
ゴールデンタイムの発生タイミング
ゴールデンタイムは1試合に一度だけ、ゲーム中盤（開始30秒後〜終了60秒前の範囲）でランダムに発生します。発生時刻を固定する設定はありません。
釣りスポット設定（fish-spot）¶
| キー | 既定値 | 説明 |
|---|---|---|
radius |
5 | 高ポイントゾーンの半径（ブロック） |
bonus-multiplier |
1.5 | ゾーン内で釣ったときのポイント倍率 |
基本ポイント設定（points）¶
釣れたアイテムごとの基本ポイントです。ここに無いアイテムはポイント0（ゴミ扱い）になります。
| キー | 既定値 |
|---|---|
COD（タラ） |
1 |
SALMON（サケ） |
2 |
PUFFERFISH（フグ） |
3 |
TROPICAL_FISH（熱帯魚） |
5 |
HEART_OF_THE_SEA（海洋の心） |
15 |
ENCHANTED_BOOK（エンチャント本） |
15 |
レアアイテム設定（rare-items）¶
rare-items に列挙したアイテムは、釣り上げると全体アナウンスされます。既定値は HEART_OF_THE_SEA と ENCHANTED_BOOK。
特殊アイテムドロップ率（special-items）¶
ゴミを釣ったときに特殊アイテムが出る確率（%）です。すべての値の合計が、特殊アイテムが出る全体確率になります。
| キー | 既定値（%） | アイテム |
|---|---|---|
ink-bomb |
3 | イカスミ爆弾 |
freeze-ball |
3 | 凍結弾 |
line-cutter |
2 | 釣り糸カッター |
lucky-bait |
2 | 幸運の餌 |
speed-bait |
3 | 加速エサ |
trap-float |
2 | トラップ浮き |
fish-beacon |
2 | 魚寄せビーコン |
魚を釣ったときの追加ドロップ
上記のドロップ率はゴミを釣ったときの判定に使われます。これとは別に、魚を釣ったときも一定確率で特殊アイテムが追加で手に入ります。その確率は下記 special-items-bonus.on-catch-chance で変更できます。
魚を釣ったときの追加ドロップ確率（special-items-bonus）¶
| キー | 既定値 | 説明 |
|---|---|---|
on-catch-chance |
5 | 魚を釣るたびに、追加で特殊アイテム抽選を行う確率（%） |
追加ドロップと通常ドロップの違い
- 通常ドロップ（
special-itemsセクション）: ゴミを釣ったときの当選確率。魚自体は手に入りません。 - 追加ドロップ（
special-items-bonus.on-catch-chance）: 魚（ポイント加算対象）を釣ったときに、まずポイントが入り、その上で抽選に当たれば追加で特殊アイテムも手に入ります。 - どちらの抽選も、当たった後にどの特殊アイテムが出るかは
special-itemsセクションの比率に従います。
特殊アイテム効果設定（item-effects）¶
| キー | 既定値 | 説明 |
|---|---|---|
ink-bomb-duration |
3 | イカスミ爆弾の盲目時間（秒） |
freeze-duration |
2 | 凍結弾の効果時間（秒） |
speed-bait-duration |
30 | 加速エサの効果時間（秒） |
speed-bait-luck-level |
2 | 加速エサで付与するLUCKレベル |
trap-duration |
60 | トラップ浮きの設置持続時間（秒） |
beacon-duration |
45 | 魚寄せビーコンの設置持続時間（秒） |
beacon-bonus |
1.3 | 魚寄せビーコンのポイントボーナス倍率 |
beacon-radius |
3.0 | 魚寄せビーコンの効果半径（ブロック）。小数指定可 |
魚寄せビーコンのアイテム説明文
配布される「魚寄せビーコン」アイテムの説明文（lore）に表示される効果半径・ボーナス倍率・設置時間は、item-effects の beacon-radius / beacon-bonus / beacon-duration の値から動的に生成されます（半径は整数に丸めて表示）。config を変更すれば説明文にも反映されます。
報酬設定（rewards）¶
ゲーム終了時に上位3名へ配る報酬です。それぞれ material（アイテム種別）・amount（個数）・name（表示名）を設定します。
| 順位 | 既定 material | 既定 amount |
|---|---|---|
first-place（優勝） |
EMERALD | 3 |
second-place（準優勝） |
EMERALD | 2 |
third-place（3位） |
EMERALD | 1 |
ソロモード（solo）¶
| キー | 既定値 | 説明 |
|---|---|---|
solo.enabled |
true | false でソロを無効にする（メニュー・ソロ看板から始められない） |
solo.menu-delay |
3 | 挑戦が終わってからソロメニューを開き直すまで（秒） |
solo.duration-seconds |
180 | 1回の挑戦の制限時間（秒。30〜3600） |
solo.countdown-seconds |
3 | 開始前のカウントダウン（秒） |
solo.max-concurrent |
4 | 同時に挑戦できる人数 |
solo.broadcast |
TOP | 全体告知。TOP＝今日の1位が更新されたとき／BIG＝大物ライン以上を釣ったとき／NONE＝流さない |
solo.ranking-size |
10 | /fpb solo top に表示する人数 |
solo.daily.timezone |
Asia/Tokyo | 日付の区切り（この時刻の0:00に出題が変わる） |
solo.daily.max-tries |
3 | 1日に挑戦できる回数（0＝無制限） |
solo.daily.avoid-repeat |
true | 前日と同じ魚を出さない |
solo.daily.keep-days |
7 | 日ごとの記録を残す日数 |
solo.daily.fish |
4種 | 出題する魚のリスト（上の「魚の調整」） |
solo.rewards.daily-clear |
EMERALD ×1 | その日初めて大物を釣ったときの報酬（amount: 0 で無し） |
solo.rewards.big-catch |
DIAMOND ×1 | その日初めて大物ライン以上を釣ったときの報酬（amount: 0 で無し） |
専用釣り竿設定（fishing-rod）¶
| キー | 説明 |
|---|---|
name |
配布される大会用釣り竿の表示名 |
lore |
釣り竿の説明文（複数行） |
その他のセクション¶
signs… 看板の位置（join/leave/solo/start.<識別子>）。setsignで自動更新されます。locations… エリア座標の保存先。/fpb setstartspawn/setlobby/setfield/setfishspotで自動更新されるため 手動編集は非推奨 です。messages… 各種ゲーム内メッセージとプレフィックス。文言を変更できます。
設定変更後は必ず /fpb reload
config.yml を編集したら /fpb reload を実行してください。ポイント配点・倍率・メッセージなどの変更が反映されます。
コマンド¶
/fpb コマンド自体はすべてのプレイヤーが実行でき、サブコマンドごとに権限が分かれています。地点・看板の設定系はプレイヤー（コンソール不可）として実行する必要があります。
プレイヤー用（全員可）¶
| コマンド | 説明 |
|---|---|
/fpb join / leave |
ロビーに参加 / 退出する（看板と同等。join は fpb.play＝既定全員） |
/fpb start [分] |
ゲームを開始（最小人数を満たせば誰でも可。分を省略すると default-duration、1〜60分で指定可） |
/fpb help / status |
ヘルプ表示 / 現在の状態・参加人数・座標設定状況を表示 |
/fpb solo |
ソロ「今日の大物」で参加してソロメニューを開く（fpb.play） |
/fpb solo start |
メニューを通さずにソロの挑戦を始める |
/fpb solo top |
今日の大物ランキング |
管理用（fpb.admin）¶
| コマンド | 説明 |
|---|---|
/fpb setstartspawn |
初期リスポーン地点を設定 |
/fpb setlobby |
待機ロビー地点を設定 |
/fpb setfield <1\|2> |
ゲームエリアの角を設定 |
/fpb setfishspot |
高ポイントゾーンを設定（任意） |
/fpb setsign <join\|leave\|solo\|start> |
視線先の看板を参加／退出／ソロ／開始看板として登録（テキストは自動書き込み） |
/fpb setsign delete |
視線先の看板の登録を解除 |
/fpb stop [main\|solo] [プレイヤー] |
強制停止。main＝大会、solo＝ソロ挑戦（プレイヤー指定で1人だけ）。省略時は進行中の方 |
/fpb solo reset <プレイヤー\|all> |
今日のソロの記録と挑戦回数を消す |
/fpb solo reroll |
今日の大物を選び直す（今日の記録はリセット） |
/fpb reload |
config.yml を再読み込み |
/fpb wand |
OP用の設定ツール（ブレイズロッド）を受け取る |
/fpb menu |
設定メニュー（GUI）を開く |
/fpb lobbyfix <プレイヤー> [force] |
ロビー退避データの復旧。入室前の持ち物が戻らないときに使う（force で退避データを破棄してロックのみ解除） |
権限ノード¶
| 権限 | 既定 | 用途 |
|---|---|---|
fpb.admin |
OP | setstartspawn / setlobby / setfield / setfishspot / setsign / stop / reload / wand / menu / solo reset / solo reroll / lobbyfix・他プレイヤー指定の join・leave の使用 |
fpb.play |
全員 | ゲームに参加できる（参加看板・/fpb join・ソロ看板・/fpb solo） |
開始看板・/fpb start は権限不要
start 系の操作（開始看板のクリック・/fpb start）には fpb.admin も fpb.play も不要で、誰でも最小参加人数を満たせばゲームを開始できます。
コマンド権限の設計
/fpb コマンド自体に権限制限はなく、サブコマンドごとに権限チェックします。join・leave・start・help・status は権限不要（全員可） で、参加・退出・開始は看板でもコマンドでも行えます。会場設定・stop・reload のみ fpb.admin が必要です。start には管理者権限は不要な点に注意してください。
ゲームの運営¶
- プレイヤーがロビー看板から参加し、
min-players（既定1人）以上集まるのを待つ。 /fpb statusで参加人数と座標設定を確認する。/fpb startまたは/fpb start <分>でゲームを開始する。- 異常時は
/fpb stopで強制終了する。
トラブルシューティング¶
/fpb start でゲームが開始できない
必須座標（初期リスポーン・ロビー・エリア角1/2）が未設定の可能性があります。/fpb status で各座標の設定状況を確認し、未設定の項目を /fpb setstartspawn / setlobby / setfield 1 / setfield 2 で設定してください。また参加者が min-players 未満の場合も開始できません。
/fpb start で「ソロ挑戦中の人がいます」と出る
釣り場は大会とソロで共用のため、ソロ挑戦中は大会を始められません。表示された時間（最長3分）待つか、/fpb stop solo でソロ挑戦を止めてください（止めた人の挑戦回数は戻ります）。
ソロの「大物に挑戦」が押せない
ソロメニューのアイコンに理由が出ます。釣り場が未設定（初期スポーン・ロビー・エリア角1/2）、大会中、満員（solo.max-concurrent）、今日の挑戦回数を使い切った、のどれかです。/fpb status の「ソロモード」欄でも状況を確認できます。
プレイヤーが看板でゲームに参加できない
看板が /fpb setsign join で登録されているか確認してください（/fpb status の「参加看板」欄で確認可能）。手書きで文字を書いただけの看板は機能しません。また、ロビー座標（/fpb setlobby）が設定されていないと参加できません。プレイヤーに fpb.play 権限があるかも確認してください。
ポイントが入らない・倍率が反映されない
points セクションに無いアイテムはポイント0になります。配点を変更したい場合は config.yml を編集し /fpb reload を実行してください。釣りスポット倍率は fishspot が設定済みで、その半径内で釣った場合のみ適用されます。
config.yml の変更が反映されない
編集後に /fpb reload を実行していない可能性があります。リロードを実行してください。なお locations セクションは設定コマンド（setstartspawn / setlobby / setfield / setfishspot）で管理されるため手動編集は推奨しません。