StormtrooperX

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) to 1.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 with optin. Choices persist across relogs and restarts.
• 🛡️ Admin tools. Manage other players' opt-out status, permission-aware tab completion, an in-game help subcommand, 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 to true/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).

🔑 Permissions

🚀 Quick start

1. Download StormtrooperX and drop the .jar into plugins/.
2. 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.
3. 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

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.