HakoniwaCore 鯖民向け説明書 (Alpha-4.0.0)

このサーバーの統合プラグイン「HakoniwaCore」の使い方をまとめた説明書です。特別な権限が無くても 使えるものと、管理者(op)や個別に権限を付与された人しか使えないものを分けて記載しています。 念のため、権限がないと使えないコマンドも「こういうことができる」という参考として載せています。

---

1. できること

• JE版・BE版(統合版)それぞれの銀行機能(入出金・送金・履歴確認)
• 作品(建築物)の登録・いいね・建築家フォロー・作品検索・宣伝・テレポート
• クイックワープ等をまとめたメインメニュー、お気に入り登録
• 施設(トラップタワー等)のサブスク契約・内見・経営状況確認
• Fly(飛行)機能(時間課金制)
• 建築ランクアップ時のDiscord通知(管理者用)
• 建築ランクに応じたプレイヤー名前の表示・一覧確認
• プレイ時間の計測・確認・時間到達報酬
• 作品登録・建築ランクアップ時のサーバー全体チャット告知
• いいね！の取り消し(看板の再クリック・コマンド・GUIいずれからでも可能)
• フォロー通知(新規作品登録の通知・フォローされた通知)のON/OFF個人設定
• 看板+チェストで作る「箱庭カプセルトイ」(チケット抽選、インベントリ満杯時は景品を保留して後から受け取り可能)
• プレイ時間の年・日・時間・分での表示、放置(AFK)時間の除外、ログイン時の告知(自分の累計時間・現在の オンライン人数)
• /hmenuからのクイックワープ(サーバー内の主要な場所への移動)
• 作品登録・いいねに応じた経済連携(サーバー設定次第で登録料の徴収・いいね報酬の獲得がある)
• いいねランキング上位3作品へのメダル表示
• 投票するとお金がもらえる投票報酬(サーバー設定次第)
• /htimeの累計プレイ時間報酬に、無料Fly時間・施設利用割引券タイプを追加
• BE銀行(/hbank-be)でもJE銀行と同じく取引履歴(history)を確認可能に
• サーバー側の設定でローン(借入)を長期間延滞すると、ペナルティ利息・預金からの自動天引きが行われる場合がある(既定は無効)

---

2. 誰でも使えるコマンド

Alpha-3.8.0で銀行コマンドの正式名称が/hbank・/hbank-beに変わりました。 旧名称の /bank・/be-bank・/atm・/beatmは引き続きエイリアス(短縮形・別名)として使えるため、 今まで通りのコマンドでも問題なく動作します。/fsubsのような短縮形は現在ありません(/hfsubsのみ)。

銀行(経済)

コマンド	できること
/hbank(/bank, /atm)	JE版の銀行メニューを開く(入出金・残高確認など)
/hbank history [from:yyyy-MM-dd] [to:yyyy-MM-dd] [min:<金額>] [max:<金額>]	取引履歴(送金/受取/預入/引出/ローン/利息)をチャットで表示する。フィルタ未指定時は直近20件、指定時は条件に合う最大100件を検索する
/hbank-be(/be-bank, /beatm)	BE版の銀行メニューを開く(統合版)
/hbank-be history [from:yyyy-MM-dd] [to:yyyy-MM-dd] [min:<金額>] [max:<金額>]	BE銀行の取引履歴を表示する(Alpha-4.0.0で新規追加、/hbank historyと同じ使い方)
/hmoney	自分の残高を確認する(下記「注意点」を参照。現時点では実際の所持金とは別の予備システムです)
/hmoney pay <プレイヤー名> <金額>	指定したプレイヤーへ送金する
/hmoney top [件数]	残高ランキングを表示する(省略時は上位10件)

プレイ時間

コマンド	できること
/htime	自分の累計プレイ時間を確認する
/htime <プレイヤー名>	指定プレイヤーの累計プレイ時間を確認する
/htime top [件数]	プレイ時間ランキングを表示する(省略時は上位10件)

いいね・作品紹介

