Please join the Discord if you have questions or for support!
**Manage your game servers with ease!** VelocityPteroPower connects your Velocity proxy to Pterodactyl, Pelican Panel, or Mc Server Soft, allowing for dynamic starting and stopping of your game servers.
**For detailed information on configuration, commands, and permissions, please visit our [Docs Page](https://docs.pluginz.dev/).**
## Key Features
– **Multi-Panel Support**: Works with Pterodactyl, Pelican Panel, and Mc Server Soft.
– **Dynamic Server Management**:
– Automatically start servers when a player attempts to connect.
– Automatically stop idle servers after a configurable timeout.
– Manual control via commands (`/ptero start`, `/ptero stop`, `/ptero restart`).
– **Whitelist Integration**:
– Fetch and enforce server whitelists from Pterodactyl/Pelican panels.
– Reload whitelists on the fly with `/ptero whitelistReload`.
– **Efficient & Safe**:
– Respects panel API rate limits (Pterodactyl/Pelican/Mc Server Soft).
– Handles forced host connections, redirecting players to a limbo server.
– **Update Notifications**: Stay informed about new plugin versions.
– **Configurable**:
– Fine-tune server startup/shutdown behavior.
– Customize logging levels.
– Per-server settings for timeouts, join delays, and whitelist enforcement.
## Installation
1. Download the latest `.jar` file from [Modrinth](https://modrinth.com/plugin/velocitypteropower).
2. Place the `.jar` file into your Velocity server’s `plugins` folder.
3. Restart your Velocity server.
4. Configure the plugin by editing `config.yml` in the `plugins/VelocityPteroPower` folder. **See the [Docs Page](https://docs.pluginz.dev/) for detailed configuration instructions.**
## Support
For issues, suggestions, or help, please [open an issue on GitHub](https://github.com/TubYoub/VelocityPteroPower/issues/new) or join our [Discord Server](https://discord.pluginz.dev).
## Contributing
Interested in contributing? Join our [Discord](https://discord.pluginz.dev) to discuss your ideas or submit a pull request!
## License
This project is licensed under the [MIT License]([https://github.com/Tubs-Pluginz/VelocityPteroPower/blob/dev/LICENSE).
A Velocity plugin that shows current players in the server list.
Inspired by .
## Configuration options
| option | default | description |
| ————————– | ————- | —————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————– |
| `playerListMode` | `”REPLACE”` | Configure how players are shown in the player list.
`”UNCHANGED”`: Keep the player list as it is.
`”ADD”`: Add players to the player list. `serverListEntryFormat` and `maxListEntries` are only applied for the added players.
`”REPLACE”`: Replace the player list with players according to `serverListEntryFormat` and `maxListEntries`.
|
| `serverListEntryFormat` | `”%1$s”` | Configure how players are shown in the server list.
`%1$s`: placeholder for the player name
`%2$s`: placeholder for the server name, on which that player is currently playing on
|
| `maxListEntries` | `16` | Configure how many players are shown in the server list. `<= 0` for unlimited (for backwards compatibility). |
| `replaceOnlinePlayerCount` | `false` | Should the online player count be replaced with the number of players currently connected to Velocity? Useful when using `ping-passthrough = "all"`. |
| `replaceMaxPlayerCount` | `false` | Should the maximum player count be replaced with the Velocity configured amount? Useful when using `ping-passthrough = "all"`. |
| `fillMissingVersionInfo` | `false` | Should the version information be replaced with what is set in `versionProtocol` and `versionName`, when no version is detected? Useful when the backend server/s is/are unavailable or still starting. |
| `replaceVersionInfo` | `false` | Should the version information always be replaced with what is set in `versionProtocol` and `versionName`? Extends `fillMissingVersionInfo`. Useful when using `ping-passthrough = “all”`. |
| `versionProtocol` | `4` (= 1.7.2) | The protocol number to be set. You can find all available protocol versions at . Used by `fillMissingVersionInfo` and `replaceVersionInfo`. |
| `versionName` | `”Velocity”` | The version name to be set. Used by `fillMissingVersionInfo` and `replaceVersionInfo`. |
Velocity Discord
# Velocity Discord
Chat from all servers gets bridged with a discord channel
## Features
– Configurable
– Webhooks or embeds or normal text for messages
– Player count in bot status
– List command
– Templating syntax for all messages
– Death and Advancement messages shown
– Server start/stop messages
– Server status in channel topic
– Reload command for config changes while the server is running
> **Note**
> This requires a [companion Velocity plugin](https://github.com/unilock/YepLib)
> and [companion backend mod/plugin](https://github.com/unilock/YepTwo) for advancement/death messages
## Installation
1. Create a bot application [here](https://discordapp.com/developers/applications/)
– Go to the `Bot` tab and click `Add bot`
2. Enable the `SERVER MEMBERS INTENT` and `MESSAGE CONTENT INTENT` under `Privileged Gateway Intents`
3. Copy the bot’s token, you might have to click `Reset Token` first
4. Install the plugin on your server, start the server once, then stop the server again
5. Open the plugin config file at `plugins/discord/config.toml`
6. Under `[discord]`, paste your token in place of `TOKEN`
7. Under `[discord]`, paste the channel id you want to use
– To get a channel id, you have to enable developer mode in Discord
– Open Discord settings, go to `Advanced`, then turn on `Developer Mode`
– Now right-click the channel you want to use and click `Copy ID`
8. Set any additional config options you want
9. Start the server and check if it works
### For Webhooks
1. Create a webhook in the channel you want to use
– Right-click the channel, click `Edit Channel`, go to `Integrations`, click `Create Webhook`
– Copy the webhook URL
2. Paste the webhook URL under `[discord.webhook]` in the config file
### For advancements/deaths
1. Install the [YepLib](https://github.com/unilock/YepLib) velocity plugin alongside this plugin
2. Install the [YepTwo](https://github.com/unilock/YepTwo) backend mod/plugin on each of your backend servers that you want to
receive advancements/deaths from
### Configuration
The config file is generated at `plugins/discord/config.toml`. See [here](https://github.com/fooooooooooooooo/VelocityDiscord/wiki/Configuration) for the default config
VelocityCoolList is a simple and easy-to-use plugin for Minecraft Velocity servers that allows you to create a whitelist based on nicknames.
## Commands and permissions
The main command is “`/vclist“`, it shows you information about VelocityCoolList, below are its arguments:
| Argument| Description | Permission |
|———|——————————————-|—————|
| enable | Enables whitelist. | vclist.admin |
| disable | Disables whitelist. | vclist.admin |
| add | Add player to the whitelist. | vclist.manage |
| remove | Remove player from the whitelist. | vclist.manage |
| list | Gives you a list of whitelisted players. | vclist.manage |
| reload | Reload plugin. | vclist.admin |
| clear | Clears the whitelist. | vclist.manage |
| status | Get the status of the plugin. | vclist.admin |
Aliases: “`/vcl“`, “`/velocitycoollist“`
## Colors and formatting
This plugin supports MiniMessage modern formatting, which allows you to make gradients and many other things.
Here is what this formatting supports, its documentation is in config and [here](https://docs.advntr.dev/minimessage/format.html#standard-tags)!
– [中文](https://github.com/MapleDust/VelocityChat/blob/v1.8/README.md)
– English
A Cross-server chat plugin for Velocity proxy
## Features
– Cross-server chat
– (configurable, default true) Enable color code
. check [Minecraft Wiki](https://minecraft.wiki/w/Formatting_codes) for
more information
, use `&` instead of `§` in game.
– `/vchat local` Send local message (to current server), alias (configurable) `/lc`.
– `/vchat broadcast` Send global message, alias (configurable) `/br`.
– Message of player joined, left and switch server.
– (configurable, default false) Send sample players when client refreshing multiplayer games.
– (configurable, default false) Show all proxy players on tab list.
– (configurable, default true) enable command `glist`.
– (configurable, default true) enable default global chat.
– (configurable) Send local message if chat message is starts with matched string.
– (configurable) translations
## Files
Locate in `plugins/VelocityChat`
### Configuration `config.toml`
– See in the file
### Langs
#### Default `langs/default/*.properties`
– The default language file is now forced to refresh
– Server exclusive chat format：`qu_an.chat.message.chat.server.=`
– Examples：
– `qu_an.chat.message.chat.server.lobby=§8[§r{0}§8|§r{1}]§r<{2}§r> {3}`
– `qu_an.chat.message.chat.server.survival=§8[§r{0}§8]§r<{2}§r> {3}`
– Use fallback chat format if missing.
– Server name：`qu_an.chat.server.name.=`
– Examples：
– `qu_an.chat.server.name.lobby=Lobby`
– `qu_an.chat.server.name.survival=§aSurvival Server`
– Use server id if missing.
VelocityBlockVersion
VelocityBlockVersion
A simple Velocity plugin to whitelist/blacklist versions from connecting to your network. This let’s you block or allow certain versions.
## Features
* Whitelist/blacklist versions from connecting.
* Custom disconnect message.
## Documentation
Visit the [wiki](https://docs.hyper.lol/plugins/velocityblockversion/about/) for help.
## License
This plugin is released under GNU General Public License v3. See [LICENSE](https://github.com/hyperdefined/VelocityBlockVersion/blob/master/LICENSE).
Lightweight HTTP API for Velocity proxies. Expose player lists, per-server counts, per-player details, etc. Ideal for websites, bots or other monitoring applications. I built it for my own uses, but it might help someone else out too.
## Quick Install
– Drop the compiled plugin JAR into your Velocity `plugins/` folder.
– Start (or restart) your proxy; the plugin will create its data folder and a `config.cfg` (if missing) in the plugin data directory.
## Configuration
– The plugin creates a `config.cfg` in its data folder on first run. Available keys:
– `port` : port the HTTP server listens on (default `25576`).
– `bindAddress` : interface/address to bind the HTTP server (default `0.0.0.0` to listen on all IPv4 interfaces; set to `127.0.0.1` for local-only access).
– `checkUpdates` : enable automatic Hangar update checks (default `true`).
– `snapshotUpdates` : include snapshot/unstable updates in checks (default `false`).
– `debugEnabled` : show debug messages (`logger.debug`) in the proxy console when `true` (default `false`).
– `allowedOrigins` : CORS allowed origins for HTTP API access (comma-separated, or * for all) (default `*`).
## Tested With
– Velocity 3.x (expects `velocity-api` on the runtime classpath)
## Endpoints
All JSON endpoints return `Content-Type: application/json; charset=utf-8` unless otherwise noted.
– `/`
– Serves the embedded `index.html` (browser-friendly).
– Example URL: `http://localhost:25576/`
– `/playerlist`
– Purpose: list connected players with basic metadata and a total count.
– Example URL: `http://localhost:25576/playerlist`
– Sample response:
– `/count`
– Purpose: return the total number of connected players.
– Example URL: `http://localhost:25576/count`
– Sample response:
“`json
{
“count”: 42
}
“`
– `/player/` or `/player?username=`
– Purpose: fetch detailed info for a connected player (exact-case lookup).
– Example URLs:
– `http://localhost:25576/player/Notch`
– `http://localhost:25576/player?username=Notch`
– Notes: returns `400` if username is missing; `404` if the player is not connected.
– Sample response:
– `/servers`
– Purpose: returns a mapping of server names to player counts.
– Example URL: `http://localhost:25576/servers`
– Sample response:
“`json
{
“lobby”: 5,
“minigames”: 12
}
“`
– `/health`
– Purpose: lightweight health check for monitoring.
– Example URL: `http://localhost:25576/health`
– Sample response:
“`json
{
“status”: “ok”
}
“`
## Commands
– `/vwapi reload` : reloads the `config.cfg` from the plugin data directory and restarts the HTTP server if the `port` or `bindAddress` have changed.
– `/vwapi version` : prints the plugin version (from the plugin metadata).
– `/vwapi debug [on|off]` : toggle or explicitly set debug logging at runtime. When enabled, the plugin prints detailed debug messages and HTTP access lines to the console.
– `/vwapi status` : shows the current HTTP server status (running/not running), the bound host and port, and an example URL you can visit (falls back to `localhost` when bound to all interfaces).
– `/vwapi help` : prints a short help listing the available `/vwapi` subcommands and usage examples.
## Permissions
– `vwapi.admin` : required to use the `/vwapi` commands.
## Notes & Behavior
– Player lookup is exact-case and only returns connected players.
– The HTTP server binds to `bindAddress`; by default this is `0.0.0.0` (all interfaces). Change to `127.0.0.1` for local-only access or a specific IP if desired.
– When you change `bindAddress` or `port` and run `/vwapi reload`, the plugin will restart the HTTP server automatically to apply the new bind/port (a full proxy restart is no longer required for those changes).
## Troubleshooting
– If the HTTP server does not start, check the proxy logs for errors about port binding or resource issues.
– Ensure `velocity-api` is available at runtime and that the plugin is placed in the correct `plugins/` folder.
## License & Support
– Licensed under the MIT License.
– If you need any help or support, please contact me on [our Discord](https://discord.2lz.pro/).
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 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.
