XD’s Utils

## Description

XD’s Utils is a plugin and mod that provides a custom web interface that you can monitor the whole server, create backups to restore points of your server with a simple script to restore to a backup, an API to get and modify data of the server and plugin through sending web requests, and more!

## Features

| Feature | Implementation |
|——————-|—————-|
| Invsee | ✅ |
| AFK Detector | ✅ |
| Bounties | ✅ |
| Custom Shops | ✅ |
| Economy | ✅ |
| Chat Muting | ✅ |
| Chat Censoring | ✅ |
| Disabled Commands | ✅ |
| Disabled Items | ✅ |
| Custom Messages | ✅ |
| Backups | ✅ |
| Web Interface | ✅ |
| Commands | ✅ |

> ✅ : Implemented
>
> 🚧 : Work in Progress
>
> ❌ : Not implemented

## Config

Config Example

“`yml
# /$$ /$$ /$$$$$$$ /$$
# | $$ / $$| $$__ $$| $/
# | $$/ $$/| $$ $$|_//$$$$$$$
# $$$$/ | $$ | $$ /$$_____/
# >$$ $$ | $$ | $$ | $$$$$$
# /$$/ $$| $$ | $$ ____ $$
# | $$ $$| $$$$$$$/ /$$$$$$$/
# |__/ |__/|_______/ |_______/

# /$$ /$$ /$$ /$$ /$$
# | $$ | $$ | $$ |__/| $$
# | $$ | $$ /$$$$$$ /$$| $$ /$$$$$$$
# | $$ | $$|_ $$_/ | $$| $$ /$$_____/
# | $$ | $$ | $$ | $$| $$| $$$$$$
# | $$ | $$ | $$ /$$| $$| $$ ____ $$
# | $$$$$$/ | $$$$/| $$| $$ /$$$$$$$/
# ______/ ___/ |__/|__/|_______/

# ============================ #
# WEB #
# ============================ #

# Enabled (true/false)
enable_web: true

# Hosted Port (1000-99999)
port: 8080

# ============================ #
# BACKUPS #
# ============================ #

# Enabled (true/false)
enable_backups: true

# Folders to back up & Backup interval (Folder Names: Minutes)
folders:
– world: 120
– world_nether: 240
– world_the_end: 240
– plugins/XDs-Utils: 300

# Max folder size (MB) (-1/0 for unlimited)
max_size: 1024

# Max backups (Int) (-1/0 for unlimited)
max_backups: 10

# Compression level (0-9)
compression_level: 7

# ============================ #
# MESSAGES #
# ============================ #

# Message to send when a player joins for the first time (true/false)
enable_first_join_message: true
# %player% – Player’s name
# %message% – Message to send
first_join_message: “%yellow%Welcome %gray%%player% %yellow%to the server!”

# Message to send when a player joins (true/false)
enable_custom_join_message: true
# %player% – Player’s name
# %message% – Message to send
join_message: “%green%+ %gray%%player%”

# Message to send when a player leaves (true/false)
enable_custom_leave_message: true
# %player% – Player’s name
# %message% – Message to send
leave_message: “%red%- %gray%%player%”

# Custom player messages (true/false)
enable_custom_message_format: true
# %player% – Player’s name
# %message% – Message to send
custom_message_format: “%gray%%player% %dark_gray%» %gray%%message%”

# ============================ #
# DISABLED ITEMS #
# ============================ #

# Items to disable (Item IDs)
disabled_items:
# – minecraft:item_1
# – minecraft:item_2
# – minecraft:item_3

# Method to disable items
# 1 – Removes Recipe
# 2 – Removes Recipe & Clears Item
disable_method: 1

# ============================ #
# DISABLED COMMANDS #
# ============================ #

disabled_commands:
# – “/command_1”
# – “/command_2”
# – “/command_3”

# ============================ #
# CHAT CENSORING #
# ============================ #

# Words to censor
censored_words:
# – “censored_word1”
# – “censored_word2”
# – “censored_word3”

# Regex patterns to censor
censor_regex_patterns:
# – “censored_regex_pattern1”
# – “censored_regex_pattern2”
# – “censored_regex_pattern3”

# Method to censor words
# 0 – Do nothing (Only logs)
# 1 – Replaces Words with ‘*’
# 2 – Removes Words from message
# 3 – Do not send message
censor_method: 1

# ============================ #
# ECONOMY #
# ============================ #

# Enable the shop (true/false)
enable_shop: true

# Allow anyone to create shops (true/false)
anyone_create_shops: true

# Enable bounties (true/false)
enable_bounties: true

# Bounty you gain when you kill a player (Int/Float/Double)
kill_reward: 100.00

# Amount of money to give to players when join the next day (Int/Float/Double)
daily_balance: 100.00

# Items in the default shop (Item ID: Cost, Amount, Slot)
shop_items:
– minecraft:elytra:
cost: 50000
amount: 1
slot: 0
– minecraft:netherite_ingot:
cost: 25000
amount: 1
slot: 1
– minecraft:diamond:
cost: 2500
amount: 1
slot: 2
– minecraft:emerald:
cost: 2500
amount: 1
slot: 3
– minecraft:gold_ingot:
cost: 50
amount: 1
slot: 4
– minecraft:iron_ingot:
cost: 50
amount: 1
slot: 5
“`

