HakoniwaEffect 鯖民向け説明書 (Alpha-0.4.3)

見た目を彩る「箱庭エフェクト」プラグインの遊び方を紹介します。移動・ジャンプ・ブロック破壊・ 攻撃のときに、購入したパーティクル演出が発動します。見た目だけの機能で、強さやゲームバランスには 一切影響しません。/heffectは/hakoniwaeffectの短縮形です。どちらを使っても同じ結果になります (以降の説明では/hakoniwaeffectの形で統一して表記します)。

WARNING

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

---

1. できること

• 移動・ジャンプ・ブロック破壊・攻撃のときにパーティクル演出を発動できる(トリガーごとに 最大4種類まで同時有効化可能)
• お気に入り(プリセット)機能で、複数エフェクトの組み合わせに名前を付けて保存・呼び出しできる
• 他のプレイヤーのエフェクトの見え方を、自分だけ非表示に調整できる
• 友達にエフェクトをプレゼントできる(ゲーム内通貨サーバー・実マネー決済サーバーいずれも対応)
• 発動回数の統計やよく使うエフェクトの内訳を確認でき、一定回数を超えると称号がもらえる
• サーバー混雑時は演出が自動的に控えめになり、サーバー全体の快適さを保つ

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

コマンド	説明
/hakoniwaeffect list	持っているエフェクトの一覧を確認する
/hakoniwaeffect set <エフェクトID>	指定したエフェクトを有効化する
/hakoniwaeffect off <トリガー種別>	指定したトリガー(移動/ジャンプ/破壊/攻撃)の演出を無効化する
/hakoniwaeffect gui	エフェクト選択GUIを開く
/hakoniwaeffect hide <none|heavy|all>	他プレイヤーのエフェクトの見え方を調整する
/hakoniwaeffect preset save|load|list|delete <名前>	エフェクトの組み合わせを保存・呼び出しする
/hakoniwaeffect gift <プレイヤー名> <エフェクトID> [個数]	ゲーム内通貨サーバーで友達にエフェクトをプレゼントする
/hakoniwaeffect buy <エフェクトID> [個数]	ゲーム内通貨サーバーでエフェクトを購入する(単発)
/hakoniwaeffect subscribe <エフェクトID>	ゲーム内通貨サーバーで月額サブスク購入する
/hakoniwaeffect unsubscribe <エフェクトID>	月額サブスクを解約する
/hakoniwaeffect trial	ゲーム内通貨サーバーでお試しセットを1日体験する
/hakoniwaeffect usage	自分の発動回数の統計・称号までの残り回数を確認する

buy/subscribe/unsubscribe/trialはゲーム内通貨で購入できるサーバーのみで使えます。 実マネー決済(Tebex/独自Shop)のサーバーでは、購入はストア側の画面から行います。

3. GUIメニューの操作

/hakoniwaeffect gui

カテゴリ一覧画面(移動・ジャンプ・破壊・攻撃)が開きます。カテゴリを選ぶと、そのトリガーで 使えるエフェクトの一覧画面に移ります。

• 持っているエフェクトをクリックすると有効化されます。もう一度クリックすると無効化できます
• カテゴリ一覧画面には、契約中(無期限/残り日数)やトライアル中の状態が表示されます
• ゲーム内通貨で購入できるサーバーでは、カテゴリ一覧画面に「一発お試し」ボタン(ネザースター)が あり、クリックだけで最高プランのエフェクトを1日お試しできます
• 称号は/hakoniwaeffect guiの画面上(名札アイテム)でのみ確認できます。チャットには 表示されません

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

お気に入り(プリセット)を保存して呼び出す

複数のエフェクトを組み合わせて使っている場合、その組み合わせに名前を付けて保存できます。

/hakoniwaeffect preset save おでかけ用     今の組み合わせを「おでかけ用」として保存
/hakoniwaeffect preset load おでかけ用     保存した組み合わせを一発で呼び出す
/hakoniwaeffect preset list                保存した名前の一覧を見る
/hakoniwaeffect preset delete おでかけ用   保存した組み合わせを削除する

「普段用」「イベント用」のように複数パターンを保存しておけば、毎回1つずつ選び直す必要が なくなります。

他のプレイヤーのエフェクトを非表示にする

街中でエフェクト持ちのプレイヤーが多いと感じたら、自分の見え方だけを調整できます (自分自身のエフェクトは常に見えます)。

