下面把 **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服务器啦！ Loading... 下面把 **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服务器啦！ 最后修改：2025 年 08 月 31 日 © 允许规范转载 赞 如果觉得我的文章对你有用，请随意赞赏