扎伊的必需品

扎伊的必需品

为你的服务器提供家园、传送和传送点功能。/sethome 和 /home 按权限限制数量,/tpa 请求通过弹窗回应,绝不会锁定你的控制,以及由管理员创建的传送点,带冷却和 VIP 等级。通过全屏游戏内管理面板进行管理。为 V3.3 构建。

[size=6][b][color=#e59bff]Zay 的[/color] [color=#c86bff]基础功能[/color][/b][/size]
[b][i]为你的《7 Days to Die》服务器提供家点、传送、传送点和真正的管理面板——在游戏内设置,而不是修改配置文件。[/i][/b]

[b][color=#10b981]● 为 V3.3 打造[/color][/b] · [b][color=#0ea5e9]⇄ 服务端 + 客户端[/color][/b] · [b][color=#ef4444]⛔ 关闭 EAC[/color][/b] · [b][color=#c86bff]✚ 兼容附加模组[/color][/b]
[line]
[quote][size=5][b]✨ [color=#f59e0b]2.10.0[/color] 的新内容[/b][/size]
[b][color=#c86bff]传送点来了。[/color][/b] 管理员可以放置命名的传送点——城镇、每个商人、社区基地——玩家输入 [font=Courier New]/warps[/font] 从列表中挑选,或输入 [font=Courier New]/warp <名称>[/font] 直接前往。每个传送点都可以有自己的冷却时间,并且可以只保留给 VIP 或管理员。

[b][color=#c86bff]可在 V3.3 上运行。[/color][/b] 本次更新破坏了 [font=Courier New]/essadmin[/font] 面板;现已修复并为 V3.3 重建。[u]你的配置和所有已保存的家点都会保留。[/u][/quote][line]
[heading]🏠 [color=#f59e0b]功能[/color][/heading]
[list]
[][b][color=#c86bff]家点[/color][/b] — 保存家点的位置 [i]以及[/i] 你面朝的方向,之后随时传送回来。[/]
[][b][color=#c86bff]多 home[/color][/b] — 可选的命名家点([font=Courier New]/sethome base2[/font]),每个权限等级有数量上限。[/]
[][b][color=#c86bff]传送请求[/color][/b] — [font=Courier New]/tpa[/font] 和 [font=Courier New]/tpahere[/font],通过弹窗应答,[u]绝不会锁定你的操作[/u]。继续游戏;按住 [b]LeftAlt[/b] 释放鼠标并点击 [b]YES[/b] 或 [b]NO[/b]。[/]
[][b][color=#c86bff]传送安全[/color][/b] — 每个目的地都会被检查,所以没人会落在墙里或地下。[/]
[][b][color=#c86bff]游戏内管理面板[/color][/b] — [font=Courier New]/essadmin[/font] 打开全屏面板:左侧分页,设置以带标题的卡片呈现,一个 [b]APPLY[/b] 按钮。[s]编辑 XML 文件[/s] 无需重启,无需编辑文件。[/]
[][b][color=#c86bff]传送点[/color][/b] — 管理员为所有人创建的目的地,每个都有自己的冷却时间和访问等级。[/]
[][b][color=#c86bff]按等级设置家点上限[/color][/b] — 给 VIP 更多家点,无需改动其他任何东西。[/]
[][b][color=#c86bff]为其他模组留出空间[/color][/b] — 其他模组可以在同一面板上添加自己的分页,让你的服务器保持[u]一个[/u]管理窗口。[/]
[][b][color=#c86bff]安静设计[/color][/b] — 成功的传送不会刷聊天消息。只有失败时才会提示。[/]
[/list][line]
[heading]⌨️ [color=#0ea5e9]玩家命令[/color][/heading]
[list]
[][b][color=#c86bff]/sethome[/color][/b] — 保存你的主家点[/]
[][b][color=#c86bff]/sethome -o[/color][/b] — 覆盖它(已有家点后需要此参数)[/]
[][b][color=#c86bff]/sethome 名称[/color][/b] — 保存一个命名家点(仅多 home 模式)[/]
[][b][color=#c86bff]/home[/color][/b] — 传送到你的主家点[/]
[][b][color=#c86bff]/home 名称[/color][/b] — 传送到命名家点[/]
[][b][color=#c86bff]/return[/color][/b] 或 [b][color=#c86bff]/back[/color][/b] — 返回你上次传送前的位置(默认关闭)[/]
[][b][color=#c86bff]/delhome 名称[/color][/b] — 删除一个家点[/]
[][b][color=#c86bff]/listhomes[/color][/b] 或 [b][color=#c86bff]/homes[/color][/b] — 列出你的家点和上限[/]
[][b][color=#c86bff]/tpa 玩家[/color][/b] — 请求传送到某人处[/]
[][b][color=#c86bff]/tpahere 玩家[/color][/b] — 请求某人传送到你处[/]
[][b][color=#c86bff]/tpaccept[/color][/b] 或 [b][color=#c86bff]/tpyes[/color][/b] — 接受请求[/]
[][b][color=#c86bff]/tpdeny[/color][/b] 或 [b][color=#c86bff]/tpno[/color][/b] — 拒绝请求[/]
[][b][color=#c86bff]/warps[/color][/b] — 打开传送点列表[/]
[][b][color=#c86bff]/warp 名称[/color][/b] — 传送到该传送点[/]
[/list][heading]🛠️ [color=#ef4444]管理员命令[/color][/heading]
[list]
[][b][color=#c86bff]/essadmin[/color][/b] — 打开管理面板[/]
[][b][color=#c86bff]/essadmin help[/color][/b] — 列出每项设置的聊天命令版本[/]
[][b][color=#c86bff]/tp 玩家[/color][/b] — 将自己传送到某位玩家处[/]
[][b][color=#c86bff]/tphere 玩家[/color][/b] — 将某位玩家传送到你处[/]
[/list]面板中的所有功能也都可以通过聊天命令使用:
[code]/essadmin status # 显示每项设置
/essadmin reload # 重新读取配置文件
/essadmin multihome on # 允许命名家点
/essadmin limit 10 5 # 权限等级 10 获得 5 个家点
/essadmin cooldown 30 # 传送之间的秒数
/essadmin setwarp town # 在你站立处创建传送点(或将其移到这里)
/essadmin warpcd town 60 # 为该传送点设置独立的 60 秒冷却
/essadmin warplevel town 10 # 只有等级 10 及以下可见[/code][line]
[heading]🧭 [color=#8b5cf6]三步设置传送点[/color][/heading]
[list=1]
[]打开 [font=Courier New]/essadmin[/font] 并进入 [b]Warps[/b] 分页。[/]
[]输入名称,在你站立的位置按下 [b]ADD HERE[/b]。传送点会保留你面朝的方向。[/]
[]设置其 [b]冷却[/b] 和 [b]等级[/b],然后按下 [b]APPLY[/b]。完成。[/]
[/list][table][tr][th]等级[/th]
[th]谁能看到该传送点[/th]
[/tr]
[tr][td]1000[/td]
[td]👥 所有人[/td]
[/tr]
[tr][td]1 到 999[/td]
[td]⭐ 该等级及以下的 VIP[/td]
[/tr]
[tr][td]0[/td]
[td]👑 仅管理员[/td]
[/tr]
[/table][quote]💡 [b]提示:[/b] 使用传送点后,玩家在该传送点冷却结束前[i]不能[/i]传送到任何其他地方。冷却保存在服务器上,因此重登或重启都不会跳过。 [font=Courier New]/return[/font] 会将其带回传送前的位置。[/quote][line]
[heading]📦 [color=#10b981]安装[/color][/heading]
[list=1]
[]将 [font=Courier New]ZaysEssentials[/font] 文件夹复制到服务器 [b]以及[/b] 每个客户端的 [b]Mods[/b] 文件夹中。[/]
[][b][color=#ef4444]关闭 EAC[/color][/b] — 这是一个代码(DLL)模组,与同类的所有模组一样。[/]
[]启动服务器。首次运行时会为你生成一个带注释的配置文件。[/]
[/list][quote]🔄 [b]要更新?[/b] 覆盖解压到旧的 [font=Courier New]ZaysEssentials[/font] 文件夹上——你的配置和所有家点都会保留。[/quote][heading]⚙️ [color=#f97316]默认配置[/color][/heading]
[list]
[]✅ 所有人都可以使用 [font=Courier New]/sethome[/font] 和 [font=Courier New]/home[/font] — [b]每人一个家点[/b][/]
[]✅ 传送请求开启,[b]60 秒[/b] 后过期[/]
[]✅ 传送点开启,冷却 [b]5 秒[/b][/]
[]⏱️ 传送之间 [b]30 秒[/b](管理员跳过)[/]
[]👑 管理员获得 [b]3[/b] 个家点,玩家 [b]1[/b] 个[/]
[]❌ [font=Courier New]/return[/font] 关闭 · ❌ 多 home 关闭[/]
[/list]配置文件 [font=Courier New]ZaysEssentials.xml[/font] 初始内容如下。你永远不必打开它——面板会写入相同的设置:
[code]<config>
<multiHome enabled="false" />
<return enabled="false" />
<tpa enabled="true" expirySeconds="60" />
<commandPermissionLevel value="1000" />
<cooldown seconds="30" />
<adminPermissionLevel value="0" />
<homeLimits>
<limit permissionLevel="0" maxHomes="3" />
<limit permissionLevel="1000" maxHomes="1" />
</homeLimits>
<warps enabled="true" defaultCooldownSeconds="5" />
</config>[/code][line]
[heading]🗄️ [color=#9a9a9a]较旧游戏版本[/color][/heading]
每个构建版本均可下载,因此你总能匹配服务器运行的游戏版本:
[table][tr][th]模组版本[/th]
[th]游戏版本[/th]
[th]包含内容[/th]
[/tr]
[tr][td]2.10.0[/td]
[td]V3.3[/td]
[td]全部内容,包括传送点[/td]
[/tr]
[tr][td]2.9.17[/td]
[td]V3.0 和 V3.1[/td]
[td]家点、传送和面板(无传送点)[/td]
[/tr]
[/table]两者不可互换——选择与你的服务器匹配的那个。较旧的文件列在本页的下载区。
[heading]💾 [color=#f97316]数据[/color][/heading]
家点按世界存储在 [font=Courier New]<存档>/ZaysEssentials/homes.xml[/font] 中,以你的跨平台 ID 为键,因此它们在重连、重启和改名后都会保留。采用原子写入;文件损坏会记录错误而不是使服务器崩溃。传送点也按世界保存([font=Courier New]warps.xml[/font]),每个玩家上次传送点使用时间保存在旁边的 [font=Courier New]warp-cooldowns.xml[/font] 中。

未来更新中的新选项会自动添加到你的 [font=Courier New]ZaysEssentials.xml[/font] 中,不会丢失你的值。
[heading]📝 [color=#9a9a9a]须知[/color][/heading]
[list]
[][b][color=#c86bff]单人游戏也可用。[/color][/b][/]
[][b][color=#c86bff]请求在重启后重置。[/color][/b] 传送请求和 [font=Courier New]/return[/font] 点保存在内存中,按设计在重启时清除。[/]
[/list][line]
[heading]🧩 [color=#c86bff]面向其他模组作者 — 在 /essadmin 中添加你自己的分页[/color][/heading]
你的模组可以将设置作为独立分页放入 [font=Courier New]/essadmin[/font],而不必提供第二个设置窗口,这样运行多个模组的服务器仍然只有一个管理界面。

[b][color=#c86bff]两个模组互不引用。[/color][/b] 整个契约就是 [font=Courier New]string[/font]、[font=Courier New]Func<string>[/font] 和 [font=Courier New]Action<string>[/font],因此你通过反射解析它,无需程序集引用,也没有硬依赖——如果未安装 Zay's Essentials,查找返回 null,你回退到自己的 UI。
[size=4][b][color=#c86bff]API[/color][/b][/size]
类型 [font=Courier New]ZaysEssentials.UI.AdminPanelExtensions[/font](程序集 [font=Courier New]ZaysEssentials[/font]),全部为静态:
[list]
[][b][color=#c86bff]RegisterTab(id, caption, icon, schema, readValues, applyValues)[/color][/b] — 添加你的分页。这是应当使用的调用。[/]
[][b][color=#c86bff]const int ContractVersion[/color][/b] — 当前为 [font=Courier New]2[/font]。在调用 [font=Courier New]RegisterTab[/font] 之前检查它(见下文)。[/]
[][b][color=#c86bff]int Count[/color][/b] — 已注册分页的数量。[/]
[][b][color=#c86bff]int MaxColumns / MaxCards / MaxSettings[/color][/b] — 容量:3 列,每列 8 张卡片,每分页 60 项设置。[/]
[/list]参数说明:
[list]
[][b][color=#c86bff]id[/color][/b] — 简短、稳定、在你的模组中唯一(例如 [font=Courier New]"veinminer"[/font])。再次注册相同 id 会 [b]替换[/b] 之前的分页。[/]
[][b][color=#c86bff]readValues[/color][/b] — 面板打开时返回你的当前值。[/]
[][b][color=#c86bff]applyValues[/color][/b] — 管理员按下 APPLY 时接收编辑后的值。[/]
[][b][color=#c86bff]icon[/color][/b] — 游戏 UI 图集中的任意精灵名称(例如 [font=Courier New]ui_game_symbol_tool[/font]、[font=Courier New]ui_game_symbol_map[/font]);传入 [font=Courier New]""[/font] 表示无图标。[/]
[/list]在模组初始化时注册一次。你的两个委托抛出的异常会被捕获并记录,因此你模组中的 bug 不会破坏面板。
[size=4][b][color=#c86bff]Schema[/color][/b][/size]
一个字符串。条目之间用 [font=Courier New];[/font] 分隔,条目内字段用 [font=Courier New]|[/font] 分隔:
[code]C|列标题 # 开始新列(最多 3 列)
K|卡片标题 # 在当前列中开始新的带标题卡片(每列最多 8 张)
S|键|标签|类型|最小值|最大值|选项|工具提示 # 一项设置 - 只有前三个字段是必需的
N|注释文本 # 卡片内的一行纯说明文字[/code][font=Courier New]类型[/font] 为以下之一:
[list]
[][b][color=#c86bff]bool[/color][/b] — 开关[/]
[][b][color=#c86bff]int[/color][/b] — 整数字段;[font=Courier New]最小值[/font]/[font=Courier New]最大值[/font] 可选,要么都提供,要么都不提供[/]
[][b][color=#c86bff]float[/color][/b] — 小数字段;与 [font=Courier New]int[/font] 相同[/]
[][b][color=#c86bff]choice[/color][/b] — [font=Courier New]◄ 值 ►[/font] 步进器;[font=Courier New]选项[/font] 是逗号分隔的列表,且为 [b]必需[/b][/]
[][b][color=#c86bff]label[/color][/b] — 静态文本,类似 [font=Courier New]N[/font] 但带键[/]
[/list]示例:
[code]C|Mining;
K|Vein;S|enabled|Enable vein mining|bool;
S|radius|Search radius|int|1|32;
N|Applies per swing.;
C|Cost;
K|Stamina;S|stamfactor|Stamina factor|float|0|5;
S|mode|Activation|choice|||Hold,Toggle,Always|Hold the key while swinging[/code]注意 [font=Courier New]choice|||Hold,Toggle,Always[/font] — [font=Courier New]最小值[/font] 和 [font=Courier New]最大值[/font] 留空,以便选项落在正确的字段中。工具提示是选项之后的字段。

你不必声明列或卡片:在任何 [font=Courier New]C[/font]/[font=Courier New]K[/font] 之前的 [font=Courier New]S[/font] 或 [font=Courier New]N[/font] 会隐式创建它们。格式错误的条目、未知标签和未知类型会被跳过并在日志中警告,而不会破坏分页,超出容量限制的内容会被丢弃并记录。显示文本中的 [font=Courier New];[/font] 和 [font=Courier New]|[/font] 会被剥离,因此不要在标签中使用它们。
[size=4][b][color=#c86bff]值[/color][/b][/size]
两个委托使用相同的格式:[font=Courier New]key=value;key=value[/font],使用你 schema 中的键。

在调用 [font=Courier New]applyValues[/font] 之前,值会在服务器上 [b]根据你自己的 schema 重新验证[/b]:数字会被限制在你的 [font=Courier New]最小值[/font]/[font=Courier New]最大值[/font] 范围内,[font=Courier New]choice[/font] 必须匹配你注册的选项之一,未知键会被丢弃,[font=Courier New]bool[/font] 会被规范化为 [font=Courier New]1[/font]/[font=Courier New]0[/font]。浮点数以格式化形式到达,选项以你的精确选项字符串到达。因此你永远不必信任或检查客户端发送的内容。

面板不会为你存储任何内容——请在 [font=Courier New]applyValues[/font] 中自行持久化这些值。
[size=4][b][color=#c86bff]最小示例[/color][/b][/size]
[code]// C# - 可选集成,无需引用 ZaysEssentials。
static void RegisterAdminTab()
{
var t = Type.GetType("ZaysEssentials.UI.AdminPanelExtensions, ZaysEssentials");
if (t == null) return; // 未安装 - 使用你自己的 UI

// 较旧的 Essentials (2.8.1) 报告 ContractVersion 1 且没有 RegisterTab,因此先检查
// 再调用它,而不是在这些服务器上抛出异常。
int version = (int)(t.GetField("ContractVersion")?.GetValue(null) ?? 1);
var registerTab = version >= 2 ? t.GetMethod("RegisterTab") : null;
if (registerTab == null) return; // 太旧 - 继续使用你自己的 UI

const string schema =
"C|Mining;K|Vein;S|enabled|Enable vein mining|bool;S|radius|Search radius|int|1|32;" +
"C|Cost;K|Stamina;S|stamfactor|Stamina factor|float|0|5;" +
"S|mode|Activation|choice|||Hold,Toggle,Always";

Func<string> read = () => $"enabled={(Cfg.Enabled ? 1 : 0)};radius={Cfg.Radius};" +
$"stamfactor={Cfg.StamFactor};mode={Cfg.Mode}";
Action<string> apply = v => { Cfg.LoadFromPanel(v); Cfg.Save(); };

registerTab.Invoke(null, new object[] {
"veinminer", "Vein Miner", "ui_game_symbol_pickaxe", schema, read, apply });
}[/code][quote]🕰️ [b]旧的 [font=Courier New]Register[/font] 调用。[/b] 还有一个来自 2.8.1 的旧版 [font=Courier New]Register(id, caption, schema, readValues, applyValues)[/font],仅为让已针对该版本编写的模组继续工作而保留。它接受扁平的 [font=Courier New]key|label|kind|min|max[/font] schema——没有列、卡片、注释或 [font=Courier New]choice[/font]——并渲染为一个长单列列表。[b]不要针对它编写新的集成[/b];请使用 [font=Courier New]RegisterTab[/font],并在较旧服务器上回退到你自己的 UI,如上所示。[/quote][line]
[heading]✅ 要求[/heading]
[list]
[]🎮 7 Days to Die [b]V3.3[/b] — V3.0 和 V3.1 请使用 [b]2.9.17[/b][/]
[]⛔ 关闭 EAC[/]
[]🖧 安装在服务器 [b]以及[/b] 每个客户端上[/]
[/list][i]由 Zayon 制作。发现 bug 或有想法?留下评论——我每一条都会读。[/i] 💬