让远程攻击的怪物像被帝国训练过一样打不中你。
针对每种怪物的精准度调节、支持玩家单独退出、零配置即可使用。无需安装客户端模组。
为什么要削弱远程怪物?
原版骷髅射手就像狙击手。它们能透过丛林树冠追踪你,在你冲刺时预判你的走位,并在三十格之外将你击退,甚至可能让你从半成型的建筑上跌落。这对硬核玩家来说或许没问题,但对其他玩家来说却令人筋疲力尽。
StormtrooperX 让远程怪物更容易打偏。 对于每种已配置的怪物,其发射的每支箭矢的方向都会受到你设定的随机偏移量影响,且针对不同怪物类型独立计算。骷髅、流浪者、沼泽尸壳、焦尸和掠夺者将从神枪手变成……好吧,帝国冲锋队。弹道速度保持不变,因此箭矢依然会飞行、呈抛物线轨迹并以与原版的伤害完全相同造成打击;只是它们不再全都射中 你。
100% 服务端运行。 玩家只需使用普通的原版客户端加入服务器。他们无需安装任何东西:既不需要资源包,也不需要模组。将
.jar文件放入plugins/目录即可生效。
✨ 功能特性
- ? 按怪物类型的精准度控制。 可以单独启用或禁用六种受支持的怪物,并为每种怪物设置独立的精准度值,范围从
0.0(原版完美瞄准)到1.0(完全的帝国冲锋队水平)。 - ? 物理效果保持原版一致。 仅扰动射击方向。速度、弧线和伤害与怪物原本造成的效果完全一致。
- ? 玩家退出机制。 纯粹主义者可以通过
/stormtrooperx optout为自己保留原版的难度,并通过optin重新加入。选择将在重连和重启后持久保存。 - ?️ 管理员工具。 管理其他玩家的退出状态、基于权限的 Tab 补全、游戏内的
help子命令以及实时的/stormtrooperx reload。 - ? 持久化存储。 默认嵌入 H2 数据库(零配置),或共享 MySQL 配合 HikariCP 连接池,使退出选择在跨服务器的网络中跟随玩家。
- ? PlaceholderAPI 支持。
%stormtrooperx_optout%解析为true或false;非常适合用于计分板和菜单。此为可选的软依赖。 - ⚡ 兼容 Folia & 轻量级。 基于事件驱动,无刻任务;热路径上使用内存缓存的退出状态;所有数据库 I/O 均在主线程之外执行。
- ? 更新检查器。 当有新版本发布时,会在启动时显示静默通知。可禁用。
- ? 免费且开源。 采用 MIT 许可证,每次发布的 jar 包均附带 Sigstore 构建来源证明和 CycloneDX SBOM。
? 适用场景
- 生存服与 SMP 服务器。 减轻远程怪物的威胁,让休闲玩家也能真正享受夜晚时光,同时不影响近战难度。
- 家庭友好型及儿童服务器。 减少来自屏幕外弩箭的廉价死亡。
- 建筑服务器。 防止骷髅狙击手将每个脚手架变成死亡陷阱。
- 混合技能社区。 退出机制意味着一个服务器可以同时服务于两类人群:默认情况下瞄准削弱,但任何要求保留原版的玩家均可切换回原版瞄准。
⌨️ 命令
基础命令:/stormtrooperx(别名 /stx, /stormtrooper)。
| 命令 | 权限节点 | 作用 |
|---|---|---|
/stormtrooperx |
stormtrooperx.use |
显示插件信息和版本。 |
/stormtrooperx help |
stormtrooperx.use |
列出你可用的子命令。 |
/stormtrooperx optout |
stormtrooperx.optout |
退出精准度削弱(始终设置为已退出状态)。 |
/stormtrooperx optin |
stormtrooperx.optout |
重新加入精准度削弱。 |
/stormtrooperx toggle |
stormtrooperx.optout |
翻转你的退出状态。 |
/stormtrooperx optout <player> |
stormtrooperx.optout.others |
使另一名在线玩家退出(同样支持 optin <player>)。 |
/stormtrooperx reload |
stormtrooperx.admin |
重载配置文件。 |
? 权限节点
| 权限节点 | 默认分配 | 授予权限 |
|---|---|---|
stormtrooperx.use |
所有人 | 访问主命令和 help。 |
stormtrooperx.optout |
所有人 | 对自己进行退出或重新加入削弱。 |
stormtrooperx.optout.others |
管理员 (ops) | 管理其他玩家的退出状态。 |
stormtrooperx.admin |
管理员 (ops) | 重载配置和管理员专属操作;同时也授予 optout.others。 |
? 快速开始
- 下载 StormtrooperX 并将
.jar文件放入plugins/目录。 - 重启服务器。搞定:开箱即用,所有六种怪物的精准度默认削弱至
0.7,无需任何配置,也无需安装依赖。 - 可选:在
plugins/StormtrooperX/config.yml中调整各怪物的精准度,然后通过/stormtrooperx reload实时应用更改。
⚙️ 配置
StormtrooperX 会在 plugins/StormtrooperX/ 目录下生成一份带有完整注释的 config.yml。
按怪物类型调节。 每种怪物都有一个 enabled 标志和一个介于 0.0(完美原版瞄准,无削弱)和 1.0(最大混乱)之间的 accuracy 值。不同类型的投射物可能需要不同的值;弩箭比箭矢飞得更平直。
版本锁定的怪物,自动处理。 Bogged(1.21+)和 Parched(1.21.11+)会在启动时自动检测。在旧版服务器上,它们会被直接跳过并记录日志行;无需配置,也不会出错。
存储后端。 选择退出偏好设置的存储位置:
h2(默认):嵌入式、基于文件的数据库;无需运行外部服务器。mysql:外部服务器,配备 HikariCP 连接池和可选的 SSL,使退出选择可以在整个服务器网络的多个服务器之间共享。
自动迁移。 从旧版本升级?配置文件会在启动时自动迁移;你的设置将被保留。
✅ 兼容性
- Minecraft 1.18 – 26.1.x。 版本限制型生物在可用时会自动激活。
- Spigot、Paper、Purpur,或任何基于 Spigot 的服务器。Folia 得到完全支持(1.20.4+, 在运行时检测)。
- Java 17+(CI 测试于 Java 17、21 和 25)。
- 无需依赖项。 PlaceholderAPI 是可选的软依赖。
- 原版客户端。 无需客户端模组或资源包。
?️ 性能与安全
- 仅基于事件驱动。 仅在弓射击事件中注册一个监听器;无刻任务,无轮询。
- 缓存热路径。 禁用检查是无锁内存查找;数据库在战斗期间绝不会接触。
- 永不阻塞服务器线程。 所有数据库和网络 I/O 均异步运行,通过 Folia 感知调度器执行。
- 加固的 MySQL。 JDBC 连接属性经过白名单过滤并 URL 编码,具有远程代码执行 (RCE) 和历史文件读取风险的 Connector/J 危险标志在池层强制关闭。
- 可信构建。 每个发布版均附带 CycloneDX SBOM 和 GitHub 构建来源证明,您可以使用
gh attestation verify进行验证。
❓ 常见问题
玩家是否需要安装模组或资源包?
不需要。StormtrooperX 完全是服务端插件。玩家使用普通原版客户端连接即可,一切正常运行。
它会改变箭矢伤害或速度吗?
不会。仅扰动射击方向。速度被明确保留,因此弹道、飞行时间和命中伤害均与原版完全一致。命中的箭矢伤害不变;只是命中的数量更少。
个别玩家能否保持原版的生物准确度?
可以。拥有 stormtrooperx.optout 权限的玩家(默认:所有人)可以运行 /stormtrooperx optout,
此时生物将像原版那样精准瞄准他们。该选择会在重新登录和重启后持久保存,管理员也可以为其他玩家管理此设置。
我的服务器版本没有的生物会怎样?
它们会被优雅地跳过。Bogged 需要 1.21+,Parched 需要 1.21.11+;在较旧的服务器上, StormtrooperX 会记录一行通知日志,并继续处理存在的生物。
我需要运行数据库服务器吗?
不需要。默认后端是嵌入式 H2,无需任何设置。MySQL 是可选的,适用于希望跨多个服务器共享禁用偏好的网络。
它在 Folia 上能工作吗?
可以。Folia (1.20.4+) 会在运行时被检测并得到完全支持;所有异步工作均通过 Folia 感知调度器执行。
源代码与问题追踪:
github.com/GooberCraft/StormtrooperX
发现错误或有任何功能请求?请在 GitHub 上提交 Issue。StormtrooperX 基于 MIT 协议开源,
是对 byteful 开发的 Stormtrooper 的重构与增强版本。
Make ranged mobs miss like they were trained by the Empire.
Per-mob accuracy tuning, per-player opt-out, zero setup. No client mod required.
Why nerf ranged mobs?
Vanilla skeletons are snipers. They track you through a jungle canopy, lead their shots while you sprint, and knock you off your half-finished build from thirty blocks out. That's fine for hardcore players, and exhausting for everyone else.
StormtrooperX makes ranged mobs miss more. Every arrow a configured mob fires gets its direction nudged by a random amount you control, per mob type. Skeletons, Strays, Bogged, Parched, Pillagers, and Piglins go from marksmen to, well, stormtroopers. Projectile speed is untouched, so arrows still fly, arc, and hit exactly as hard as vanilla; they just don't all hit you.
100% server-side. Players join with an ordinary vanilla client. There is nothing for them to install: no resource pack, no mod. Drop the jar in
plugins/and it works.
✨ Features
- ? Per-mob accuracy control. Enable or disable each of the six supported mobs individually and
give each its own accuracy value, from
0.0(vanilla-perfect aim) to1.0(full stormtrooper). - ? Physics stay vanilla. Only the direction of the shot is perturbed. Speed, arc, and damage are exactly what the mob would have dealt anyway.
- ? Player opt-out system. Purists can keep vanilla difficulty for themselves with
/stormtrooperx optout, and come back withoptin. Choices persist across relogs and restarts. - ?️ Admin tools. Manage other players' opt-out status, permission-aware tab completion, an
in-game
helpsubcommand, and live/stormtrooperx reload. - ? Persistent storage. Embedded H2 by default (zero setup), or shared MySQL with HikariCP pooling so opt-out choices follow players across a network.
- ? PlaceholderAPI support.
%stormtrooperx_optout%resolves totrue/false; great for scoreboards and menus. Optional soft dependency. - ⚡ Folia-ready & featherweight. Event-driven with no tick tasks, in-memory opt-out cache on the hot path, and all database I/O off the main thread.
- ? Update checker. A quiet startup notice when a new release is out. Can be disabled.
- ? Free & open source. MIT-licensed, with Sigstore build-provenance attestation and a CycloneDX SBOM on every release jar.
? Perfect for
- Survival & SMP servers. Take the edge off ranged mobs so casual players can actually enjoy night time, without touching melee difficulty.
- Family-friendly & kids servers. Fewer cheap deaths from off-screen crossbow bolts.
- Builders' servers. Stop skeleton snipers from turning every scaffold into a death trap.
- Mixed-skill communities. The opt-out system means one server can serve both audiences: nerfed aim by default, vanilla aim for anyone who asks.
⌨️ Commands
Base command: /stormtrooperx (aliases /stx, /stormtrooper).
| Command | Permission | What it does |
|---|---|---|
/stormtrooperx |
stormtrooperx.use |
Show plugin info and version. |
/stormtrooperx help |
stormtrooperx.use |
List the subcommands you may use. |
/stormtrooperx optout |
stormtrooperx.optout |
Opt out of the accuracy nerfs (always sets opted-out). |
/stormtrooperx optin |
stormtrooperx.optout |
Opt back in to the accuracy nerfs. |
/stormtrooperx toggle |
stormtrooperx.optout |
Flip your opt-out state. |
/stormtrooperx optout <player> |
stormtrooperx.optout.others |
Opt out another online player (also optin <player>). |
/stormtrooperx reload |
stormtrooperx.admin |
Reload the configuration. |
? Permissions
| Permission | Default | Grants |
|---|---|---|
stormtrooperx.use |
everyone | Access to the main command and help. |
stormtrooperx.optout |
everyone | Opt out of / back in to nerfs for yourself. |
stormtrooperx.optout.others |
ops | Manage other players' opt-out status. |
stormtrooperx.admin |
ops | Reload and admin-only actions; also grants optout.others. |
? Quick start
- Download StormtrooperX and drop the
.jarintoplugins/. - Restart your server. That's it: all six mobs are nerfed out of the box at accuracy
0.7, with no configuration required and no dependencies to install. - Optional: tune per-mob accuracy in
plugins/StormtrooperX/config.yml, then apply it live with/stormtrooperx reload.
⚙️ Configuration
StormtrooperX generates a fully commented config.yml in plugins/StormtrooperX/.
Per-mob tuning. Each mob gets an enabled flag and an accuracy value between 0.0 (perfect
vanilla aim, no nerf) and 1.0 (maximum chaos). Different projectile types can want different
values; crossbow bolts fly flatter than arrows.
Version-gated mobs, handled for you. Bogged (1.21+) and Parched (1.21.11+) are detected at startup. On older servers they're simply skipped with a log line; nothing to configure, nothing breaks.
Storage backends. Choose where opt-out preferences live:
h2(default): embedded, file-based database; no external server to run.mysql: external server with HikariCP pooling and optional SSL, so opt-out choices can be shared across a whole network of servers.
Automatic migration. Upgrading from an older release? The config migrates itself on startup; your settings are preserved.
✅ Compatibility
- Minecraft 1.18 – 26.1.x. Version-gated mobs activate automatically where available.
- Spigot, Paper, Purpur, or any Spigot-based server. Folia is fully supported (1.20.4+, detected at runtime).
- Java 17+ (CI-tested on Java 17, 21, and 25).
- No required dependencies. PlaceholderAPI is an optional soft dependency.
- Vanilla clients. No client-side mod or resource pack.
?️ Performance & safety
- Event-driven only. One listener on the bow-shoot event; no tick tasks, no polling.
- Cached hot path. The opt-out check is a lock-free in-memory lookup; the database is never touched during combat.
- Never blocks the server thread. All database and network I/O runs async, through a Folia-aware scheduler.
- Hardened MySQL. JDBC connection properties are allowlisted and URL-encoded, and risky Connector/J flags with RCE and file-read history are forced off at the pool layer.
- Trustworthy builds. Every release ships a CycloneDX SBOM and a GitHub build-provenance
attestation you can verify with
gh attestation verify.
❓ FAQ
Do players need to install a mod or resource pack?
No. StormtrooperX is entirely server-side. Players connect with a normal vanilla client and everything just works.
Does it change arrow damage or speed?
No. Only the direction of the shot is perturbed. Speed is explicitly preserved, so arcs, flight time, and damage on hit are all exactly vanilla. A shot that connects hurts just as much; fewer of them connect.
Can individual players keep vanilla mob accuracy?
Yes. Any player with stormtrooperx.optout (default: everyone) can run /stormtrooperx optout and
mobs will aim at them exactly as vanilla intended. The choice persists across relogs and restarts,
and admins can manage it for other players.
What happens with mobs my server version doesn't have?
They're skipped gracefully. Bogged needs 1.21+ and Parched needs 1.21.11+; on older servers StormtrooperX logs a one-line notice and carries on with the mobs that exist.
Do I need to run a database server?
No. The default backend is embedded H2 and requires zero setup. MySQL is optional, for networks that want opt-out preferences shared across multiple servers.
Does it work on Folia?
Yes. Folia (1.20.4+) is detected at runtime and fully supported; all async work goes through a Folia-aware scheduler.
Source code & issue tracker:
github.com/GooberCraft/StormtrooperX
Found a bug or have a feature request? Open an issue on GitHub. StormtrooperX is open source under MIT,
a refactored and enhanced take on Stormtrooper by byteful.
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 StormtrooperX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新内容
变更
- 支持 Minecraft 26.2 和 26.3。 现在支持的版本范围是 Minecraft 1.18 至 26.3.x(此前为 26.1.x)。为此无需更改任何插件代码。发布前已通过四种方式验证:完整测试套件针对 Spigot 26.2 和 26.3 API 编译并全部通过;打包 JAR 引用的所有 Bukkit 和 PlaceholderAPI 方法及字段均能在 Spigot 26.2/26.3、Paper 26.3 和 Folia 26.3 API 中正确解析,包括插件以反射方式绑定的 Folia 调度器方法;在实时 Paper 26.3 服务器上,对全部六种受支持生物(骷髅、流浪者、沼泽骷髅、炙烤骷髅、掠夺者、猪灵)发射的箭矢进行了伤害削弱,且在
/stormtrooperx reload前后保持投射物速度不变;CI 的前向兼容性作业现在每次推送都基于 26.3 API 进行构建。
安全
- H2 2.5.252 集成了上游的安全修复。 内置的 H2 数据库(默认
h2后端)包含了针对连接 URL 设置注入(#4381)、JAVA_OBJECT值缺少反序列化过滤器(#4412),以及SecureFileStore在部分读取时跳过解密(#4405)的修复。这些漏洞在 StormtrooperX 中均不可利用:H2 URL 仅由插件数据文件夹和固定设置构成,弃用表仅存储VARCHAR/BOOLEAN/TIMESTAMP列,且数据库未加密。这是一次纵深防御层面的更新。上游参考了尚未发布的公告 GHSA-x6w5-3gpx-27hm,未分配 CVE 编号。
依赖项
- MySQL Connector/J 9.7.0 → 26.7.0(内置)。版本号的跳跃是因为 Oracle 将 Connector/J 迁移至 MySQL Server 的日历版本号体系;26.7.0 是 9.7 的继任者,而非重写版本。使用
mysql后端需要 MySQL Server 8.4 或更高版本(请参阅升级说明)。26.7.0 中的错误修复(LOAD DATA LOCAL INFILE清理、X Protocol 连接、getNStringUTF-8 别名)对本插件无影响:allowLoadLocalInfile被强制关闭,X Protocol 相关类已从 JAR 中剥离,且未使用 N 字符ResultSet方法。未涉及任何 CVE。 - H2 2.4.240 → 2.5.252(内置,默认后端)。除了上述安全修复外,此次更新还带来了 MVStore 损坏和数据竞态条件的修复,适用于插件的文件后备弃用存储:在
SHUTDOWN后重新打开时的“双重标记”损坏(#4387)、块重写数据竞态(#4374),以及在恐慌状态下停止以防止存储损坏(#4343)。现有数据库无需迁移:由 1.10.1 版本的 H2 2.4.240 写入的文件可在 2.5.252 下正常打开、读取并接受插入或更新操作。 - 构建和测试工具:
maven-compiler-plugin3.15.0 → 3.16.0,maven-surefire-plugin3.5.6 → 3.6.0,cyclonedx-maven-plugin2.9.2 → 2.9.3,JUnit Jupiter 6.1.2 → 6.1.3,Mockito 5.23.0 → 5.24.0。这些组件均未打包进 JAR。
构建
- 发布流水线动作已更新,所有动作仍锁定在
release.yml中的提交 SHA:actions/setup-java5.2.0 → 6.1.0(v6 还会根据供应商校验和验证 JDK 下载),actions/attest-build-provenance4.1.1 → 4.2.2,softprops/action-gh-release3.0.2 → 3.0.3,以及cloudnode-pro/modrinth-publish2.5.0 → 2.5.2。 - 前向兼容性 CI 作业已迁移至 26.3 API(“Ceiling compat (26.3 API)”),仍运行于 Java 25 以匹配 26.x 所需的服务器运行时环境。
升级说明
如果从 1.10.x 升级: 对于大多数服务器而言,这是即插即用替换。配置架构未发生变化(config-version: 3 继续适用,不执行任何迁移),权限和命令也未发生变更。
- H2 用户(默认): 无需任何操作。现有的弃用数据库将按原样读取。
- MySQL 用户:请先检查你的 MySQL 服务器版本。 内置的 Connector/J 26.7.0 要求 MySQL Server 8.4 或更高版本。由于驱动程序已阴影打包(shaded)到 JAR 中,无法替换为旧版本。如果你的数据库服务器运行的是 MySQL 8.0,请在更新插件之前升级服务器,或者在能够升级之前继续使用 1.10.1。
服务器兼容性: Spigot、Paper、Purpur 和 Folia 1.20.4+,适用于 Minecraft 1.18 至 26.3.x,Java 17+。Minecraft 26.x 服务器本身需要 Java 25。
JAR 验证: 通过 GitHub Actions 构建并使用 Sigstore 签名证明。请使用 gh attestation verify StormtrooperX-1.11.0.jar --repo GooberCraft/StormtrooperX 进行验证(需要 gh 2.43.0+)。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