PlayerCrasher Plugin do Minecraft 1.20.1, 1.21.1

PlayerCrasher

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
• Requires PacketEvents
• Showcase
• Supported Platforms & Versions
• Spoofers
• Commands
• Permission Nodes
• Installation
• Compiling From Source
• Prerequisites
• Steps
• 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:

• Explosion
• Particle
• Position

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.Crash Allows the player to use the /crash command.
• PlayerCrasher.Bypass Exempts the player from being crashed when the /crash command is used on them.
• PlayerCrasher.Alerts Makes the player receive alerts when a player is being crashed by another player.
• PlayerCrasher.CrashInfo - Allows the player to use the /crashinfo command.
• PlayerCrasher.UpdateNotify Makes 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 build

Windows

.\gradlew build

Credits

Special thanks to:

• @Retrooper: Author of PacketEvents.

License

This project is licensed under the GPL3 License.