コマンド	できること
/hl	いいね機能のメインコマンド(引数無しでメニュー起動等)
/hl follow <player>	指定した建築家をフォローする(新規作品登録時に通知が届く)
/hl unfollow <player>	フォローを解除する
/hl following	現在フォロー中の建築家一覧を表示する(開くとフォロー中建築家の新着通知は既読になります)
/hl unlike <作品ID>	送った「いいね！」を取り消す
/hl follownotify <on|off>	フォロー関連の通知(新規作品登録の通知・自分がフォローされた通知)を個人単位でON/OFFする(既定はON)
/hltp <id>	いいねした建築物へテレポートする(サーバー側の設定次第で料金がかかる、または連続実行にクールダウンがかかる場合がある)
/hladtp <token>	宣伝(広告)のチャットリンクをクリックした際に実行される、常に無料のテレポート(自分で番号を打ち込むものではなく、リンクをクリックして使う想定)
/hlmenu	いいねメニュー(プレイヤー検索・フォロー中一覧を含む)を開く
/hlplayer	自分が管理している作品一覧をGUIで表示する
/hlsearch <プレイヤー名> [likes|new]	指定プレイヤーの作品一覧をGUIで表示する(省略時はいいね数順、new指定で新着順)
/hlplayers	作品を登録しているプレイヤー一覧をGUIで表示する
/hlinfo <作品ID>	作品名・作者・共同編集者・いいね数・座標などの概要をチャットに表示する
/hlrank list	建築ランク一覧(ランクキー・表示名・色)を表示する
/hlrank <プレイヤー名>	指定プレイヤーの現在の建築ランクを表示する(オフライン時は確認不可)

箱庭カプセルトイ

/hcapsuletoyは/hctの短縮形です。どちらを使っても同じ結果になります。

コマンド	できること
/hcapsuletoy claim(/hct claim)	インベントリ満杯で受け取れなかった景品を受け取る

メインメニュー

コマンド	できること
/hmenu	クイックワープ等を含むメインメニューを開く
/hmenu favorites	お気に入り登録したメニュー項目だけを集めた一覧を開く

施設

コマンド	できること
/hfsubs menu	施設メニューをGUIで開く
/hfsubs list	施設の一覧(カタログ)を表示する
/hfsubs info [施設ID/プレイヤー名]	施設の詳細情報、または自分の経営ステータスを表示する
/hfsubs status	自分自身の経営ステータス(契約状況・現在の契約者数等)を確認する
/hfsubs history <施設ID>	自分がオーナーの施設について、過去の支払い履歴(年月・支給額)を確認する
/hfsubs subscribe <施設ID>	契約中の施設の自動更新をオンにする(期限が切れると次回エリア入場時に自動で支払われます)
/hfsubs unsubscribe <施設ID>	契約中の施設の自動更新をオフにする(期限が切れても自動では引き落とされなくなります)
/hfsubs tour [施設ID]	施設の内見を開始/終了する

Fly(飛行)

コマンド	できること
/hfly	飛行のオン/オフを切り替える(分単位で課金される場合あり)
/hfly on / /hfly off	飛行を有効化/無効化する
/hfly speed <1-10>	飛行速度を10段階で設定する
/hfly status	自分の飛行状態・速度・料金の目安を確認する

---

3. GUIメニューなどの非コマンド系操作

看板を使った作品登録・いいね

• 建築物の前などに看板を設置し、1行目にhakoniwa(サーバー側の設定次第で別の文字列の場合あり)と書くと、その建築物が作品として登録されます。2行目に作品名を入力できます(空欄の場合は「無名の箱庭」になります)
• 登録すると看板の表示が自動で書き換わり、3行目に作品ID、4行目に現在のいいね数が表示されます。登録後の看板は誰でも編集できないよう自動でロック(封蝋)されます
• 登録済みの看板を右クリックすると、その作品に「いいね！」を送れます(1人1回まで)
• 既に「いいね！」を送った看板をもう一度右クリックすると、「いいね！」を取り消せます(/hl unlike・GUIの「いいね！」ボタンからの取り消しも同じ扱いです)
• 作品のオーナーまたは共同編集者がShiftキーを押しながら看板を右クリックすると、管理メニュー(名前変更・共同編集者の追加/削除・宣伝など)がGUIで開きます
• 名前変更や共同編集者追加は、GUIでボタンを押した後にチャットへ直接入力する形式です(cancelと入力するといつでも中止できます)
• 作品を新規登録すると、サーバーに入っている全員のチャットへ告知が流れます(サーバー側の設定で 無効にされている場合は流れません)
• サーバー設定次第では、作品を新規登録する際に一定額(/hmoney残高)が徴収されます。残高が 足りない場合は登録できません。また、自分の作品にいいねをもらうたびに一定額の報酬が もらえる場合があります(同じ人から同じ作品への報酬は生涯1回までで、いいねの取り消し・ やり直しでは再度もらえません)

