主配置与世界池

主配置位置：

plugins/GTMyWorld/config.yml

存储模式

单端使用本地存储：

storage:
  mode: local
  cluster-id: default
  node-id: auto

多家园服使用 mysql 或 redis，所有家园服填写相同的 cluster-id，连接信息填写在对应节点。

服务器节点

server:
  id: home-1
  accept-new-realms: true
  proxy-channel: BungeeCord
  max-worlds: 8
  max-realms-per-world: 256
  max-realms: 2048

配置	用途
id	当前子服在代理中的真实名称，多家园服不可重复
accept-new-realms	是否接收新家园，维护节点时可设为 false
max-worlds	当前节点最多创建多少个家园世界
max-realms-per-world	每个世界最多容纳多少个家园
max-realms	当前节点总家园上限

多节点会根据可用容量与负载分配新家园。玩家使用 /gtmw home 或接受跨服访问时，由代理连接到家园所在节点。

世界池

world-pool:
  prefix: gtmw
  realms-per-row: 32
  spacing: 1024
  origin:
    x: 0
    y: 80
    z: 0
  keep-inventory: true

spacing 必须大于 levels.yml 中最大的家园直径，并为红石、实体和爆炸预留安全距离。调整 spacing、realms-per-row 或原点只适合新服初始化阶段；已有家园后保持不变。

keep-inventory: true 会让 GTMyWorld 管理的家园世界默认死亡不掉落，不影响普通世界和副本世界。修改后执行 /gtmw admin reload，再在家园世界死亡测试一次；物品和经验应保留。

性能设置

performance:
  heartbeat-seconds: 10
  node-timeout-seconds: 45
  cache-seconds: 120
  autosave-seconds: 15
  max-block-changes-per-tick: 2048
  unload-delay-seconds: 120
  core-sweep-seconds: 60

max-block-changes-per-tick 控制模板分批生成速度。大型模板可适当提高，在线人数较多时保持默认或降低。unload-delay-seconds 控制空闲家园世界等待多久卸载。

服务器全局限制

restrictions:
  redstone: false
  mob-spawn: false
  animal-spawn: true
  pvp: false
  explosion: false
  fire-spread: false
  fluid-flow: true
  max-entities: 200
  max-tile-entities: 500

这些值是全服上限。家园主人只能在允许的范围内调整自己的家园设置。例如 pvp: false 时，玩家无法通过家园 GUI 开启 PVP。

settings.owner-editable 决定哪些设置显示给家园主人：

settings:
  owner-editable:
    - public-access
    - participate-rank
    - redstone
    - mob-spawn
    - animal-spawn
    - pvp
    - fire-spread
    - explosion
    - fluid-flow
    - leaf-decay

返回限制

return-home:
  blocked-servers:
    - dungeon
    - arena
  blocked-world-contains:
    - dungeon
    - arena
    - boss

玩家位于名单中的子服，或世界名包含指定文字时，不能使用快速返回家园。名单忽略大小写。