HakoniwaStore 鯖民向け説明書 (Alpha-0.1.0)
見た目を彩る「箱庭エフェクト」プラグインの遊び方に加え、今回のバージョンから「箱庭クラフト ストア」の支援段階(寄付段階称号)の遊び方も紹介します。どちらも見た目・演出だけの機能で、 強さやゲームバランスには一切影響しません。/heffectは/hakoniwaeffectの、/hstoreは /hakoniwastoreの短縮形です。どちらを使っても同じ結果になります(以降の説明では長い形で 統一して表記します)。
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 | 自分の発動回数の統計・称号までの残り回数を確認する |
/hakoniwastore status [プレイヤー名] | 現在の支援段階・次の段階までの差額を確認する |
/hakoniwastore buy <段階ID> | ゲーム内通貨で支援段階を購入する(差額のみ課金) |
/hakoniwastore gift <プレイヤー名> <段階ID> | 他のプレイヤーへ支援段階を贈る(代金は自分が支払う) |
/hakoniwastore title <on|off> | 称号表示の設定を保存する(一定以上の段階が必要。現バージョンでは実際の表示処理が未実装のため、設定を変えても見た目は変わりません) |
/hakoniwastore titlecolor <カラーコード> | 称号色の設定を保存する(一定以上の段階が必要。現バージョンでは実際の表示処理が未実装のため、設定を変えても見た目は変わりません) |
buy/subscribe/unsubscribe/trialはゲーム内通貨で購入できるサーバーのみで使えます。 実マネー決済(独自Shop)のサーバーでは、購入はストア側の画面から行います。支援段階も同様に、 ゲーム内通貨(/hakoniwastore buy)と実マネー決済(箱庭クラフトストアの画面)の両方で購入できます。
3. GUIメニューの操作
/hakoniwaeffect guiカテゴリ一覧画面(移動・ジャンプ・破壊・攻撃)が開きます。カテゴリを選ぶと、そのトリガーで 使えるエフェクトの一覧画面に移ります。
- 持っているエフェクトをクリックすると有効化されます。もう一度クリックすると無効化できます
- カテゴリ一覧画面には、契約中(無期限/残り日数)やトライアル中の状態が表示されます
- ゲーム内通貨で購入できるサーバーでは、カテゴリ一覧画面に「一発お試し」ボタン(ネザースター)が あり、クリックだけで最高プランのエフェクトを1日お試しできます
- 装飾パスの称号は
/hakoniwaeffect guiの画面上(名札アイテム)でのみ確認できます。チャットには 表示されません
支援段階のGUIは現バージョン(Alpha-0.1.0)ではまだ用意されていません。/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のようなコマンドで称号表示・ 称号色の設定を保存できます。ただし現バージョン(Alpha-0.1.0)では、この設定を実際に チャットや名前表示へ反映する処理が未実装のため、コマンドを実行しても見た目は変わりません (今後のバージョンで対応予定です)。
Webサイト(箱庭クラフトストア)から購入する場合も、購入先プレイヤー名を入力すると同じ差額計算が 働きます。
5. よくある質問
Q. エフェクトや支援段階を使うと強くなったり有利になったりしますか? A. いいえ。どちらも見た目だけの機能で、強さやゲームバランスには一切影響しません。
Q. 支援段階に有効期限はありますか? A. ありません。一度到達した段階は無期限で保持されます(装飾パスのような月額課金ではありません)。
Q. 装飾パスの称号がチャットに出ないのですが不具合ですか? A. 不具合ではありません。称号は/hakoniwaeffect guiの画面上でのみ確認できる仕様です。
Q. 支援段階のtitle/titlecolorコマンドを実行しても見た目が何も変わりません。 A. 不具合ではありません。現バージョン(Alpha-0.1.0)では、これらのコマンドは設定を保存する ところまでしか実装されておらず、チャット・名前表示等へ反映する処理は未実装です。今後の バージョンで対応予定です。
Q. エフェクトが急に出なくなりました。 A. サーバー混雑時の自動調整の可能性があります。下記「注意点」を参照してください。
6. 注意点
- サーバーの動作が重い時間帯は、動きながら出るエフェクト(移動トリガー)や派手めの演出が 一時的に控えめになったり出なくなったりすることがあります。これはサーバー全体を快適に保つための 自動調整で、故障や不具合ではありません。混雑が解消すれば自動的に元通りになります
- 無料試用期間や季節限定の特典は、開始・終了からしばらくの間は、ログインするたびにお知らせが 表示されます
- 支援段階の名称・価格は今後変更される可能性があります(現バージョンの表示名は仮のものです)
- 支援段階は決済完了後の返金・交換については、別途公開される特定商取引法に基づく表記の定めに 従います
- 支援段階の称号ON/OFF・称号色の設定(
title/titlecolor)は、現バージョンでは保存のみで 実際の表示には反映されません(今後のバージョンで対応予定)
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での申込確認後などに使用) |
8. 備考
- Alpha-0.1.0: 「箱庭クラフトストア」の支援段階(寄付段階称号)機能を追加。 別プラグイン (hakoniwa-store)として分離検討していたものを、hakoniwa-effect本体・Webサイト (stripe-relay)・Webhookエンドポイントへ完全統合し、
/hakoniwastoreコマンドとして実装した。 装飾パスの権利データとは別ファイル(support-entitlements.yml)で管理するため、既存の 装飾パスの動作・所持状況には一切影響しない。