Mechanics
Explosive Projectile System- High-Impact Snowballs: Fires custom-engineered projectiles that trigger explosions upon impact.
- Tactical Balancing: Every shot is governed by a configurable cooldown to prevent spam and maintain combat integrity.
- Durability & Degradation: Items feature limited uses with visual durability tracking. The weapon is automatically destroyed once all charges are depleted.
- Modern Formatting: Full MiniMessage support for all item names, lores, and chat notifications.
- Real-time Updates: Dynamic lore updates to show remaining ammunition and weapon status.
Configuration & Customization
In-Game Management- Live GUI Editor: Access a comprehensive configuration suite via /sniper gui. Modify weapon stats in real-time without touching a config file or restarting the server.
- Visual Item Mapping: A unique drag-and-drop system within the GUI allows you to set any item—including those with custom model data—as the Sniper base.
- On-the-Fly Adjustments: Update damage values, explosion radiuses, and shot limits instantly through intuitive commands.
Technical Integrations
World & Region Protection- WorldGuard Hook: Fully compatible with WorldGuard regions. Projectiles are automatically neutralized in regions where PvP is disabled or flags prevent combat.
- Safe Zone Logic: Prevents griefing by ensuring explosive damage respects server-side protection settings.
- Optimized Codebase: Built specifically for modern environments (Paper 1.21+ and Java 21).
- Zero Restart Workflow: Complete reload system for configuration files and internal logic.
Administration & Commands
Staff Commands| Command | Description |
| /sniper give <player> | Grants a Sniper item to the specified player. |
| /sniper gui | Opens the visual configuration and skin management interface. |
| /sniper reload | Reloads all configuration files and internal settings. |
| /sniper setuses <n> | Defines the maximum charges for the weapon. |
| /sniper setcooldown <s> | Sets the delay between shots in seconds. |
| /sniper setradius <r> | Configures the explosion radius of the projectile. |
| /sniper setdamage <d> | Adjusts the raw damage dealt by the impact. |
- sniper.use — Grants permission to fire the weapon (Default: false).
- sniper.admin — Grants full access to administrative commands and the configuration GUI (Default: op).
Technical Specifications
System Requirements- Platform: Paper 1.21 or higher.
- Environment: Java 21.
- Optional Dependencies: WorldGuard (highly recommended for region-based restrictions) & PlaceholderApi.
Contact me on discord for help : panda12r
