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`

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

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**

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!

xClearBlocks

#🧹 ClearBlock: Scheduled Region Clearing for Spigot/Paper

ClearBlock is an essential maintenance plugin designed for survival, creative, or resource servers that rely on fixed areas (like build plots or mining worlds) staying clean and lag-free.

It utilizes the power of WorldGuard to precisely target and remove specific blocks and dropped items on a set schedule, ensuring a pristine environment for your players without constant manual intervention.

✨ Features

WorldGuard Integration: Target a specific ProtectedRegion ID defined in your WorldGuard setup. Only blocks and items inside this region are scanned and cleared.

Asynchronous Scanning: The heavy task of scanning thousands of blocks runs asynchronously (on a separate thread) to prevent server main thread lag, maintaining smooth gameplay.

Configurable Block Clearing: Specify a list of blocks (e.g., COBWEB, WATER, LAVA, GRAVEL) that will be instantly cleared.

Dropped Item Removal: Toggle a configuration option (clear-items-enabled: true) to automatically remove all dropped org.bukkit.entity.Item entities within the target region.

Scheduled Warnings: Players receive configurable, synchronized chat warnings 30 seconds before the clear event starts, giving them time to secure their items and avoid confusion.

Configurable Interval: Set the clear interval in Minecraft Ticks (e.g., 72000 ticks = 1 hour).

⚙️ Installation & Setup

Requirements

Spigot/Paper/BukkitTacoSpigot (1.18+)

WorldGuard (v7.0.9 or newer recommended)

WorldEdit (v7.2.14 or newer recommended)

Configuration (config.yml)

Stop your server.

Place the xClearBlock.jar in your plugins/ folder.

Start the server once to generate the default config.yml, then stop it again.

Edit the configuration:

“`
# The list of materials (blocks) to clear. Use ALL CAPS names.
blocks-to-clear:
– COBWEB
– LAVA
– WATER

# The ID of the WorldGuard region that should be scanned and cleared.
# THIS MUST BE A REGION YOU HAVE PRE-DEFINED!
target-region-id: my_clearing_region

# Set to true to clear all dropped items (org.bukkit.entity.Item) within the region.
clear-items-enabled: true

# How often the clearing task should run, in Minecraft Ticks.
# 72000 Ticks = 1 hour
clear-interval-ticks: 1200
“`

Start your server. The plugin will announce its successful enablement in the console.

💖 Brought to you by Xaso Studios!

This project is proudly supported by Phyntra Host.

If you’re looking for incredibly fast, lag-free hosting to run your large Spigot, Paper, or custom server with complex plugins like ClearBlock, check out their plans:

👉 [[Phyntra Host]](https://billing.phyntra.net/)

[Optional: Add a logo/banner image for the host here if Modrinth allows.]

XCatch

# XCatch
### Efficient yet effective plugin to catch X-rayers for Minecraft 1.13-1.19.
XCatch analizes how a player is mining by looking it how many turns it makes and how many rare ores it finds in a small period of time.
## Features
– Send an alert to staff after a configurable amount of flags.

![image](https://user-images.githubusercontent.com/67508414/163673854-b3b1c3c1-1f9f-4c47-92e5-34d28ba77030.png)
– Automatically ban players after a configurable amount of flags (off by default).
– See flags and bans of online or offline players in a gui.

![image](https://user-images.githubusercontent.com/67508414/162445888-556cf94e-2389-4887-ac4c-585e1af2b859.png)![image](https://user-images.githubusercontent.com/67508414/163673833-9c7a7153-0f3c-4d47-9a2a-7a709e496427.png)
– Ability to specify multiple ban times depending on how many previous bans a player has
– Log flags in a Discord channel with DiscordSRV
– Ability to execute commands after a number of flags

https://bisecthosting.com/diamond

## Why use this over other plugins
– Plugins that hide ores (like Orebfuscator) are generally very CPU intensive, while XCatch is not and those plugins can be bypassed if the player knows the seed, which can be easily obtained with a seedcracker mod, while XCatch cannot be easily bypassed.
– Plugins that announce when a player has mined a lot of ores (like OreAnnouncer) have way more false flags when players are just lucky or when they find a big ore vein
## Commands
– /xcatch help, shows all commands.
– /xcatch view [], shows flags of all players or the player specified.
– /xcatch info, get some statistics about XCatch on your server

![image](https://user-images.githubusercontent.com/67508414/162447605-1f0d2fe2-cb74-4b46-b24d-4100e2a6d5d9.png)
– /xcatch reload, reload the XCatch config.
– /xcatch debug , get some debug stats of a player.
## Permissions
– xcatch.alert: Players with this permission get notified of a flag.
– xcatch.command: Players with this permission get access to the XCatch command
– xcatch.bypass: Players with this permission bypass all XCatch checks
– xcatch.noban: Players with this permission will still get flagged as normal, but XCatch won’t automtically ban them

## FAQ
Q: XCatch isn’t detecting me Xraying

A: **Make sure you don’t have the XCatch.bypass permission**

Q: How do I configure XCatch?

A: The configuration file is in the `XCatch` folder an is named `config.yml`, there are clear descriptions of what everything does in the config file.

xBossBar

![Header](https://assets.drygo.dev/uploads/modrinth/xbossbar/header.webp)

# xBossBar 〽️

**xBossBar** is a powerful and customizable bossbar management plugin for Minecraft servers. It allows server administrators to create, manage, and display bossbars with personalized colors, styles, titles, and per-player visibility.

### Key Features 💫

– **BossBar Management** – Create, remove, and edit bossbars with ease.
– **Custom Titles** – Set unique titles for each bossbar.
– **Colors & Styles** – Multiple colors and styles including segmented and solid bars.
– **Per-Player Bars** – Show bossbars to specific players or all players.
– **Progress Control** – Dynamically set bossbar progress in-game.
– **API Support** – Fully featured API to integrate bossbars with other plugins or custom systems.
– **User-Friendly** – Simple and clear commands for fast management.

### Useful Links 🔗

– GitHub Repository – Access the source code, latest releases, and submit **Issues** for bug reports, feature requests, or questions.
– Wiki Documentation – Guides for commands, configuration, placeholders, and API usage.

### Support ❓

For technical issues, unexpected behavior, or enhancement suggestions, please submit an **Issue** on the GitHub repository. This ensures your feedback is tracked and addressed efficiently.

xBossBar is designed to provide a **robust, flexible, and professional bossbar management solution**, allowing Minecraft server owners to enhance gameplay with visually engaging and fully customizable bossbars.

xBlocked

![banner](https://cdn.modrinth.com/data/cached_images/5cfd67d2edcd913cbe8572d3e157007da644b031.jpeg)
## 📌 xBlocker Description

## Example #1
![example1](https://cdn.modrinth.com/data/cached_images/9e0f3df6ff161860154e25eb276527486cefb233.png)

xBlocker is the ultimate plugin to control and customize the connection experience on your Minecraft server, designed for admins who want professionalism, flexibility, and full compatibility.

🔹 Version Management:
Set a minimum allowed protocol (e.g. from 1.16.5 upwards) and block outdated or incompatible clients with clear, customized messages.

🔹 Custom Messages:

Server List (Ping) text to inform players about unsupported versions.

Unique disconnection screens, with dynamic placeholders like %server_version%.

Full integration with i18n (multi-language): messages automatically adapt to the player’s locale.

🔹 Internationalization (i18n):
Multi-language system with support for Spanish, English, and Portuguese, among others. The plugin detects the client’s locale and shows the appropriate translation.

🔹 Compatibility & Performance:

Optimized IP → protocol caching.

Works on Spigot, Paper, and forks (for MOTD).

Proxy support (BungeeCord / Velocity) through xMotd integration.

🔹 Extra Tools for Admins:

Built-in Modrinth update notifier.

Optional usage stats via bStats.

Advanced debug mode for testing and troubleshooting.

✨ With xBlocker you gain total control over how your server appears in the client list and how version mismatches are handled — all with a professional, multi-language, hassle-free experience.

## ✨ Config.yml ✨
“`yaml
# _________ _____.__
# _ ___ ____ _____/ ______| ____
# / / / _ / __| |/ ___
# ___( <_> ) | | | / /_/ >
# ______ /____/|___| /__| |_____ /
# / / /_____/
# Hecho con amor por 777 Studios – xPlugins
#
# Wiki y informacion: https//xblocker.willfry.net/

