HakoniwaStore 鯖民向け説明書 (Alpha-0.3.5)

見た目を彩る「箱庭エフェクト」プラグインの遊び方に加え、今回のバージョンから「箱庭クラフト ストア」の支援段階(寄付段階称号)の遊び方も紹介します。どちらも見た目・演出だけの機能で、 強さやゲームバランスには一切影響しません。/heffectは/hakoniwaeffectの、/hstoreは /hakoniwastoreの短縮形です。どちらを使っても同じ結果になります(以降の説明では長い形で 統一して表記します)。

WARNING

本書に記載の内容が、当サーバーの実際の設定・運用状況とは異なっている場合があります。 ご利用の際は、実際にコマンドを実行して動作をご確認いただくようお願いします。実行結果に ついては本書内で説明していますので、内容をご理解のうえで実行してください。実行によって 生じた不利益について、運営チームは責任を負いかねます。

1. できること

• 移動・ジャンプ・ブロック破壊・攻撃のときにパーティクル演出を発動できる(トリガーごとに 最大4種類まで同時有効化可能)
• お気に入り(プリセット)機能で、複数エフェクトの組み合わせに名前を付けて保存・呼び出しできる
• 他のプレイヤーのエフェクトの見え方を、自分だけ非表示に調整できる
• 友達にエフェクトをプレゼントできる(ゲーム内通貨サーバー・実マネー決済サーバーいずれも対応)
• 装飾パス(そよ風/きらめき/万華鏡)は1回の購入につき30日間有効。自動更新はされないため、 期限が切れる前に同じパス以上を再度購入すると、有効期限が延長されます
• 発動回数の統計やよく使うエフェクトの内訳を確認でき、一定回数を超えると称号がもらえる
• サーバー混雑時は演出が自動的に控えめになり、サーバー全体の快適さを保つ
• 累計支援額に応じた「支援段階」を購入・確認できる。既に支援段階を持っている場合は 次の段階との差額のみで済む(1回の購入につき30日間有効。有効期間内に追加購入すると 期限が延長されます)

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>	ゲーム内通貨サーバーで30日間購入する(有効期間内の再購入で延長)
/hakoniwaeffect unsubscribe <エフェクトID>	(Alpha-0.3.0以降、自動更新が廃止されたため実際の解約処理は行いません。案内メッセージのみ)
/hakoniwaeffect trial	ゲーム内通貨サーバーでお試しセットを1日体験する
/hakoniwaeffect usage	自分の発動回数の統計・称号までの残り回数を確認する
/hakoniwastore status [プレイヤー名]	現在の支援段階・次の段階までの差額を確認する
/hakoniwastore buy <段階ID>	ゲーム内通貨で支援段階を購入する(差額のみ課金)
/hakoniwastore gift <プレイヤー名> <段階ID>	他のプレイヤーへ支援段階を贈る(代金は自分が支払う)
/hakoniwastore title <on|off>	称号表示のON/OFFを切り替える(一定以上の段階が必要。表示されるかはサーバーの設定次第、下記「GUIメニューの操作」参照)
/hakoniwastore titlecolor <カラーコード>	称号色をカスタム指定する(一定以上の段階が必要)

buy/subscribe/unsubscribe/trialはゲーム内通貨で購入できるサーバーのみで使えます。 実マネー決済(独自Shop)のサーバーでは、購入はストア側の画面から行います。支援段階も同様に、 ゲーム内通貨(/hakoniwastore buy)と実マネー決済(箱庭クラフトストアの画面)の両方で購入できます。

3. GUIメニューの操作

/hakoniwaeffect gui

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

• 持っているエフェクトをクリックすると有効化されます。もう一度クリックすると無効化できます
• カテゴリ一覧画面には、契約中(無期限/残り日数)やトライアル中の状態が表示されます
• ゲーム内通貨で購入できるサーバーでは、カテゴリ一覧画面に「一発お試し」ボタン(ネザースター)が あり、クリックだけで最高プランのエフェクトを1日お試しできます
• 装飾パスの称号(名札アイテム)と、発動回数に応じた使用回数称号(プレイヤーの頭アイテム)は、 それぞれ別のアイテムとして/hakoniwaeffect guiの画面上に並んで表示されます(2026-08-12〜)。 どちらもチャットには表示されません。所持していない/未達の場合はそのアイテム自体が 表示されません

支援段階のGUIはまだ用意されていません。/hakoniwastore statusで確認してください。

支援段階の称号は、サーバーの設定によってはチャット・タブリスト・頭上の名前(ネームプレート)へ 表示される場合があります(表示されるかどうかはサーバーの設定次第で、必ず表示されるとは 限りません。詳しくは運営のお知らせを確認してください)。

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

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

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

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

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

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

支援段階を購入する(段階的な例)

1. まず/hakoniwastore statusで自分の現在の段階を確認します。
2. 購入したい段階が決まったら/hakoniwastore buy tier3のように、段階IDを指定して購入します。
3. 既に下位の段階を持っている場合、支払うのは「その段階までの差額」だけです。全額を再度 支払う必要はありません。
4. /hakoniwastore title on・/hakoniwastore titlecolor &bのようなコマンドで称号表示・ 称号色を設定できます。サーバーの設定によっては、チャットやタブリスト等に反映されます。

Webサイト(箱庭クラフトストア)から購入する場合も、購入先プレイヤー名を入力すると同じ差額計算が 働きます。

5. よくある質問

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

Q. 支援段階に有効期限はありますか? A. あります。1回の購入につき30日間有効です。有効期間内に同じ段階以上を追加購入すると、 有効期限が購入日数分延長されます。期限が切れると称号は自動的に非表示になります(装飾パスと 同様、こちらも期限のある商品です)。

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

Q. 支援段階のtitle/titlecolorコマンドを実行しても見た目が何も変わりません。 A. 不具合の可能性もありますが、多くの場合はサーバー側でまだ表示設定が有効になっていないことが 原因です。運営にお問い合わせください。

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

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通知を即時テスト送信する
/hakoniwastore grant <プレイヤー名> <段階ID>	支援段階を手動で付与する(Google Formでの申込確認後などに使用)
/hakoniwastore reload	config.ymlの支援段階設定を再読み込みする(2026-08-12追加)

8. 備考

• Alpha-0.1.0: 「箱庭クラフトストア」の支援段階(寄付段階称号)機能を追加。 別プラグイン (hakoniwa-store)として分離検討していたものを、hakoniwa-effect本体・Webサイト (stripe-relay)・Webhookエンドポイントへ完全統合し、/hakoniwastoreコマンドとして実装した。 装飾パスの権利データとは別ファイル(support-entitlements.yml)で管理するため、既存の 装飾パスの動作・所持状況には一切影響しない。
• Alpha-0.1.1: 装飾パスのセット称号(「[そよ風]」等)のチャット表示を廃止し、使用回数称号と 同じくGUI(/hakoniwaeffect gui)限定表示へ統合。以前チャットに出ていた称号は、これ以降 GUIのカテゴリ一覧画面(名札アイテム)でのみ確認できる。（Alpha-0.1.1版はこちら）
• Alpha-0.2.0: 支援段階を「無期限買い切り」から「30日間有効・追加購入で延長」方式へ変更。 称号がチャット・タブリスト・ネームプレートへ表示できるようになった(サーバーの設定次第)。 既存の支援段階保持者は、このバージョンの適用と同時に有効期限切れ扱いとなるため、 再購入が必要になる場合があります。（Alpha-0.2.0版はこちら）
• Alpha-0.3.0: 装飾パス(そよ風/きらめき/万華鏡)を「月額自動更新サブスクリプション」から 「30日間有効・追加購入で延長」方式へ変更。既に月額契約中の方は、しばらくの間は従来通り 自動更新される場合があります(運営からの案内をご確認ください)。（Alpha-0.3.0版はこちら）
• Alpha-0.3.1: 支援段階の表示名を「○円箱」で確定(例: 100円箱)。ストアサイトのロゴ・アイコンを 正式デザインへ更新。（Alpha-0.3.1版はこちら）
• Alpha-0.3.2: サーバー内部の不具合修正(称号が無いプレイヤーの表示に一部影響していた問題を 解消)。遊び方・コマンドに変更はありません。（Alpha-0.3.2版はこちら）
• Alpha-0.3.3: 称号の反映方法を整理しました(PlaceholderAPI経由のみに統一)。遊び方・コマンドに 変更はありません。（Alpha-0.3.3版はこちら）
• Alpha-0.3.4: サーバー運営側の設定変更です。ゲーム内通貨での支援段階購入(/hakoniwastore buy・ gift)が一時的に停止される場合があります(独自Webショップでの購入は影響を受けません)。 （Alpha-0.3.4版はこちら）
• Alpha-0.3.5: /hakoniwaeffect guiの情報アイテムが、装飾パスの称号と使用回数称号の2枠に 分かれて表示されるようになりました。遊び方・コマンドの基本的な使い方に変更はありません。