简单访问控制

创作者: Zephyrfit
已更新:2026-09-21 08:47:51
164KB

关于此 MOD

可配置的门、大门、储物箱、床、制作/烹饪、制图、推车和船只的公开/私密/白名单访问权限。对目标传送门安全。

简单访问控制

轻量级访问控制,用于 玩家建造的门/大门、容器、床、制作台、烹饪台、制图桌、推车和船只 在《英灵神殿》1.0版本中。

专为小型多人服务器设计,无需结界、公会或团队系统即可实现对象级隐私。

行为

  • 玩家建造的受支撑物体为 默认公开.
  • 创作者永久拥有访问管理权限。
  • 所有者可在以下两者之间切换单个对象:
    • 公开 ——除非明确禁止,否则所有人都可以使用它。
    • 私有 只有所有者才能使用;玩家例外情况不授予访问权限。
    • 白名单 —所有者及明确允许的玩家可以使用它。
  • 每名玩家的规则:
    • 默认 — 遵循对象的公开/私有/白名单模式。
    • 允许 — 始终允许该玩家。
    • 拒绝 — 始终拒绝该玩家。
  • 公开应用显式拒绝规则;私有保持仅所有者可用;白名单生效 拒绝优先于允许,默认拒绝.
  • 主人始终被允许。
  • 完全公开且无有效限制的建筑沿用原版拆解和伤害规则:其他玩家可以摧毁它。
  • 一旦存在有效的限制(私人/白名单模式,或公共模式的拒绝),拆解和玩家伤害将仅限所有者/管理员。
  • 私有和白名单对象受保护:只有所有者/管理员才能销毁它们。
  • 制作站覆盖范围包括工作台、熔炉、大锅和蜜酒壶,当预制体使用瓦尔海姆的 制作站 组件。
  • 烹饪站的隐私设置会同时阻止添加食物/燃料和收取烹饪好的物品。
  • 制图桌隐私会分别保护两项操作:读取共享地图和存放玩家的发现。
  • 购物车隐私涵盖其存储以及通过购物车交互进行的附加和分离操作。
  • 飞船隐私保护涵盖船上存储和操舵/飞船控制。它无法从物理上阻止玩家跳上船。
  • 生物和环境伤害保持原版;此模组阻止未经授权的 玩家 破坏,而非世界模拟。
  • 世界生成的宝箱/门和无玩家创建者的部件会被忽略。

用途

  1. 查看受支持的玩家建造物体或其交互控件之一。
  2. 按住 左Shift 然后按下英灵神殿的 使用 键(E, F等)循环 公开 → 私有 → 白名单 → 公开 不打开窗口。
  3. 按住 左Shift + A 当《英灵神殿》设置为法语时,或者 左 Shift + Q 在其他所有语言中,打开详细的访问控制窗口。
  4. 选择公开/私人/白名单,并将各个玩家设置为默认/允许/拒绝。
  5. 在白名单模式下,将所有允许的玩家设置为 允许.
  6. 更改存储在对象的ZDO中,因此会随世界一同持久保存。

首次添加白名单玩家时,该玩家必须处于连接状态。配置完成后,即使该玩家离线也会保留在白名单中。面板现在会显示明确的白名单摘要,并在当前未检测到其他玩家时显示警告。

已被占领的床是个特例:当 已分配床位强制为私人 = true,Valheim 分配的睡眠者将成为床的所有者。床被强制设为私有,忽略白名单例外,只有该睡眠者可以使用或摧毁它;服务器管理员保留其覆盖权限。

安装

Gale 或其他 Thunderstore 模组管理器(推荐)

  1. 搜索 简易访问控制 由 泽菲特 在你的模组管理器中。
  2. 将其安装到用于加入服务器的 Valheim 配置文件中。
  3. 在专用服务器和每个客户端上安装相同版本的软件包。
  4. 安装或配置更改后,重启英灵神殿和服务器。

模组管理器会自动下载预编译插件并安装声明的BepInEx依赖。普通玩家只需 不 需要 .NET SDK、源代码或 Windows 构建安装程序。

手动安装

  1. 安装 BepInExPack Valheim 5.4.2350 或更高版本。
  2. 下载Thunderstore包并解压。
  3. 复制 BepInEx/插件/简易访问控制/简易访问控制.dll 进入匹配 BepInEx/plugins/SimpleAccessControl 客户端或专用服务器上的目录。
  4. 服务器和每个客户端上必须使用相同版本的 SimpleAccessControl。

