Box はあらゆるアイテムを仮想的なインベントリへ収納できるようにするプラグインです。
Vaultに依存しています
Box には以下のような特徴があります。
- GUI によって直感的にアイテムの預け入れ・引き出し・売買・クラフトができます。
- データ保存先として MySQL・SQLite のどちらかを選択できます。
- SQLite の場合は設定なしにすぐ使えます。
- Bungeecord で運用するときは MySQL によりサーバ間で設定を共有できます。
- すべての機能(カテゴリの入れ替え・売買価格)の設定を自由に書き換えられます。
- アイテム名がチャットに表示されるあらゆる場面において、ホバーによってアイテム情報を閲覧できます。
- アイテムを拾ったとき自動的に Box に収納できます(自動収納の項参照)。
- アイテムを消費するとき自動的に Box から補充できます(自動消費の項参照)。
リリースから最新のリリースへ移動し、Assets から JAR ファイルをダウンロードします。
そしてダウンロードした JAR ファイルをサーバーの plugins/
ディレクトリに投入しサーバーを再起動します。
再起動後に、
config.yml
categories.yml
layout.yml
messages.yml
prices.yml
craftrecipes.yml
が生成されます。
/box autostore all true
(全アイテムを Box に収納するコマンド)を実行して拾ったアイテムをすべて Box に収納できます。
必要に応じて特定のアイテムのみ収納したり、逆に収納しないように設定できます。
/box stick
を実行すると Box Stick と呼ばれる棒が手に入ります。
これをオフハンドに持つことで、メインハンドにあるアイテムを消費したとき自動的に Box からそのアイテムを補充できます。
インストール時に生成された設定を参照して適量書き換えます。その後サーバーを再起動します。
追加の設定は必要ありません。
※ 初期設定はクリエイティブタブに準拠しており設定を変更せずともそのまま使えます。
カテゴリの設定は categories.yml
に定義されています。
データベースに登録されているアイテムのほとんどがこのファイルに定義されています(コマンドブロックやバリアブロックを除く)。
/box
コマンドをゲーム内で実行してカテゴリを確認しつつ定義を書き換えます。
その後 /boxadmin reload
を実行して差分を確認します。
コマンドでカテゴリを追加するには、チェストに視線を向けつつ /boxadmin addcategory <カテゴリ名> <GUIでの表示名> <使用するアイコン>
を実行します。これによりチェストの中身を自動的にカテゴリとして追加できます。
カテゴリに追加せずアイテムを直接データベースに追加するには、対象のアイテムを手に持ち /boxadmin register
を実行します。
名前は登録されたアイテムを持ち /box iteminfo
を実行することで参照できます。
この名前をカテゴリに登録することで GUI からそのアイテムを参照できるようになります。
登録されたアイテムは <material>:<id>
というフォーマットです。
これは /boxadmin customname <アイテム> <新規名>
を実行することで変更できます。
Box の GUI による売買価格は prices.yml
に定義されています。
アイテム名は categories.yml
に記載されているものを使用してください。
なお、現状(v3.1.x)デフォルトでデータベースに存在するアイテムはほとんど Spigot の Material
列挙型と同じものです。
ポーション、スプラッシュポーション、リンガリングポーション、効果付き矢、エンチャント本以外は除きます(後述)。
ポーション効果のあるものは <アイテム名>_<効果名>[_<EXTENDED | UPGRADED>]
です。
時間延長には EXTENDED
、効果増強には UPGRADED
を付加してください。
効果名は Spigot のPotionType
列挙型を参照してください。
エンチャント本の名前は ENCHANTED_BOOK_<エンチャント名>
です。エンチャント名は Spigot の Enchantment
クラスを参照してください。
Box の GUI によるクラフトレシピは craftrecipes.yml
に定義されています。
標準で設定されるクラフトレシピはマインクラフトで使用されるデフォルトのレシピとなっています。
標準のクラフトレシピがおかしい場合は craftrecipes.yml
に追記して対応できます。記述はデフォルトで書かれていることを参考にします。
- メッセージ設定:
messages.yml
を変更します。 - GUI の表示設定:
layout.yml
を変更します。
-
/box autostore <ITEM | ALL> [true | false]
: 自動収納の設定を変更します。 -
/box autostorelist <page>
: 自動収納の設定を表示します。 -
/box give <player> <ITEM> [amount]
: 誰かにアイテムを与えます。 -
/box stick
: オフハンドに持つとアイテム消費先が Box になる杖を手に入れます。 -
/box help [page]
: ヘルプを表示します。 -
/box version
: バージョンを表示します。 -
/box <iteminfo | iinfo>
: アイテム情報が見れるホバーを表示します。 -
/box <deposit | d> [<amount> | <ITEM> [amount] | ALL]
: 引数無しで手持ちのアイテムを預けます。ALL を指定すると手持ちのアイテムで* 預けられるものをすべて預けられます。アイテム名を指定すると、インベントリからそのアイテムを預けます。 -
/box <withdraw | w> <ITEM> [amount]
: アイテムを引き出します。 -
/boxadmin autostore <player> < <ITEM> [true|false] | ALL <true|false> >
: 自動収納の設定を変更します。 -
/boxadmin autostorelist <player> <page>
: 自動収納の設定を表示します。 -
/boxadmin reload
: 設定を再読込します。 -
/boxadmin customname <ITEM> <after>
: アイテムの内部名前を設定します。この名前は GUI 上でも使われます。 -
/boxadmin addcategory <カテゴリ名> <GUI上の表示名> <ICONになるアイテム>
: チェストをクリックして、中にはいっているアイテムをもとにカ* テゴリを追加します。 -
/boxadmin give <player> <ITEM> [amount]
: 誰かにアイテムを与えます。 -
/boxadmin take <player> <ITEM> [amount]
: 誰かのアイテムを減らします。 -
/boxadmin set <player> <ITEM> <amount>
: 誰かのアイテム量をセットします。 -
/boxadmin help <page>
: ヘルプを表示します。 -
/boxadmin register
: 手に持っているアイテムをデータベースに登録します。
boxadmin.*
:- 説明:
/boxadmin <args...>
コマンドのすべてを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin
:- 説明:
/boxadmin ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.addcategory
:- 説明:
/boxadmin addcategory ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.autostore
:- 説明:
/boxadmin autostore ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.autostorelist
:- 説明:
/boxadmin autostorelist ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.customname
:- 説明:
/boxadmin customname ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.register
:- 説明:
/boxadmin register
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.give
:- 説明:
/boxadmin give ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.help
:- 説明:
/boxadmin help ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.reload
:- 説明:
/boxadmin reload
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.set
:- 説明:
/boxadmin set ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.take
:- 説明:
/boxadmin take ...
コマンドを使うための権限 - デフォルト権限:
op
- 説明:
boxadmin.creative
:- 説明: GUI でアイテムを取引してもストックに影響がなくなる権限。取り出し放題になる。
- デフォルト権限:
false
box.*
:- 説明:
/box <args...>
のすべてを使えるようになる権限 - デフォルト権限:
op
- 説明:
box.autostore
:- 説明:
/box autostore ...
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.autostorelist
:- 説明:
/box autostorelist ...
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.withdraw
:- 説明:
/box withdraw ...
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.deposit
:- 説明:
/box deposit ...
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.give
:- 説明:
/box give ...
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.help
:- 説明:
/box help ...
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.version
:- 説明:
/box version
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.stick.*
:- 説明:
/box stick
に関するすべての権限 - デフォルト権限:
true
- 説明:
box.stick
:- 説明:
/box stick
コマンドを使うための権限 - デフォルト権限:
true
- 説明:
box.stick.block
:- 説明:
/box stick
でブロックをデータベースから消費する権限 - デフォルト権限:
true
- 説明:
box.stick.food
:- 説明:
/box stick
で食べ物をデータベースから消費する権限 - デフォルト権限:
true
- 説明:
box.stick.potion
:- 説明:
/box stick
でポーションをデータベースから消費する権限 - デフォルト権限:
true
- 説明:
box.stick.tool
:- 説明:
/box stick
で武具・道具をデータベースから消費する権限 - デフォルト権限:
true
- 説明: