XD’s Library

### XD’s Library

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

—

### Features

> Please view the [Documentation](https://xdlib.xdpxi.dev/) for the correct features for your version

—

### Building from Source

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

– Clone the [Git repository](https://github.com/XDPXI/XDLib)

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

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

WorldChatter


# Security Features

### Anti-Swear
This helps to prevent any sensitive or inappropriate words from your chat to help keep it clean.
It has the ability to customize words (BlackList / WhiteList).

### Anti-Repeat
This prevents players from repeating the same words or letters over and over again.

### Anti-ADs
It will block any type of IPs or URLs from the player.

### Anti-Caps
This helps to prevent the player from sending large uppercased messages in the chat!

# Configurations!

### Detection Messages!
If anyone triggers one of the security settings, you will be alerted, and they will be alerted as well.

“`yaml
DetectedMessage: “&c%player_name%’s message got detected by the following flags &e[%flags%] n———-> &6%message%” # Change how the detection message is sent
DetectedPlayerMessage: “&cYou have been detected by the following flags &e[%flags%]” # Changes how the message is sent to the player (set it to “” if you don’t want to send it)
“`

### Switch Messages (For Proxies)
This will notify everyone in the server or the previous and current server when a player switches from one server to another!

“`yaml
# This switch message is only available for both BungeeCord & Velocity
SwitchSettings:
enabled: true
global: true # false is just the current server & previous server / true all the servers
premessage: “&a%player_name% &ehas switched from &6%previous_server% &eto &f%current_server%”
comessage: “&a%player_name% &ehas arrived from &6%previous_server%”
“`

### Others

“`yaml
SpamMessage: “&cYour message is blocked by the &eAnti-Spamn&7Remaining time: %duration% seconds” # Changes how the anti-spam message is sent (set it to “” if you don’t want to send it)
ChatClearMessage: “&eThe Chat has been cleared by &a%sender%” # Changes how the cleared chat message gets sent
NoPermissionMessage: “&eYou’re not allowed to use this command!”
“`

# Utilities Features!

### Aliases
This feature enhances WorldChatter’s placeholders by allowing customization of player and place names using two new placeholders: `{player_name}` and `{player_place}`.

“`yaml
aliases:
enabled: true
place:
world: “&aOverworld&r”
player:
OmarOmar93: “OmarOmar93 &o&eTest Omar Yes”
“`

### Chat Locking
This allows staff or console to lock or unlock the chat using `wc lock`!

“`yaml
ChatLockMessage:
enabled: true
public: true # TRUE | Shows the message to everyone or FALSE | just the sender
locked: “&eThe Chat is now &cLOCKED &eby &a%sender%”
unlocked: “&eThe Chat is now &aUNLOCKED &eby &a%sender%”
currently: “&eThe Chat is Currently &clocked”
“`

### Clear Chat!
Clear the chat with `wc clear`!

### Custom Join and Quit Messages!
Customize join and quit messages with special permissions for certain players.

“`yaml
Join:
enabled: true
level: 1 # 1 is just current place / 2 the whole server
place: “world” # place to send the message
message: “&a%player_name% &fhas joined the game!”
permmode: true # Checks to use the permissions mode to send messages / disabled will use default message
permissions:
“admin”:
permissions: [ “worldchatter.control”, “*” ]
message: “&a%player_name% &fhas joined the gamen&e[Teleport to %player_name%]”

Quit:
enabled: true
level: 1 # 1 is just current place / 2 the whole server
place: “world” # place to send the message – type %place% to make it the last player’s place
message: “&a%player_name% &fhas left the game!”
permmode: false # Checks to use the permissions below to show a different message or no!
permissions:
“admin”:
permissions: [ “worldchatter.control”, “*” ]
message: “&a%player_name% &fhas left the game &8You have nothing to do to that player :P”
“`

### Notifications
Customize notification sounds for detections.

“`yaml
notification:
enabled: true
staff: # notification detection for staff
sound: “BLOCK_NOTE_BLOCK_PLING” # the sound to play as the notification you can find it here by https://helpch.at/docs/SERVER_VERSION_GOES_HERE/index.html?org/bukkit/Sound.html
volume: 1 # volume of the sound
pitch: 1 # pitch of the sound
player: # notification detection to the player
sound: “BLOCK_NOTE_BLOCK_PLING”
volume: 1
pitch: 1
“`

### Channels
Introducing the new **Channels** Feature!
Add Places or Players **or both if you would like!** Into each other and priortize them from top to bottom according to the importance of each channel!
“`yml
GlobalSending: true
channels:
admin:
players:
– “OmarOmar93”
– “HoneySalted”
– “Notch”
places:
– “World”
– “Lobby”
main:
places:
– “world”
– “world_nether”
– “world_the_end”
“`

### Debug Mode – (Implemented in Channels only Currently)
The New Debug mode is what prints out more information about WorldChatter! like, Warnings, Errors and infos for each action happening inside the plugin!

“`yml
debug:
enabled: true
info: “&7[&9WorldChatter Debugger &r| Info&7]&r ”
warning: “&7[&9WorldChatter Debugger &r| &eWarning&7]&e ”
error: “&7[&9WorldChatter Debugger &r| &4Error&7]&4 ”
“`


# WorldChatterAPI
Learn more about the API and its capabilities by [Clicking here!](https://github.com/OmarOmar93/WorldChatterAddonChecker)

# Donate!
If you’d like to support the development of WorldChatter and other projects, consider donating!
[Buy me a Coffee!](https://www.paypal.com/paypalme/omaomar93)

# Other Projects!
[WorldCaster](https://modrinth.com/plugin/worldcaster)
Standalone Broadcast Add-on

# Supported Plugins!
– PlaceholderAPI
– Multiverse-Core
– ItemsAdder (With PlaceholderAPI)
– Luckperms
– And other plug-ins that have PlaceholderAPI’s placeholder!

# Massive thank you to:
– **Abdelaziz189356** – For the help with 2.0, 2.1, and 3.0 being possible, 3.0 Tester!
– **yousife_7aloly** – The tester for 2.0!
– **FastEverlast** – The Tester for 2.4!
– **Fabrizio Santana, 4zy** – 3.0 Testers

There are lots of additional features to explore!
Thank you for taking the time to read this and use the plugin!

Wallrun

WallRun introduces smooth, momentum-based wall-running to Minecraft.
Players can run along walls, extend jumps, and chain movements for fast, fluid parkour.
Perfect for Parkour maps, Minigames, and PvP, while staying lightweight, responsive, and performance-friendly.

VyHub

VyHub, the comprehensive solution to build, manage and monetize Minecraft stores and communities. Easy integration of your Minecraft server and store. It’s the all-in-one management platform designed for your gaming community. VyHub offers a webshop, website, a donation store and bans and warnings.
Design and manage your Minecraft community through VyHub. We acknowledge that community management is hard work and takes a lot of time. With VyHub we automate your donation webstore fully. Furthermore, you can also save time on banning and warning players.

Create a professional community website and webstore in 5 minutes!

And there is more: VyHub provides you with an all-in-one solution to manage your community and gain valuable insights. Communicate, warn and ban players while maintaining good oversight of your community and its rules. With this resource you can make the best out of your community and server monetization.

The all-in-one system includes many features:

Ban and Warnings system (quick community management)
Sync groups/ranks (assign ranks through LuckPerms)
Ticketing system
Forums system
Shop system (unlimited categories, servers and packets)
Buy for a friend
Over 20 payment options (through: PayPal, Paysafecard, Stripe)
Multi language support
Discord roles and notifications
Quick support
Full API
And much more…
For more information and direct contact to the developers and the VyHub community visit our Discord (https://discord.gg/QZxQHtZnSB)

Pricing: VyHub can be used for free.
We take a small commission of 3 to 5% on purchases made through your VyHub store.
So you only pay when you make money.

Not yet convinced?
Check out the free VyHub Demo here: https://demo.vyhub.net/

Try out the different views, dashboards and customization options with VyHubs unique look and fell.

Lets go!

Create your account for FREE on https://vyhub.net, create your VyHub instance and add a Minecraft server.
Download addon for FREE and drag and drop the latest VyHub Plugin folder into your Gmod serveraddonsdirectory.
Restart your server and set your api-key through a simple command displayed in the setup process.
Congratulations your server is now connected! You can start selling products on your server!
For guides and further information visit: https://docs.vyhub.net

VoxasVoice

**VoxasVoice brings real proximity voice chat to Minecraft. 🎙️**
Talk to players around you with spatial audio that actually makes sense — the closer someone is, the louder they sound. Walk away and their voice naturally fades. It feels exactly how you’d expect voice chat in Minecraft to work.

**🗣️ Proximity Voice Chat**
Speak and be heard by nearby players. Voice volume scales with distance automatically — no setup needed, it just works.

**👥 Private Voice Groups**
Want to talk with your team across the map? Create a private voice group and invite your friends. Groups support password protection so strangers can’t join. Distance doesn’t matter inside a group.

**🔇 Player Controls**
See who’s talking nearby and take control. Mute specific players, adjust individual volumes, and manage your experience without leaving the game.

**🎛️ Advanced Audio Settings**
Fine-tune your microphone and speaker settings, enable noise reduction, and monitor your voice levels with a built-in voice meter.

**🔒 Encrypted & Secure**
All voice traffic is encrypted end-to-end. Your conversations stay private.VoxasVoice requires the Fabric mod on the client and the plugin-bridge on the server. Both are included in this release.
Ready to make your Minecraft world actually feel alive? Give it a try. 🌍

VoxaAegis

# VoxaAegis

VoxaAegis is a layered anti-bot protection system for Minecraft server networks.

It is built to reduce the impact of join floods, coordinated bot waves, repeated retry swarms, suspicious registration behavior, and abnormal post-join bot sessions through explainable server-side mitigation.

VoxaAegis does not try to be a DDoS firewall. It is a plugin-layer defense system for Minecraft traffic that helps operators detect, slow down, isolate, challenge, and block bot-like clients before they can damage the player experience.

## What It Does

VoxaAegis combines multiple protection layers instead of relying on one simple rate limit.

Main features:

– Join flood and burst-rate limiting
– Coordinated username, timing, IP, and subnet wave detection
– Risk scoring for suspicious usernames, fresh addresses, retry swarms, churn, and offender memory
– Quarantine flow for suspicious joins
– Fake entry gate / screening room for players under review
– Adaptive anti-bot challenges
– HumanityGate post-join verification
– Post-join liveness checks for physics-void and look-only sessions
– Client brand, locale, ping, movement, and interaction signal checks
– Repeated `/register` secret wave detection without storing plaintext passwords
– Persistent cooldown ledger for restart-safe mitigation memory
– Runtime bypass and temporary trust controls
– Operator-facing status, stats, diagnostics, event journal, and support dumps

## Commands

– `/voxaaegis help` — show command list
– `/voxaaegis status` — live protection overview
– `/voxaaegis stats` — mitigation and screening statistics
– `/voxaaegis profile` — current attack profile
– `/voxaaegis attacklog [limit]` — recent attack summaries
– `/voxaaegis events [limit]` — recent event journal
– `/voxaaegis dump` — write a support dump
– `/voxaaegis inspect ` — inspect a live player
– `/voxaaegis analyze [ip]` — preview join scoring
– `/voxaaegis doctor` — topology and runtime checks
– `/voxaaegis cache status` — cache and housekeeping state
– `/voxaaegis cache purge` — force cleanup
– `/voxaaegis release ` — release a quarantined player
– `/voxaaegis bypass add ` — add a runtime username bypass
– `/voxaaegis bypass add-ip ` — add a runtime IP bypass
– `/voxaaegis bypass remove ` — remove a runtime username bypass
– `/voxaaegis bypass remove-ip ` — remove a runtime IP bypass
– `/voxaaegis bypass list` — list runtime username bypasses
– `/voxaaegis bypass list-ip` — list runtime IP bypasses
– `/voxaaegis trust add ` — temporarily trust an address
– `/voxaaegis trust remove ` — remove temporary trust
– `/voxaaegis trust list` — list trusted addresses
– `/voxaaegis reload` — soft reload
– `/voxaaegis hard-reload` — full runtime rebuild reload

## Why Use It

VoxaAegis is designed for server owners who want practical anti-bot protection without losing visibility.

The plugin focuses on:

– layered mitigation instead of one brittle hard block
– readable operator diagnostics
– clear attack summaries
– configurable quarantine and challenge behavior
– safer handling of suspicious players before they reach the real server
– compatibility with authentication plugins through allowed auth commands
– actionable status output for tuning during attacks

## Supported Platforms

Primary backend line:

– Paper
– Purpur
– Pufferfish
– Spigot best-effort

Proxy / network line:

– Velocity
– BungeeCord / Waterfall

Secondary / experimental lines:

– Folia
– Sponge
– Legacy Spigot / Paper 1.16.5 – 1.19.4 through the separate legacy jar

## Version Support

Modern backend and proxy line:

– Minecraft `1.20 – 1.21.11`

Legacy backend line:

– Minecraft `1.16.5 – 1.19.4`
– Requires Java 17
– Uses the separate `voxa-aegis-legacy-0.3.jar`

## Important Notes

– Current release line: **0.3**
– Main recommended runtime: **Paper / Purpur / Pufferfish**
– Sponge is a narrow experimental line and should not be treated as equal to the Paper-family runtime.
– BungeeCord / Waterfall support exists, but Velocity is the preferred proxy platform.
– VoxaAegis is not a replacement for real network-layer DDoS protection.
– For very large attacks, use proper hosting protection and a proxy-first architecture.

Version Numbering Converter

# VNC (Version Numbering Converter)

Version Numbering Converter (VNC) is a Java library for working with Minecraft versions across both numbering families:

– Classic Java-style versions such as `1.20.6` and `1.21.11`
– Year-based drop versions such as `24.1`, `25.4`, and `26.1.1`

It covers two use cases:

– Pure version modeling and conversion through `MinecraftVersion`, `VersionScheme`, and `MappingTable`
– Bukkit/Paper runtime detection through `VNC`, including server constants, player version resolution, protocol lookup, and version comparisons

## Highlights

– Exact historic mappings from `1.0.0` through `1.21.11`
– Drop support for current lines such as `25.4`, `26.1`, and `26.1.1`
– Protocol lookup for exact releases and published snapshots
– A runtime bridge for Bukkit/Paper with legacy-compatible constants like `SERVER_VERSION`
– String-based comparisons that correctly handle patch-sensitive boundaries like `1.20.5`

## Core API

### 1. Parse and inspect versions

“`java
MinecraftVersion classic = MinecraftVersion.parse(“1.21.11”);
MinecraftVersion drop = MinecraftVersion.parse(“26.1”);

classic.isClassic(); // true
classic.getVersion(); // “1.21.11”
classic.getProtocol(); // 774
classic.supportsHex(); // true

drop.isClassic(); // false
drop.getVersion(); // “26.1”
drop.getProtocol(); // 775
“`

### 2. Convert between numbering schemes

“`java
String dropName = VersionScheme.MOJANG.toDrop(“1.20.3”); // “23.2”
String classicName = VersionScheme.MOJANG.toClassic(“25.2.2”); // “1.21.8”

String customClassic = VersionScheme.CROA_CUSTOM.toClassic(“25.4”); // “1.22”
String customDrop = VersionScheme.CROA_CUSTOM.toDrop(“1.22.1”); // “25.4.1”
“`

### 3. Create your own mapping scheme

“`java
MappingTable table = new MappingTable()
.registerLine(30, 1, “1.50”, “1.50.1”)
.registerMapping(“1.51”, “30.2”);

VersionScheme scheme = VersionScheme.mapped(table);

scheme.toDrop(“1.50.1”); // “30.1.1”
scheme.toClassic(“30.2”); // “1.51”
“`

### 4. Resolve protocols

“`java
Integer protocol = MinecraftVersion.protocolForIdentifier(“1.20.6”); // 766
Integer snapshot = MinecraftVersion.protocolForIdentifier(“26.2-snapshot-3”);

MinecraftVersion newest = MinecraftVersion.fromProtocol(754); // 1.16.5
List all = MinecraftVersion.versionsForProtocol(767); // 1.21, 1.21.1
“`

## Bukkit / Paper runtime API

`VNC` exposes a runtime snapshot of the current server:

“`java
MinecraftVersion server = VNC.SERVER_MINECRAFT_VERSION;
String classic = VNC.SERVER_CLASSIC_VERSION;
String drop = VNC.SERVER_DROP_VERSION;
int protocol = VNC.SERVER_PROTOCOL;
double legacy = VNC.SERVER_VERSION;

boolean modernRegistry = VNC.isAtLeast(“1.20.5”);
boolean legacyCommands = VNC.isBefore(“1.13”);
boolean inRange = VNC.isBetween(“1.19”, “1.21.11”);
“`

Player version resolution uses ViaVersion when present and falls back to the server version otherwise:

“`java
MinecraftVersion playerVersion = VNC.player(player);

if (playerVersion.supportsHex()) {
// Safe to send RGB formatting to this player
}
“`

## Why use the string helpers?

`SERVER_VERSION` is still available for compatibility with older plugins, but patch-sensitive checks should prefer:

“`java
VNC.isAtLeast(“1.20.5”);
VNC.isBefore(“1.21.9”);
VNC.compare(VNC.SERVER_MINECRAFT_VERSION, “26.1”);
“`

That avoids the common limitations of comparing versions only as `double`.

## Requirements

– Java 8+
– For the Bukkit runtime helpers: a Bukkit/Paper-compatible runtime on the classpath
– Optional: ViaVersion, if you want `VNC.player(…)` to resolve the effective client version instead of the server version