**What’s New in Version 1.1.0:**
– Switched configuration to YAML (`config.yml`) for easier editing and more flexibility
– Config auto-update: After plugin updates, your config.yml is automatically merged with the latest default config. New options are added, your values are preserved, and the layout (including comments) always matches the latest default.
– All messages (including toggle messages for /sctoggle) are now fully configurable and translatable via config.yml.
– Added support for <#RRGGBB> hex colors, &-codes, and §-codes in all configurable messages (prefix, format, toggle, etc.)
– Discord integration: Staff chat can now be linked with a Discord channel (bi-directional)
– Discord messages in Minecraft are clearly marked as `[STAFF][D]` and support formatting
– Fixed: Discord messages are now reliably shown in Minecraft (requires Discord MESSAGE_CONTENT intent)
– Many internal code cleanups and bugfixes
**What’s New in Version 1.0.0:**
– Staff chat command: `/sc `
– Multiple aliases: `/staffchat`, `/s`, `/a`
– Permission-based access (`staffchat.use` by default, configurable)
– Customizable prefix and message format with color code support (`&` codes)
– Configuration file (`config.properties`) for easy customization
– Toggle command `/sctoggle` to enable or disable receiving staff chat messages
– Console logging of all staff chat messages
**Commands:**
– /sc – Send a message to staff chat
– /staffchat – Alias for /sc
– /s – Alias for /sc
– /a – Alias for /sc
– /sctoggle – Enable or disable receiving staff chat messages
**Permissions:**
staffchat.use – Allows the player to use and see staff chat
**How to Use:**
– Type `/sc ` to send a message to all online staff members
– Use `/sctoggle` to mute or unmute staff chat messages for yourself
If you have questions, suggestions, or need help, feel free to contact me on [Discord](https://discord.com/invite/vVrpvBEfeQ).
Velocity-Skript
# Velocity-Skript
## _Having bugs on new Velocity Version will be fixed next update_
—
### _**A Velocity Plugin where you can create your own commands like the bukkit plugin Skript!**_
**Test.vsk** _(every skript file need to end with .vsk to work)_
“`
# Welcome message on player join
on join:
send “Welcome, %player%! Enjoy your stay on %players-server%!” to player
# Commands
command /greet:
trigger:
send “Hello, %player%! Welcome to the server!” to player
# Broadcast to the everybody
command /broadcast:
trigger:
broadcast “Attention everyone!”
command /connectlobby:
trigger:
connect player to “Lobby-1”
“`
## Available Placeholders
> **%player%**
>
> Description: This placeholder is replaced with the username of the player who triggered the command or event.
> Example Usage: send “Hello, %player%!” to player
> Example Output: Hello, DieSuperKatze!
> **%players-server%**
>
> Description: This placeholder is replaced with the name of the server that the player is currently connected to.
> Example Usage: send “You are currently on %players-server%.” to player
> Example Output: You are currently on Lobby-1.
> **%loop-player%**
>
> Description: This placeholder is used within a loop of all players. It is replaced with the username of the player being processed in the current iteration of the loop.
> Example Usage: send “Hello, %loop-player%!” to loop-player
> Example Output: Hello, Player1! (and so on for each player in the loop)
## Todo:
– Adding events for setting Server Motds
– Adding multiple arguments in one command
– Fix issues with the every
Join my Discord server for support, questions, or just to hang out!
—
Velocity Server Manager
# Velocity Server Manager
This project is a fork of [BungeeServerManager](https://git.fetz-gr.ch/NoahFetz/bungeeservermanager) by Noah Fetz, edited to work on Velocity Proxies.
This project follows the MIT License as per upstream, it has not been edited.
Check out the original Plugin on SpigotMC here: [BungeeServerManager [BungeeCord] [MySQL]](https://www.spigotmc.org/resources/bungeeservermanager-bungeecord-mysql.24837/)
## Features
* Add or Remove Servers from your Velocity Proxy without restarting
* Restriction who can join specific servers with permissions
* Jump to any player’s server you want
* Servers are saved in a MySQL Database
* Receive notifications when servers go online or offline
* Kick all players from a specific server to a random lobby
* Manage Server Flags to customize server behavior
* /hub or /lobby command to go to a lobby server
* Configurable messages
## Known Issues.
– No known issues at this time.
## Installation
### Prerequisites
You’ll need:
* A Proxy that is running Velocity (duh)
* A MySQL or MariaDB Database
* About 5-10 minutes of your time to set everything up
### Setup
1. Download the latest release of Velocity Server Manager.
2. Place the downloaded `.jar` file into your `plugins` folder of your Velocity Proxy.
3. Start your Proxy to generate the default configuration files. It will shutdown automatically due to a missing database connection.
4. Open the generated `mysql.yml` file in a text editor and fill in the details for a valid database connection.
5. Start your Proxy again. The plugin should connect to the database and create the necessary tables.
6. (Optional, but **_encouraged_**) Remove all servers that are not fallback servers from your `velocity.toml`. Instead, add them using `/addserver` either ingame or in the console. Refer to [here](#commands).
7. (Optional) Configure the messages in `messages.yml` to your liking.
You are now ready to use Velocity Server Manager! Have fun managing your servers on the fly, dynamically.
### FAQ
If you read this, you’ve probably encountered an issue or are interested in some other stuff. Here are some common things and what to do:
1. **The Proxy shuts down immediately after starting!**
– Make sure your database connection details in `mysql.yml` are correct.
– Ensure that your database server is running and accessible from the machine running the Proxy.
– If any of the above do not apply, check the Proxy logs for any error messages related to the plugin. It is probably not this plugin’s fault. (Hopefully)
2. **I can’t connect to a server that I added!**
– Make sure the server is online and reachable from the Proxy.
– Check `/server` to see if the server is listed. If it isn’t, it probably has the `DISABLED` [flag](#flags) set.
– Check if the server is marked as `RESTRICTED` and ensure you have the necessary permissions to join it.
3. **The plugin doesn’t seem to be working at all!**
– Update Velocity if you haven’t updated in a while.
– Check the Proxy logs for any error messages related to the plugin.
4. **I found a bug or have a feature request!**
– Open an issue [here](https://github.com/GunnableScum/velocity-server-manager/issues) on GitHub describing the problem or feature you’d like to see.
– Please do not contact me on any other platform regarding bugs or features. GitHub is the only place where I want and will track these things. I’ve had somebody interested in a different project message me on Reddit in a Private Chat. Who does that?
## Permissions
Have fun configuring to your heart’s desire.
* `servermanager.goto` – Be able to use /goto and /jumpto.
* `servermanager.help` – See the help list.
* `servermanager.notify` – Receive notifications when somebody manages servers.
* `servermanager.servers.add` – Add servers to your network.
* `servermanager.servers.delete` – Delete servers from your network.
* `servermanager.servers.reload` – Reload server data from the database and re-add them to the proxy.
* `servermanager.servers.list` – List all servers in your network.
* `servermanager.servers.kick` – Kick all players from a specific server to a random lobby.
* `servermanager.ignorekick` – Be exempt from being kicked when a server is cleared.
* `servermanager.servers.info` – View information about a specific server.
* `servermanager.servers.flags` – Manage Server flags. Check [here](#flags) for more info.
* `servermanager.server.[servername]` – Access a specific server if it has the `RESTRICTED` flag.
* `servermanager.server.*` – Access all servers that have the `RESTRICTED` flag.
* `servermanager.ignorerestriction` – Ditto of the above, if your Permission system does not support wildcards.
## Commands
– `[hub, lobby]` – Go to a Lobby Server
– `[goto, jumpto]` – Go to a player’s current server
– `[whereami, wai]` – Find which server you are currently on
– `[addserver]` – Adds a server to your network
– `[delserver]` – Deletes a server from your network
– `[reloadserver]` – Reloads the data of a specific server or all servers in the network
– `[serverlist, sl]` – Lists all servers in your network
– `[serverinfo, si]` – Shows some information about a specific server
– `[flagserver]` – Add a flag to a server
– `[unflagserver]` – Remove a flag from a server
– `[clearserver, kickserver]` – Kicks all players from the specific server to a random lobby
– `[servermanager]` – A unified command for every action
## Flags
Flags are how to plugin identifies servers and their conditions. Some are immutable.
* `EMPTY (Bitvalue: 0)` – No flags set
* `LOBBY (Bitvalue: 1)` – This server is a lobby server. Players will be sent here when they join the proxy or are kicked from another server.
* `RESTRICTED (Bitvalue: 2)` – This server is restricted. Only players with the `servermanager.server.*` or `servermanager.ignorerestriction` permission can join.
* `DISABLED (Bitvalue: 4)` – This server is disabled. Players cannot join this server, not even staff. If you want this server to be joinable by only staff, use RESTRICTED instead.
* `PROXYMANAGED (Bitvalue: 9)` – This server is managed by the proxy. This flag is immutable and applies to all servers added in the `velocity.toml` file. If this flag is present, you cannot apply any other flags.
**NOTE: Bitvalue 9 means that the PROXYMANAGED flag is a combination of the LOBBY flag and itself. This is intentional to encourage people to only put fallback servers into their `velocity.toml` file.**
**NOTE: Flags of Servers are stored in the database. Please do not tamper with the database manually unless you know exactly what you are doing. I will not fix any bugs where the database has been manually tampered with. You are on your own.**
## Contribution
I made this as a small side project to learn a tiny bit more about Programming for the Velocity Proxy. I will probably not look at PR Requests anytime soon. If you do feel up to the task, you can fork this repository instead.
Just make sure to follow the license.
Instead, if you’d like to support me financially, you can [Donate on my Ko-Fi Page](https://ko-fi.com/GunnableScum)!
## License
This fork is licensed under the upstream MIT License – see the LICENSE file here or [upstream](https://git.fetz-gr.ch/NoahFetz/bungeeservermanager/-/blob/master/LICENSE?ref_type=heads) for details
Velocity Server Aliases
# Velocity Server Aliases
## Overview
Simple plugin for Velocity Proxy that provides server command aliases/shortcuts. It makes it easier for players to move between servers in the network without typing complex commands.
## Plugin Information
– **Velocity Version**: 3.4.0-SNAPSHOT
– **Java**: 17+
**Note**: You can add more aliases by editing the `config.toml` file in the plugin folder.
## Custom Messages
The plugin supports configurable custom messages using:
– **Color codes**: `&a` (green), `&e` (yellow), `&c` (red), `&b` (cyan), `&f` (white)
– **Placeholder `{server}`**: Replaced with the target server name
### Configurable Messages:
– `connecting`: Message when connecting to a server
– `already_connected`: Message when you are already on that server
– `server_not_found`: Message when the server does not exist
—
# Velocity Server Aliases
## Overview
Plugin simple para Velocity Proxy que proporciona aliases/shortcuts para comandos de servidor. Facilita a los jugadores moverse entre servidores en la red sin escribir comandos complejos.
**Nota**: Puedes agregar más aliases editando el archivo `config.toml` en la carpeta del plugin.
## Mensajes Personalizados
El plugin soporta mensajes personalizados configurables con:
– **Códigos de color**: `&a` (verde), `&e` (amarillo), `&c` (rojo), `&b` (cyan), `&f` (blanco)
– **Placeholder `{server}`**: Se reemplaza con el nombre del servidor de destino
### Mensajes Configurables:
– `connecting`: Mensaje al conectar a un servidor
– `already_connected`: Mensaje cuando ya estás en ese servidor
– `server_not_found`: Mensaje cuando el servidor no existe
Velocity Redis Whitelist
UUID based whitelist for Velocity. Uses Redis as a storage backend.
Uses Redis sets named “whitelist.main”.
External apps, e.g. bots may add/remove from this whitelist.
Compatible with [BungeeSafeguard](https://github.com/Luluno01/BungeeSafeguard) with [Redis-BSG](https://github.com/Luluno01/redis-bsg) addon.
Velocity Queue
# SecVers Queue System
A powerful Velocity queue system supporting multiple priority queues with full LuckPerms integration.
—
## FEATURES
– Supports multiple queues: Premium, VIP, Default, and Softban
– Fully compatible with LuckPerms MySQL database
– Modular queue enabling/disabling via config
– Automatic fallback to limbo server
– Queue priority processing: Premium -> VIP -> Default -> Softban (after 5min)
– Individual queue position messages for each player
– Designed for cracked and premium servers, with LibreLogin Support
– Lightweight, optimized for 500+ concurrent queued players
—
## HOW IT WORKS
1. Player joins the limbo/queue server (configure this in Velocity with limboserver setting).
2. The queue system checks the player’s group via LuckPerms database (MySQL only).
3. The player is assigned to their respective queue:
– Premium -> VIP -> Default -> Softban
4. Every tick (5s by default), the system checks if the target server is online and has available slots.
5. Players are sent to the target server based on queue priority.
—
## CONFIGURATION (config.yml)
“`yaml
# SecVers Queue config.yml
# Enable LuckPerms support.
# Requires a MySQL or MariaDB connection without SSL.
enablelp: false
# The server players join to wait in queue
limboserver: queue
# The target server players will be sent to
targetserver: survival
# Group configuration
# Group names are retrieved from the ‘luckperms_user_permissions’ table.
# Example: use ‘premium’ not ‘group.premium’.
Groups:
softban: badgroup
default: default
vip: vip
premium: premium
displayname_softban: badgroup
displayname_default: default
displayname_vip: VIP
displayname_premium: Premium
# Queue settings
# Enable or disable queues individually
# SoftbanQueueEnabled defaults to allowing join after 5 minutes if other queues are empty
QueueGroupSettings:
premiumQueueEnabled: true
vipQueueEnabled: true
QueueEnabled: true
SoftbanQueueEnabled: true
1. Player joins the limbo server queue.
2. Queue system retrieves their group from LuckPerms MySQL.
3. Adds them to their queue (Premium -> VIP -> Default -> Softban).
4. Every 5 seconds:
– Checks target server status
– Moves next player in priority order if slots are available.
—
## NOTES
– LuckPerms support requires MySQL or MariaDB.
– Softban queue enforces a 5-minute wait if other queues are empty.
– Designed for Velocity and supports LibreLogin setups.
Player Logger
This is a comprehensive player statistics tracking plugin for Velocity proxy servers that allows administrators to monitor and lookup player information across multiple backend servers.
**What’s New in Version 1.0.0:**
**Initial Release Features:**
– Complete player data tracking system with UUID, names, IPs, and timestamps
– Dual storage support – Choose between local JSON files or MySQL database
– Real-time playtime tracking – Automatic session tracking with accurate playtime calculation
– Online/Offline status system – Visual status indicators for player availability
– Server tracking – Records current server for online players and last server for offline players
– Click-to-connect functionality – Join players directly from lookup results
– Live playtime updates – Current session time is included when viewing player stats
**Administrative Tools:**
– **Lookup Commands** – Two aliases for flexibility (`/lookup` and `/playerlookup`)
– **Permission System** – Separate permissions for lookups and data deletion
– **Real-Time Data** – Playtime updates automatically include current session
**Commands:**
– `/lookup ` – Display detailed player statistics including status, server, playtime, and more
– `/playerlookup ` – Alias for `/lookup` command
– `/deletedata ` – Request deletion of all player data (requires confirmation)
– `/deletedata confirm` – Confirm data deletion within 30 seconds
**Permissions:**
– `playerlogger.lookup` – Permission to use lookup commands
– `playerlogger.delete` – Permission to delete player data (separate for security)
**Tracked Data:**
The plugin tracks comprehensive player information:
– **Player Name** – Current and historical usernames
– **UUID** – Unique player identifier
– **IP Address** – Last known IP address
– **First Login** – Timestamp of first connection
– **Last Seen** – Most recent activity timestamp
– **Online Status** – Current online/offline state with visual indicators
– **Current Server** – Live server location with click-to-join (online players)
– **Last Server** – Most recent server location (offline players)
– **Playtime** – Total playtime with automatic session tracking
**Storage Options:**
Choose between JSON files or MySQL database:
**JSON Mode (Default):**
– Simple file-based storage in `playerdata.json`
– No external dependencies required
– Perfect for smaller networks
– Automatic file creation and updates
**MySQL Mode:**
– Scalable database storage with HikariCP connection pooling
– Ideal for larger networks and multiple proxy instances
– Automatic table creation and schema updates
– Support for special characters in passwords
– Connection pooling for optimal performance
**Technical Highlights:**
– **Async Operations** – All database queries run asynchronously using CompletableFuture
– **Session Tracking** – Automatic playtime calculation with session management
– **Live Updates** – Playtime includes current session when viewing online players
– **HikariCP Pooling** – Optimized connection management for MySQL
– **Schema Migration** – Automatic database updates for new features
– **Click Events** – Adventure API integration for interactive server names
– **Color Support** – Full Minecraft color code support with `&` formatting
**Important when setting up:**
1. Choose your storage type in `config.yml` (local or mysql)
2. If using MySQL, configure database credentials with proper permissions
3. Restart the proxy server to initialize storage
4. Assign `playerlogger.lookup` permission to administrators
5. Assign `playerlogger.delete` permission only to trusted staff
6. Customize messages in `messages.yml` to match your server’s style
Just send me a message on [Discord](https://discord.com/invite/vVrpvBEfeQ) if you have any questions, suggestions, or requests for new plugins.
Velocity Limbo Handler
# ⚡ Velocity Limbo Handler
🌀 A smart **limbo & queue handler** for [Velocity](https://velocitypowered.com)
Keeps your players connected, calm, and coming back even when backend servers crash.
1. Grab the latest `.jar` from [Releases](https://github.com/akselglyholt/velocity-limbo-handler/releases).
2. Drop it into your Velocity `plugins` folder.
3. Restart the proxy (config files will generate).
4. Adjust `config.yml` + `messages.yml` to your liking.
5. Restart once more — done! 🎉
—
## ⚙️ Config Highlights
“`yaml
# config.yml
limbo-name: “limbo” # The name of your limbo server
direct-connect-server: “lobby” # Where to send direct connections
task-interval: 3000 # Queue processing interval (milliseconds)
queue-notify-interval: 30 # How often to tell players their position
disabled-commands: [“server”,”hub”] # Commands blocked in limbo
“`
👉 Messages can be tweaked in `messages.yml` so your players see exactly what you want.
* Players get queued automatically, no setup required.
* Commands blocked per config.
* LibreLogin support ensures login/auth flow isn’t broken.
* Maintenance plugins are respected (bypass logic included).
—
## 🤝 Contributing
Pull requests are welcome! Just follow the style already in place.
Check `CONTRIBUTING.md` for details.
—
## 📖 License
Licensed under **GPL-3.0** — free to use, modify, and share under the same license.
velocity-hub-command
The velocity-hub plugin adds the /hub command to the velocity network for easy return if a hub server or similar is present.Simply add it to the velocity server and the /hub command will run on all connected servers!
The `/hub`command is added across the entire Velocity network. There is no need to add the plugin to Paper servers or other server connected to Velocity.
The game version is for all versions supported by Velocity 3.4.0-SNAPSHOT as it is added to the proxy server only. The game version must be specified and is specified, but see the [PaperMC website](https://docs.papermc.io/velocity/server-compatibility/) for details.
# Installation
1. Download the latest release of the plugin
2. Put velocity-hub-x.x-SNAPSHOT.jar in /plugins directory of velocity
This completes the process!
# Config reference
– hubServerName
Specify the destination server. This is the server name listed in servers in velocity.toml. (Usually, the hubServerName is the same as the server name listed in the try=[] brackets.)
### Message custom
We support Japanese, Russian, and other languages. If there are any languages that we do not support, please let us know via GitHub issue!
MiniMessage is supported. If you write like `hub`
, it will be displayed in red. See [here](https://docs.papermc.io/misc/tools/minimessage-web-editor) for details.
You can test the display at the following sites.
[https://webui.advntr.dev/](https://webui.advntr.dev/)
[https://minecraft.menu/minecraft-rgb-generator](https://minecraft.menu/minecraft-rgb-generator)
– transferMessage
Sets the message to be sent to the player who used the command during the transfer.
– alreadyConnectedMessage
Sets the message if the player using the command is on the server designated as the forwarding destination.
– serverNotAvailableMessage
Sets the message when the specified server is unavailable.
# Issue and question
If the plugin does not work properly, try deleting config.json.
Problems and questions feature request [here](https://github.com/stellarcielo/velocity-hub/issues).
Velocity/hub
# Velocity/hub
This plugin, written for networks running velocity, adds the ability for users, to use the /hub command, to return to the lobby.
The available servers for lobbies are configurable, and the first available server on the list will be used to transfer players to it.
With additional permissions, it is possible, to transfer other players to the lobby, using the /hub command.
# Permissions
To protect the unappropriated use of the /hub command, we have set some permissions.
### vhub.command.hub
This permission protects the whole base of the /hub command.
### vhub.command.hub.others
This permission protects the /hub command.
For the use to send other players to the hub, both, this and the base permission are required at the same time.
# Configuration
This plugin provides a configuration file in the json format.
The content is the list of server names, which are your lobby.
On trying to connect to the lobby, the plugin picks the first available server and sends the target player to it.
# Dependencies
This plugin requires the availability of the Kotlin 1.8.21 library, we recommend using the [MCKotlin](https://modrinth.com/plugin/mckotlin) because it supports Velocity as well.
But you are free to use any other platform supported Kotlin library provider as well!
# Have fun
You are welcome to use the plugin on your velocity server!