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

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

WARNING

本書の記載内容には、当サーバーの現在の設定・運用状況に適用されていないものが一部含まれる可能性があります。実際にお使いになる際は、コマンド等をご自身で実行し、動作をご確認いただくようお願いいたします。 なお、実行するとどうなるかについては本書内でしっかりと説明していますので、それをご確認・ご理解いただいたうえでの実行によって生じた被害等について、運営チームは責任を負いません。

---

1. できること

• JE版・BE版(統合版)それぞれの銀行機能(入出金・送金・履歴確認)
• 作品(建築物)の登録・いいね・建築家フォロー・作品検索・宣伝・テレポート
• クイックワープ等をまとめたメインメニュー、お気に入り登録
• 施設(トラップタワー等)のサブスク契約・内見・経営状況確認
• Fly(飛行)機能(時間課金制)
• 建築ランクアップ時のDiscord通知(管理者用)
• 建築ランクに応じたプレイヤー名前の表示・一覧確認
• プレイ時間の計測・確認・時間到達報酬
• 作品登録・建築ランクアップ時のサーバー全体チャット告知
• いいね！の取り消し(看板の再クリック・コマンド・GUIいずれからでも可能)
• フォロー通知(新規作品登録の通知・フォローされた通知)のON/OFF個人設定

---

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

/atmは/bankの短縮形です。どちらを使っても同じ結果になります。同様に/beatmは/be-bankの 短縮形です。/fsubsのような短縮形は現在ありません(/hfsubsのみ)。

銀行(経済)

コマンド	できること
/bank(/atm)	JE版の銀行メニューを開く(入出金・残高確認など)
/bank history	直近20件の取引履歴(送金/受取/預入/引出/ローン)をチャットで表示する
/be-bank(/beatm)	BE版の銀行メニューを開く(統合版)
/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 <プレイヤー名>	指定プレイヤーの現在の建築ランクを表示する(オフライン時は確認不可)

メインメニュー

コマンド	できること
/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と入力するといつでも中止できます)
• 作品を新規登録すると、サーバーに入っている全員のチャットへ告知が流れます(サーバー側の設定で 無効にされている場合は流れません)

作品概要のGUI表示

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

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

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

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

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

作品検索結果の並び替え

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

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

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

施設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. /bank historyに何も表示されない → まだ取引履歴がありません。送金・受取・預入・引出・ ローンの借入/返済のいずれかを行うと記録されます(表示されるのは直近20件までです)。
• Q. /hfsubs unsubscribeした施設はどうなる? → 契約期限が切れても自動では引き落とされなくなり、 期限切れ後にエリアへ入ると施設外(ワールドスポーン)へ案内されます。再度利用したい場合は /hfsubs subscribe <施設ID>で自動更新をオンに戻してください。

---

6. 注意点

• 施設のエリアに入ると、契約が切れていれば自動的に課金されます。残高不足の場合は課金されず、 施設外(ワールドスポーン)へ移動させられます。
• /hfsubs historyは施設のオーナー本人のみ確認できます(他プレイヤーの施設の履歴は見られません)。
• Alpha-3.4.1以降、/hlrankupは廃止されました。 建築ランクアップ関連の操作は すべて/hlrank up / /hlrank set / /hlrank announce(下記7章参照)に統合されています。
• /hmoneyで確認・操作できる残高は、現時点では実際の所持金(チェストショップ等での お買い物に使われる金額)とは別の、動作確認用の予備システムです。 サーバーの経済システムを 段階的に見直している最中のため、しばらくの間は/hmoneyと実際の所持金が一致しません。 実際のお買い物には引き続き通常通り所持金をお使いください。今後、切り替えが完了する タイミングでは事前にお知らせします。
• /htimeで計測されるプレイ時間は、/htime migrate-ontime(管理者が任意のタイミングで実行)を 実行するまでは0からのスタートです。既存のOnTimeプラグインが表示する時間とは別の記録として 進みます。
• 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 <プレイヤー名> <金額>	指定したプレイヤーへ残高を付与する
/hmoney take <プレイヤー名> <金額>	指定したプレイヤーから残高を没収する
/hmoney migrate-jecon [force]	Jeconが管理している所持金データを/hmoney側へ一括で取り込む(1回限り。再実行にはforceが必要)
/hmoney maintenance <on|off|status>	決済機能(/hmoney pay等)の一時停止/再開/状態確認

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

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

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

コマンド	できること
/hdb reload	データベース接続を再初期化する
/hknwcore	全モジュールのconfig再読み込みを含む管理者向けコマンド
(銀行の管理機能)	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.3版はこちら）
• Alpha-3.6.4で、いいね！の取り消し(看板の再クリック・/hl unlike・GUI)、フォロー通知の ON/OFF個人設定(/hl follownotify・GUIボタン、自分がフォローされた際の通知も追加)、 いいねメニューの安定性向上(操作エラー時に固まらず自動で閉じるように改善)、 プレイヤー検索ボタンの「β版」表記削除を実施
• Alpha-3.6.4で、いいね！の取り消し(看板の再クリック・/hl unlike・GUI)、フォロー通知の ON/OFF個人設定(/hl follownotify・GUIボタン、自分がフォローされた際の通知も追加)、 いいねメニューの安定性向上(操作エラー時に固まらず自動で閉じるように改善)、 プレイヤー検索ボタンの「β版」表記削除を実施