配置参考
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,重点关注:
useLocalResourcePacklocalResourcePackNameresourcePackHash
虚拟线程
{
"enableVirtualThreads": true,
"virtualThreadsForWebOps": true,
"virtualThreadsForPackBuild": true,
"virtualThreadsForOneClickOps": true
}
主要用于把 Web、资源包和部分运维任务尽量从传统阻塞模型里解耦出来。
建议改配置的顺序
建议按下面顺序理解与调整:
- Web 访问与安全
- 性能主开关
- 资源包模式
- 假人 / 生电保护
- 更细的网络与传送链路设置
如果你只是普通运维,很多配置可以优先通过 Web 面板观察后再决定是否改动。