📦 首次安装

目标：先让两个子服的基础同步稳定工作，再启用备份与预加载。

1. 安装前准备

• 阅读兼容性与限制，所有子服使用相同 InvSync 版本。
• 准备 Redis，以及 MySQL 或 MongoDB 中的一种。数据库、Redis 不要直接暴露到不可信网络。
• 所有参与同步的子服使用同一持久化库，同一 Redis 数据库编号与前缀。
• 保持玩家 UUID 策略一致，不在切换过程中改变正版/离线认证与代理转发配置。
• 备份各服世界、玩家数据与数据库。如果原来已有其他同步插件，先走迁移指南，不要让两套插件同时对玩家写档。

2. 安装主插件

在每个参与同步的子服安装对应版本主插件，启动一次生成配置后停服。基础同步不要求安装预加载代理插件。

首次初始化

数据库没有该玩家数据时，InvSync 会使用当前子服的玩家数据建立记录。已有多份本地存档时，应先规划哪份为权威数据，不要让玩家随机先进入任意子服。

3. 配置数据服务

下面只展示需要改的片段，合并到已生成的配置，不能覆盖整份配置。

# Redis 服务地址，端口默认 6379；数据库编号默认 0。
redis:
  host: '10.0.0.2'
  port: 6379
  database: 0
  # 未设置密码时留空；参与同一套同步的子服保持一致。
  password: ''
  # 默认空字符串；用于隔离 Redis 键，不隔离持久化主表。
  prefix: ''
# 持久化类型，默认 mysql；也可选择 mongodb。
storage: 'mysql'
mysql:
  host: '10.0.0.3'
  port: 3306
  database: 'invsync'
  user: 'invsync'
  passwd: '替换为实际密码'
  ssl: false

MySQL 数据库需要预先存在，账号需要相应建表、升级表和读写权限。TLS 按实际数据库证书与连接要求设置，不盲目切换 ssl。

选择 MongoDB 时改 storage: mongodb，填写生成配置里的 mongodb 分组。需要认证时按实际设置 authenticationDatabase、user、passwd。

4. 选择同步项

默认开启背包、末影箱、经验、生命、饥饿、统计、进度和药水效果。游戏模式、最大血量、PDC、OP、Vault 和位置默认关闭。见配置参考。

大厅或小游戏不需要共享背包时，不要直接复制生存服配置加入同一数据集；仅改 Redis 前缀不能完整隔离存档。

5. 启动并验证

1. 启动数据服务和子服。
2. 检查 Redis 与持久化存储连接成功，且插件未被禁用。
3. 用测试账号执行同步验证。
4. 主流程稳定后，开启自动保存与备份。
5. 需要预加载加速时，按预加载部署配置代理端组件；该功能已随主插件提供，不需要额外付费。

配置修改

/invsync reloadLang 只重载语言文件，不是完整配置重载。修改数据库、Redis、同步或备份配置后，安排正常停服重启，避免热卸载与强制终止。