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 将会提示这一点。插件的其他部分不需要网络访问。
安装步骤
- 停止服务器。
- 将
SSP-1.0.0.jar 放入 plugins/ 文件夹。
- 启动服务器。在控制台中查找
[SSP] Command /ssp registered.。
- 以操作员身份在游戏中运行
/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 可关闭它。 |
SSP-1.0.0.jar — what's inside, and what you need to run it
This is the file you drop into your server. Everything below describes that
one jar: what it contains, what it needs, and what it creates once it starts.
What the file is
|
|
| Filename |
SSP-1.0.0.jar |
| Size |
~138 KB |
| Type |
Bukkit/Spigot server plugin (not a client mod, not a datapack) |
| Contents |
33 compiled classes + plugin.yml + config.yml |
| Bundled libraries |
None — nothing is shaded in |
It is a plugin, so it goes in your server's plugins/ folder. Players do
not install anything, and it will not do anything if put in a client mods/
folder.
What you need
Required
|
|
| Java 17 or newer |
The jar is compiled to Java 17 bytecode (class major version 61). Any server running MC 1.18+ already meets this. |
| A Bukkit-family server |
Spigot, Paper, or Purpur. Also works on Bukkit-hybrid loaders (Mohist, Arclight, Cardboard). |
| Minecraft 1.18 → current |
Declared api-version: 1.18. Anything newer is reached reflectively at runtime, so one jar covers the whole range. |
| Operator status |
The entire /ssp tree is gated behind the ssp.admin permission (default: op). Without it the command reports as nonexistent. |
Fabric and Forge will not load this. They are different mod loaders with no
plugin.yml and no Bukkit entry point. Use a hybrid server if you need it on
one of those.
Optional — both entirely safe to leave uninstalled
| Plugin |
What it unlocks |
Without it |
| SkinsRestorer |
A disguised player sees their own new skin instantly, no relog. |
Skins still change and everyone else sees them immediately; the wearer needs a relog. |
| Simple Voice Chat |
The proximity voice gate — microphones muted unless the speaker holds ssp.voice. |
The voice gate sits idle. Everything else is unaffected. |
Both are detected at startup. Neither is bundled, and a missing one is logged
as a normal info line, not an error.
Internet access
The identity scrambler resolves usernames against api.mojang.com and
sessionserver.mojang.com. If your server cannot reach the internet, disguises
will not find identities to use — /ssp random diagnose will tell you so.
Nothing else in the plugin needs network access.
Installing
- Stop the server.
- Drop
SSP-1.0.0.jar into plugins/.
- Start the server. Look for
[SSP] Command /ssp registered. in the console.
- Run
/ssp in-game as an operator to see the full command list.
To update, replace the jar and restart. Your config.yml is never
overwritten — see the warning below.
What it creates on first run
All inside plugins/SSP/:
| Path |
What it holds |
Safe to edit by hand? |
config.yml |
Settings. Nine sections: unknown-command-message, chat, sign, voice, identity, plotarmor, admin, troll, illusion. |
Yes — then /ssp reload. |
data.yml |
Runtime state: whitelists, bypass lists, bans, timeouts, plot armour, saved disguises. |
No — not while the server is running; the plugin overwrites it. |
presets/ |
One .yml per saved inventory preset (/ssp inventory save). |
Not recommended. |
The one gotcha worth knowing
Bukkit never overwrites an existing config.yml. If you have run an older
build and then update the jar, any new settings will be missing from your
file and will silently fall back to their coded defaults.
If a newly documented option seems to do nothing, that is why. Either add the
key by hand, or delete config.yml and restart to regenerate it — data.yml
and presets/ are untouched by that, so you lose no bans, whitelists or
loadouts.
Permissions
| Node |
Default |
Grants |
ssp.admin |
op |
The entire /ssp tree. Also implies ssp.admin.inventory. |
ssp.admin.inventory |
op |
Only /ssp inventory — so loadout management can be delegated without handing over the rest of the plugin. |
ssp.voice |
nobody |
Lets the holder's proximity voice actually be broadcast. Never granted automatically; hand it out through your permissions plugin. |
What the commands are
Nine tabs. Full descriptions are in README.md; the complete
per-command list with behaviour notes is in CHANGELOG.md.
| Tab |
Purpose |
/ssp chat |
Global chat lockdown and bypass whitelist. |
/ssp sign |
Sign lockdown, enforced three separate ways. |
/ssp random |
Identity scrambler — real skins and usernames from real accounts. |
/ssp plotarmor |
Survival lock: fatal hits never register a death. |
/ssp admin |
Real moderation: bans, timeouts, freeze, vanish, invsee, teleport. |
/ssp troll |
Cosmetic, fully reversible effects. No item loss, no lasting damage. |
/ssp illusion |
Fake output for staging a moment — nothing here is real. |
/ssp inventory |
Global gear presets: save once, deploy to anyone. |
/ssp status, /ssp reload |
Current state, and re-read config.yml. |
Three commands are genuinely destructive and are logged to console on every
use, independent of chat scrollback: /ssp admin clearinventory,
/ssp inventory load onto another player, and /ssp inventory delete.
If something goes wrong
| Symptom |
Check |
/ssp says unknown command |
Are you an operator? That message is also what non-ops are designed to see. Run /plugins — green means loaded. |
Plugin missing from /plugins |
It failed to enable. The console has the reason at startup. |
| Disguise applies but you can't see your own skin |
Expected on Spigot without SkinsRestorer. Run /ssp random diagnose — the ACTIVE BACKEND: line says which path is in use. |
| A config option seems ignored |
Your config.yml predates it. See the gotcha above. |
| Everyone gets re-disguised on login |
The global scramble is on. /ssp random disable turns it off. |
评论 0
登录后参与评分
还没有评论,来抢沙发吧