下面把 Bedrock Dedicated Server（BDS） server.properties 文件里出现的所有字段，按“用途-可选值-常见坑”三段式逐条解释。看完就能按需改配置，知道哪个键会影响游戏玩法、性能还是安全。
🌐 基本信息
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| server-name | 显示在服务器列表里的名字 | 任意字符串（不含分号） | 只影响展示，不影响连接 |
| level-name | 存档文件夹名 | 默认 Bedrock level | 改名会生成新世界，旧世界不会自动迁移 |
| level-seed | 地图种子 | 任意字符串/留空随机 | 只在第一次生成世界时生效，改后需删世界重开 |
🎮 游戏规则
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| gamemode | 新玩家默认模式 | survival creative adventure | 如果 force-gamemode=false，已来过世界的玩家保持上次退出时的模式 |
| force-gamemode | 强行把旧玩家拉回 gamemode 设定 | true/false | 开 true 会覆盖玩家上次记录的模式 |
| difficulty | 世界难度 | peaceful easy normal hard | 和平模式不会刷怪，经验农场直接失效 |
| allow-cheats | 是否允许指令（/gamemode、/give 等） | true/false | 关服后改值再开即可生效，无需重开世界 |
👥 玩家与权限
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| max-players | 人数上限 | 任意正整数 | 只是软上限，超了也能挤进来，用脚本踢人更靠谱 |
| online-mode | 强制 Xbox Live 验证 | true/false | 关=离线服，外网必被刷号；开=正版/外置登录才能进 |
| allow-list （旧称 white-list） | 开白名单 | true/false | 为 true 时必须在 allowlist.json 里列出玩家 XUID |
| default-player-permission-level | 新人默认权限 | visitor member operator | 访客只能看不能破坏方块 |
🌏 网络端口
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| server-port | IPv4 监听端口 | 1-65535，默认 19132 | 云服务器安全组/路由器要放行UDP |
| server-portv6 | IPv6 监听端口 | 默认 19133 | 同上要放行 UDP |
| enable-lan-visibility | 是否在局域网广播 | true/false | 多开服务器时建议关，避免端口冲突 |
🖼️ 性能与视距
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| view-distance | 最大服务端发送视距（区块） | ≥5 整数，默认 32 | 视距越大，带宽/内存占用越高，低配机建议 10-16 |
| tick-distance | 世界更新半径（区块） | 4-12，默认 4 | 调高会让红石/作物在更远的地方工作，但 CPU 吃紧 |
| max-threads | 最大工作线程数 | 0=自动，或正整数 | 一般别动，0 即可，设太高可能反降性能 |
| player-idle-timeout | 挂机多久踢出（分钟） | 0=不踢 | 适合公共服防占坑 |
🎨 资源包与外观
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| texturepack-required | 强制使用服务器材质包 | true/false | 为 true 时客户端必须下载并启用指定包 |
| disable-persona | 禁用商城角色（内部） | 默认 false | 不必改 |
| disable-custom-skins | 禁用自定义皮肤 | true/false | 开 true 后玩家只能穿商城/默认皮肤，防“恶心皮肤” |
💬 聊天限制
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| chat-restriction | 聊天级别 | None Dropped Disabled | Dropped 只提示“聊天已禁用”；Disabled 连输入框都不给 |
| disable-player-interaction | 玩家间完全不可交互 | true/false | 极端防熊，连 PVP、交易、推车都不能做 |
🛠️ 网络/调试高级开关
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| compression-threshold | 最小压缩包大小（字节） | 0-65535 | 0=全部压缩，延迟低但 CPU 高 |
| compression-algorithm | 压缩算法 | zlib / snappy | snappy 更快，zlib 更小 |
| server-authoritative-movement-strict 系列 | 反作弊：位置、下马、实体交互、方块破坏 | true/false | 开 true 高延迟玩家会频繁被拉回 |
| player-position-acceptance-threshold | 允许客户端与服务端坐标误差 | 默认 0.5 格 | 设太大容易“穿墙”，太小高延迟卡 |
| block-network-ids-are-hashes | 用哈希值代替顺序 ID 传输方块 | true/false | 默认 true，别动 |
🐛 调试 / 脚本
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| content-log-file-enabled | 把内容错误写日志 | true/false | 开 true 便于排查脚本/行为包报错 |
| allow-outbound/inbound-script-debugging | 允许脚本调试器连接 | true/false | 生产环境务必关，防止 RCE |
| script-debugger-auto-attach 系列 | 自动连调试器 | disabled connect listen | 同上，仅开发用 |
| script-watchdog-* 系列 | 脚本性能看门狗 | 见注释 | 默认已开，内存/耗时超阈值自动关服 |
📁 世界生成 / 客户端生成
| 键 | 用途 | 可选值/示例 | 常见坑 |
|---|---|---|---|
| client-side-chunk-generation-enabled | 允许客户端生成远景区块 | true/false | 关 false 可减轻客户端卡顿，但远处会空 |
| server-build-radius-ratio | 服务端生成区块比例 | Disabled 或 0-1 小数 | 设 1.0 全由服务端生成，客户端不省 CPU |
🔚 一句话总结
- 想改玩法：改
gamemode、difficulty、allow-cheats。 - 想防熊：开
online-mode=true、allow-list=true、server-authoritative-*=true。 - 想省性能：降
view-distance、tick-distance，或关client-side-chunk-generation-enabled。 - 调试脚本：才需要动
script-*、diagnostics-*，生产环境保持默认即可。
拿着这份对照表，就能精确调整你的MC服务器啦！