/hakoniwaeffect hide none    全員のエフェクトを表示する(既定)
/hakoniwaeffect hide heavy   「重め」の派手な演出だけ非表示にする
/hakoniwaeffect hide all     他プレイヤーのエフェクトを全て非表示にする

エフェクトをプレゼントする

ゲーム内通貨で購入できるサーバーでは、/hakoniwaeffect gift <プレイヤー名> <エフェクトID> [個数]で、自分の残高から支払って友達にエフェクトをプレゼントできます。実マネー決済(独自Shop)の サーバーでは、購入フォームのユーザー名欄に贈りたい相手のユーザー名を入力するだけでプレゼント 購入ができます。

5. よくある質問

Q. エフェクトを使うと強くなったり有利になったりしますか? A. いいえ。見た目だけの機能で、強さやゲームバランスには一切影響しません。

Q. 称号がチャットに出ないのですが不具合ですか? A. 不具合ではありません。称号は/hakoniwaeffect guiの画面上でのみ確認できる仕様です。

Q. エフェクトが急に出なくなりました。 A. サーバー混雑時の自動調整の可能性があります。下記「注意点」を参照してください。

Q. エフェクトはどこで手に入りますか? A. サーバーの案内(Tebex/独自Shop/ゲーム内通貨での購入案内)に従ってください。無料試用期間や 季節限定の特典が実施される場合は、その都度サーバー内でお知らせします。

6. 注意点

• サーバーの動作が重い時間帯は、動きながら出るエフェクト(移動トリガー)や派手めの演出が 一時的に控えめになったり出なくなったりすることがあります。これはサーバー全体を快適に保つための 自動調整で、故障や不具合ではありません。混雑が解消すれば自動的に元通りになります
• 無料試用期間や季節限定の特典は、開始・終了からしばらくの間は、ログインするたびにお知らせが 表示されます(その瞬間サーバーにいなかった方にも情報が届くようにするためです)

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

コマンド	説明
/hakoniwaeffect grant <プレイヤー名> <エフェクトID> [日数]	エフェクトを付与する
/hakoniwaeffect revoke <プレイヤー名> <エフェクトID>	エフェクトを剥奪する
/hakoniwaeffect grantset <プレイヤー名> <セットID>	セット単位でまとめて付与する
/hakoniwaeffect revokeset <プレイヤー名> <セットID>	セット単位でまとめて剥奪する
/hakoniwaeffect usage <プレイヤー名>	他プレイヤーの使用統計を確認する
/hakoniwaeffect usagetop	サーバー全体の使用回数ランキング(TOP10)を確認する
/hakoniwaeffect stats	エフェクトごとの所持者数ランキングを確認する
/hakoniwaeffect verify	config.ymlの設定不整合を検査する
/hakoniwaeffect reload	config.ymlを再読み込みする
/hakoniwaeffect freecampaign <on|off|status>	無料試用期間を手動切替・確認する
/hakoniwaeffect admintest	Discord通知を即時テスト送信する

8. 備考

• 2026年8月6日　初版公開（Alpha-0.3.5）（Alpha-0.3.5版はこちら）
• 2026年8月7日　無料試用期間・季節限定エフェクトの開始/終了お知らせを、ログインのたびに表示するよう改善（Alpha-0.3.6、docs-v2への個別配置はなし）
• 2026年8月7日　ジャンプエフェクトが発動しないことがある不具合を修正、GUIに「一発お試し」ボタンを追加（Alpha-0.3.7）（Alpha-0.3.7版はこちら）
• 2026年8月7日　サーバー混雑時にエフェクトを自動的に控えめにする機能を追加、追従お供のパーティクルが静止中も出続けていた不具合を修正（Alpha-0.3.8）（Alpha-0.3.8版はこちら）
• 2026年8月7日　エフェクトのプレゼント機能、使用回数・称号機能を追加（Alpha-0.4.0、docs-v2への個別配置はなし）
• 2026年8月7日　無料試用期間中に誤って課金されてしまう不具合を修正（Alpha-0.4.1、docs-v2への個別配置はなし）
• 2026年8月7日　称号の確認場所をGUI限定に変更、使用回数の内訳に構成比(%)を追加（Alpha-0.4.2）（Alpha-0.4.2版はこちら）
• 2026年8月9日　「虹色ブレイク」が実際は2色にしかならなかった不具合を修正し、全色相を巡回する虹色になるようにしました（Alpha-0.4.3）（構成変更前の版はこちら）
• 2026年8月10日　バージョン番号は据え置きのまま、全プラグイン共通の8章構成テンプレートに沿って構成を整理しました。内容の変更はありません