已经在对象访问控制列表中的玩家,即使离线也仍会显示在面板中。新玩家必须至少连接过一次服务器后才能被选中。已连接的玩家会从ZNet名册中读取,即使其角色当前未在你附近加载。

多人游戏

安装在 专用服务器和每个客户端。对于由Gale管理的服务器,发布/安装Thunderstore包并将其添加到共享的Gale配置文件中。

该模组故意修补 容器.检查访问权限(长整数) 而不是替换容器打开逻辑,以保持与 MultiUserChest 等同样管理箱子所有权/打开会话的模组兼容。

传送门不在本模组的涵盖范围内。简单访问控制不会修补 传送世界、传送门放置或传送门瞄准,因此留下 目标传送门 自行负责其公共/私人/队伍/管理/公会规则。在本文档中,“门”指木门或铁门等实体门。

悬停文本始终显示有效状态(公开, 私密, 白名单 或 公开但有例外) 且两个快捷方式均已解析。装备锤子/建造工具时会显示破坏状态。原始标记如 使用 从不显示。

界面遵循《英灵神殿》所选语言:法语使用法语文本;英语及其他所有游戏语言使用英语。

维护者/源码构建

本节内容仅供开发者和包维护者参考。通过 Gale 或 Thunderstore 安装时无需此步骤。

单独的源存档包含 安装程序_简单访问控制.cmd在Windows上,它会检测本地的Valheim安装、BepInEx核心和Gale配置文件,针对当前安装的Valheim程序集进行编译,构建本地包,并可将其安装到Gale或本地专用服务器中。其转录内容写入到 安装日志;当缺少 Microsoft .NET SDK 8 时,它可以通过 Windows 程序包管理器提供安装该 SDK 的选项。

对于经过测试的版本, PUBLISH_Thunderstore.cmd 重新构建包并在以下位置发布: 泽菲特 命名空间。Thunderstore 服务账号令牌通过屏蔽的本地输入获取,不会被存储。

配置

生成的文件: BepInEx/配置/zephyrfit.simpleaccesscontrol.cfg

  • 管理修饰键 = 左Shift
  • 面板键 = 无 (自动: A 法语中, Q 其他语言)
  • 为私人强制分配床位 = true
  • ProtectConfiguredPieces = true
  • 管理员覆盖 = true
  • 显示悬停状态 = true
  • 仅在使用建造工具时显示破坏效果 = true
  • 详细日志 = false
  • 容器 = true
  • 门和门 = 真
  • 床 = 真
  • 制作站 = true
  • 烹饪台 = true
  • 制图台 = true
  • 推车 = true
  • 船只 = 是

每个对象类别都可以单独禁用。在服务器和每个客户端上使用相同的类别值,然后在更改文件后重启英灵神殿/服务器。禁用某个类别时,世界中已存储的ACL数据会被保留。

管理修饰符 被两个快捷方式共享(左Shift, 左Alt, 左Ctrl,右侧变体等)。快速循环键始终遵循 Valheim 自身的 使用 绑定,因此使用 F 自动获得 Shift+F, Alt+F,等等。 面板键 = 无 选择 A 为了一款法国游戏,以及 Q 否则;设置一个明确的 按键代码 将其覆盖。Shift/Alt/Ctrl 预设也可直接在访问面板中使用。

已有的1.0.0–1.0.3版本世界会无损迁移:包含至少一条允许规则的旧Private对象将被视为白名单;不包含允许规则的旧Private对象仍保持为Private。

访问窗口的顶部和底部都有“关闭”按钮;按 Escape 键仍然有效。在正常交互期间,破坏状态会被隐藏,装备锤子/建造工具时才会显示,除非 仅在使用建造工具时显示破坏效果 已禁用。

范围 / 安全模型

这是一个物体交互/访问系统,并非完整防破坏保护的替代品。它用于过滤正常使用行为,并在存在有效访问限制后防止未经授权的玩家拆卸或损坏受支持的物体。公共无限制物体仍遵循原版破坏规则。生物和环境伤害被有意保留。

要求

  • 英灵神殿 1.0+
  • BepInExPack Valheim 5.4.2350+
  • 服务器 + 客户端

AI披露

初始实现的很大一部分是在AI辅助下生成的。在Thunderstore上发布时,请包含 AI生成 Thunderstore政策要求的类别。

许可

麻省理工学院

Valheim: 英灵神殿 的热门 MOD

探索适用于 Valheim: 英灵神殿 的最佳MOD,带来新功能、升级画面,以及令人兴奋的方式来改变您的游戏体验。

使用 Xmod 解锁 Valheim: 英灵神殿 的全部潜力 — 今天就探索这些顶级 MOD!