文档首页 / 参考 / 配置参考
Reference

配置参考

整理当前最常用、最值得优先理解的配置项。 — TreeCore / TreeMC 官方技术文档,面向 Minecraft 服务端运维与开发。

参考 8 分钟

配置参考

TreeCore 配置文件为:

  • treecore.json

首次启动会自动生成,当前既可以:

  • 直接手改 JSON
  • 通过 Web 面板可视化编辑

由于配置项较多,这里只整理最常用、最值得优先理解的部分。


Web 访问

{
  "webServerPort": 8080,
  "webAllowRemote": false,
  "webBindAddress": "127.0.0.1",
  "webRequireAuth": false,
  "webAdminToken": ""
}

建议

  • 单机维护:保留默认值
  • 局域网 / 公网访问:开启 webAllowRemote,并务必启用 webRequireAuth

性能主开关

{
  "enableOptimization": true,
  "dynamicViewDistance": true,
  "dynamicSimulationDistance": true,
  "autoLayeredPresetEnabled": true,
  "msptTarget": 45
}

含义

  • enableOptimization:总开关
  • dynamicViewDistance:动态视距
  • dynamicSimulationDistance:动态模拟距离
  • autoLayeredPresetEnabled:自动分层预设
  • msptTarget:优化器目标 MSPT

网络 / 传送链路

{
  "deltaAwarePacketFilter": true,
  "tabListBatchEnabled": true,
  "teleportPreloadEnabled": true,
  "chunkPreloadEnabled": true,
  "loginStormProtectionEnabled": true,
  "broadcastScopeReductionEnabled": true
}

这一组更偏向:

  • 网络冗余控制
  • 多人进入保护
  • 远距离移动与传送体验优化

生电 / 假人

{
  "fakePlayerEnabled": true,
  "fakePlayerMaxCount": 16,
  "fakePlayerDefaultLifetimeSeconds": 600,
  "carpetDuplicationEnabled": false,
  "tntDuplicationEnabled": false,
  "redstoneOptimizationEnabled": false,
  "redstoneHotspotThrottle": false,
  "redstoneHeatReplayEnabled": false
}

理解方式

  • 假人系统默认开启
  • TNT / 地毯复制默认关闭
  • 红石热点保护与回放默认关闭

也就是说:

默认更偏原版与保守策略,需要时再逐项打开。


资源包

{
  "resourcePackUrl": "",
  "resourcePackHash": "",
  "forceResourcePack": false,
  "resourcePackPrompt": "",
  "useLocalResourcePack": false,
  "localResourcePackName": "pack.zip"
}

两种使用方式

  • 外部 URL 模式
  • 本地托管 ZIP 模式

如果你使用 Web 面板拖拽上传 ZIP,重点关注:

  • useLocalResourcePack
  • localResourcePackName
  • resourcePackHash

虚拟线程

{
  "enableVirtualThreads": true,
  "virtualThreadsForWebOps": true,
  "virtualThreadsForPackBuild": true,
  "virtualThreadsForOneClickOps": true
}

主要用于把 Web、资源包和部分运维任务尽量从传统阻塞模型里解耦出来。


建议改配置的顺序

建议按下面顺序理解与调整:

  1. Web 访问与安全
  2. 性能主开关
  3. 资源包模式
  4. 假人 / 生电保护
  5. 更细的网络与传送链路设置

如果你只是普通运维,很多配置可以优先通过 Web 面板观察后再决定是否改动。