SSP - 脚本化服务器插件

插件

原名 SSP - Scripted Server Plugin · 作者 qzvp

如果你有一个脚本化的 SMP 服务器,这个插件会对你有帮助。

0 本站下载 0 关注 更新于 2 个月前

最新 1.0.1 · 26.2 · Spigot

一键开服(送7天)

SSP-1.0.0.jar — 内部结构及运行所需条件

这是你需要放入服务器的文件。下文描述了该 jar 文件:它包含什么、需要什么,以及启动后会创建什么。


文件说明

文件名 SSP-1.0.0.jar
大小 ~138 KB
类型 Bukkit/Spigot 服务器插件(非客户端模组,非数据包)
内容 33 个编译类 + plugin.yml + config.yml
捆绑库 无 — 未进行任何阴影处理(shaded)

它是一个插件,因此请放入你服务器的 plugins/ 文件夹中。玩家无需安装任何内容,且若将其放入客户端的 mods/ 文件夹中将不会生效。


运行需求

必需

Java 17 或更高版本 该 jar 基于 Java 17 字节码编译(类主版本号为 61)。任何运行 MC 1.18+ 的服务器均已满足此要求。
Bukkit 系列服务器 Spigot、Paper 或 Purpur。也兼容 Bukkit 混合加载器(Mohist、Arclight、Cardboard)。
Minecraft 1.18 → 最新版本 声明的 api-version: 1.18。通过反射在运行时获取更高版本,因此一个 jar 即可覆盖整个版本范围。
操作员权限 整个 /ssp 命令树受 ssp.admin 权限控制(默认:op)。若无此权限,命令将显示为不存在。

Fabric 和 Forge 无法加载此插件。 它们是拥有不同模组加载器的模组,没有 plugin.yml 也没有 Bukkit 入口点。如果需要在这些加载器上使用,请使用混合服务器。

可选 — 完全安全地不安装亦可

插件 解锁功能 未安装时的表现
SkinsRestorer 伪装后的玩家能立即看到自己的新皮肤,无需重新登录。 皮肤仍然会改变,其他所有玩家都能立即看到;但穿着者需要重新登录才能看到变化。
Simple Voice Chat 距离语音门控 — 除非说话者持有 ssp.voice 权限,否则麦克风将被静音。 语音门控处于空闲状态。其他一切不受影响。

两者均在启动时检测。均未捆绑,缺失时会以普通信息行记录日志,而非错误。

互联网访问

身份混淆器需向 api.mojang.com 和 sessionserver.mojang.com 解析用户名。如果你的服务器无法访问互联网,伪装将无法找到可用的身份 — 执行 /ssp random diagnose 将会提示这一点。插件的其他部分不需要网络访问。


安装步骤

  1. 停止服务器。
  2. 将 SSP-1.0.0.jar 放入 plugins/ 文件夹。
  3. 启动服务器。在控制台中查找 [SSP] Command /ssp registered.。
  4. 以操作员身份在游戏中运行 /ssp 以查看完整命令列表。

要更新,只需替换 jar 并重启。你的 config.yml 永远不会被覆盖 — 请参阅下方的警告。


首次运行时创建的文件

全部位于 plugins/SSP/ 目录下:

路径 包含内容 允许手动编辑?
config.yml 设置。九个部分:unknown-command-message、chat、sign、voice、identity、plotarmor、admin、troll、illusion。 是 — 然后运行 /ssp reload。
data.yml 运行时状态:白名单、绕过列表、封禁、超时、地块护甲、已保存的伪装。 否 — 服务器运行时不可编辑;插件会覆盖它。
presets/ 每个已保存的物品栏预设对应一个 .yml 文件(通过 /ssp inventory save 保存)。 不建议。

值得注意的一个陷阱

Bukkit 永远不会覆盖现有的 config.yml。 如果你运行过旧版本构建然后更新了 jar,你的文件中将缺少任何新增的设置,它们将静默回退到代码中的默认值。

如果某个新记录的选项似乎不起作用,原因就在于此。要么手动添加键,要么删除 config.yml 并重启以重新生成它 — data.yml 和 presets/ 不受此操作影响,因此你不会丢失任何封禁、白名单或装备配置。


权限节点

节点 默认值 授予权限
ssp.admin op 整个 /ssp 命令树。同时也隐含 ssp.admin.inventory。
ssp.admin.inventory op 仅限 /ssp inventory — 因此可以在不交出插件其余部分控制权的情况下委托装备管理。
ssp.voice 无人 允许持有者的近距离语音实际被广播。绝不会自动授予;请通过你的权限插件发放。

命令说明

共有九个标签页。完整描述见 README.md;带有行为备注的完整单命令列表见 CHANGELOG.md。

标签页 用途
/ssp chat 全局聊天锁定与绕过白名单。
/ssp sign 告示牌锁定,通过三种独立方式强制执行。
/ssp random 身份混淆器 — 使用真实账户的真实皮肤和用户名。
/ssp plotarmor 生存锁定:致命伤害永不记录死亡。
/ssp admin 真正的管理功能:封禁、超时、冻结、隐身、物品查看、传送。
/ssp troll 外观效果,完全可逆。无物品损失,无持久伤害。
/ssp illusion 用于营造瞬间效果的虚假输出 — 此处的一切皆非真实。
/ssp inventory 全局装备预设:保存一次,部署给任何人。
/ssp status, /ssp reload 当前状态,以及重新读取 config.yml。

有三个命令是真正具有破坏性的,并且每次使用时都会记录到控制台,独立于聊天滚动条之外:/ssp admin clearinventory、向另一个玩家执行 /ssp inventory load,以及 /ssp inventory delete。


如果出现问题

症状 排查方法
/ssp 提示未知命令 你是操作员(OP)吗?该消息也是非 OP 玩家预期会看到的。运行 /plugins —— 显示绿色表示已加载。
/plugins 列表中缺少插件 启用失败。启动时控制台会记录原因。
伪装生效但无法看到自己的皮肤 在未安装 SkinsRestorer 的 Spigot 上属正常现象。运行 /ssp random diagnose —— ACTIVE BACKEND: 行会显示当前使用的路径。
某个配置选项似乎被忽略 你的 config.yml 版本较旧,早于该选项的引入。参见上方的注意事项。
所有玩家登录时都被重新伪装 全局随机伪装功能已开启。使用 /ssp random disable 可关闭它。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源