spigot.ymlの設定
spigot.ymlはSpigotを使用している時のみ作成されます。
非常に細かい設定が可能ですが、大抵はデフォルトのままでも大丈夫でしょう。
この記事ではSpigot 1.13.2で動作確認を行っています。バージョンによっては設定ファイルの設定項目が異なることもあるでしょう。
スポンサーリンク
目次
config-version
config-version
はSpigotが設定ファイルのバージョンを確認するための値なので触らないようにしましょう。
ちなみにこの記事はconfig-version: 11
で確認しています。
settings
settings
の項目です。主にパフォーマンス関連の設定
設定 | デフォルト | 説明 |
---|---|---|
debug | false | デバッグ用オプション、通常はfalseのままでいい |
late-bind | false | すべてのプラグインがロードされるまでプレイヤーがサーバーにログインできないようにする。個人的にはtrueを推奨 |
bungeecord | false | BungeeCord用の機能を有効にするか設定。BungeeCordを使用する際にはtrueにする |
timeout-time | 60 | 設定した値の間にサーバーが応答しないとフリーズしたと判定してスレッドダンプを出力しサーバーが再起動する、単位は秒 |
restart-on-crash | true | サーバーがクラッシュした際に自動的にサーバーの再起動を試みるか設定 |
restart-script | ./start.sh | サーバーの起動スクリプトを指定。/restartコマンドとrestart-on-crashで使用される |
save-user-cache-on-stop-only | false | ユーザーキャッシュを常にディスクに保存するか、サーバーを停止した時のみ保存するかを設定 |
user-cache-size | 1000 | ユーザーキャッシュのサイズ数を設定する |
netty-threads | 4 | netty(ネットワークの通信を行う機能)を実行するスレッド数の設定 |
sample-count | 12 | サーバーリストのプレイヤー数の上にマウスを移動した際に表示されるプレイヤー数の設定 |
player-shuffle | 0 | 基本的にプレイヤーのパケットは参加した順に処理され、再ログインするとキュー内の位置が変わり他のプレイヤーよりも先に処理されるようになる そのため、サーバーのゲーム内容次第(PVPなど)では戦略的に再ログインするプレイヤーなどが発生する事もある この設定はそれらを防止する機能で、定期的にキューをシャッフルすることで再ログインのメリットを無効化する 単位はtick(1/20秒)で0にすると無効、値が小さすぎる(具体的には100未満)だとパフォーマンスに問題が発生する可能性がある |
moved-too-quickly-multiplier | 10.0 | "moved too quickly"(移動速度が速すぎる)の設定。この値は実質的にプレイヤーの移動速度の最大値になる 通常はデフォルトのままで問題ないがTNT砲などでこの速度を上回って移動する必要がある時は値を大きくする |
moved-wrongly-threshold | 0.0625 | "moved wrongly"(誤って移動した)の設定、通常はデフォルトのままで問題ない 値を大きくするとラバーバンド現象を軽減できる可能性があるが、プレイヤーに悪用される可能性もある (ラバーバンド現象: 通信状況が悪いなどの理由で操作しても元の位置に戻されてしまう現象) |
attribute | 2048.0 | 体力(maxHealth)、速度(movementSpeed)、ダメージ(attackDamage)などの最大値を指定 |
restart-on-crash
を利用する際の注意点ですが、何らかのバグなどで起動してすぐクラッシュするような状況だと起動→クラッシュ→再起動→クラッシュ……を繰り返す場合があるので気を付けましょう。
messages
各種メッセージなどが設定できます。
設定 | デフォルト | 説明 |
---|---|---|
whitelist | You are not whitelisted on this server! | ユーザーがホワイトリストに入っていない際のメッセージ |
unknown-command | Unknown command. Type "/help" for help. | 存在しないコマンドを実行した際のメッセージ |
server-full | The server is full! | サーバーが満員の際のメッセージ |
outdated-client | Outdated client! Please use {0} | クライアントのバージョンが古い場合のメッセージ。{0}は必要なバージョンに置き換わる |
outdated-server | Outdated server! I'm still on {0} | サーバーのバージョンが古い場合のメッセージ。{0}は必要なバージョンに置き換わる |
restart | Server is restarting | サーバーをリスタートした際のメッセージ |
commands
コマンド関係の設定です。
設定 | デフォルト | 説明 |
---|---|---|
log | true | ユーザーが使用したコマンドをコンソールに表示するか |
silent-commandblock-console | false | コマンドブロックの出力をコンソールに表示するか |
tab-complete | 0 | タブコンプリートを表示するまでに何文字入力する必要があるか -1なら無効、0ならすべて表示、1以上なら指定した文字数を入力するとタブコンプリートされる 古いバージョンでは挙動が少し違う |
send-namespaced | true | タブを押した時にネームスペース付き(プラグイン名:コマンド名)の構文で表示するか |
replace-commands | [setblock,summon,testforblock,tellraw] | 指定したコマンドのBukkit実装を無効にしてバニラの振る舞いを利用する |
spam-exclusions | [/skill] | スパムチェックから除外するコマンド |
stats
統計関連の設定です。
設定 | デフォルト | 説明 |
---|---|---|
disable-saving | false | trueにすると統計が保存されなくなる |
forced-stats | {} | 特定の統計の値を強制的に設定値にする場合に使用 |
advancements
1.12で追加された進捗関係の設定です。
設定 | デフォルト | 説明 |
---|---|---|
disable-saving | false | trueにすると進捗が保存されなくなる |
disabled | [] | 無効にする進捗のリスト。無効にする際は子の進捗も無効にしないとエラーが出る |
world-settings
世界の設定をさらに細かく設定できます。
次の例のように、世界名(ディレクトリ名)を使用してworld-settingsの下に新しいセクションを追加すると世界別に設定できます。
world-settings:
default:
verbose: true
# ~ 略 ~
# worldの個別設定を行う場合
world:
verbose: false
設定内容は以下の通りです。ゲームバランスに大きな影響を与える物もあるので自分が何をやっているかしっかり理解してから編集してください。
設定 | デフォルト | 説明 |
---|---|---|
verbose | true | 各ワールドの詳細情報と設定を起動時にコンソールに表示するか |
view-distance | 10 | プレイヤーの周囲のロードされるチャンク数を設定。値は1から15の範囲でなければならない プレイヤー数が多い場合は値を下げると負荷を減らせる |
item-despawn-rate | 6000 | ドロップしたアイテムが消滅するまでの時間、単位はtick(1/20秒) |
arrow-despawn-rate | 1200 | 刺さった矢が消滅するまでの時間、単位はtick(1/20秒) |
wither-spawn-sound-radius | 0 | ウィザーがスポーンした際の音の範囲を設定 |
dragon-death-sound-radius | 0 | エンダードラゴンが死亡した際の音の範囲を設定 |
mob-spawn-range | 6 | プレイヤー周囲のMOBがスポーンする半径を設定 |
nerf-spawner-mobs | false | trueにした場合モンスタースポナーから出現するMOBがAIを持たなくなる |
enable-zombie-pigmen-portal-spawns | true | ネザーポータルからゾンビピッグマンをスポーンさせるか 当然ながらfalseにするとポータルを使用する金塊TTは動作しなくなる |
zombie-aggressive-towards-villager | true | falseに設定するとゾンビが村人を襲わなくなる |
hanging-tick-frequency | 100 | 絵画、額縁、結んだリードなどを更新する間隔を設定、単位はtick(1/20秒) |
max-tnt-per-tick | 100 | 1tickに処理するTNTの数 |
hopper-amount | 1 | ホッパーが1回に転送するアイテムの数を設定 |
random-light-updates | false | さまざまな理由で更新されていない明かりを修正するためにチャンクをランダムに更新する設定 |
seed-village | 10387312 | 村を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-desert | 14357617 | 砂漠の寺院を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-igloo | 14357618 | イグルーを生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-jungle | 14357619 | ジャングルの寺院を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-swamp | 14357620 | 魔女の小屋を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-monument | 10387313 | 海底神殿を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-shipwreck | 165745295 | 難破船を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-ocean | 14357621 | 海底遺跡を生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
seed-slime | 987234911 | スライムチャンクを生産する際に使われるseed値。より細かいカスタマイズをする際に設定 |
marge-radius
は落ちているエンティティをまとめる設定です。
Spigotサーバーでエンダードラゴンを倒すと経験値が"しょぼく"なりますが、この機能が原因です。
設定 | デフォルト | 説明 |
---|---|---|
item | 2.5 | 同じアイテムが近くに落ちている時にひとまとめにする範囲の設定 |
exp | 3.0 | 経験値オーブが近くに落ちている時にひとまとめにする範囲の設定 |
entity-activation-range
はエンティティが活性化する範囲の設定です。
小さくするとパフォーマンスが向上しますが、TTなどの動作に影響を与える可能性があります。
設定 | デフォルト | 説明 |
---|---|---|
animals | 32 | 動物が活性化する範囲 |
monsters | 32 | モンスターが活性化する範囲 |
misc | 16 | その他エンティティが活性化する範囲 |
tick-inactive-villagers | true | 村人の処理のために誰も居ないチャンクをロードする設定 無効にするとパフォーマンスは向上するが村人の処理にバグが発生する可能性がある |
entity-tracking-range
はエンティティがクライアントに表示(もしくは追跡)として認識される範囲をブロック単位で設定します。
この範囲の外のエンティティはレンダリングされなくなるため表示されません。PVPサーバーなどでは値を下げると壁透過MODなどの使用をある程度妨害できるでしょう。
変更してもサーバー側のパフォーマンスはあまり変わりませんが、値を下げるとクライアント側の負荷は下がります。(当然ながらエンティティが見えるようになる範囲も狭まります)
設定 | デフォルト | 説明 |
---|---|---|
players | 48 | プレイヤーが表示される範囲 |
animals | 48 | 動物が表示される範囲 |
monsters | 48 | モンスターが表示される範囲 |
misc | 32 | 絵画、額縁、落ちているアイテム、経験値オーブ、看板の文字などが表示される範囲 |
other | 64 | サーバー上のすべてのエンティティに対する一般的な上限 |
ticks-per
はホッパーの転送間隔を調整する設定です。
ホッパーが多いサーバーでは変更するとパフォーマンスが向上しますが、ホッパーを利用したレッドストーン回路などが壊れる可能性もあります。
設定 | デフォルト | 説明 |
---|---|---|
hopper-transfer | 8 | ホッパーがアイテムを出し入れしてから次に出し入れするまでの間隔。単位はtick(1/20秒) |
hopper-check | 1 | ホッパーの上に落ちたアイテムなどを検索する間隔。単位はtick(1/20秒) |
growth
は植物の生長速度の設定です。単位はtick(1/20秒)
変更してもパフォーマンスは向上しません。
設定 | デフォルト | 説明 |
---|---|---|
cactus-modifier | 100 | サボテンの成長速度を設定 |
cane-modifier | 100 | サトウキビの成長速度を設定 |
melon-modifier | 100 | スイカの成長速度を設定 |
mushroom-modifier | 100 | キノコの成長速度を設定 |
pumpkin-modifier | 100 | カボチャの成長速度を設定 |
sapling-modifier | 100 | 苗木の成長速度を設定 |
beetroot-modifier | 100 | ビートルートの成長速度を設定 |
carrot-modifier | 100 | ニンジンの成長速度を設定 |
potato-modifier | 100 | ジャガイモの成長速度を設定 |
wheat-modifier | 100 | 小麦の成長速度を設定 |
netherwart-modifier | 100 | ネザーウォートの成長速度を設定 |
vine-modifier | 100 | ツタの成長速度を設定 |
cocoa-modifier | 100 | カカオの成長速度を設定 |
hunger
はさまざまな動作を行った際の満腹度の減少量に関する設定です。
設定 | デフォルト | 説明 |
---|---|---|
jump-walk-exhaustion | 0.05 | 通常のジャンプ |
jump-sprint-exhaustion | 0.2 | ダッシュジャンプ |
combat-exhaustion | 0.1 | 戦闘行為 |
regen-exhaustion | 6.0 | 体力の自然回復 |
swim-multiplier | 0.01 | 水泳 |
sprint-multiplier | 0.1 | ダッシュ |
other-multiplier | 0.0 | その他 |
max-tick-time
は次のタスクにスキップする前のタイルやエンティティ操作に消費する時間の設定です。単位はミリ秒。
値を低くするとパフォーマンスが大幅に向上するが、とくにエンティティの値を下げると動作がぎこちなく見えるようになる可能性がある。
設定 | デフォルト | 説明 |
---|---|---|
tile | 50 | タイル操作に費やす時間の設定、10~20でパフォーマンスが大幅に向上 |
entity | 50 | エンティティ操作に費やす時間の設定、20~25でパフォーマンスが大幅に向上 |
squid-spawn-range
はイカがスポーンする高さの設定です。
この値より低いY座標の水中でイカがスポーンします。
設定 | デフォルト | 説明 |
---|---|---|
min | 45.0 | イカがスポーンする高さ |