HakoniwaStore 鯖民向け説明書 (Alpha-0.5.1)
見た目を彩る「箱庭エフェクト」プラグインの遊び方に加え、今回のバージョンから「箱庭クラフト ストア」の支援段階(寄付段階称号)の遊び方も紹介します。どちらも見た目・演出だけの機能で、 強さやゲームバランスには一切影響しません。/heffectは/hakoniwaeffectの、/hstoreは /hakoniwastoreの短縮形です。どちらを使っても同じ結果になります(以降の説明では長い形で 統一して表記します)。
1. できること
- 移動・ジャンプ・ブロック破壊・攻撃のときにパーティクル演出を発動できる(トリガーごとに 最大4種類まで同時有効化可能)
- お気に入り(プリセット)機能で、複数エフェクトの組み合わせに名前を付けて保存・呼び出しできる
- 他のプレイヤーのエフェクトの見え方を、自分だけ非表示に調整できる
- 友達にエフェクトをプレゼントできる(ゲーム内通貨サーバー・実マネー決済サーバーいずれも対応)
- 装飾パス(そよ風/きらめき/万華鏡)は1回の購入につき30日間有効。自動更新はされないため、 期限が切れる前に同じパス以上を再度購入すると、有効期限が延長されます
- 発動回数の統計やよく使うエフェクトの内訳を確認でき、一定回数を超えると称号がもらえる
- サーバー混雑時は演出が自動的に控えめになり、サーバー全体の快適さを保つ
- 累計支援額に応じた「支援段階」を購入・確認できる。既に支援段階を持っている場合は 次の段階との差額のみで済む(1回の購入につき30日間有効。有効期間内に追加購入すると 期限が延長されます)
- 「ガチャ」で装飾エフェクトが抽選で手に入る(Alpha-0.4.10で追加)。 当たったエフェクトは 永久に使用できます。詳しくは下記「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> | ゲーム内通貨サーバーで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 他プレイヤーのエフェクトを全て非表示にする支援段階を購入する(段階的な例)
- まず
/hakoniwastore statusで自分の現在の段階を確認します。 - 購入したい段階が決まったら
/hakoniwastore buy tier3のように、段階IDを指定して購入します。 - 既に下位の段階を持っている場合、支払うのは「その段階までの差額」だけです。全額を再度 支払う必要はありません。
/hakoniwastore title on・/hakoniwastore titlecolor &bのようなコマンドで称号表示・ 称号色を設定できます。サーバーの設定によっては、チャットやタブリスト等に反映されます。
Webサイト(箱庭クラフトストア)から購入する場合も、購入先プレイヤー名を入力すると同じ差額計算が 働きます。
ガチャを引く(Alpha-0.4.10で追加)
ガチャはゲーム内コマンドではなく、箱庭クラフトストアのWebサイトから購入します。
- ストアサイトの「ガチャ」カテゴリから「箱庭ガチャ(1回)」または「箱庭ガチャ(5回セット)」を選びます。
- 商品詳細ページで排出確率を確認できます(下表参照)。
- カートに追加してStripeで決済すると、決済完了後すぐに抽選が行われ、当たった装飾が自動で プレイヤーへ付与されます。ゲーム内で何かコマンドを打つ必要はありません。
ガチャの排出確率(2026-09-21時点、変更する場合は本ドキュメント・ストアサイトの両方を更新します)
| 区分 | 内容 | 合計確率 |
|---|---|---|
| 通常(既存の軽めエフェクト、8種) | ソウルの足跡・ふわり上昇ジャンプ・水泡の軌跡・花びらの軌跡・砂ぼこりの弾け・流星ジャンプ・木の葉の飛散・灰の煙 | 48% |
| 通常(既存の中程度エフェクト、4種) | 炎の軌跡・さざ波の軌跡・花火ジャンプ・呪いの一撃 | 24% |
| ガチャ限定(新規エフェクト、6種) | 不死鳥の加護・共鳴の一撃・疾風のジャンプ・ハートの足跡・白煙の軌跡・凶兆の残滓 | 24% |
| ジャックポット | 支援段階「100円箱」(30日分) | 4% |
「はずれ」はありません(必ず何らかの装飾が手に入ります)。特定の組み合わせを揃える必要がある コンプガチャ形式ではなく、1回ごとに独立した抽選です。当たった個別エフェクトは永久に 使用できます(装飾パスと異なり有効期限はありません)。ガチャ限定エフェクトは装飾パス (そよ風/きらめき/万華鏡)には含まれておらず、ガチャでしか入手できません。
5. よくある質問
Q. エフェクトや支援段階を使うと強くなったり有利になったりしますか? A. いいえ。どちらも見た目だけの機能で、強さやゲームバランスには一切影響しません。
Q. 支援段階に有効期限はありますか? A. あります。1回の購入につき30日間有効です。有効期間内に同じ段階以上を追加購入すると、 有効期限が購入日数分延長されます。期限が切れると称号は自動的に非表示になります(装飾パスと 同様、こちらも期限のある商品です)。
Q. 装飾パスの称号がチャットに出ないのですが不具合ですか? A. 不具合ではありません。称号は/hakoniwaeffect guiの画面上でのみ確認できる仕様です。
Q. 支援段階のtitle/titlecolorコマンドを実行しても見た目が何も変わりません。 A. 不具合の可能性もありますが、多くの場合はサーバー側でまだ表示設定が有効になっていないことが 原因です。運営にお問い合わせください。
Q. エフェクトが急に出なくなりました。 A. サーバー混雑時の自動調整の可能性があります。下記「注意点」を参照してください。
Q. ガチャで支援段階の他に個別エフェクトが当たりましたが、装飾パスとは別物ですか? A. はい、別物です。装飾パス(そよ風/きらめき/万華鏡)は30日間有効な使い放題パスですが、 ガチャで当たった個別エフェクトは永久に使用できる代わりに、そのエフェクト1つだけが対象です。
Q. ガチャの排出確率は変わることがありますか? A. 変更する可能性はありますが、変更する場合は本ドキュメント・ストアサイトの両方を 必ず更新し、変更後の確率が分かるようにします。
6. 注意点
- サーバーの動作が重い時間帯は、動きながら出るエフェクト(移動トリガー)や派手めの演出が 一時的に控えめになったり出なくなったりすることがあります。これはサーバー全体を快適に保つための 自動調整で、故障や不具合ではありません。混雑が解消すれば自動的に元通りになります
- 無料試用期間や季節限定の特典は、開始・終了からしばらくの間は、ログインするたびにお知らせが 表示されます
- 支援段階の表示名(「○円箱」形式)、および装飾パス・支援段階・統合プランの価格は 2026年9月21日に正式決定として凍結されました。以降の金額変更は「価格改定」として 別途お知らせします
- 支援段階・統合プラン・ガチャは決済完了後の返金・交換については、別途公開される 特定商取引法に基づく表記の定めに従います。なお、運営判断により返金処理が行われた場合、 対象の特典・称号(ガチャの当選分を含む)は失効します
- 支援段階の称号は、サーバーの設定によって表示される場所・見え方が異なります(必ずチャット・ タブリスト・ネームプレートすべてに表示されるとは限りません)
- ガチャの当選結果(排出される装飾の種類・レアリティ)について、運営は補償を行いません。 排出確率は事前に開示している通りです
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 revoke <プレイヤー名> | 支援段階を手動で剥奪する(誤付与の取り消し等、2026-08-13追加) |
/hakoniwastore planrevoke <プレイヤー名> <プランID> | 統合プラン(装飾パス+支援段階)をまとめて剥奪する(2026-08-13追加) |
/hakoniwastore reload | config.ymlの支援段階設定を再読み込みする(2026-08-12追加) |
8. 備考
Alpha-0.5.1: サーバー内部のセキュリティ・運用面を強化しました(不正アクセス対策の 簡易レート制限、設定の初期値チェック、障害時の手順書整備)。一般プレイヤーの遊び方・ コマンド・購入できる商品に変更はありません。 （Alpha-0.5.0版はこちら）
Alpha-0.5.0: バージョン番号の訂正です。Alpha-0.4.10のガチャ機能追加分は、内容の大きさに 対してパッチ番号が適切ではなかったため、マイナー番号(Alpha-0.5.0)へ付け直しました。 遊び方・コマンド・ガチャの内容に変更はありません。 （Alpha-0.4.10版はこちら）
Alpha-0.4.10: 仮価格だった4商品を正式決定として凍結しました。新機能「ガチャ」(¥500/1回、 ¥2,200/5回セット、装飾エフェクトが抽選で当たる)を追加し、ガチャ限定の新規エフェクト6種 (不死鳥の加護・共鳴の一撃・疾風のジャンプ・ハートの足跡・白煙の軌跡・凶兆の残滓)を 追加しました。ガチャの当選結果は永久に使用できます。既存の装飾パス・支援段階・統合プランの 遊び方・コマンドに変更はありません。 （Alpha-0.4.9版はこちら）
Alpha-0.4.9: 運営判断により返金処理が行われた場合、対象の特典・称号が失効する旨を ストアサイト・特定商取引法に基づく表記へ明記しました(実際の失効処理自体はAlpha-0.4.3から 変わっていません)。支援段階の表示名(「○円箱」)が確定済みであることも明記しました。 一般プレイヤーの遊び方・コマンドに変更はありません。 （Alpha-0.4.8版はこちら）
Alpha-0.4.8: 運営向けに、統合プランをまとめて剥奪できる
/hakoniwastore planrevokeを 追加しました。また、これまで一部の権限設定(例:.use権限をfalseにする設定)が意図通りに 効いていなかった不具合を修正しました。一般プレイヤーの遊び方には影響ありません。Alpha-0.4.7: サーバー内部のビルド設定を修正しました(プレイヤーの遊び方・コマンドへの 影響はありません)。一時的にプラグインのロードに失敗し支援段階の称号プレースホルダーが 正しく表示されない不具合が発生していましたが、解消済みです。
Alpha-0.4.6: ストアサイトのダークモードで、商品カードの「称号: ○○」の文字が見づらかった 問題を修正しました。表示内容・遊び方に変更はありません。
Alpha-0.4.5: 称号は「箱庭[極]」(5000円箱)が最高になりました。 これまでの「箱庭[覇]」 (10000円箱)・「箱庭[皇]」(20000円箱)は廃止され、5000円箱以上はすべて同じ「箱庭[極]」が 付与されます(価格が高いほど称号が豪華になる仕組みではなくなりました)。統合プラン 「統合プラン・大」(万華鏡+20000円箱)の称号も「統合プラン・中」と同じになりました。 あわせて、ストアサイトの各商品カード・詳細ページに「称号: ○○」の表示が追加され、 どの商品でどの称号がもらえるか一目で分かるようになりました。（Alpha-0.4.4版はこちら）
Alpha-0.4.3: 支援段階・統合プランを返金・解約した際、権利が自動で剥奪されるようになった (これまでは装飾パス・個別エフェクトのみ自動剥奪対象だった)。あわせて管理者コマンド
/hakoniwastore revokeを追加した(上記表参照)。（Alpha-0.4.2版はこちら）Alpha-0.3.5〜0.4.2の変更点は鯖民向け説明書-vAlpha-0.4.2を参照 (このリンクはAlpha-0.4.2版のファイル自身にある変更履歴を指す。history-hakoniwa-effect/配下は プラグイン名変更前(hakoniwa-effect単体時代)の別バージョン系列のため無関係)。
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枠に 分かれて表示されるようになりました。遊び方・コマンドの基本的な使い方に変更はありません。 （Alpha-0.3.5版はこちら）Alpha-0.3.6: 支援段階のアップグレード(上位段階への切り替え)時、有効期限の計算方法が 変更されました。以前は残り日数に+30日がそのまま加算されていましたが、今後はアップグレード 時点から30日で計算されます(同じ段階の再購入・延長は従来通りです)。遊び方・コマンドの 基本的な使い方に変更はありません。（Alpha-0.3.6版はこちら）
Alpha-0.4.0: サーバー内部の準備作業です。遊び方・コマンド・価格に変更はありません。 （Alpha-0.4.0版はこちら）
Alpha-0.4.1: サーバー内部の準備作業です。遊び方・コマンド・価格に変更はありません。 （Alpha-0.4.1版はこちら）
Alpha-0.4.2: 独自Webショップに新しい商品が4つ追加されました。装飾パス・支援段階を セットで割安に購入できる「統合プラン」(統合プラン・小/大)と、既存の装飾パス・支援段階と 同じ内容で支援額を増やしたい方向けの高額版(装飾パス・万華鏡+/5000円箱+)です。 ゲーム内のコマンド・遊び方に変更はありません。（Alpha-0.4.2版はこちら）