クイックワープメニュー

• /hmenuのメイン画面から「クイックワープ」ボタンでワープ先一覧を開けます。実際に登録されている warp名に合わせているため、サーバー側で新しい場所が追加された場合はこの一覧も更新されます

作品概要のGUI表示

• /hlmenu等から開く各作品の詳細メニューに「作品概要」ボックスがあります。クリックすると/hlinfoと同じ内容がチャットに表示されます

フォロー通知のON/OFFボタン

• /hlmenuのメイン画面に「フォロー通知」ボタンがあります。クリックするたびに有効/無効が切り替わり、 無効にすると新規作品登録の通知・自分がフォローされた通知の両方が届かなくなります (/hl follownotify on|offと同じ設定です)

いいねメニューの「フォロー中の建築家」ボタン

• /hlmenuを開くと、「フォロー中の建築家」ボタンに未読の新着(新規登録・宣伝)件数がバッジ表示されます
• ボタンを押してフォロー中一覧を開くと、その時点で既読になりバッジは消えます

いいねランキングのメダル表示

• /hmenuのランキングメニューを開くと、いいね数の全体順位1〜3位の作品名の先頭に 🥇🥈🥉のメダルが自動で表示されます。特別な操作は不要です

作品検索結果の並び替え

• /hlsearchや/hlmenuから開くプレイヤーの作品一覧画面に、並び替え切り替えボタンがあります
• クリックするたびに「いいね数順」と「新着順」が切り替わります(新着順は登録された順番=作品IDの新しい順です)

メニューのお気に入り登録

• /hmenuで開けるメニュー内の項目(ワープ・投票など)を、Shiftキーを押しながらクリックすると「お気に入り」に登録できます(もう一度Shift+クリックすると解除)
• /hmenu favoritesで、お気に入り登録した項目だけをまとめて表示・実行できます(最大36件まで)

箱庭カプセルトイの遊び方

• カプセルトイ機(看板+チェストのセット)の近くで、チケット(運営配布)を手に持った状態で看板を右クリックすると抽選します
• 当たった景品はインベントリへ自動的に送られます。インベントリに空きが無い場合は景品が保留され、 後から/hcapsuletoy claimでまとめて受け取れます(チケット自体はこの時点で消費済みです)
• ハズレの場合は何も渡されず、チケットのみ消費されます

施設GUIの自動更新オン/オフ

• 施設メニューの詳細画面から、契約中の施設の自動更新を「オン/オフにする」ボタンで切り替えられます(/hfsubs subscribe / unsubscribeと同じ操作)
• 施設のエリアに入っているあいだ、契約期限まで残り3日以内になるとチャットで警告が表示されます(1日1回まで)。自動更新中はそのまま何もしなければ次回入場時に自動で引き落とされ、自動更新をオフにしている場合は期限が切れると入場できなくなります

---

4. 主要コマンドの使い方の例

作品を登録していいねを集める

1. 建築物の前に看板を設置し、1行目にhakoniwa、2行目に作品名(例: 我が家)を書く
2. 看板の表示が自動的に書き換わり、作品IDが割り振られる
3. 他のプレイヤーが看板を右クリックすると「いいね！」が送られる
4. /hlinfo <作品ID>でいつでも作品概要(いいね数・座標等)を確認できる

気になる建築家をフォローする

1. /hl follow <プレイヤー名>でフォローする
2. 相手が新しい作品を登録すると通知が届き、/hlmenuの「フォロー中の建築家」ボタンにバッジが表示される
3. /hl following(またはボタン)を開くと一覧を確認でき、同時に既読になる

施設を契約して使う・自動更新を止める

1. /hfsubs listで施設一覧を確認し、気になる施設は/hfsubs tour <施設ID>で内見する
2. 施設のエリアに入ると自動的に契約・課金され、以後はエリアに入るたびに期限が延長される
3. 使わなくなったら/hfsubs unsubscribe <施設ID>で自動更新を止める(期限が切れても課金されなくなる)
4. 再度使いたくなったら/hfsubs subscribe <施設ID>で自動更新を再開する