# =========================
# I18N (MULTI-LENGUAJE)
# =========================
i18n:
enabled: true # true = usar bundles /messages/*.yml
default-lang: “es_ES” # idioma por defecto
# PLAYER_LOCALE_THEN_DEFAULT: usa el locale del cliente; si no, default
# FIXED: fuerza el idioma en fixed-lang
mode: “PLAYER_LOCALE_THEN_DEFAULT”
fixed-lang: “es_ES” # usado si mode=FIXED
ping-lang: “es_ES” # idioma para PING/MOTD (no hay Player)
# Mapeos para normalizar locales reportados (ej. es -> es_ES)
locale-map:
es: “es_ES”
en: “en_US”
pt: “pt_BR”

# =========================
# Notificador de Actualizaciones (Modrinth) (No tocar)!!
# =========================
updates: # (No tocar)!!
modrinth: # (No tocar)!!
enabled: true # (No tocar)!!
project: “xblocked” # (No tocar)!!
# Comprobar cada X horas (>=1)
check-interval-hours: 1 # (No tocar)!!
notify: # (No tocar)!!
console: true
admins-on-join: true
permission: “xblocked.update”

# =========================
# bStats (No tocar)!!
# =========================
bstats:
enabled: true
plugin-id: 27316

# — Compatibilidad de versiones —
# Protocolo mínimo permitido (735 = MC 1.16.5; 763 = 1.20.1; 769 = 1.21.1, etc.)
min-protocol: 735

# Texto que se muestra a la DERECHA en la lista de servidores cuando
# el cliente es más antiguo que min-protocol o no coincide con el servidor.
# Se procesa con el mismo formato indicado en motd.format (auto/legacy/mini).
# NOTA: si i18n.enabled=true, se usará messages/.yml -> serverlist.incompatible.
# Este texto queda como FALLBACK si desactivas i18n.
incompatible-message: “&c ✖️ ¡Oye! 1.19.4 – 1.21x”

# — Caché IP -> protocolo detectado (handshake) —
cache-ttl-seconds: 45 # Tiempo de vida de la entrada
cache-soft-limit: 1000 # Límite suave de entradas (limpieza si se excede)

# Motd ( Solo para Spigot x paper ) Para velocity/bungee Usa xMotd
motd:
enabled: false # true para habilitar el MOTD personalizado
format: auto # auto | legacy | mini
center: true # centra cada línea (approx. por caracteres)
center-width: 50 # ancho usado para el centrado
# Si i18n.enabled=true y existe messages/.yml->motd.*, se prioriza ese contenido.
line1: “&cxBlocked &7| &fLobby”
line2: “&f¡Bienvenido!”

# — Mensaje de desconexión en LOGIN (Outdated server/client) —
disconnect:
enabled: true
# Si es true, solo reemplaza mensajes tipo “Outdated …”.
# Si es false, reemplaza cualquier kick de login por este mensaje.
only-on-version-mismatch: true
format: auto # auto | legacy | mini
# Placeholders disponibles:
# %server_version% -> versión del servidor (ej: git-Paper-196 (MC: 1.20.1))
# Si i18n.enabled=true, se usa messages/.yml->disconnect.incompatible (por jugador).
# Este texto queda como FALLBACK si desactivas i18n.
message: “✖ Servidor/cliente no coinciden. Usa %server_version%

#### ##### #### # # #### ### #### ##### ### # #
# # # # # # # # # # # # # # # ## #
# # ##### #### # # #### ##### # # # # # # #
# # # # # # # # # # # # # # # ##
#### ##### # ### # # # # #### ##### ### # #

debug: true # logs de handshake/ping/disconnect
debug-force-incompatible: false # fuerza el estado incompatible para

“`
## ✨ Messanges / ES and EN

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

serverlist:
incompatible: “✖ Your version is not supported. Please use %server_version%

disconnect:
incompatible: “✖ Server/client mismatch. Please use %server_version%

motd:
line1: “GhostBlocker”
line2: “Professional connection control

admin:
reloaded: “Config reloaded.
“`