- 已编辑
前言
如题,因为之前那个毛毛糙糙的优化指南坏掉了(字面意思)。
所以又开一帖,好好地讲一下paper端的配置文件与基本优化思路。
也算是给自己做个备忘录吧。
阅读之前,请注意:
- 几乎所有基于Bukkit的服务端都会有bukkit.yml文件,几乎所有基于Spigot的服务端都会有spigot.yml文件
- 本文对于CatServer、Mohist等Spigot+Forge端仅作参考
- 推荐值基于我的开服经验和对服务器的理解,可能并不准确
原文地址:
更多打算翻译的文件:
- command
- Eula
- permission
- server
正文
适用于1.12-1.15服务端,不同的版本之间,配置文件会有出入;对于更低/更高的版本,本篇仅供参考
bukkit.yml
全局适用的配置
全局配置
allow-end
是否开启末地。 布尔型(true或false)
默认值: true
看情况启用,一般生存服都要用,小游戏服就关了好了
warn-on-overload
是否显示信息
"[WARNING] Can't keep up! Did the system time change, or is the server overloaded?"。 布尔型(true或false)
默认值: true
影响不大
permissions-file
自定义权限文件。 (文件名)
默认值: permissions.yml
影响不大
update-folder
插件升级临时存放文件夹,重启后将会升级插件 (文件夹名)
注意: 这个文件夹必须在plugins文件夹里,否则不会启用
默认值: update
影响不大
ping-packet-limit
现在的版本无效。老版本:游戏内每秒ping的最大发包数量 (整数,包/秒)
默认值: 100
没有影响
use-exact-login-location
自从Minecraft添加了方块内实体会弹出方块的机制,玩家总是发现他们登入的位置在他们登出的位置的上面(特别是登出地点在洞穴里的情况下)。这个选项可以开关这个机制。设为true时,我们将会绕过香草原版检测和登入时移动玩家位置的机制。设为false时,我们会继续使用原版的机制,当玩家卡在什么东西里面的时候移动玩家的位置。
默认值: false
影响不大
world-container
保存世界(即存档)的文件夹。如果这个选项不存在,那就直接把存档放在根目录 (文件夹名)
默认不存在这个选项,也没有默认值
影响不大
plugin-profiling
允许使用/timings指令,用于测算插件和事件占用的资源。
默认值: false
影响不大,有了spigot/paper的timings之后就更不需要这个了
connection-throttle
客户端进服间隔(距离上次尝试进服的时间间隔)。设置为0则会禁用此功能,但是会让你的服务器暴露于危险之中(只建议测试服设为0)(长整数,毫秒)
默认值: 4000
推荐值: 5000 - 10000 (影响不大,但是可以一定程度上防假人)
query-plugins
远程连接请求插件列表时是否返回插件列表。 布尔型(true或false)
默认值: true
推荐值: false (影响不大)
deprecated-verbose
当插件注册了一个过时的事件的时候发出警告。这个选项设为true/false可以开关此功能,设为default则是一直发出警告,除非开发者标记了这个事件为已注册。 (string)
默认值: default
影响不大
shutdown-message
关服时显示的文字
默认值: Server closed
推荐值: 服务器关闭 (影响不大)
决定了每个世界存在的怪物、动物数量。
当spigot.yml中的mob-spawn-range为8的时候,实际上限=下面设置的数量x玩家人数
生成限制
monsters
怪物
MC原版默认值:70
推荐值:25 - 45 (影响较大,建议人多的服设置为25甚至更低)
animals
动物
MC原版默认值:15
推荐值:5 - 10 (影响不大)
water-animals
水生生物(鱼、章鱼和守护者)<--这个守卫者算不算鱼?
MC原版默认值:5
推荐值:同上 (影响不大)
ambient
环境生物的数量(众所周知——蝙蝠)<--洞穴里的,不是森林里的
MC原版默认值:15
推荐值:0 - 2 (影响不大)
注意:部分由现有生物生成的怪物、动物不受这些限制的影响,它们有自己的限制。
注意:这些限制仅对已加载区块中的怪物、动物起效——未加载区块中的实体不会计入
Bukkit服务器:
- 刷怪上限=设定的值x玩家人数x刷怪区块数÷256
- 玩家人数是指该世界的玩家人数而不是总人数
原版:
- 刷怪上限=设定的值x刷怪区块数÷289
原版的刷怪机制保证了即使视野距离低于8,也能保证怪物密度和视野距离高于8时大致相等
Bukkit的机制很奇怪?我也觉得,因为如果刷怪半径为8(原版设定),那么实际刷怪区域是(8x2+1)2=289区块
但是我查到的资料显示,Bukkit的修正值就是256……
服务器会回收一些本应卸载却没有卸载成功的区块
区块回收
period-in-ticks
每隔多少tick,区块回收器会回收一次区块。设为0将禁用区块回收器。
默认值:600
推荐值:400 - 800 (影响有点大,内存小的服务器建议设置为400,太小只会浪费CPU性能)
load-threshold
上次区块回收之后,需要加载多少新区块才会再次启用区块回收器。设为0将禁用这个阈值功能。
默认值:0
推荐值:300 (影响不是很大,但是设置得太小没意义)
间隔一定的游戏刻来执行某些任务
刻
animal-spawns
每多少tick生成一次动物
设置为20则每秒尝试生成一次。(非常不推荐)
注意:设为0的话将会禁用动物生成,这时我们建议使用spawn-animals选项。
MC原版默认值:400
推荐值:400 - 600 (影响不大)
monster-spawns
每多少tick生成一次怪物
设置为1则每tick尝试生成一次。(非常不推荐)
注意:设为0的话将会禁用动物生成,这时我们建议使用spawn-monsters选项。
MC原版默认值:1
推荐值:3 - 5 (影响较大,每秒生成怪物20次的资源浪费简直可怕)
autosave
This bukkit.yml setting allows servers to set the number of ticks for each save-all event.
MC原版默认值:6000
水桶服默认值:0
推荐:6000 - 12000 (1.13以上十分推荐使用bukkit自带的保存机制,设置得太小只会导致死亡卡顿,太大会导致保存的时候卡一下)
注意:许多服务器使用自动保存插件来执行保存任务,这会关闭Bukkit的保存机制,原版MC的保存机制会导致延迟卡顿,而且有些多余。 如果你选择启用这个功能,记住时间绝对不能设置得太短,建议6000以上(6000 = 5 分钟,可以让服务器保持运行效率).
废弃功能,目前不会出现在配置文件里,没必要看
自动升级
enabled: (布尔值) 是否检查自动更新。 默认值:true
on-broken: (字符串数组) 如果当前运行的版本有重大漏洞则警告。 Can be "warn-ops" and/or "warn-console". 默认值:[warn-console, warn-ops]
on-update: (字符串数组) 如果当前运行的版本过时则警告。 Can be "warn-ops" and/or "warn-console". 默认值:[warn-console, warn-ops]
preferred-channel: (字符串) Which release channel is preferred for this server. Can be "rb", "beta" or "dev". 默认值:rb
host: (字符串) 检查更新的网址。除非你知道你在做什么,否则永远不要动这项。 默认值:dl.bukkit.org
已经停用了,去看看command.yml
指令别名
已经停用了,去看看command.yml
可选功能
数据库
SQLite 默认配置:
database:
username: bukkit
isolation: SERIALIZABLE
driver: org.sqlite.JDBC
password: walrus
url: jdbc:sqlite:文件目录\文件名.db
MySQL 示例配置:
database:
username: 用户名
isolation: SERIALIZABLE
driver: com.mysql.jdbc.Driver
password: 密码
url: jdbc:mysql://IP地址:端口号/数据库名
配置某个世界的生成选项
可选:世界选项
整个配置文件大体这样
settings:
...
aliases:
...
database:
...
worlds:
world1:
generator: CleanroomGenerator
示例配置
settings:
...
aliases:
...
database:
...
worlds:
world1:
generator: CleanroomGenerator:10,stone,20,dirt,1,grass
spigot.yml
指令相关
指令相关
tab-complete
- 版本高于#1368:
默认值:0
推荐值:1或2(主要影响游戏体验)
类型:整数
描述:你可以设置玩家键入几个字符之后才可以使用Tab补全,这可以防止玩家使用这个功能占用服务器资源或者寻找漏洞。
0 任何情况下都会Tab补全
-1 任何情况下都不会Tab补全
1 输入1个字符后会Tab补全
2 输入2个字符后会Tab补全... 以此类推... - 版本低于#1368:
默认值:true
推荐值:true(主要影响游戏体验)
类型:布尔型(true或false)
描述:是否可用Tab补全,这会让玩家补全所有已经在服务器里注册的指令。
send-namespaced
默认值:true
推荐值:true(主要影响游戏体验)
类型:布尔型(true或false)
描述:Tab补全时像这样显示指令提示 <plugin>:<command>
举例:/minecraft:tp —— 使用minecraft原版的tp指令而不是essentialsX的
silent-commandblock-console
默认值:false
类型:布尔型(true或false)
描述:控制是否将命令方块执行指令的反馈打在控制台上
log
默认值:true
类型:布尔型(true或false)
描述:是否将玩家输入的指令显示在控制台和记录在日志里
replace-commands
默认值:[setblock, summon, testforblock]
类型:列表
描述:取消Bukkit对列表中的指令的修改/拓展,而是使用其原版的版本
使用“&”来加颜色/样式,使用“\n”换行
消息相关
whitelist
默认值:"You are not whitelisted on this server!"
类型:字符串
描述:如果白名单开启,而玩家没有在白名单上时会将拒绝玩家进服并显示这个提示。你可以使用/whitelist add {用户名}
指令将玩家添加到白名单上
unknown-command
默认值:"Unknown command. Type "help" for help."
类型:字符串
描述:当玩家输入的指令没有注册/不存在时,会在玩家聊天框显示这句话
server-full
默认值:"The server is full!"
类型:字符串
描述:如果服务器满员了(人数达到设置的上限),服务器就会拒绝玩家进服,同时会显示这个提示。
outdated-client
默认值:"Outdated client! Please use {}"
类型:字符串
描述:当玩家使用不支持的旧版的客户端时会拒绝玩家进服并显示这个提示。{}
这个位置会显示服务器的版本(推荐的版本)。
outdated-server
默认值:"Outdated server! I'm still on {0}"
类型:字符串
描述:当玩家使用不支持的新版的客户端时会拒绝玩家进服并显示这个提示。{}
这个位置会显示服务器的版本(推荐的版本)。
restart
默认值:"Server is restarting"
类型:字符串
描述:如果服务器执行/restart
指令,就会踢出所有玩家并向其显示这个提示。
统计数据
统计数据
disable-saving
默认值:false
类型:布尔型(true或false)
描述:如果设为true,服务器将不会记录玩家的统计信息和成就信息。推荐强制启用achievement.openInventory
(将其设为1)防止成就信息滞留在玩家的屏幕上。
forced-stats
默认值:{}
类型:查找表(Map)
描述:强制设置统计信息的值的查找表。
进度系统
进度系统
disable-saving
默认值:false
类型:布尔型(true或false)
描述:如果启用,服务器将不会保存1.12引入的进度系统的信息。
disabled
默认值:[]
类型:列表
描述:禁用的进度列表。这个列表中的进度将无法取得,且不会显示在成就GUI里,进度GUI就是那个按Esc键后出现的“进度”按钮点进去或者按下“进度”按键(默认是L键)出现的窗口。如果列表中禁用的进度有子进度没有一起被禁用的话,控制台就会刷报错。下面那个列表是所有进度,复制粘贴这个列表可以禁用所有进度。
所有进度
- minecraft:story/root
- minecraft:nether/root
- minecraft:end/root
- minecraft:adventure/root
- minecraft:husbandry/root
- minecraft:story/shiny_gear
- minecraft:end/elytra
- minecraft:adventure/summon_iron_golem
- minecraft:husbandry/break_diamond_hoe
- minecraft:story/obtain_armor
- minecraft:nether/return_to_sender
- minecraft:adventure/sleep_in_bed
- minecraft:story/lava_bucket
- minecraft:end/dragon_breath
- minecraft:end/kill_dragon
- minecraft:adventure/kill_all_mobs
- minecraft:story/enchant_item
- minecraft:nether/all_potions
- minecraft:story/follow_ender_eye
- minecraft:husbandry/tame_an_animal
- minecraft:nether/create_beacon
- minecraft:story/deflect_arrow
- minecraft:story/iron_tools
- minecraft:adventure/totem_of_undying
- minecraft:adventure/kill_a_mob
- minecraft:adventure/adventuring_time
- minecraft:nether/brew_potion
- minecraft:husbandry/plant_seed
- minecraft:end/dragon_egg
- minecraft:adventure/sniper_duel
- minecraft:end/levitate
- minecraft:nether/create_full_beacon
- minecraft:nether/summon_wither
- minecraft:husbandry/balanced_diet
- minecraft:nether/all_effects
- minecraft:nether/fast_travel
- minecraft:nether/get_wither_skull
- minecraft:husbandry/bred_all_animals
- minecraft:story/mine_stone
- minecraft:story/enter_the_nether
- minecraft:adventure/trade
- minecraft:nether/uneasy_alliance
- minecraft:story/mine_diamond
- minecraft:story/upgrade_tools
- minecraft:nether/find_fortress
- minecraft:story/cure_zombie_villager
- minecraft:story/form_obsidian
- minecraft:end/find_end_city
- minecraft:end/enter_end_gateway
- minecraft:nether/obtain_blaze_rod
- minecraft:adventure/shoot_arrow
- minecraft:story/enter_the_end
- minecraft:husbandry/breed_an_animal
- minecraft:end/respawn_dragon
- minecraft:story/smelt_iron
全局配置
全局配置
netty-threads
默认值:4
推荐值:除非你很懂,否则别动
类型:整数
描述:控制Netty执行联网任务的线程的数量。
bungeecord
默认值:false
推荐值:不开群组服就false
类型:布尔型(true或false)
描述:开关蹦极端特性(群组服模式)。包括IP白名单(千万别把这个当最终解决方案,这只是个额外保护措施,你依旧需要设置IPTables!)和IP传递(子服可以得到玩家真实IP)。
timeout-time
默认值:60
推荐值:不懂的话不建议动,硬是想动的话,建议30以上
类型:整数
描述:单位:秒。在服务器失去响应多久之后,开始执行线程转储;如果额外有配置自动重启,将会自动重启。
restart-on-crash
默认值:true
推荐值:如果你配置好了重启脚本,那就设置为true;否则设置为false即可
类型:布尔型(true或false)
描述:设置为true时,如果服务器崩溃了,它将会尝试自动重启。
restart-script
默认值:./start.sh
推荐值:你的脚本名(比如start.bat),如果你的启动脚本和服务端不在一起,那么你还需要输入绝对/相对路径
类型:字符串(File path)
描述:服务器启动脚本的位置,当服务器执行/restart
指令的时候也会用这个脚本来重启。
late-bind
默认值:false
推荐值:如果你检查过没有插件出问题,那就设置为true
类型:布尔型(true或false)
描述:在所有插件都加载完毕之前,延迟玩家进服。请注意,在使用这个功能之前请先测试一下,某些插件配这个功能会出问题。
sample-count
默认值:12
推荐值:随意,不要太大,不喜欢这个功能可以设为0
类型:整数
描述:在多人游戏菜单,当鼠标移动到服务器人数上时,随机挑选几名玩家,将其名字显示出来。
player-shuffle
默认值:0
推荐值:我觉得没有玩家会干这种事,小游戏服可以试试调到6000
类型:整数
描述:防止玩家出于“战略”意图不断退出重进服务器——服务器处理玩家发包的优先级是按玩家登录顺序来的,后登录的玩家的发包会被优先处理。设为20就是每秒钟洗牌一次玩家发包处理优先级。设为100以下可能会出问题(当然设为0是没问题的)。
filter-creative-items
默认值:true
推荐值:true
类型:布尔型(true或false)
描述:让创造模式玩家无法拿到黑名单里的物品。
user-cache-size
默认值:1000
推荐值:超过活跃玩家数即可
类型:整数
描述:在usercache.json文件中存储多少玩家的信息
save-user-cache-on-stop-only
默认值:false
推荐值:false
类型:布尔型(true或false)
描述:设置是否只在服务关闭的时候存储玩家信息
moved-wrongly-threshold
默认值:0.0625
推荐值:如果服务器延迟较大,可以设为0.125
类型:十进制小数
描述:设置“错误移动”的判决门限。这个值设置得较高可以减少服务器的检测,但是可能遭到玩家滥用(例如作弊穿墙等等)
注意:这个设置低是导致xxx moved wrongly
报错的主因;实际上很难防作弊
moved-too-quickly-multiplier
默认值:10
推荐值:如果服务器延迟较大,可以设为10以上
类型:十进制小数
描述:设置“速度过快”的判决门限。这个值设置了玩家实际最大的移动速度能高于服务器规定的多少(百分比)。部分情况下会出问题,比如人间TNT大炮。
注意:老版本是moved-too-quickly-threshold,不是按百分比而是按格数来的。
注意:这个设置低是导致xxx moved too quickly
报错的主因;实际上很难防作弊
log-villager-deaths
默认值:true
推荐值:看个人喜好
类型:布尔型(true或false)
描述:是否记录村民死亡信息
item-dirty-ticks
默认值:20
推荐值:20
类型:整数
描述:控制item-dirty检查的时间间隔。Minecraft每个游戏刻都会检查物品NBT是否有改变。因为这会检查所有的NBT数据,所以会造成很大的性能开销。Spigot只会对物品的数量/数据/类型等数据做基础检查,默认每20游戏刻做一次深度检查。
“Default”对所有世界生效,想要定制某个世界的配置,创建一个与之同级添加别的表(表名为世界名)即可
分世界配置
verbose
默认值:true
推荐值:true
类型:布尔型(true或false)
描述:是否在服务器启动的时候在控制台/日志中显示每个世界的细节报告和配置情况。可以全局或分世界启用/禁用。
view-distance
默认值:10
推荐值:5-8(太低会影响游戏体验)
类型:整数
描述:每个玩家周围加载的区块半径。这个值只能设置在1到15之间。如果你的玩家很多,将这个值减小可以减轻服务器的负载。
注意:在1.14.4,新安装的服务器和升级到这个版本的服务器的该选项的全局设置将默认变为default
。设为default
时,服务器会采用server.properties文件中的设置。这个选项现在可以用于分开设置各个世界的视野距离。
merge-radius:
- ↳ exp
默认值:3.0
推荐值:3.5-4.5(太高会导致经验球穿墙合并到一起)
类型:整数
描述:设置多少格内的掉落在地的经验球会合并到一起 - ↳ item
默认值:2.5
推荐值:3.0-4.0(太高会导致物品穿墙合并到一起)
类型:整数
描述:设置多少格内的掉落在地的同类物品会合并到一起
chunks-per-tick
默认值:650
推荐值:不懂的话默认即可
类型:整数
描述:配置每个tick更新/植物生长的区块数量。设置较低会导致植物生长缓慢,反之亦然。
版本:Spigot 1.9以前
item-despawn-rate
默认值:6000
推荐值:6000(5分钟);如果是游戏服,可以设置为3000甚至更低;如果玩家经常乱丢垃圾,可以降低到3000-4500
类型:整数
描述:控制掉落物会在多少游戏刻之后消失。降低这个数值会让地上的物品更快消失(因为会减少实体数量,所以会降低服务负载,节约资源);增加这个数值会让地上的物品待得更久,消耗更多资源(实体长期保留,会增加服务器负载)。
mob-spawn-range
默认值:6
推荐值:4
类型:整数
描述:玩家附近的刷怪半径,单位是区块。增加这个数字会让怪物显得更少且消失得更快,同样地,降低这个数值会导致部分怪物因为缺少刷怪环境而更难刷出。查阅Minecraft刷怪机制可以获得更多信息。
关于刷怪机制问题
Bukkit服务器:
- 刷怪上限=设定的值x玩家人数x刷怪区块数÷256
原版:
- 刷怪上限=设定的值x刷怪区块数÷289
原版的刷怪机制保证了即使视野距离低于8,也能保证怪物密度和视野距离高于8时大致相等
Bukkit的机制很奇怪?我也觉得,因为如果刷怪半径为8(原版设定),那么实际刷怪区域是(8x2+1)2=289区块
但是我查到的资料显示,Bukkit的修正值就是256……
如果刷怪距离为8(原版设定),那么:
- 刷怪上限≈设定的值x玩家人数
如果降低刷怪距离,那么很明显,设定的怪物上限不变的情况下
- 刷怪上限下降,怪物密度略微上升(玩家附近不允许刷怪,所以刷怪空间其实被挤压了,按原版的计算方式来算也是一个结果)
综上,我建议将刷怪距离控制在4个区块内(64格),离得太远玩家又看不到(除非你设置怪物能在64格外显示给玩家)也打不到(太远了打到了也没太大意义)。
设置得太大会导致部分怪物刷在玩家活动范围外,不停地刷出->冻住->刷掉,造成资源浪费;不过设置得太小可能导致怪物刷不出来或者只刷一圈。
growth:
- ↳ 配置植物生长
下面有 cactus仙人掌, melon西瓜, pumpkin南瓜, sapling树苗, cane藤蔓, mushroom蘑菇, wheat小麦, netherwart下界疣, vine藤蔓, cocoa咖啡豆
默认值:100
推荐值:看需求,100就是按原版生长速度来
类型:整数
描述:控制列出来这些的植物/资源的成长速度。默认(100)情况下,植物生与香草原版速度保持一致,当然也可能因为别的配置(如chunks-per-tick)导致实际速度慢一些。
改变这些值不会提高性能。你改变这项只能用于改变游戏中作物的生长速度/行为,不会提升游戏性能。
entity-activation-range
默认值:(animals: 32, monsters: 32, misc: 16, water: 16)
推荐值:(animals: 24, monsters: 28, misc: 8, water: 8)
类型:整数
描述:配置多少格内的实体出于“活跃”状态,此范围外的实体将会出于一个极不活跃的状态来减少服务器负载。改变这个值可能对游戏体验造成不利影响,请务必谨慎。
降低这些值会提高游戏性能,但是,古尔丹,代价是影响游戏体验。降低这些值会对刷物品机器/刷怪场产生影响,对生物的行为不会产生太大影响。
注意:1.13以上新增的是water
tick-inactive-villagers
默认值:true
推荐值:看情况
类型:布尔型(true或false)
描述:配置在实体活跃范围外的村民是否保持“活跃”状态。
关闭这项意味着村民不会像原版那样活动,而玩家交易之前需要在村民附近待一会等村民补货。
entity-tracking-range
默认值:(players: 48, animals: 48, monsters: 48, misc: 32, other: 64)
推荐值:视情况而定,这些值太大同时玩家/实体太多的话,可能会轻微影响客户端的流畅性和微妙地占用更多网络带宽
(players: 48, animals: 32, monsters: 48, misc: 24, other: 64)
类型:整数
描述:设置实体在客户端的“可见”距离,或者说“追踪”距离。这个距离外的实体将不会被客户端渲染,节省CPU和带宽资源。
- 对于PVP服来说或许有用,降低player值可以一定程度上“阻止”透视和雷达的拓展/模组起效。
- Misc项影响物品展示框、画、掉落物、经验球和告示牌上的字。
- Other项是全局最大值,影响所有实体。
改变这些值不会提高性能。降低这些值可以减轻客户端负担和延迟。
save-structure-info
默认值:true
推荐值:视情况而定,生存服推荐true
类型:布尔型(true或false)
描述:配置服务器是否使用1.6.3引入的方法保存结构信息。如果设为false,可能导致末影之眼不会指向要塞,下界要塞不会生成凋零骷髅,1.7加入的沼泽小屋不会生成女巫等问题。
random-light-updates
默认值:false
推荐值:视情况而定,一般推荐false,因为会占用许多资源
类型:布尔型(true或false)
描述:配置服务器是否会随机检查某个区块发育光照是否正常并尝试修复。1.7版本中这个选项会配置是否在区块加载的第一个游戏刻检查光照。
nerf-spawner-mobs
默认值:false
推荐值:视情况而定,如果你的服务器中大量存在刷怪笼,那么还是设为true为好
类型:布尔型(true或false)
描述:如果设为true,刷怪笼刷出的生物将不再有AI。它们通常只会受水流影响(被冲走),烈焰人除外,它们依旧会发射火球和上下浮动。
zombie-aggressive-towards-villager
默认值:true
推荐值:true,很鸡肋的功能
- 如果你的玩家抱怨僵尸总是杀死他们的村民,你可以设为false
- 如果你的服的玩法中不存在僵尸找村民的机制,同时又存在僵尸,你可以设为false
- 如果你不想要玩家利用僵尸感染村民后村民降价的游戏机制,你可以设为false。
类型:布尔型(true或false)
描述:设为false后,僵尸将不再会尝试追踪和杀死村民。当然此时僵尸因为AI中少了东西,所以消耗的资源也少了,可以轻微地降低卡顿。
enable-zombie-pigmen-portal-spawns
默认值:true
推荐值:true,除非你不想要玩家制造主世界刷金塔或者游戏玩法不需要这些猪人
类型:布尔型(true或false)
描述:设为false后,下界门将不会刷猪人。这个选项可以用于整治大型下界门刷金塔,同时不会影响包括猪人在内的实体穿越下界门来到另一个世界。
max-entity-collisions
默认值:8
推荐值:4-8,如果玩家很喜欢密集养殖场,建议调整到4以下或者BAN了
类型:整数
描述:限制一个实体在一个游戏刻内可以碰撞的次数。降低这个值可以明显降低密集养殖场导致的卡顿。
dragon-death-sound-radius
默认值:0
推荐值:0
类型:整数
描述:末影龙死亡音效可以传多远。
wither-spawn-sound-radius
默认值:0
推荐值:0
类型:整数
描述:凋灵召唤音效可以传多远。
max-bulk-chunks
默认值:10
推荐值:8-16,主要看带宽
类型:整数
描述:设置每个包中最多发送几个区块
版本:Spigot 1.9之前
max-tick-time
默认值:(tile: 50, entity: 50)
推荐值:(tile: 9999, entity: 9999)
- 如果你更看重TPS带来的顺畅游戏体验而不是玩家与实体交互的游戏体验,按照下文描述里的配置是没问题的
- 如果你不想看到玩家打僵尸时玩家攻击击飞僵尸后2秒僵尸才落地,动物像个笨蛋一样只会盯着玩家手里的小麦看看好久才迈一步,同时TPS是20,没有任何卡顿的情况,建议设置为我推荐的9999
- 如果值太低就会出现上一条出现的情况,timings报告甚至会告诉你你的服务器一切正常
类型:整数
描述:单位毫秒。在服务器跳过实体和tile的任务之前,这些实体和tile最多可以花费多少时间。根据报告,tiles:10-20,entities:20-25,是一个不错配置。
降低这些值会提供很大的性能提升,但是会以游戏体验为代价。降低这些值会导致实体出现卡顿、滞后的情况,但是不会改变其行为模式。
clear-tick-list
默认值:false
推荐值:false
类型:布尔型(true或false)
描述:可以防止随着时间流逝导致tick-list变得过大的潜可能题,不过会导致一些问题比如说植物生长缓慢和导致你设置好的值变化。这个选项是为了那些确实有需要而且知道自己在做什么的人准备的。对于大多数腐竹来说,不建议修改,应该保持默认。
hopper-alt-ticking
默认值:false
推荐值:false(影响不大)
类型:布尔型(true或false)
描述:漏斗使用动态游戏刻,表现得和原版一样,同时为每秒的激励提供一个潜在的游戏刻。(抱歉我实在不知道怎么翻译。)如果服务器存在大量空的漏斗,建议开启。启动这个选项后,hopper-check将不再起效。
版本:Spigot 1.8.3以前
hopper-amount
默认值:1
推荐值:1(影响较大,如果你的玩家喜欢无脑铺漏斗,建议和hopper-transfer一起成倍增加)
类型:整数
描述:控制每次漏斗活动时最多可以传输/吸取的物品数。最好结合hopper-transfer一起使用,达到更好的效果。
seed-village
默认值:10387312
推荐值:自己随机一个(没啥影响)
类型:整数
描述:控制这个世界中村庄生成位置的种子,允许更进一步地定制其生成。默认值表示使用原版的。
如果使用原版值,很有可能会有人利用暴力穷举找到你的世界种子。如果你无论如何都想保留世界种子不告诉玩家,那么推荐你在生成世界之前先将这个值替换为随机数。
seed-feature
默认值:14357617
推荐值:自己随机一个(没啥影响)
类型:整数
描述:控制这个世界中特性建筑(比如下界要塞)生成位置的种子,允许更进一步地定制其生成。默认值表示使用原版的。
如果使用原版值,很有可能会有人利用暴力穷举找到你的世界种子。如果你无论如何都想保留世界种子不告诉玩家,那么推荐你在生成世界之前先将这个值替换为随机数。
seed-monument
默认值:10387313 [??]
推荐值:自己随机一个(没啥影响)
类型:整数
描述:控制这个世界中海底遗迹生成位置的种子,允许更进一步地定制其生成。默认值表示使用原版的。
如果使用原版值,很有可能会有人利用暴力穷举找到你的世界种子。如果你无论如何都想保留世界种子不告诉玩家,那么推荐你在生成世界之前先将这个值替换为随机数。
seed-slime
默认值:987234911 [??]
推荐值:自己随机一个(没啥影响)
类型:整数
描述:控制这个世界中史莱姆区块(生成史莱姆的区域)位置的种子,允许更进一步地定制其生成。默认值表示使用原版的。
如果使用原版值,很有可能会有人利用暴力穷举找到你的世界种子。如果你无论如何都想保留世界种子不告诉玩家,那么推荐你在生成世界之前先将这个值替换为随机数。
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 #其他行动额外消耗倍率
推荐值:保持默认(没啥影响)
类型:双精度浮点数
描述:配置在玩家执行相应行为时减少的饥饿值
hanging-tick-frequency
默认值:100
推荐值:100(影响较大,别太小就行)
类型:整数
描述:悬挂起来的实体(画、物品展示框、拴绳等等)的刷新间隔
ticks-per:
- ↳ hopper-transfer
默认值:8
推荐值:8(影响较大,如果你的玩家喜欢无脑铺漏斗,建议和hopper-amount一起成倍增加)
类型:整数
描述:当漏斗 传送/吸取/放入 物品之后多久 传送/吸取 下一个物品。香草原版默认是8tick。 - ↳ hopper-check (在2015年3月25日1.8.3版本中移除,2017年2月10日1.11.2版本重新加入)
默认值:1
推荐值:1(影响很大,如果你的玩家喜欢无脑铺漏斗,就改到2或4或者更高)
类型:整数
描述:漏斗距离上次尝试 传送/吸取 物品多久之后再尝试一次。举个例子,设置为8的话,漏斗会每8tick检测其上方有没有掉落物或者上面的箱子里有没有东西。0或1则使用原版机制(每tick都检查)。如果hopper-alt-ticking设为true,这个选项无效。修改这个选项将导致大部分基于漏斗的机械由于不同步而失效。
paper.yml
基于1.14.4配置文件
全局配置
verbose
默认值:false
推荐值:false,除非你知道你在做什么
描述:设置服务器启动时是否显示所有的配置信息到日志。
load-permissions-yml-before-plugins
默认值:true
推荐值:true
描述:加载插件之前先加载bukkit的permission.yml文件,允许插件在启动时就检查权限情况。
bungee-online-mode
默认值:true
推荐值:不开正版验证就false
描述:指示服务器在作为群组服的子服时如何处理玩家的UUID和数据。你应该设置得与代理服务器的online-mode相匹配。
region-file-cache-size
默认值:256
推荐值:256;磁盘太慢了或者玩家很多,同时磁盘空间还挺大的话,可以尝试512
描述:设置区块文件缓存的最大数量。
incoming-packet-spam-threshold
默认值:300
描述:Sets the threshold at which the server will consider incoming packets as spam and ignore them.
save-player-data
默认值:true
描述:Sets whether the server should save player data, such as inventories, experience, and advancements.
use-alternative-luck-formula
默认值:false
描述:Use alternative luck formula by Aikar, allowing luck to be applied to items that have no quality defined. Makes major changes to fishing formulas.
use-versioned-world
默认值:false
描述:Sets whether the server should save your world in version-specific directories.
warning: This setting is highly experimental! Don’t use this in a production environment!
suggest-player-names-when-null-tab-completions
默认值:true
描述:Instructs the server to return a list of players when tab-completing if the plugin has no tab completions of its own.
enable-player-collisions
默认值:true
描述:Sets whether the server should allow players to collide with one another.
warning: This setting can be broken by plugins interacting with the scoreboard, double check plugins when troubleshooting this value.
save-empty-scoreboard-teams
默认值:false
描述:Some scoreboard plugins leave hundreds of empty scoreboard teams around, dramatically slowing down login times. This sets whether the server should remove those empty teams automatically.
velocity-support
enabled
默认值:false
描述:Set this to true if this server is behind a Velocity proxy.
online-mode
默认值:true
描述:Instructs the server how to handle player UUIDs and data when behind velocity. Set to match your proxy’s online-mode setting.
secret
默认值:‘ ‘ (empty string)
描述:The secret string that is shared by your Velocity proxy and this server. This needs to match your proxy’s forwarding-secret setting.
async-chunks
- enabled
默认值:true
描述:Sets whether the server should load and save chunks asynchronously, improving performance. - load-threads
默认值:-1
描述:The number of threads the server should use for world saving and loading. This is set to (number of processors - 1) by default.
watchdog
- early-warning-every
默认值:5000
描述:The interval in milliseconds between printed thread dumps while the server is hanging. - early-warning-delay
默认值:10000
描述:The number of milliseconds before the watchdog thread starts printing thread dumps after the server starts hanging.
spam-limiter
- tab-spam-increment
默认值:1
描述:The number that the internal tab spam counter increases by when a player presses tab in the chat window. - tab-spam-limit
默认值:500
描述:The number that the internal tab spam counter can reach until the server kicks the player for spam.
book-size
- page-max
默认值:2560
描述:The max number of bytes a single page in a book can contribute to the allowed byte total for a book. - total-multiplier
默认值:0.98
描述:Each page has this multiple of bytes from the last page as it’s contribution to the allowed byte total for a book (with the first page being having a multiplier of 1.0).
messages
- no-permission
默认值:‘&cI’‘m sorry, but you do not have permission to perform this command. Please contact the server administrators if you believe that this is in error.’
描述:The message the server sends to requestors with insufficient permissions. - kick
- authentication-servers-down
默认值:‘ ‘ (empty string)
注意:The default value instructs the server to send the vanilla translateable kick message.
描述:Message to kick a player with when they are disconnected because the Mojang authentication servers are down. - connection-throttle
默认值:Connection throttled! Please wait before reconnecting.
描述:Message to use when kicking a player when their connection is throttled. - flying-player
默认值:Flying is not enabled on this server
描述:Message to use when kicking a player for flying. - flying-vehicle
默认值:Flying is not enabled on this server
描述:Message to use when kicking a player’s vehicle for flying.
- authentication-servers-down
timings
- enabled
默认值:true
描述:Controls the global enable state of the Timings platform. - verbose
默认值:true
描述:Instructs Timings to provide more specific information in its reports. For example, specific entity types causing lag rather than just “entities”.
server-name-privacy
默认值:false
描述:Instructs Timings to hide server name information in reports.
hidden-config-entries
默认值:{ database, settings.bungeecord-addresses }
描述:Configuration entries to hide in Timings reports.
history-interval
默认值:300
描述:The interval in seconds between individual points in the Timings report.
history-length
默认值:3600
描述:The total amount of data to keep for a single report.
警告:This value is validated server side, massive reports will be rejected by the report site.
server-name
默认值:Unknown Server
描述:Instructs timings on what to put in for the server name.
下面这些配置可以分世界起效,创建一个与default同级的表即可;表名为世界名,表内的项目可以不完整,缺失的内容会由default中的代替。
分世界配置
per-player-mob-spawns
默认值:false
描述:Determines whether the mob limit (in bukkit.yml) is counted per-player or for the entire server.
disable-teleportation-suffocation-check
默认值:false
描述:Disables the suffocation check the server performs before teleporting a player.
注意:While useful to keep your players out of walls, leaving this feature on may allow players to teleport through solid materials by logging out in specific locations.
optimize-explosions
默认值:false
描述:Instructs the server to cache entity lookups during an explosion, rather than recalculating throughout the process. This speeds up explosions significantly.
portal-search-radius
默认值:128
描述:The maximum range the server will use to look for an existing nether portal. If it can’t find one in that range, it will generate a new one.
fixed-chunk-inhabited-time
默认值:-1
描述:If 0 or greater, set the chunk inhabited time to a fixed number.
注意:The timer is increased when chunks are kept loaded because of player activity.
use-vanilla-world-scoreboard-name-coloring
默认值:false
描述:Instructs the server to use the vanilla scoreboard for player nickname coloring.
注意:Useful when playing on adventure maps made for the vanilla server and client.
remove-corrupt-tile-entities
默认值:false
描述:Instructs the server to automatically remove tile entities it detects as broken and cannot fix.
enable-treasure-maps
默认值:true
描述:Allows villagers to trade treasure maps.
treasure-maps-return-already-discovered
默认值:false
描述:Instructs the server to target the first treasure location found, rather than the first undiscovered one. Vanilla mechanics normally find the first undiscovered location, which may lead to structures that were not fully looted, and can also fail with a world border set. Enabling this will make the map simply find the closest target structure, regardless if it has been loaded or not already.
experience-merge-max-value
默认值:-1
描述:Instructs the server put a maximum value on experience orbs, preventing them all from merging down into 1 single orb.
注意:The default value instructs the server to use no max value, allowing them to merge down into a single orb. This is especially noticeable when defeating boss monsters.
prevent-moving-into-unloaded-chunks
默认值:false
描述:Sets whether the server will prevent players from moving into unloaded chunks or not.
max-auto-save-chunks-per-tick
默认值:24
描述:The maximum number of chunks the auto-save system will save in a single tick.
falling-block-height-nerf
默认值:0
注意:Values less than 1, will disable this feature.
描述:The height at which falling blocks will be removed from the server.
tnt-entity-height-nerf
默认值:0
注意:Values less than 1, will disable this feature.
描述:The height at which Primed TNT entities will be removed from the server.
filter-nbt-data-from-spawn-eggs-and-related
默认值:true
描述:Instructs the server to remove certain NBT data from spawn-eggs, falling-blocks, and other often abused items in creative mode.
注意:Some adventure maps may require this be turned off to function correctly, but we do not recommend turning it off on a public server.
max-entity-collisions
默认值:8
描述:Instructs the server to stop processing collisions after this value is reached.
disable-creeper-lingering-effect
默认值:false
描述:Disables creepers randomly leaving behind a lingering area effect cloud.
duplicate-uuid-resolver
默认值:saferegen
描述:Specifies the method the server uses to resolve entities with duplicate UUIDs. This can be one of the following values:
saferegen: Regenerate a UUID for the entity, or delete it if they are close.
delete: Delete the entity.
silent: Does nothing, not printing logs.
warn: Does nothing, printing logs.
duplicate-uuid-saferegen-delete-range
默认值:32
描述:If multiple entities with duplicate UUIDs are within this many blocks, saferegen will delete all but 1 of them.
disable-thunder
默认值:false
描述:Disables thunderstorms.
skeleton-horse-thunder-spawn-chance
默认值:0.01
描述:Sets the chance that a “Skeleton Trap” (4 skeleton horsemen) will spawn in a thunderstorm.
disable-ice-and-snow
默认值:false
描述:Disables ice and snow formation.
count-all-mobs-for-spawning
默认值:false
描述:Determines whether spawner mobs and other misc mobs are counted towards the global mob limit.
keep-spawn-loaded-range
默认值:8
描述:The range in chunks around spawn to keep loaded.
keep-spawn-loaded
默认值:true
描述:Instructs the server to keep the spawn chunks loaded at all times.
auto-save-interval
默认值:-1
注意:Default value instructs the world to use Bukkit’s default.
描述:Instructs this world to use a specific value for auto-save instead of bukkit’s global value.
armor-stands-do-collision-entity-lookups
默认值:true
描述:Instructs armor stand entities to do entity collision checks.
non-player-arrow-despawn-rate
默认值:-1
注意:The default value instructs the server to use the same default arrow despawn rate from spigot.yml that is used for all arrows.
描述:The rate, in ticks, at which arrows shot from non-player entities are despawned.
creative-arrow-despawn-rate
默认值:-1
描述:The rate, in ticks, at which arrows shot from players in creative mode are despawned.
water-over-lava-flow-speed
默认值:5
描述:Sets the speed at which water flows while over lava.
grass-spread-tick-rate
默认值:1
描述:Sets the delay, in ticks, at which the server attempts to spread grass. Higher values will result in slower spread.
bed-search-radius
默认值:1
描述:The distance the server checks for a safe place to respawn a player near their bed. Increasing this value gives players a better chance to respawn at their bed should it became obstructed.
use-faster-eigencraft-redstone
默认值:false
描述:Sets whether the server uses theosib’s redstone algorithms, completely overhauling how redstone works. The new algorithms should be many times faster than current vanilla ones.
warning: This may change how redstone works in very extreme edge-cases.
fix-zero-tick-instant-grow-farms
默认值:true
描述:Enable to fix zero-tick instant farms. See bug MC-113809 for more info.
nether-ceiling-void-damage
默认值:false
描述:Instructs the server to do void damage when an entity is on top of the nether ceiling. Use to limit nether ceiling travel in a vanilla-lore friendly way.
allow-non-player-entities-on-scoreboards
默认值:false
描述:Instructs the server to treat non-player entities as if they are never on a scoreboard.
注意:Enabling this value may increase the amount of time the server spends calculating entity collisions.
disable-explosion-knockback
默认值:false
描述:Instructs the server to completely block any knockback that occurs as a result of an explosion.
container-update-tick-rate
默认值:1
描述:The rate, in ticks, at which the server updates containers and inventories.
parrots-are-unaffected-by-player-movement
默认值:false
描述:Makes parrots “sticky” so they do not fall off a player’s shoulder when they move. Use crouch to shake them off.
prevent-tnt-from-moving-in-water
默认值:false
描述:Instructs the server to keep Primed TNT entities from moving in flowing water.
armor-stands-tick
默认值:true
描述:Disable to prevent armor stands from ticking. Can improve performance with many armor stands.
spawner-nerfed-mobs-should-jump
默认值:false
描述:Determines if spawner nerfed mobs should attempt to float (jump) in water.
baby-zombie-movement-modifier
默认值:0.5
描述:Modifies the speed that baby zombies move at, where 0.5 is 50% faster than the mob base speed, and -0.4 would be 40% slower.
allow-leashing-undead-horse
默认值:false
描述:Instructs the server to allow players to leash undead horse types.
all-chunks-are-slime-chunks
默认值:false
描述:Instructs the server to treat all chunks like slime chunks, allowing them to spawn in any chunk.
注意:This may actually decrease your chances of running into a Slime as they now have a much larger potential spawn area.
mob-spawner-tick-rate
默认值:1
描述:How often mob spawners should tick to calculate available spawn areas and spawn new entities into the world.
game-mechanics
disable-pillager-patrols
默认值:false
描述:Disables Pillager patrols and associated AI.
scan-for-legacy-ender-dragon
默认值:true
描述:Determines whether the server searches for the ender dragon when loading older worlds.
disable-chest-cat-detection
默认值:false
描述:Allows you to open chests even if they have a cat sitting on top of them.
shield-blocking-delay
默认值:5
描述:The number of ticks between a player activiating their shield and it actually blocking damage.
disable-end-credits
默认值:false
描述:Instructs the server to never send the end game credits when leaving the end.
disable-player-crits
默认值:false
描述:Instructs the server to disable critical hits in PvP, instead treating them as normal hits.
disable-sprint-interruption-on-attack
默认值:false
描述:Determines if the server will interrupt a sprinting player if they are attacked.
disable-relative-projectile-velocity
默认值:false
描述:Instructs the server to ignore shooter velocity when calculating the velocity of a fired arrow.
disable-unloaded-chunk-enderpearl-exploit:
默认值:true
描述:Prevent enderpearls from storing the thrower when in an unloaded chunk.
max-growth-height
- cactus
默认值:3
描述:Maximum height cactus blocks will naturally grow to. - reeds
默认值:3
描述:Maximum height reed blocks will naturally grow to.
fishing-time-range
- MinimumTicks
默认值:100
描述:The minimum number of RNG ticks needed to catch a fish. - MaximumTicks
默认值:600
描述:The maximum number of RNG ticks before catching a fish.
despawn-ranges
- soft
默认值:32
描述:The number of blocks away from a player in which entities will be randomly selected to be despawned. - hard
default 128
描述:The number of blocks away from a player in which entities will be forcibly despawned.
lightning-strike-distance-limit
- sound
默认值:-1
描述:The distance that players will hear lightning from. - impact-sound
默认值:-1
描述:The distance that players will hear a lightning impact from. - flash
默认值:-1
描述:The distance that players will see lightning flashes in the sky.
frosted-ice
- enabled
默认值:true
描述:Instructs the server to enable (and tick) frosted ice blocks. - delay
- min
默认值:20
描述:minimum RNG value to apply frosted-ice effects at. - max
默认值:40
描述:maximum RNG value to apply frosted-ice effects at.
- min
lootables
- auto-replenish
默认值:false
描述:Instructs the server to automatically replenish lootable containers.
注意:This feature is useful for long-term worlds in which players are not expected to constantly explore to generate new chunks. - restrict-player-reloot
默认值:true
描述:Prevents the same players from coming back and re-looting the same containers over and over. - reset-seed-on-fill
默认值:true
描述:Resets the loot seed each time the lootable is refilled. Effectively randomizing the new loot items on each refill. - max-refills
默认值:-1
描述:Sets the maximum number of times a lootable may be refilled.
注意:The default value will allow a lootable to refilled an infinite number of times. - refresh-min
默认值:12h
描述:The minimum amount of time that must pass before a lootable will be eligible to be refilled.
注意:This field uses time-based values. 12s = 12 seconds, 3h = 3 hours, 4d = 4 days. - refresh-max
默认值:2d
描述:The maximum amount of time that can pass before a lootable is refilled.
注意:This field uses time-based values. 12s = 12 seconds, 3h = 3 hours, 4d = 4 days.
hopper
- cooldown-when-full
默认值:true
描述:Instructs the server to apply a short cooldown when the hopper is full, instead of constantly trying to pull new items. - disable-move-event
默认值:false
描述:Completely disables the InventoryMoveItemEvent for hoppers. Dramatically improves hopper performance but will break protection plugins and any others that depend on this event.
alt-item-despawn-rate
- enabled
默认值:false
描述:Determines if items will have different despawn rates. - items
默认值:{ COBBLESTONE: 300 } (a list of mappings)
描述:Determines how long each respective item despawns in ticks. You can use item names from this enum <https://papermc.io/javadocs/paper/1.14/org/bukkit/Material.html>.
anti-xray
- enabled
默认值:false
描述:Controls the on/off state for the Anti-Xray system. - engine-mode
默认值:1
描述:Sets the Anti-Xray engine mode. Where 1 is to replace hidden blocks with stone and 2 is to replace all blocks with random block data. - chunk-edge-mode
默认值:3
描述:Sets how the engine handles chunk edges. Where 1 is not to obfuscate the edges of chunks with unloaded neighbors, 2 is to not send the chunk until its neighbors are present (similar to a x-1 view distance), and 3 is to load the neighbor so it can properly obfuscate the current edge (similar to an x+1 view distance). - max-chunk-section-index
默认值:3
描述:Controls to what Y value (height) the engine should operate to, expressed in chunk sections.
注意:To determine the total height, use this formula: ($index + 1) * 16. Therefore, the default value of 3 will result in the engine functioning up to Y: 64. - update-radius
默认值:2
描述:Controls the distance in blocks from air or water that hidden-blocks are hidden by the anti-xray engine. - hidden-blocks
默认值:{ gold_ore, iron_ore, coal_ore, lapis_ore, mossy_cobblestone, obsidian, chest, diamond_ore, redstone_ore, clay, emerald_ore, ender_chest }
描述:List of blocks to be hidden in engine mode 1.
注意:This list is using Mojang server names not bukkit names. - replacement-blocks:
默认值:{ stone, oak_planks }
描述:List of blocks that should be replaced by hidden-blocks in engine mode 2.
注意:This list is using Mojang server names not bukkit names.
generator-settings
- flat-bedrock
默认值:false
描述:Instructs the server to generate bedrock as a single flat layer.
squid-spawn-height
- maximum
默认值:0.0
描述:The maximum height at which squids will spawn.
注意:The default value defers to Minecraft’s default setting, which as of 1.12 is the sea-level of the world (usually Y: 64).