---

5. よくある質問

• Q. 「権限がありません」と表示された → そのコマンドは下記7章に該当する管理者専用コマンドです。 必要であれば運営に相談してください。
• Q. /hladtpを自分で打っても使えない/すぐ使えなくなる → /hladtpは宣伝時にチャットへ届く 「クリックで無料テレポート」リンクをクリックして使うためのコマンドです。リンクに埋め込まれた トークンには有効期限(通常数分)があり、時間が経つと同じリンクは使えなくなります。改めて宣伝が 行われた際の新しいリンクを使ってください。
• Q. Flyを使うと課金される? → サーバー側の設定次第です。飛行中は一定時間ごとに料金がかかる 場合があります(/hfly statusで目安を確認できます)。クリエイティブ/スペクテイターモード中や、 hakoniwa.fly.free権限を持っている場合は課金されません。
• Q. /hltpでテレポートすると料金がかかることがある? → サーバー側の設定(teleport-fee)が 有効な場合、通常のいいねテレポートには料金がかかることがあります。ただし宣伝経由の/hladtpは 常に無料です。
• Q. /hltpを連打すると「クールダウン中です」と表示される → サーバー側の設定 (teleport-cooldown)が有効な場合、一定時間内の連続テレポートが制限されます。表示された秒数だけ 待ってから再度お試しください。宣伝経由の/hladtpはこの制限の対象外です。
• Q. フォロー中建築家のバッジ件数が減らない → /hlmenuの「フォロー中の建築家」ボタンを実際に クリックしてフォロー中一覧を開くと既読になります。ボタンを見ただけでは既読になりません。
• Q. /hmenu favoritesを開いても何も表示されない → まだお気に入りを登録していません。各メニューで お気に入りにしたい項目をShift+クリックしてから、改めて/hmenu favoritesを開いてください。
• Q. /hbank historyに何も表示されない → まだ取引履歴がありません。送金・受取・預入・引出・ ローンの借入/返済/利息のいずれかを行うと記録されます(フィルタ未指定時は直近20件までです)。
• Q. /bankや/be-bankと打っても使えなくなった? → 使えます。Alpha-3.8.0で正式名称が /hbank / /hbank-beに変わりましたが、/bank / /be-bank / /atm / /beatmは 今まで通りエイリアス(別名)として動作します。
• Q. /hfsubs unsubscribeした施設はどうなる? → 契約期限が切れても自動では引き落とされなくなり、 期限切れ後にエリアへ入ると施設外(ワールドスポーン)へ案内されます。再度利用したい場合は /hfsubs subscribe <施設ID>で自動更新をオンに戻してください。
• Q. 投票してもお金がもらえない → サーバー側の設定次第です(無効にされている場合があります)。 有効な場合は投票を検知した時点で自動的に付与され、特別なコマンド操作は不要です。
• Q. /htimeの報酬で無料Fly時間や割引券をもらったが、いつ使われる? → 無料Fly時間は /hflyを使っているあいだ自動的に消費され、通常の課金が一時的に発生しなくなります。 施設利用割引券は、次に施設の契約更新(自動課金)が発生したタイミングで自動的に適用されます。 どちらも自分で使うコマンドはありません。
• Q. ローンを借りたら「延滞しています」と通知が来た → サーバー側でローン延滞機能が有効化されて いる場合、借入から一定期間(既定7日)を過ぎても返済していないと、ペナルティ利息が上乗せされ、 預金残高から可能な範囲で自動的に天引きされます。詳しくは下記「注意点」を参照してください。

---

6. 注意点

