08 建家权限：购买、赠送、托管与卸载
建家权限是基于 SCUM 服务器的 AdminUsers.ini 实现的特殊权限。玩家获得权限后，服务器文件中会增加一行类似：
76561199174639885[SetGodMode]玩家进入游戏后使用：
#SetGodMode True即可开启建造相关权限。
商城的目标是只让玩家使用建造权限，不把它当成真正管理员权限使用。因此这套功能会同时做三件事：
- 同步
AdminUsers.ini。 - 记录哪些 SteamID 是商城托管的建家权限。
- 监管建家权限玩家是否违规使用其他管理命令或离开领地范围。
示例视频预留
这里后续可放“建家权限从购买到生效”的视频，例如：/mp4/newwebdoc/08-build-permission-flow.mp4
一、后台入口
常用入口有两个：
后台 -> 支付设置 -> 建家权限
后台 -> 日志命令 -> 服务器权限管理支付设置主要用于配置玩家自助购买。
服务器权限管理主要用于查看、赠送、卸载和同步 AdminUsers.ini。
首次使用前，建议先备份服务器原始文件：
Saved/Config/WindowsServer/AdminUsers.ini如果远程路径不同，需在日志服务器、FTP/SFTP 或建家权限相关配置中指定正确路径。
二、建家权限托管开关
建家权限托管 是总开关。
开启后：
- 玩家可以购买建家权限。
- 后台可以赠送临时建家权限。
- 程序会同步
AdminUsers.ini。 - 程序会监管建家权限玩家。
关闭后：
- 玩家不能购买建家权限。
- 后台不应再上传建家权限变更。
- 建家权限监管不再处理玩家管理命令。
如果服主只是想手动维护服务器管理员，不建议开启建家权限托管。
三、初始管理与建家权限的区别
首次同步时，程序会下载服务器当前的 AdminUsers.ini。文件里已有、且没有被商城标记为建家权限的 SteamID，会视为初始管理。
初始管理：
- 是服务器原本的管理员。
- 不受建家权限监管。
- 不会因为使用管理命令而被踢出。
建家权限：
- 来自商城购买、补单或后台赠送。
- 会写入
管理权限表。 user.是否管理员会被标记为3，用于区分商城托管建家权限。- 到期、下线或违规时会被卸载。
永久管理权限：
- 可以在后台新增。
- 不受建家权限监管。
- 不应修改
user.是否管理员。
四、玩家自助购买条件
玩家端通常在：
玩家前端 -> 充值 -> 建家权限购买前需要满足：
- 建家权限托管已开启。
- 分钟售价大于 0。
- 购买分钟数不低于最低限制。
- 玩家会员等级达到要求。
- 玩家已有领地旗数据。
- 支付完成并回调成功。
玩家购买成功后，游戏内会收到提示，提醒使用 #SetGodMode True。
如果玩家说“支付了但没权限”，管理应先查建家权限订单是否支付完成，再查服务器权限管理中的同步状态。
如果玩家已有未到期建家权限，再次购买或后台赠送会在当前到期时间基础上追加时长。
五、后台赠送建家权限
后台可在玩家信息操作面板或服务器权限管理里赠送建家权限。
推荐使用流程：
- 输入玩家 SteamID 或从玩家信息中选择。
- 填写分钟数。
- 提交赠送。
- 页面提示“已提交同步”。
- 等待同步状态变为成功。
这里的“已提交”不等于服务器文件已经上传完成。上传需要 SFTP/FTP 可用，且远程路径能找到 AdminUsers.ini。
六、为什么赠送后有时前端提示网络失败
建家权限上传远程文件可能比较慢。当前设计是数据库写入成功后快速返回，再后台同步文件。
玩家或管理看到的常见状态：
| 状态 | 含义 |
|---|---|
| 已提交同步 | 数据已写入，正在等待上传 AdminUsers.ini |
| 正在上传 | 后端正在上传权限文件 |
| 同步完成 | 文件已同步，权限应生效 |
| 同步失败 | 远程连接、路径、权限或文件写入失败 |
如果一直不同步，优先检查 SFTP/FTP 配置和远程 Saved/Config/WindowsServer/AdminUsers.ini 路径。
七、到期、下线与提前结束
建家权限会记录到期时间。到期后程序会卸载权限并重新同步 AdminUsers.ini。
玩家下线后也会卸载建家权限，避免玩家离线期间仍保留服务器管理员行。
玩家还可以在游戏内主动发送：
@结束建家权限用于提前结束当前建家权限。
到期卸载不会主动踢出玩家。权限状态如果在游戏内没有及时刷新，玩家重新进服即可。
注意
玩家下线后也会卸载建家权限。当前设计不是“剩余时间下次继续使用”，而是为了降低临时权限离线留存在服务器文件里的风险。
八、违规处理
建家权限玩家只允许使用：
SetGodMode true如果日志中检测到托管建家权限玩家使用其他管理命令，程序会：
- 记录违规。
- 卸载该玩家建家权限。
- 同步
AdminUsers.ini。 - 发送踢出命令：
#Kick 玩家SteamID这里是踢出，不是封禁。玩家被踢出后需要重新进入服务器。
九、领地范围保护
建家权限只允许在玩家自己的领地旗附近使用。
程序会从 RCON 返回的领地旗数据同步到建家权限领地旗表。一个玩家可能有多个领地旗，因此不会只依赖 user 表里的单一坐标。
规则说明：
- 玩家在领地旗范围内：正常。
- 玩家超出最近领地旗范围约 100 米：传送回最近领地旗。
- 找不到有效领地旗：可能无法购买或无法正常监管。
玩家问“为什么我被拉回去”，一般就是离开了建家权限允许范围。
十、常见玩家问题
问：我买了建家权限，为什么还不能建？
答：请在游戏聊天输入 #SetGodMode True。如果仍不行，管理需要确认建家权限同步是否完成。
问：我重复购买会叠加时间吗？
答：会。未到期时再次购买，会在当前到期时间后继续追加。
问：为什么我被传送回旗帜附近？
答：建家权限只允许在自己的领地旗范围内使用。离开范围后系统会把你传回最近的领地旗。
问：为什么我被踢出了？
答：建家权限只允许使用建造权限相关命令。如果使用了其他管理命令，系统会卸载权限并踢出一次。
问：权限到期后为什么还显示能用？
答：服务器权限文件已经卸载后，游戏内状态可能需要重新进服刷新。
十一、管理排障检查表
- 建家权限托管是否开启。
- 价格是否大于 0。
- 玩家是否有领地旗。
- 订单是否支付完成。
管理权限表是否有该 SteamID。user.是否管理员是否为3。- SFTP/FTP 是否能上传
AdminUsers.ini。 - 服务器权限管理列表里来源是否显示正确。
- 玩家是否使用了非
SetGodMode true命令。 - 下权限后是否已完成上传。
- 是否误开启了允许空
AdminUsers.ini上传。
注意
不要手动把普通玩家长期加入 AdminUsers.ini，否则商城无法判断这是初始管理还是临时建家权限。需要托管就让商城写入，需要永久管理就走后台“永久管理权限”。
空文件保护
程序默认会拒绝上传空 AdminUsers.ini。除非非常清楚后果，不建议开启允许空文件上传。