XD’s Library

### XD’s Library

#### XDPXI’s library for numerous tasks.

### Features

> Please view the Documentation for the correct features for your version

### Building from Source

#### To build the mod from source follow the steps below:

– Clone the Git repository

– Run `gradlew build` or `build.ps1` in your terminal in the cloned repository

#### The compiled mod will be in `build/libs`

XDiscordUltimate

# XDiscordUltimate

The most comprehensive Discord integration plugin for Minecraft servers. Features modern slash commands, chat bridge, verification system, tickets, moderation, and much more.

![Version](https://img.shields.io/badge/version-1.0.0-blue)
![Minecraft](https://img.shields.io/badge/minecraft-1.16.5+-green)
![Java](https://img.shields.io/badge/java-17+-orange)
![Discord](https://img.shields.io/badge/discord-JDA_5.0-7289da)
![License](https://img.shields.io/badge/license-MIT-purple)

## Features

– **Chat Bridge** – Seamless chat sync between Minecraft and Discord
– **Verification System** – Secure account linking with verification codes
– **Support Tickets** – Full ticket system with Discord integration
– **Player Stats** – Track and display player statistics
– **Server Status** – Auto-updating status embed in Discord
– **Moderation** – Ban sync, chat filtering, and report system
– **Admin Console** – Execute server commands from Discord
– **Announcements** – Broadcast to both Discord and Minecraft
– **Booster Perks** – Reward Discord server boosters
– **Admin Alerts** – Server health monitoring
– **Server Logging** – Log all events to Discord

## Quick Start

1. Download the latest release
2. Place in your `plugins` folder
3. Start server to generate config
4. Configure `config.yml` with your bot token and guild ID
5. Restart server

“`yaml
discord:
bot-token: “YOUR_BOT_TOKEN”
guild-id: “YOUR_GUILD_ID”
channels:
chat: “CHANNEL_ID”
logs: “CHANNEL_ID”
“`

## Documentation

### Getting Started

**New to XDiscordUltimate?** Start here:

| Guide | Description |
|——-|————-|
| [**Getting Started Guide**](docs/GETTING-STARTED.md) | Step-by-step setup from scratch |
| [Installation Guide](docs/INSTALLATION.md) | Quick installation reference |

### Core Documentation

| Document | Description |
|———-|————-|
| [Installation Guide](docs/INSTALLATION.md) | Complete setup instructions |
| [Configuration Guide](docs/CONFIGURATION.md) | All configuration options |
| [Commands Reference](docs/COMMANDS.md) | All commands and permissions |
| [Features Guide](docs/FEATURES.md) | Detailed feature explanations |
| [Permissions Reference](docs/PERMISSIONS.md) | All permission nodes |
| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues and solutions |
| [Messages Configuration](docs/MESSAGES.md) | Customize all messages |
| [Developer API](docs/API.md) | API for developers |
| [Database Reference](docs/DATABASE.md) | Database schema and configuration |

### Module Documentation

| Module | Description |
|——–|————-|
| [Chat Bridge](docs/modules/CHAT-BRIDGE.md) | Minecraft-Discord chat sync |
| [Verification](docs/modules/VERIFICATION.md) | Account linking system |
| [Server Logging](docs/modules/SERVER-LOGGING.md) | Event logging to Discord |
| [Admin Alerts](docs/modules/ADMIN-ALERTS.md) | Server health monitoring |
| [Tickets](docs/modules/TICKETS.md) | Support ticket system |
| [Moderation](docs/modules/MODERATION.md) | Ban sync, filter, reports |
| [Server Control](docs/modules/SERVER-CONTROL.md) | Remote server management |
| [Player Stats](docs/modules/PLAYER-STATS.md) | Statistics tracking |
| [Server Status](docs/modules/SERVER-STATUS.md) | Auto-updating status embed |
| [Booster Perks](docs/modules/BOOSTER-PERKS.md) | Discord booster rewards |
| [Bot Console](docs/modules/BOT-CONSOLE.md) | Discord console access |
| [Announcements](docs/modules/ANNOUNCEMENTS.md) | Cross-platform broadcasts |
| [Module Manager](docs/modules/MODULE-MANAGER.md) | Managing modules |

## Commands

### Player Commands
| Command | Description |
|———|————-|
| `/verify ` | Link your Discord account |
| `/support ` | Create a support ticket |
| `/report ` | Report a player |
| `/stats [player]` | View player statistics |
| `/help` | Open help menu |

### Admin Commands
| Command | Description |
|---------|-------------|
| `/xdiscord reload` | Reload configuration |
| `/xdiscord status` | Show plugin status |
| `/xdiscord modules` | List all modules |
| `/announce ` | Make an announcement |

### Discord Slash Commands
| Command | Description |
|---------|-------------|
| `/verify` | Get verification code |
| `/status` | Show server status |
| `/players` | List online players |
| `/stats [player]` | View player statistics |
| `/console ` | Execute server command |

## Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `xdiscord.verify` | Use verification | true |
| `xdiscord.support` | Create tickets | true |
| `xdiscord.report` | Report players | true |
| `xdiscord.admin` | Admin commands | op |
| `xdiscord.console` | Console access | false |
| `xdiscord.announce` | Make announcements | op |
| `xdiscord.bypass.verification` | Bypass verification | false |
| `xdiscord.bypass.filter` | Bypass chat filter | false |

## Requirements

- **Minecraft Server**: Spigot/Paper 1.16.5+
- **Java**: 17 or higher
- **Discord Bot**: With MESSAGE_CONTENT intent enabled

### Optional Dependencies
- LuckPerms - For permission groups
- PlaceholderAPI - For placeholders
- Vault - For economy (future)

## Configuration Example

```yaml
# Admin Discord IDs
adminIDs:
- "123456789012345678"

# Enable features
features:
chat-bridge:
enabled: true
chat-channel-id: "1234567890"
minecraft-to-discord: true
discord-to-minecraft: true

verification:
enabled: true
verified-role: "Verified"
code-expiry-minutes: 5

server-logging:
enabled: true
logs-channel-id: "1234567890"
log-join-leave: true
log-commands: true

tickets:
enabled: true
auto-close-hours: 48
save-transcript: true

player-stats:
enabled: true

server-status:
enabled: true
channel-id: "1234567890"
update-interval: 60

moderation:
enabled: true
sync-bans: true
auto-moderate: true

admin-alerts:
enabled: true
tps-threshold: 15.0
ram-threshold: 90

booster-perks:
enabled: true
permission-group: "booster"

# Discord settings
discord:
bot-token: "YOUR_TOKEN"
guild-id: "YOUR_GUILD_ID"
channels:
chat: ""
logs: ""
tickets: ""
moderation: ""

# Database
database:
type: "sqlite"
```

## Support

- **Issues**: GitHub Issues
- **Discord**: Join our Discord

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

Made with ❤️ by XreatLabs

xDay

![banner](https://cdn.modrinth.com/data/cached_images/3a2a49d68ed0e198a689293165288602c47feb3b.jpeg)Total
## xDay Time & Weather Control per World

Summary (Short Description)
Independently control the time and weather of each world. Set worlds to always be day, always night, rain-free, and customize all messages with full HEX color support!

Body (Full Description)
Tired of unpredictable weather in your lobby? Want to create a mining world that’s perpetually dark and storm-free? xDay is the definitive solution. This extremely lightweight and efficient plugin gives you absolute control over the day-night cycle and the weather, all on a per-world basis.

Its intuitive configuration and total message customization make it an essential tool for any server type, from Survival to minigames.

✨ Key Features
✅ Total Per-World Control: The main event! Assign a fixed time and weather to specific worlds (world, world_nether, lobby, etc.) and let the rest run normally.

⚙️ Simple & Intuitive Configuration: Everything is managed from a very easy-to-understand config.yml file. No complex in-game commands needed!

🎨 100% Customizable Messages: Edit every plugin message from messages.yml. Full support for classic Minecraft color codes (&a) and HEX color codes (<#FF5733>) for unique color palettes!

📖 Dynamic Help Menu: Add or remove lines from the help menu directly in the messages.yml file. Tailor the help message to your server!

🚀 Lightweight & High-Performance: Designed to be as efficient as possible, with no impact on your server’s performance.

🤝 Developer API: Includes a simple API for other plugins to hook into xDay and get a world’s configuration.

⌨️ Command Tab-Completion: The /xday help and /xday reload commands have tab completion for faster use.

🔧 Configuration
The plugin generates two configuration files in the /plugins/xDay/ folder.

config.yml
“`yaml
# _________ _____.__
# _ ___ ____ _____/ ______| ____
# / / / _ / __| |/ ___
# ___( <_> ) | | | / /_/ >
# ______ /____/|___| /__| |_____ /
# / / /_____/
# Hecho con amor por 777 Studios – xPlugins

# Configuración por defecto para mundos que no estén en la lista de abajo.
default-settings:
lock-weather: ‘disabled’ # Opciones: ‘clear’, ‘rain’, ‘disabled’
set-time: ‘disabled’ # Opciones: ‘day’, ‘noon’, ‘night’, ‘disabled’, o un número (0-24000)

# Configuración para mundos específicos.
worlds:
# Mundo principal normal
world:
lock-weather: ‘clear’
set-time: ‘day’

# Mundo del Nether
world_nether:
lock-weather: ‘disabled’
set-time: ‘disabled’

# Mundo del End
world_the_end:
lock-weather: ‘disabled’
set-time: ‘disabled’

# Ejemplo para un mundo de minería donde siempre es de noche:
# minas:
# lock-weather: ‘clear’
# set-time: ‘night’
“`

Messanges:
“`yaml
# _____ ____ ____ ___________ |__| ____ ______
# / _/ __ / / ___/__ | |/ __ / ___/
# | Y Y ___/| | \___ / __ _ | ___/ ___
# |__|_| /___ >___| /____ >(____ /__| |___ >____ >
# Hecho con amor por 777 Studios – xPlugins
# Usa colores HEX (<#RRGGBB>) o de Minecraft (&a, &b, etc.)

prefix: “<#FFB347> [xDay] ”

reload: “<#77DD77>¡La configuración y los mensajes han sido recargados!”
no-permission: “<#FF6961>No tienes permiso para ejecutar este comando.”
help-message:
– “&7—————–&f Ayuda de <#FFB347>xDay &7——————–”
– ”
– “<#AEC6CF> /xday help <#878787>➛&f Muestra este mensaje de ayuda.”
– “<#AEC6CF> /xday reload <#878787>➛&f Recarga la configuración del plugin.”
– “”
– “<#C3B1E1>💕 Plugin creado por WillfryDev. 💕”
– ”
– “&7—————————————”
“`
💻 Commands & Permissions
/xday help (Alias: /xd)

Description: Displays the configurable help menu.

Permission: xday.help (granted to all by default).

/xday reload

Description: Reloads the config.yml and messages.yml files without a server restart.

Permission: xday.reload (granted to OPs by)

![bstats](https://bstats.org/plugin/bukkit/xDay/27310)

📘 For Developers (API)

“`
xDay includes a static API to make integration with other plugins easy.

1. Add softdepend to your plugin.yml:

YAML

softdepend: [xDay]
2. Access the API in your code:

Java

// Check if xDay is on the server
if (getServer().getPluginManager().getPlugin(“xDay”) != null) {

// Get the API instance
jn.willfrydev.xday.api.xDayAPI api = jn.willfrydev.xday.xDay.getApi();

// Example Usage
World lobbyWorld = Bukkit.getWorld(“lobby”);
if (lobbyWorld != null) {
String weather = api.getLockedWeather(lobbyWorld); // Returns “clear”, “rain”, or “disabled”
String time = api.getLockedTime(lobbyWorld); // Returns “day”, “night”, etc.

System.out.println(“The weather in the lobby is locked to: ” + weather);

// You can also force an update
api.forceUpdate(lobbyWorld);
}
}

Download xDay and take absolute control over your worlds’ atmosphere!

XDailyVoucher

# XDailyVoucher

A feature-rich daily rewards and voucher system for your Minecraft server!

## 📚 Overview

XDailyVoucher brings an engaging rewards system to your server, encouraging player retention through daily login rewards and a flexible voucher system.

### ✨ Features

**Daily Rewards:**
– Progressive rewards with streak bonuses
– Custom rewards for each day
– Special weekly rewards
– Visual GUI interface
– Persistent streak tracking

**Voucher System:**
– Create custom vouchers
– Multiple rewards per voucher
– Support for both command and item rewards
– Visual GUI for editing voucher contents
– Flexible command execution
– Admin distribution controls
– Player redemption system with limits

## 🎮 Usage

### Player Commands:
– `/xdv daily` – Open daily rewards GUI
– `/xdv redeem ` – Redeem available vouchers

### Admin Commands:
– `/xdv reload` – Reload configuration
– `/xdv voucher ` – Create vouchers
– `/xdv vgui ` – Edit voucher items through GUI
– `/xdv give [amount]` – Distribute vouchers
– `/xdv dailyitem ` – Set rewards
– `/xdv active ` – Enable redemption
– `/xdv deactive ` – Disable redemption
– `/xdv vlist` – List all vouchers

## 📋 Requirements

– Paper 1.17+
– Vault

## ⚙️ Configuration

Easily customize through `config.yml`:
– Base reward amounts
– Streak multipliers
– All messages and notifications

## 🔒 Permissions

– `xdv.admin` – Administrative access
– `xdv.use` – Basic player access (default: true)

## 🔧 Installation

1. Download the plugin
2. Place in plugins folder
3. Restart server
4. Configure settings

## 🤝 Support

Need help? Found a bug? Have a suggestion?
– Create an issue on our GitHub

## 📝 License

Released under the GNU License

XConfig

# ⚙️ | XConfig
XConfig is a simple library Free and Open-Source that allows create multiple files rapidly and do some action with that files as the developer want, or simply get values from the files. The library has a good code-quality, you can see the library code and contribute to it.

You can create various configuration files, by the moment the library only has support for YAML files.

Features:
* Support for Bukkit and BungeeCord platforms.
* Make multiple files easy.
* Control about the files.
* Get multiple values from files.
* Write values into the files.
* Reload or save the files.
* Colorize the texts with normal colors and HEX colors.

![](https://jitpack.io/#InitSync/XConfig)
![Codacy Badge](https://www.codacy.com/gh/InitSync/XConfig/dashboard?utm_source=github.com&utm_medium=referral&utm_content=InitSync/XConfig&utm_campaign=Badge_Grade)

# 🛠️ | Installation
XTools installation is very easy, you can import the library using a dependency manager such as Maven or Gradle. Or just add the jar to BuildPath of your project.

To get the jar, either download it from GitHub or Spigot. Or just Build it locally

You can see examples about how to import the library at the Wiki.

# ➕ | Contribute
Do you want contribute with the library?

* Make a Pull Request
* Issues

# ✅ | Build
If you want build the project locally, download it, you must be had Gradle and Java 8+ for this.

Now for build the project
“`
git clone https://github.com/InitSync/XConfig
cd XConfig
./gradlew shadowJar
“`

The files will be at the `XConfig/bin` folder.

# 🎫 | License
This project is licensed under the GNU General Public License v3.0 license, for more details see the file [License](LICENSE)

XCommand Rename

![X-Command Rename](https://cdn.modrinth.com/data/cached_images/1c7643efb7bbb7eb2a7fffed060a411c275ce18d_0.webp)

**XCommandRename** is a lightweight and powerful plugin for Paper Minecraft servers that allows you to create shortcuts for existing commands!

### Features
– **Simple Configuration** – All commands are configured through a user-friendly config.yml
– **Dynamic Registration** – Commands are automatically registered upon startup
– **Argument Support** – Use {1}, {2}, and so on to pass arguments
– **Permission System** – Configure access rights through permissions and operators-only
– **Colorful Messages** – Full support for RGB color codes
– **Instant Reload** – Apply changes without restarting the server
– **Multiline Messages** – Support for complex text notifications
– **Wide Compatibility** – Works on Paper from 1.16.5 to 1.21.10+

### Examples of use
– **Shortening long commands:**
– Instead of /server hub, players can simply write /hub
– **Commands with arguments:**
– “/gmode creative” will execute “/gamemode creative”
– “/gmode survival Player123” will execute “/gamemode survival Player123”
– **Commands with multiple arguments:**
– “/pay Player123 1000” will execute “/economy give Player123 1000”

### Commands
– **/xcr reload** – Reload the plugin configuration

### Access rights
– **xcr.reload** – Reload the plugin (default for OP)

### Argument support
– Use placeholders in the execute field to pass arguments:
– **{1}** – the first argument
– **{2}** – the second argument
– **{3}** – the third argument
– and so on…

### Technical details
– API version: **1.16**
– Supported platforms: **Paper**
– Supported versions: **1.16.5** – **1.21.10+**
– Requires **Java: 17+**
– Dependencies: **None**

XColor

###### **Update for this plugin incoming!!**

### Features

1. **Customizable Prefixes:**
– Modify the your Name as the owner want with Minimessage Format:
`/cosmetics prefix ` – MiniMessage Support

2. **Reset Options:**
– Reset customizations for name or prefix:
`/cosmetics reset`

### Benefits:
– **Enhanced Personalization:** Express yourself with unique colors, bold styles, and custom statuses.
– **Easy Reset Options:** Quickly return to default settings without hassle.
– **Role-Specific Access (Upcoming):** Admins can control access with a detailed permission system for better server management.

### Commands:
– “/cosmetics prefix
– “/cosmetics reset“

### Permissions
– “colorstatus.command.cosmetics.reset“
– “colorstatus.command.cosmetics.prefix“

## Placeholder API
– Placeholder
– `%xcolor_cosmetics_prefix_name%`
– `%xcolor_cosmetics_prefix_text%`

### Coming SOON
– ~~Placeholder API~~
– Database for Multi-server support
– More Cosmetics
– More Commands/Commands Options

xCoinFlip

🎲 xCoinFlip

The best modern and immersive betting system for your Minecraft server

![Banner](https://cdn.modrinth.com/data/cached_images/6e9ab718e79103c59a7ccf2c7660fd80623e5853.jpeg)

**xCoinFlip** is a highly optimized and fully customizable plugin that adds a “Heads or Tails” (Coinflip) betting system to your server. Designed to offer a fresh and addictive experience, it allows players to wager their money on 1v1 duels with high-quality animations, boosting engagement and improving your network’s economy flow.

> ### ✨ Recent Highlights (v1.0.1)
> * **New:** **Cryptographically Secure Randomness** using `SecureRandom` for 100% fair duels.
> * **New:** **Suspenseful Roulette Animation** with realistic friction/slowing effects.
> * **New:** **Trillion (T) Support** in smart amount parsing for large economies.
> * **New:** **Chat-based Creation Prompt** to quickly set bets without long commands.

> ### 🔥 Key Features

– 🎰 **Immersive Roulette Animation:** Unlike other basic betting plugins, our GUI features a spectacular “friction” spin effect. The player heads start spinning smoothly and gradually slow down, generating an incredible level of tension and suspense just before the winner is revealed.
– 🔒 **Provably Fair:** The probability engine is entirely unpredictable. Written using secure randomness parameters (`SecureRandom`), it guarantees a purely impartial 50/50 ratio, eliminating any chance of scams or player exploits.
– 💬 **Lightning-Fast Wagers:** Tired of typing long commands? Players can simply open the GUI, click the “Create Game” button, and the plugin will seamlessly capture their next chat message. It even supports amount abbreviations! Drop a `1.5k`, `50m`, `3B`, or even **`2T`** and the plugin handles the rest.
– 💾 **Excellent Performance (H2 Built-in):** Comes with its own asynchronous built-in database manager to store pending games without consuming main-thread resources, meaning you don’t even need to hassle with external MySQL setups.
– 🎨 **100% Customizable:** The power is in your hands. Modify the GUI layouts (slots, titles, items), chat messages, action bars, sounds, win chances, and global broadcasts directly through the `.yml` files.
– 🎆 **Visual Rewards:** Spectacular victory effects including snappy sounds, firework launches, and totem particles to properly celebrate large wins.
– 📡 **Discord Webhook Integration:** Automatically broadcast massive wins and epic duels directly to your Discord community channels via configurable webhooks.

> ### ⚙️ Commands & Permissions

**General Commands – `/cf` or `/coinflip`**
* `/cf menu` : Opens the main active games GUI. *(No specific permission required by default)*
* `/cf create ` : Instantly create a new coinflip wager without opening the GUI.
* `/cf help` : View available commands based on player privileges.

**Admin Commands:**
* `/cf reload` : Hot-reload `config.yml`, `gui.yml`, and `animation.yml` without needing to restart your server.
* **Default Admin Permission:** `xcoinflip.admin` (Can be modified in config).

> ### 🎢 Example Menu (Custom)


> ### 🧩 Dependencies

To ensure xCoinFlip runs smoothly, your server requires the following:

* **Vault** – *(Required)*
* **Any Economy Provider** (EssentialsX, CMI, etc.) – *(Required)*
* **PlaceholderAPI** – *(Optional but recommended)*

> ## 💗 Servers that use our plugin
> * **SolarCraftMc** (Survival Vanilla)
> * **MineFania** (Survival OP)

> ### 💬 Support & Community
> Developed and maintained by the **xPlugins** team.
> If you have any questions, suggestions, or need help configuring the plugin, you are more than welcome to join our official Discord.
>
> 😊 **Available in: ES / EN / CUSTOM**

X-Clearlag

![Spigot](https://www.spigotmc.org/resources/x-clearlag-custom-cleaning-1-8-1-21-11.132713/) ![Wiki](https://wiki-x-proyects.vercel.app/) ![Discord](https://discord.com/invite/Yb6GsfGWmd)

# **X-ClearLag**
*Next-generation entity cleanup with Folia support, proximity protection, and multi-language modular tasks*

## 📄 Description
**X-ClearLag** is the ultimate, professional-grade entity management solution for modern servers. Completely rebuilt from the ground up, it offers **native Folia compatibility**, wall-clock precision tasks, and advanced performance optimizations. Protect your players’ experience with the brand-new **Proximity Protection system**, automatically intervene during lag spikes with **TPS-based emergency cleanups**, and monitor your world smoothly using the **Interactive Chunk Inspector**.

All of this without a single annoying console warning. Supports **Spigot, Paper, Purpur, and Folia (1.8.x – 26.1)**.

## ⚡ Main Commands
**`/xcl [subcommand]`** (*Aliases: `/clearlag`, `/xclearlag`*)
– **`help`** – Shows the interactive help menu.
– **`reload`** – Hot-reloads configuration and language files.
– **`clear`** – Manually triggers the main cleanup tasks instantly.
– **`inspect`** – Opens the **Interactive Chunk Inspector** to hunt down entity clusters.
– **`clearchunk `** – Wipes all entities from a targeted chunk.
– **`tpchunk `** – Teleports instantly to a specific chunk coordinate.
– **`update`** – Checks for the latest X-ClearLag updates.

## ⭐ Key Features
– **Folia & Next-Gen Support** — 100% compatible with Folia’s regional threading model. Built for elite performance.
– **Player Proximity Protection** — Smartly ignores dropped items and entities that are right next to your active players.
– **TPS Monitor & Auto-Cleanup** — Server lagging? X-ClearLag detects TPS drops and automatically triggers an emergency surgical cleanup.
– **Batch Processing & Anti-Spike** — Removes thousands of entities in controlled batches over multiple ticks, preventing the classic “clearlag server freeze”.
– **Interactive Chunk Inspector** — View the Top 12 busiest chunks and manage them through interactive chat clicks.
– **Internal Notifications & PAPI** — Use `[TITLE], [ACTIONBAR], [BROADCAST], [SOUND]` directly in config. Full PlaceholderAPI support.
– **BossBar Countdown** — Elegant visual countdown bar for players during the last 60s (Requires 1.9+).
– **Task-Based Architecture** — Create unlimited independent cleanup tasks. Make one run every 5 mins for drops, and another every 30 mins to run `save-all`.
– **Granular Protection** — Secure mobs by name-tag, leash state, type whitelist, or world blacklists.

## 🌐 Multi-Language Support
– **English** — `en`
– **Español** — `es`
– **Português** — `pt`
– **日本語** — `ja`
– **Русский** — `ru`
– **Custom** — `custom`

## 🔑 Permissions
– **`xclearlag.admin.*`** — Grants all admin permissions (Default: OP).
– **`xclearlag.admin.reload`** — Access to `/xcl reload`.
– **`xclearlag.admin.clear`** — Access to `/xcl clear`.
– **`xclearlag.admin.inspect`** — Access to `/xcl inspect`.
– **`xclearlag.admin.clearchunk`** — Access to `/xcl clearchunk`.
– **`xclearlag.admin.tpchunk`** — Access to `/xcl tpchunk`.
– **`xclearlag.admin.update`** — Access to `/xcl update`.
– **`xclearlag.bypass`** — Bypass countdown messages (Default: false).
– **`xclearlag.notify`** — Receive cleanup notifications (Default: true).

## 🧩 Developer API
X-ClearLag provides a lightweight API for other plugins to interact with the cleanup engine. Support for custom events like `XPreClearEvent` (cancellable) and `XPostClearEvent` allows you to prevent cleanups during critical moments or track performance metrics easily. Full **PlaceholderAPI** support included!

## ⚙️ Configuration Example
> [!TIP]
> This is a basic example. For a full explanation of every setting and module, please visit our Official Wiki.

“`yaml
prefix: “&8[&bX-ClearLag&8] &7”
language: “en”

tps-check:
enabled: true
threshold: 16.0
interval: 60
task-to-run: [“clearlag”]

bossbar:
enabled: false
color: “RED”
style: “SOLID”

tasks:
clearlag:
enabled: true
interval: 300
min-players: 3
remove-drops: true
protect-named: true
protect-leashed: true
protect-near-player: false
near-player-radius: 16
countdown: [60, 30, 10, 5, 3, 2, 1]
countdown-commands:
60:
– ‘[TITLE] &b&lX-ClearLag’
– ‘[SUBTITLE] &7Cleanup in &c60s’
– ‘[SOUND] NOTE_PLING’
10:
– ‘[ACTIONBAR] &eEntities removed in &c10s&e!’
entities: [ARROW, SNOWBALL, EXPERIENCE_ORB]
protected-entities: [PLAYER, VILLAGER, ARMOR_STAND]
commands: []

optimizations:
batch-size: 100
chunks-per-tick: 40
“`

Need help? Join our Discord Community or read the Official Wiki!