• /hmoney / /hbank / /hbank-beのtake-all(一括没収)は、confirmを付けずに実行すると 対象人数・没収予定合計のプレビューのみが表示され、実際の没収は行われません。内容を確認してから confirmを付けて再実行してください。
• 作品登録料・いいね報酬・投票報酬・/htimeのfly時間/割引券報酬は、いずれもサーバー側の設定で 無効化・金額変更されている場合があります。金額が説明書と異なる場合はサーバー側の設定が優先されます。
• ローン延滞時の自動天引き・ペナルティ利息機能(サーバー側の設定で有効化されている場合のみ): 借入から一定期間(既定7日)を過ぎても返済していないローンには、一定間隔ごとにペナルティ利息 (既定2%)が上乗せされ、預金残高から可能な範囲(既定10%)で自動的に天引きされます。この機能は 既定では無効になっているため、有効化されているかどうかはサーバーの運営告知を確認してください。
• 施設のエリアに入ると、契約が切れていれば自動的に課金されます。残高不足の場合は課金されず、 施設外(ワールドスポーン)へ移動させられます。
• /hfsubs historyは施設のオーナー本人のみ確認できます(他プレイヤーの施設の履歴は見られません)。
• Alpha-3.4.1以降、/hlrankupは廃止されました。 建築ランクアップ関連の操作は すべて/hlrank up / /hlrank set / /hlrank announce(下記7章参照)に統合されています。
• /hmoneyで確認・操作できる残高は、現時点では実際の所持金(チェストショップ等での お買い物に使われる金額)とは別の、動作確認用の予備システムです。 サーバーの経済システムを 段階的に見直している最中のため、しばらくの間は/hmoneyと実際の所持金が一致しません。 実際のお買い物には引き続き通常通り所持金をお使いください。今後、切り替えが完了する タイミングでは事前にお知らせします。
• /htimeで計測されるプレイ時間は、/htime migrate-ontime(管理者が任意のタイミングで実行)を 実行するまでは0からのスタートです。既存のOnTimeプラグインが表示する時間とは別の記録として 進みます。
• Alpha-3.7.0以降、/htimeの表示は「〇時間〇分」固定ではなく、累計時間に応じて年・日・時間・分の 必要な単位のみ表示するようになりました(例: 1日未満なら「3時間20分」、1日を超えると「1日3時間20分」)。
• Alpha-3.7.0以降、座標移動が無いまま5分(既定値)以上放置していた時間は累計プレイ時間としてカウント されません。視点だけ動かす操作は放置解除とみなされません。
• Alpha-3.6.4以降、いいねメニュー操作中に想定外のエラーが起きた場合は、メニューがそのまま 固まるのではなく自動的に閉じてエラーメッセージが表示されるようになりました。表示された場合は もう一度操作をお試しください(改善しない場合は運営へご連絡ください)。
• 過去に発生した以下の不具合は修正済みです。同様の症状が再発した場合は運営へご連絡ください。
  • メニューGUI表示中に持っていたアイテムが消える不具合(Alpha-3.3.4で修正)
  • お気に入り登録のShift+クリック時にアイテムを持ち出したように見える表示不具合(Alpha-3.3.5で修正)
  • /hlrankupが実行できない不具合(Alpha-3.3.10で修正、管理者向けコマンド、Alpha-3.4.1で/hlrankup自体を廃止)

---

7. 管理者権限などが必要なコマンド

以下は管理者(op)や、個別に権限を付与された人専用のコマンドです。通常の鯖民は使えませんが、 「こういう管理ができる」という参考として一覧にしています。

いいね機能の管理(hakoniwa.like.admin、既定op)

コマンド	できること
/hl reload	いいね機能のconfigを再読み込みする
/hl sync	看板表示をDBの値で強制同期する
/hl refresh	全ての看板表示を作り直す
/hldiscord renotice	全登録作品をID番号順にDiscordへ一括再告知する
/hldiscord ranking	週間いいねランキングをDiscordへ即時送信する(通常は自動投稿だが、手動でも送れる)
/hlrank up <プレイヤー名> <ランクキー> [メンション対象DiscordID]	LuckPermsのランクグループ付与(/lp user <player> parent add <ランクキー>)を自動実行したうえで、建築ランクアップをDiscordへ通知する(通知にはランクごとの色が反映されます)。実行するとランクアップ一覧台帳・ランク記録(likes/player-ranks.yml)にも登録・更新され、サーバー全体のチャットへも告知される
/hlrank announce	台帳に登録されている全員のランクアップ一覧をまとめて1通のDiscord通知として送信する
/hlrank set <プレイヤー名> <ランクキー> [メンション対象DiscordID]	LuckPerms付与・Discordへの個別通知は行わず、/hlrank announceで告知する台帳への登録・更新だけを行う(後から追加・修正したい場合に利用)
/hlrank remove <プレイヤー名>	記録されているランク(likes/player-ranks.yml)を削除する。LuckPerms側のグループ付与には影響しない
/hlrank reload	建築ランクの定義(likes/ranks.yml)を再読み込みする

