Minecraft server.properties 配置文件完全指南 📋 概述
server.properties 是 Minecraft Java版服务器的核心配置文件，控制着服务器的各项功能和行为。本指南将详细介绍每个配置项的作用和推荐设置。
⚠️ 重要提示：
修改配置后需要重启服务器才能生效
🌐 网络设置 配置项默认值类型说明server-ip空字符串服务器绑定IP（留空表示绑定所有网络接口）server-port25565整数服务器主端口query.port25565整数查询服务端口rcon.port25575整数RCON远程控制端口network-compression-threshold256整数网络压缩阈值（字节），0=始终压缩，-1=禁用prevent-proxy-connectionsfalse布尔是否阻止通过代理连接🔧 网络优化建议 压缩阈值：建议设置为 256，平衡性能和带宽端口设置：确保防火墙开放相应端口🏷️ 基础设置 配置项默认值类型说明motdA Minecraft Server字符串服务器描述（在服务器列表中显示）server-nameUnknown Server字符串服务器名称（RCON中显示）max-players20整数服务器最大玩家容量online-modetrue布尔重要：是否启用正版验证difficultyeasy字符串游戏难度gamemodesurvival字符串默认游戏模式force-gamemodefalse布尔是否强制玩家使用默认游戏模式hardcorefalse布尔是否启用极限模式pvptrue布尔是否允许玩家对战allow-flightfalse布尔是否允许飞行📝 配置说明 游戏难度选项 peaceful - 和平模式（无怪物）easy - 简单模式normal - 普通模式（推荐）hard - 困难模式游戏模式选项 survival - 生存模式（推荐）creative - 创造模式adventure - 冒险模式spectator - 观察者模式🌍 世界设置 配置项默认值类型说明level-nameworld字符串世界文件夹名称level-seed空字符串世界生成种子level-typeminecraft:normal字符串世界类型generator-settings{}JSON自定义世界生成器设置generate-structurestrue布尔是否生成结构（村庄、要塞等）allow-nethertrue布尔是否允许下界max-world-size29999984整数世界最大半径（方块）spawn-protection16整数出生点保护半径🗺️ 世界类型说明 类型说明minecraft:normal标准世界生成minecraft:flat超平坦世界minecraft:large_biomes大型生物群系minecraft:amplified放大化世界（需要强劲硬件）⚡ 性能设置 配置项默认值类型说明view-distance10整数重要：玩家视距（区块数，2-32）simulation-distance10整数服务器模拟距离（区块数，3-32）max-tick-time60000整数单tick最大处理时间（毫秒）max-chained-neighbor-updates1000000整数连锁更新最大次数sync-chunk-writestrue布尔同步区块写入use-native-transporttrue布尔使用本地传输优化（Linux）entity-broadcast-range-percentage100整数实体广播范围百分比🎯 性能优化推荐 根据服务器规模调整 服务器规模view-distancesimulation-distancemax-players小型（1-10人）6-86-810-20中型（10-30人）8-108-1030-50大型（30+人）6-86-850+👑 权限管理 配置项默认值类型说明enable-command-blockfalse布尔是否启用命令方块function-permission-level2整数函数执行权限等级（1-4）op-permission-level4整数OP权限等级（1-4）white-listfalse布尔是否启用白名单enforce-whitelistfalse布尔是否强制执行白名单broadcast-console-to-opstrue布尔是否向OP广播控制台消息🔒 权限等级说明 等级权限描述1绕过重生点保护2使用命令方块，/clear、/difficulty、/effect、/gamemode、/gamerule、/give、/summon、/setblock 和 /tp3使用 /ban、/deop、/kick 和 /op4使用 /stop🛡️ 安全设置 配置项默认值类型说明enforce-secure-profiletrue布尔强制安全配置文件（1.19+）log-ipstrue布尔是否记录玩家IP地址text-filtering-config空字符串文本过滤配置文件路径hide-online-playersfalse布尔是否隐藏在线玩家列表rate-limit0整数连接速率限制（数据包/秒，0=无限制）📦 资源包设置 配置项默认值类型说明resource-pack空字符串资源包下载URLresource-pack-sha1空字符串资源包SHA1校验值require-resource-packfalse布尔是否强制要求资源包resource-pack-prompt空字符串资源包提示信息（支持JSON格式）resource-pack-id空字符串资源包唯一标识符（1.20.3+）💡 资源包配置示例 propertiesresource-pack=https://example.com/resourcepack.zip
resource-pack-sha1=abc123def456...
require-resource-pack=true
resource-pack-prompt={"text":"请安装服务器资源包","color":"gold"}🔧 高级设置 配置项默认值类型说明enable-jmx-monitoringfalse布尔启用JMX监控enable-queryfalse布尔启用查询服务enable-rconfalse布尔启用RCON远程控制rcon.password空字符串RCON密码enable-statustrue布尔启用服务器状态查询player-idle-timeout0整数玩家空闲超时（分钟，0=禁用）🖥️ RCON配置示例 propertiesenable-rcon=true
rcon.port=25575
rcon.password=your_secure_password_here⚠️ 重要注意事项 🚨 关键配置警告 MOTD中文显示
❌ 错误：直接输入中文会显示乱码✅ 正确：使用 MOTD生成工具 生成正确格式世界名称限制
❌ 错误：level-name=我的世界✅ 正确：level-name=myworld🔥 警告：中文世界名会导致服务器无法启动正版验证变更
⚠️ 重要：服务器运行后不建议修改 online-mode📝 原因：会导致玩家UUID变更，造成数据丢失🔗 参考：UUID详解💡 最佳实践 备份配置：修改前先备份 server.properties逐步调整：一次只修改少量配置项性能监控：关注TPS和内存使用情况日志检查：修改后查看启动日志是否有错误🛠️ 配置模板 🏠 小型服务器 properties# 基础设置
motd=\\u00A76\\u00A7l我的家庭服务器
max-players=10
difficulty=normal
gamemode=survival
# 性能优化
view-distance=8
simulation-distance=8
max-tick-time=60000
# 安全设置
online-mode=true
white-list=true
spawn-protection=16🏢 公共服务器（大型） properties# 基础设置
motd=\\u00A7a\\u00A7l欢迎来到我们的服务器！
max-players=100
difficulty=normal
gamemode=survival
# 性能优化
view-distance=6
simulation-distance=8
entity-broadcast-range-percentage=80
# 安全设置
online-mode=true
enforce-secure-profile=true
rate-limit=300
player-idle-timeout=30🔧 故障排除 常见问题 Q: 服务器启动失败？
A: 检查以下项目：
level-name 是否包含中文或特殊字符端口是否被占用eula.txt 是否设置为 eula=trueQ: 中文MOTD显示乱码？
A: 使用Unicode转义序列或MOTD生成工具
Q: 玩家连接失败？
A: 检查：
online-mode 设置是否正确网络端口是否开放白名单设置📞 技术支持 如果在配置过程中遇到问题：
官方交流群：1034218113官方工单系统：客服中心（工单会在三个工作日内回复）实时客服：工作时间 9:00-18:00🔗 相关文档 服务端文件结构详解性能优化指南插件安装指南权限管理教程