Description
Gallery
Changelog
Versions
Overview
An easy-to-use Minecraft plugin that enables the crashing of a player's game through the use of a command.
Requires PacketEvents
Ensure the PacketEvents library is installed on your server.
Table of Contents
- Overview
- Showcase
- Supported Platforms & Versions
- Spoofers
- Commands
- Permission Nodes
- Installation
- Compiling From Source
- Credits
- License
Showcase
Supported Platforms & Versions
| Platform | Supported Versions |
|---|---|
| Bukkit (Spigot, Paper, Folia etc.) | 1.8.8 - 1.21.3 |
| Velocity | Latest Major |
| BungeeCord (or any forks) | Latest Major |
Features
- Completely Asynchronous - The plugin is designed to be as lightweight as possible. All packet modifications are done asynchronously, so the main thread is never blocked.
- Folia Support - The plugin integrates with Folia, which is a Paper fork that adds regionised multithreading to the server.
- Crash Detector - By sending both a keep alive and transaction packet, the plugin can detect if a player has crashed, even if the player is still connected.
- Configurable - The plugin is highly configurable, allowing you to adjust the settings to your liking.
- Update Checker - The plugin automatically checks for updates on startup. If a new version is available, a message will be sent to the console.
Usage/Examples
/crash (player) [Method]
Note: The method parameter is optional. If no method is provided, the plugin will use the most appropriate method based on the player's version.
Methods:
ExplosionParticlePosition
Commands
/pc- Displays the plugin's version and author./crash (player) [Method]- Crashes the specified player's game./crashinfo [player]- Displays the client brand and version of the specified player.
Permission Nodes
Players that are OP (Operators) have these permissions by default.
PlayerCrasher.CrashAllows the player to use the /crash command.PlayerCrasher.BypassExempts the player from being crashed when the /crash command is used on them.PlayerCrasher.AlertsMakes the player receive alerts when a player is being crashed by another player.PlayerCrasher.CrashInfo- Allows the player to use the /crashinfo command.PlayerCrasher.UpdateNotifyMakes the player receive an update notification when a new version is available.
Installation
- Prerequisites: Install PacketEvents.
- Download: Get the latest release from the GitHub release page.
- Installation: Move the downloaded plugin to your server's plugins directory.
- Configuration: Customize settings in
config.yml. - Restart: Restart the server for changes to take effect.
Compiling From Source
Prerequisites
- Java Development Kit (JDK) version 21 or higher
- Git
Steps
-
Clone the Repository:
git clone https://github.com/Bram1903/MinecraftPlayerCrasher.git -
Navigate to Project Directory:
cd MinecraftPlayerCrasher -
Compile the Source Code: Use the Gradle wrapper to compile and generate the plugin JAR file:
Linux / macOS
./gradlew buildWindows
.\gradlew build
Credits
Special thanks to:
- @Retrooper: Author of PacketEvents.
License
This project is licensed under the GPL3 License.
All Versions
+ Add Version
[3.0.2] PlayerCrasher 3.0.2
by DevBram on Oct 15, 2026
Download
- Added: 1.21.2 & 1.21.3 Compatibility
- Added: PacketEvents 2.6.0 Compatibility
[3.0.1] PlayerCrasher 3.0.1
by DevBram on Oct 15, 2026
Download
## Release Notes
- [x] Fixed a bug where a player wasn't being registered when the client packet wasn't valid
- [x] Changed the shadow plugin library to Gradle Up
- [x] Some small improvements and refactoring
[3.0.0] PlayerCrasher 3.0.0
by DevBram on Oct 15, 2026
Download
# v3.0.0 Release Notes
I am happy to announce the release of version 3.0.0, which includes a major rewrite and restructuring of the project. This update makes the code largely platform-independent, requiring only a few platform-specific methods, as long as PacketEvents supports the platform. This version includes numerous bug fixes, adds proxy support, and introduces various enhancements.
## Key Highlights
### Proxy Support
The plugin now supports proxy servers. You can simply place the plugin in the proxy server's plugin directory, and it will manage all your backend servers. Additionally, you can execute the crash command at the proxy level, affecting players on backend servers.
### 1.21 Support
The plugin is now compatible with all versions from 1.8.8 to 1.21, including Bukkit, Spigot, Paper, Folia, and their forks, as well as Bungeecord, Velocity, and their forks.
### Improved Messaging and Color Scheme
We have updated numerous messages and improved the overall color scheme for better readability and aesthetics. Previous issues with improper coloring of commands on Bukkit platforms and consoles have also been fixed.
### New Commands
We have added
## Known Issues
There are still some minor issues that need to be addressed. In certain cases, a player may be flagged as crashed, followed by a message indicating a failed crash attempt. This false detection is not harmful and will be fixed in a future patch.
On Velocity upon crashing a player an error is being thrown by Velocity a player has abruptly been disconnected, but because this is an error that is being thrown by Velocity automatically it's not something I can suppress or stop from happening.
For a detailed list of changes, please refer to the [full changelog](https://github.com/Bram1903/MinecraftPlayerCrasher/compare/v2.5.0...v3.0.0).
I am happy to announce the release of version 3.0.0, which includes a major rewrite and restructuring of the project. This update makes the code largely platform-independent, requiring only a few platform-specific methods, as long as PacketEvents supports the platform. This version includes numerous bug fixes, adds proxy support, and introduces various enhancements.
## Key Highlights
### Proxy Support
The plugin now supports proxy servers. You can simply place the plugin in the proxy server's plugin directory, and it will manage all your backend servers. Additionally, you can execute the crash command at the proxy level, affecting players on backend servers.
### 1.21 Support
The plugin is now compatible with all versions from 1.8.8 to 1.21, including Bukkit, Spigot, Paper, Folia, and their forks, as well as Bungeecord, Velocity, and their forks.
### Improved Messaging and Color Scheme
We have updated numerous messages and improved the overall color scheme for better readability and aesthetics. Previous issues with improper coloring of commands on Bukkit platforms and consoles have also been fixed.
### New Commands
We have added
/crashplayer and /bomb as aliases for the crash command. This addresses the issue where some hosts block the crash command from being executed in a terminal environment.## Known Issues
There are still some minor issues that need to be addressed. In certain cases, a player may be flagged as crashed, followed by a message indicating a failed crash attempt. This false detection is not harmful and will be fixed in a future patch.
On Velocity upon crashing a player an error is being thrown by Velocity a player has abruptly been disconnected, but because this is an error that is being thrown by Velocity automatically it's not something I can suppress or stop from happening.
For a detailed list of changes, please refer to the [full changelog](https://github.com/Bram1903/MinecraftPlayerCrasher/compare/v2.5.0...v3.0.0).
[2.5.0] PlayerCrasher 2.5.0
by DevBram on Oct 15, 2026
Download
# Changes
- Added: Brand Detector
- Added: Automatically using the best method based on the client's version
- Added:
/crashinfo [player]which gives the client their brand and version. - Improved: Hover Component after executing the crash command
- Fixed: Wrongly detecting when someone was crashed / not crashed
- Fixed: NullPointerException upon executing
/crash
[2.4.0] PlayerCrasher 2.4.0
by DevBram on Oct 15, 2026
Download
## Changes
- Added: Support for 1.20.5 & 1.20.6 (we now support 1.8.8-1.20.6)
- Added: Proper crash detector thanks to jt for providing me with a good method
- Updated: PacketEvents from
2.2.1->2.3.0 - Removed:
FoliaScheduler, because it has been merged upstream into PacketEvents.
[2.3.1] PlayerCrasher 2.3.1
by DevBram on Oct 15, 2026
Download
Fixed: Permission Issue, where everyone had the crash permission by default 😢
Fixed: [#9](https://github.com/Bram1903/MinecraftPlayerCrasher/issues/9), which occurred due to a reallocation issue.
Fixed: [#9](https://github.com/Bram1903/MinecraftPlayerCrasher/issues/9), which occurred due to a reallocation issue.
[2.3.0] PlayerCrasher 2.3.0
by DevBram on Oct 15, 2026
Download
## Dependency Rewrite
I removed every single shaded dependency and moved PacketEvents to provided. This means that starting from this version you will need to install the latest version of PacketEvents yourself. This will greatly improve performance on servers where multiple plugins are using PacketEvents.
The total size of the plugin has been reduced from 3.28MB to 44KB. Quite an improvement if I say so myself 😄
## Roadmap
The next release will include support for Minecraft Version 1.20.5, but I am awaiting an update from PacketEvents to be able to do so.
I removed every single shaded dependency and moved PacketEvents to provided. This means that starting from this version you will need to install the latest version of PacketEvents yourself. This will greatly improve performance on servers where multiple plugins are using PacketEvents.
The total size of the plugin has been reduced from 3.28MB to 44KB. Quite an improvement if I say so myself 😄
## Roadmap
The next release will include support for Minecraft Version 1.20.5, but I am awaiting an update from PacketEvents to be able to do so.
[2.2.0] PlayerCrasher 2.2.0
by DevBram on Oct 15, 2026
Download
- Fixed: Crasher bypass introduced in a random hacked client.
- Fixed: Update Notifier spamming when a new version was available.
- Updated: PacketEvents
[2.1.0] PlayerCrasher 2.1.0
by DevBram on Oct 15, 2026
Download
## Scare Crash Removal
To not violate Modrinth's Content Rules, the scare crash has been completely removed.
To not violate Modrinth's Content Rules, the scare crash has been completely removed.
[2.0.0] PlayerCrasher 2.0.0
by DevBram on Oct 15, 2026
Download
- Improved Version Support** - We now support every single Minecraft version between 1.8.8 and 1.20.4.
- Folia Support** - The plugin now runs on [Folia](https://papermc.io/software/folia).
- Switched to PacketEvents** - We have switched to [PacketEvents](https://github.com/retrooper/packetevents) to make it much easier to support multiple versions.
- Performance & Stability Improvements** - The plugin is now much more stable and performant than v1.4.2!
- Adventure Component Libary** - We now use the Adventure component library, to make components much more appealing to look at, and to make it easier to support multiple versions without having to change the implementation.