施設の管理(hakoniwa.fsubs.admin、既定op)

コマンド	できること
/hfsubs reload	施設configを再読み込みする
/hfsubs status <player>	他プレイヤーの経営ステータスを確認する(自分自身の確認は誰でも可)
/hfsubs history <施設ID>	自分がオーナーでない施設の支払い履歴も確認できる

Flyの管理(hakoniwa.fly.admin、既定op)

コマンド	できること
/hfly reload	Fly機能のconfigを再読み込みする
(権限保持者は課金対象外)	hakoniwa.fly.free権限を持つ人はFly課金が発生しない

独自Economy(/hmoney)の管理(hakoniwa.economy.admin、既定op)

コマンド	できること
/hmoney balance <プレイヤー名>	他プレイヤーの残高を確認する
/hmoney give <プレイヤー名> <金額|割合%>	指定したプレイヤーへ残高を付与する(例: 10%で対象の現在残高の10%分を追加)
/hmoney take <プレイヤー名> <金額|割合%>	指定したプレイヤーから残高を没収する(例: 10%で対象の現在残高の10%分を没収)
/hmoney take-all <金額|割合%> [min:<最低残高>] [confirm]	登録者全員、または一定残高以上の対象から一括で没収する。confirmを付けずに実行すると対象人数・没収予定合計のプレビューのみ表示される
/hmoney migrate-jecon [force]	Jeconが管理している所持金データを/hmoney側へ一括で取り込む(1回限り。再実行にはforceが必要)
/hmoney maintenance <on|off|status>	決済機能(/hmoney pay等)の一時停止/再開/状態確認
/hmoney supply	全プレイヤーの残高合計(マネーサプライ)、JE/BE銀行それぞれの預金・ローン残高合計を表示する

プレイ時間の管理(hakoniwa.time.admin、既定op)

コマンド	できること
/htime reload	プレイ時間報酬の定義(time/rewards.yml、AFK閾値・ログイン告知設定を含む)を再読み込みする
/htime migrate-ontime [force]	OnTimeが管理している累計プレイ時間データを一括で取り込む(1回限り。再実行にはforceが必要)

箱庭カプセルトイの管理(hakoniwa.capsuletoy.admin、既定op)

コマンド	できること
/hcapsuletoy list	登録済みのカプセルトイ機一覧を表示する
/hcapsuletoy modify <name>	カプセルトイ機に紐付けるチェストを変更する(実行後、対象チェストを右クリック)
/hcapsuletoy delete <name>	カプセルトイ機の登録を削除する
/hcapsuletoy ticket <プレイヤー名>	指定プレイヤーへチケットを1枚発行する
/hcapsuletoy reload	設定(capsuletoy/config.yml)を再読み込みする
/hcapsuletoy migrate [force]	旧プラグイン「HakoniwaCapsuleToy」のデータを一括移行する(1回限り。再実行にはforceが必要)

データベース・全体管理(hakoniwa.admin、既定op)

コマンド	できること
/hdb reload	データベース接続を再初期化する
/hknwcore	全モジュールのconfig再読み込みを含む管理者向けコマンド
/hbank migrate	旧バージョン(Alpha-3.7.0以前)のYAMLデータ(bank/players/)を一括移行する(通常は初回起動時に自動実行されるため、手動実行が必要になるのは移行漏れがあった場合のみ)
/hbank-be migrate	旧バージョンのYAMLデータ(bank/be_players/)を一括移行する(上記と同様、通常は自動実行される)
/hbank give <プレイヤー名> <金額|割合%>	指定したプレイヤーへ銀行残高を付与する
/hbank take <プレイヤー名> <金額|割合%>	指定したプレイヤーから銀行残高を没収する
/hbank take-all <金額|割合%> [min:<最低残高>] [confirm]	登録者全員、または一定残高以上の対象から一括で没収する(JE銀行)
/hbank-be give <プレイヤー名> <金額|割合%>	指定したプレイヤーへBE銀行残高を付与する
/hbank-be take <プレイヤー名> <金額|割合%>	指定したプレイヤーからBE銀行残高を没収する
/hbank-be take-all <金額|割合%> [min:<最低残高>] [confirm]	登録者全員、または一定残高以上の対象から一括で没収する(BE銀行)
/hbank-be syncparams	JE銀行の利息率・限度額・ローン延滞設定等をBE銀行へ一括反映する
/hknwcore audit [player:<名前>] [source:<種別>] [min:<金額>] [max:<金額>] [limit:<件数>]	bank/economy/facility/fly/ChestShop等を横断した金銭移動の監査ログを検索する
(銀行の管理機能)	hakoniwa.bank.admin / hakoniwa.bank.be.admin(既定op)で銀行の管理機能を使用できる
(メニューの管理機能)	hakoniwa.menu.admin(既定op)でメインメニューの管理機能を使用できる

