FastCrystals Plugin

FastCrystal Plugin Features
FastCrystal is an optimized and async-powered Minecraft plugin that enhances Ender Crystal PvP mechanics by allowing players to enable or disable instant crystal removal upon attack. The plugin is designed for large servers with features that prioritize performance, efficiency, and smooth gameplay.

Key Features:
1️⃣ Ultra-Fast Ender Crystal Breaking

• Players can toggle Fast Crystal Mode to instantly remove Ender Crystals upon hitting them.
• Uses async processing to prevent any lag when handling crystal removals.

2️⃣ Asynchronous Processing (No Lag)

• Async event handling for player joins, entity damage, and command execution to prevent lag spikes.
• Uses ConcurrentHashMap for thread-safe storage of players’ toggle status.

3️⃣ Smart Crystal Removal (Thread-Safe)

• Crystals are checked asynchronously and then removed on the main thread to avoid crashes.
• Prevents TPS drops by optimizing entity removal.

4️⃣ Toggleable Per-Player Mode

• Players can enable or disable Fast Crystal Mode via /fastcrystals.
• Mode is persistent per session and defaults to enabled/disabled based on the config.

5️⃣ High-Performance Command Execution

• /fastcrystals command runs asynchronously, preventing lag.
• Uses fast async processing to modify and store player settings.

6️⃣ Customizable Messages & Settings

• Configurable enable/disable messages for players.
• Supports RGB Hex Colors (e.g., #FF0000) for chat messages.

7️⃣ Auto-Enable Mode on Join (Optional)

• Players can automatically have Fast Crystal Mode enabled on join.
• Configurable via defaultStatus: true/false.

8️⃣ Supports Latest Minecraft Versions (1.20+)

• Supports Paper 1.20+ and future versions.
• Automatically detects Minecraft version and applies the best method.

9️⃣ Lightweight and Optimized for PvP Servers

• Designed for large PvP-based servers with heavy player activity.
• No unnecessary packet handling, making it ultra-lightweight.

⚙ Configuration (config.yml)
The plugin has an easy-to-use config.yml for customization:

# FastCrystal Plugin Configuration

# Enable fast crystal removal for all players on join (true = enabled, false = disabled)
defaultStatus: true

# Enable or disable the /fastcrystals command
commandEnabled: true

# Message when Fast Crystal Mode is enabled
enableMessage: "&aFast Crystals Mode: Activated!"

# Message when Fast Crystal Mode is disabled
disableMessage: "&cFast Crystals Mode: Deactivated!"

Commands & Permissions

Command Description Permission
/fastcrystals Toggle Fast Crystal Mode fastcrystals.use

• Players can toggle the feature ON/OFF at any time.
• No permissions required for OPs.

Why Use FastCrystal?
✅ Asynchronous Optimized – Runs in the background to prevent lag.
✅ Zero TPS Impact – Handles player data efficiently.
✅ Ultra-Lightweight – No unnecessary packet manipulation.
✅ Built for PvP Servers – Designed for fast-paced Crystal PvP gameplay.
✅ Future-Proof – Supports 1.20+ and upcoming versions.

Example Use Case (Crystal PvP)

1. A player joins a Crystal PvP server.
2. The plugin automatically enables Fast Crystal Mode for them.
3. When they hit an Ender Crystal, it instantly disappears, allowing for faster fights.
4. They can type /fastcrystals to disable or enable the feature at any time.

Installation Guide

1. Download FastCrystal.jar.
2. Place it in the plugins/ folder of your Paper 1.20+ server.
3. Start the server & modify config.yml if needed.
4. Players can use /fastcrystals to toggle their mode.

DISCORD