Residence 联动

Residence 在 plugin.yml 中是 softdepend。不安装 Residence 时，VideoPlayer 仍可运行；安装后，区域和屏幕操作会同时考虑 VideoPlayer 权限与领地授权。

授权关系

在 Residence 区域内，创建和删除操作不能只看 videoplayer.action.*：

1. 玩家必须拥有对应 VideoPlayer 权限。
2. 玩家还必须是领地所有者，或满足 Residence 的 padd 控制。
3. 任一检查不通过，操作都应被拒绝。

涉及节点：

• videoplayer.action.create_area
• videoplayer.action.remove_area
• videoplayer.action.create_screen
• videoplayer.action.remove_screen
• 更新、UV、缩放和元数据相关节点

生命周期

静态审查记录显示，Residence 标志或生命周期事件先触发全局延迟刷新，再把每位玩家的权限读取交回对应实体调度上下文。监听器、重试和缓存刷新任务在桥接关闭时取消并注销。

这属于指定版本源码的静态结论，不代表所有 Residence 版本都经过运行验证。

排障

症状	检查顺序
有 VideoPlayer 权限但不能创建	是否位于 Residence、是否为所有者、padd 是否允许
领地外可用、领地内不可用	Residence 标志和领地继承设置
修改标志后没有立即变化	等待延迟刷新，检查插件日志和 Residence 版本
卸载 Residence 后异常	完整重启并确认没有旧监听器/依赖残留；不要热替换插件 JAR