---

8. 備考

• 2026年7月26日　初版公開（Alpha-3.3.0）
• Alpha-3.3.1で/hdb・/hknwcoreにタブ補完を追加(コマンド自体の使い方に変更はありません)
• Alpha-3.3.2でフォロー中建築家の新着通知バッジ(/hlmenu)と/hltpのクールダウン設定(既定無効)を追加
• Alpha-3.3.3で/bank history(送金履歴)、/hmenu favorites(メニューのお気に入り登録)、 /hlsearchの並び替えオプション(いいね数順/新着順)を追加
• Alpha-3.3.4でGUI表示中にアイテムが消失する不具合の修正、/bank historyの記録対象を 預入・引出・ローンの借入/返済まで拡大
• Alpha-3.3.5でお気に入り登録時にアイテムを持ち出したように見える表示不具合を修正
• Alpha-3.3.6で建築ランクアップのDiscord通知コマンド/hlrankupを追加
• Alpha-3.3.7で作品概要をチャット表示する/hlinfoコマンドとGUIボタンを追加
• Alpha-3.3.8で/hlrankup実行時にLuckPermsのランクグループ付与(/lp user <player> parent add <ランクキー>)を 自動実行するよう変更(コマンド一つで権限付与と告知が完結)
• Alpha-3.3.9で施設(/hfsubs)に期限切れ間近の通知・自動更新オン/オフ(subscribe/unsubscribe)・ 支払い履歴確認(history)・契約者数表示を追加。/fsubsの短縮エイリアスは廃止
• Alpha-3.3.10で/hlrankupが実行できない不具合(内部的な登録漏れ)を修正
• Alpha-3.3.11で建築ランクアップのDiscord通知に、ランクごとの色をEmbedの帯色として反映するよう修正
• 2026年8月10日、内容(バージョン番号)は据え置いたまま、鯖民向け説明書の章立てを全プラグイン共通の 8章構成(できること／誰でも使えるコマンド／非コマンド系操作／使い方の例／よくある質問／注意点／ 管理者向けコマンド／備考)へ再構成
• Alpha-3.3.12で/hlrankup list(ランクアップ一覧の一括Discord告知)を追加
• Alpha-3.3.13で/hlrankup register(Discord通知・LuckPerms付与を行わず台帳への登録のみ行う)を追加
• Alpha-3.3.14で建築ランク一覧・確認コマンド/hlrank、ランクに応じたプレイヤー名前の表示機能を追加
• Alpha-3.3.15で、Alpha-3.3.14で追加したプレイヤー名自体の文字色変更機能を廃止(名前前の ランク表示(Prefix)は変更なし)
• Alpha-3.3.16でランク表示(Prefix)の内部的な反映方式を変更(コマンド・見た目の変更はありません)
• Alpha-3.3.17で、opアカウントでランク表示が実際と異なるランクとして表示される不具合を修正
• Alpha-3.3.18で、プレイヤー名周りのランク表示(Suffix)をLuckPermsのグループ設定側に一本化し、 hakoniwa-core側からの重複した表示上書きを撤去(表示自体は引き続きLuckPerms側で行われます)
• Alpha-3.4.0で/hlrankupを廃止し、/hlrank up・/hlrank set・/hlrank announceへ統合
• Alpha-3.4.1で、一部環境でデータベース初期化エラーが発生していた不具合を修正 (鯖民が体感できる仕様変更はありません)
• Alpha-3.5.0で、経済システム(所持金)を外部プラグイン「Jecon」からhakoniwa-core自身へ 段階的に移行する準備として、/hmoney(残高確認・送金・ランキング)を追加。現時点では 動作確認用の予備システムであり、実際の所持金には影響しません(詳細は上記「注意点」参照)
• Alpha-3.5.1で、管理者向け移行コマンド(/hmoney migrate-jecon)実行時の内部的な安全策を 強化(鯖民が体感できる仕様変更はありません)
• Alpha-3.5.2で、管理者向けに決済機能を一時停止できる/hmoney maintenanceコマンドを追加 (メンテナンス作業中に決済のみを止めたい場合の対応で、通常時の動作に変更はありません)
• Alpha-3.6.0で、プレイ時間の計測・確認・時間到達報酬を行う/htimeを追加(外部プラグイン 「OnTime」の内製化。既存のOnTimeとは共存し、移行は/htime migrate-ontimeで任意に実行できます)
• Alpha-3.6.1で、/hlrank up実行時のランク付与記録(likes/player-ranks.yml)と、 記録削除コマンド/hlrank removeを追加(管理者向け、LuckPerms側のグループには影響しません)
• Alpha-3.6.2で、いいね機能の管理者コマンドの権限確認方法や内部処理を改善(鯖民が体感できる 仕様変更はありません)
• Alpha-3.6.3で、作品登録・建築ランクアップ時のサーバー全体チャット告知を追加(config設定で 文章変更・無効化可能)。あわせて/hltp / /hlinfoのタブ補完追加、コマンドメッセージの 内部整理を実施
• Alpha-3.6.4で、いいね！の取り消し(看板の再クリック・/hl unlike・GUI)、フォロー通知の ON/OFF個人設定(/hl follownotify・GUIボタン、自分がフォローされた際の通知も追加)、 いいねメニューの安定性向上(操作エラー時に固まらず自動で閉じるように改善)、 プレイヤー検索ボタンの「β版」表記削除を実施
• Alpha-3.7.0で、外部プラグイン「HakoniwaCapsuleToy」を内製化(/hcapsuletoy、看板+チェストの カプセルトイ機・チケット抽選・インベントリ満杯時の景品保留とclaim受け取り、旧プラグインからの データ移行/hcapsuletoy migrateに対応)。あわせて/htimeの表示を年・日・時間・分の可変表示に変更、 放置(AFK)時間を累計プレイ時間から除外、ログイン時に自分の累計プレイ時間とサーバーの現在 オンライン人数を告知する機能を追加
• Alpha-3.8.0で、JE銀行・BE銀行・独自Economy(/hmoney)の残高データベースを1つのファイル (economy/economy.db)へ集約(管理・バックアップの簡略化。各システムの残高そのものが 合算されるわけではなく、保存先が1ファイルにまとまる変更です)。あわせて銀行コマンドの 正式名称を/bank→/hbank、/be-bank→/hbank-beに変更(旧名称は引き続きエイリアスとして 利用可能)。/hmenuに「クイックワープ」メニューを追加
• Alpha-3.8.1で、/hmoney give / /hmoney takeを割合指定(例: 10%)に対応(管理者向け、 鯖民が体感できる仕様変更はありません)
• Alpha-3.8.2で、/hmoney / /hbank / /hbank-beに一括没収コマンド(take-all)を追加。 あわせて/hbank / /hbank-beにも/hmoneyと同様のgive / take(割合指定対応)を追加。 経済系DBのファイル名をeconomy.db→bank_economy.dbへ変更(旧ファイルは削除せずそのまま 残す)。/hmenuの権限判定・お気に入り登録・メニュー遷移まわりの内部的な不具合を修正 (これまで/hmenuが開けなかった場合は、この修正で開けるようになった可能性があります)
• Alpha-3.9.0で、作品登録料・いいね報酬(サーバー設定次第で有効)を追加し、いいねランキング 上位3作品にメダル表示を追加。投票するとお金がもらえる投票報酬を追加。/htimeの累計プレイ時間 報酬に、無料Fly時間・施設利用割引券のタイプを追加(いずれもサーバー側の設定に応じた内容で、 鯖民が新しく覚える操作はありません) （Alpha-3.9.0版はこちら）
• Alpha-4.0.0で、/hbank history / /hbank-be historyが期間・金額でのフィルタ検索に対応(新規、 /hbank-be history自体もこのバージョンで新規追加)。ローンを長期延滞した場合にペナルティ利息・ 預金からの自動天引きが行われる機能を追加(サーバー側の設定で有効化されている場合のみ、既定は 無効)。経済システムの内部実装をJeconから完全移行(鯖民が体感できる仕様変更はありません)