Velocity Friends

This is a friends system for Velocity proxy servers that allows players to manage friendships, send messages, and interact across multiple servers.

> **What’s New in Version 1.4.0:**
>
> **Version & Status System:**
> – Built-in version checker with live update notifications and download links
> – Activity status system (Active/AFK/DND) with colored status indicators
> – Compatibility checker for Velocity versions
>
> **Enhanced Friend Interactions:**
> – Accept friend requests from offline players
> – Clickable friend names for quick messaging
> – DND mode blocks incoming messages
> – Status dots with hover text for all player states
>
> **Configuration Improvements:**
> – `disable_empty_messages` – Auto-disable empty config messages (default: true)
> – All messages, colors, and hover texts fully customizable
> – Tab-completion for /friend status command
>
> **Quality of Life:**
> – Improved error handling for empty messages
> – Better visual feedback and notifications
> – Minor bug fixes and performance improvements

**Commands:**
– `/friend add ` – Send a friend request
– `/friend accept ` – Accept a friend request (works with offline players)
– `/friend deny ` – Deny a friend request
– `/friend remove ` – Remove a friend
– `/friend list` – View all friends with online status and server location (click to join!)
– `/friend requests` – Show pending friend requests
– `/friend msg ` – Send a private message
– `/friend reply ` – Reply to the last message
– `/friend broadcast ` – Message all online friends
– `/friend status [active|afk|dnd]` – Set your activity status
– `/friend settings` – Open the interactive settings menu
– `/friend version` – Check plugin version and updates
– `/friend reload` – Reload configuration (admin only)

**Permissions:**
– friends.use – Basic permission to use the friends system
– friends.reload – Permission to reload the plugin configuration

**Settings Menu:**
Players can customize their experience with toggleable options:
– Friend Requests – Enable/disable receiving friend requests
– Notifications – Toggle friend online/offline notifications
– Messages – Enable/disable friend messages
– Status Message – Set a custom status visible to friends

**Plugin Messaging API:**
The plugin provides a complete API for Spigot/Paper servers to interact with the friends system:

**Available Requests:**
– GET_FRIENDS – Retrieve all friends with names and online status
– GET_ONLINE_FRIENDS – Get only online friends
– GET_SETTINGS – Fetch a player’s settings and status message
– UPDATE_SETTING – Change player settings from backend servers
– GET_PENDING_REQUESTS – List all pending friend requests
– ARE_FRIENDS – Check if two players are friends

**Automatic Events:**
– FRIEND_ONLINE – Triggered when a friend comes online
– FRIEND_OFFLINE – Triggered when a friend goes offline
– FRIEND_SERVER_SWITCH – Notified when a friend switches servers (NEW in 1.2.0)
– FRIEND_REQUEST – Sent when receiving a new friend request
– SETTING_CHANGED – Notified when settings are updated

**Storage Options:**
Choose between JSON files or MySQL database:

JSON Mode (Default):
– Simple file-based storage
– No external dependencies
– Perfect for smaller networks

MySQL Mode:
– Scalable database storage
– HikariCP connection pooling
– Ideal for larger networks
– Tables: friendships, pending_requests, player_settings, player_names

**Features:**
– Cross-server friend system for Velocity networks
– Live version checker – Stay updated with automatic version notifications
– Activity status system – Active, AFK, and DND modes with visual indicators
– Server display – See which server each friend is on
– Click-to-join – Instantly join your friends by clicking their server
– Offline support – Accept friend requests from offline players
– Server switch tracking with clickable notifications
– Private messaging between friends
– Broadcast messages to all online friends
– Customizable settings per player
– Offline player name display
– Console logging for moderation
– MySQL support with connection pooling
– JSON fallback for simplicity
– Plugin Messaging API for custom integrations
– Automatic username caching
– Interactive settings menu
– Configurable notifications (join/leave/server switch)
– Flexible message customization with auto-disable for empty entries

**PlaceholderAPI Support (New!):**

Use the included companion plugin to display friend data in scoreboards, holograms, chat, and more:

**Available Placeholders:**
– %friends_online% # Number of online friends
– %friends_total% # Total number of friends
– %friends_offline% # Number of offline friends
– %friends_online_list% # Comma-separated online friends
– %friends_online_servers% # Unique servers count

**Supported Velocity Version:**
Velocity 3.3.0 and higher (Java 17+)

**Important when setting up:**
1. Choose your storage type in `config.yml` (json or mysql)
2. If using MySQL, configure database credentials
3. Restart the proxy server
4. Optionally integrate with Spigot/Paper plugins using the Plugin Messaging API

Just send me a message on [Discord](https://discord.com/invite/vVrpvBEfeQ) if you have any questions, suggestions, or requests for new plugins.

Velocity Discord

# Discord-Velocity
This plugin sends messages to a Discord channel when the proxy starts/stops and when players join/leave.

**Configuration**
– Place the bot token and channel id in `plugins/DiscordVelocity/config.yml` (the plugin will create a default file on first run).
– You can customize messages in the same file. Supported placeholders:
– `{player}` – the player’s username (underscores are escaped to avoid unintended italics)
– `{velocity_online}` – number of players currently connected to the proxy

Messages are YAML strings and may include Discord emoji and markdown like `**bold**` — player underscores are escaped but emoji and bold remain functional.

### **Notes**
– Requires Java 17 and a Velocity 3.4.0-SNAPSHOT compatible proxy.

Velocity-CommandLimiter

# What Is This
Powerful Plugin that manipulates all commands under proxy or proxies to control display and execution!
limit and disable command!

# How To Use
### Before Installation
Basically, it is recommended to use with permission management plug-ins such as LuckPerms.

## How To Setup
Put the downloaded plugin into the Velocity plugin folder and run it once.

Then the default config will be generated.

### Config

The settings described in `[[permissions]]` in config will be applied to players who have the permissions described in `[[permissions]]`.

If a player has multiple permissions due to group inheritance in LuckPerms, etc., all settings will be activated, so the settings with the most restrictions will be given priority.

For example, if `default` is set to `commands = [“help”, “list”]` and `guest` inherits the default permissions, then even if `guest` is set to `commands = [“list”]`, `help `is not available!

“`toml
# Permission to view and execute all commands `commandlimiter.admin` for the following
allAllowed = “admin”
# Restrict the display and execution of all commands by players who do not have any privileges, or
limitNoPermissionsPlayer = true

# Configuration of commands available for each permission node
[[permissions]]
# Value of permission node `commandlimiter.default` for the following
nodeName = “default”
# Enable whitelist or not?
# If false, it will be in blacklist format
whiteList = true
# For whitelist, only the commands described below can be displayed and executed
# If blacklisted, only the commands described below will be restricted
# Commands containing subcommands can be filtered by wildcards or regular expressions
commands = [“help”, “list”, “me*”, “msg*”, “teammsg*”, “tell*”, “tm*”, “trigger*”, “w*”, “random*”]
“`

### Permission Node
The root of the permission node for this plugin is `commandlimiter`.

If you want to set it up with LuckPerms etc., you need to set it up as follows

> Example of LuckPerms settings saved in yaml
“`yaml
name: default
permissions:
– commandlimiter.default:
value: true
“`

## Command
The following commands are available

| Command |Alias | Description | Required Permission Nodes |
|—————————|————-|————————————————-|———————–|
| `/commandlimiter-reload` | `/cl-reload` | Reload the plugin config to reflect the settings | `commandlimiter.admin`|

> ⚠️Attention⚠️

Even if you reload the configuration with the command, the client will display the commands as they were before they were configured** until you reconnect to the server.

This is due to the fact that the client gets the commands that are available when connecting to the server.

# Support SNS
SNSList: [https://kuwa.dev/](https://kuwa.dev/)

Twitter(x): [https://x.com/kuwamain](https://x.com/kuwamain)

Discord Support Server: [https://kuwa.app/discord/support](https://kuwa.app/discord/support)

> Japanese
# What Is This
プロキシやプロキシ下にある全てのコマンドを操作して表示と実行を制御する強力なPlugin

# How To Use
### 導入前に
基本的にはLuckPerms等の権限管理プラグインと利用することをお勧めいたします

## 設定方法
ダウンロードしたプラグイン本体を、Velocityのプラグインフォルダに入れ、一度起動します

そうすることでデフォルトのconfigが生成されます

### Configの説明

config内の`[[permissions]]`に記述した権限を持つプレイヤーに記述した設定が反映されるようになります

LuckPermsのグループ継承等で複数の権限を持つプレイヤーの場合、すべての設定が有効化されるため、制限が多い設定が優先されます

例を言うと、`default`に`commands = [“help”, “list”]`が設定されていて、`guest`がデフォルトの権限を継承するようになっている場合、たとえ`guest`が`commands = [“list”]`のように設定されていても`help`を利用することはできません

“`toml
# 全てのコマンドの表示と実行を許可する権限 以下の場合`commandlimiter.admin`
allAllowed = “admin”
# 権限を何も持っていないプレイヤーのすべてのコマンドの表示と実行を制限するか
limitNoPermissionsPlayer = true

# 各 permission node で利用できるコマンドの設定
[[permissions]]
# permission node の値 以下の場合`commandlimiter.default`
nodeName = “default”
# ホワイトリストを有効にするか
# falseの場合はブラックリスト形式になる
whiteList = true
# ホワイトリストの場合は、以下に記述したコマンドのみ表示と実行が可能になる
# ブラックリストの場合は記述したコマンドのみ制限される~~~~
# サブコマンドを含むコマンドの場合、ワイルドカードや正規表現でフィルタ可能
commands = [“help”, “list”, “me*”, “msg*”, “teammsg*”, “tell*”, “tm*”, “trigger*”, “w*”, “random*”]
“`

### Permission Node
このプラグインの permission node の root は `commandlimiter` になっています

LuckPerms等で設定する場合は以下のように設定する必要があります

> LuckPermsの設定をyamlで保存するようにしている場合の例
“`yaml
name: default
permissions:
– commandlimiter.default:
value: true
“`

## Command
以下のコマンドが利用可能なコマンドです

| コマンド |エイリアス | 説明 | 必要なPermissionノード |
|—————————|————-|————————————————-|———————–|
| `/commandlimiter-reload` | `/cl-reload` | プラグインのconfigを再読み込みして設定を反映します | `commandlimiter.admin`|

> ⚠️注意⚠️

コマンドで設定を再読み込みしたとしても、コマンドの表示に関しては**サーバーに再接続するまでクライアントでは設定前の表示**になります

これはクライアントがサーバー接続時に利用できるコマンドを取得する仕様のためです

Velocity Carbon Discord

# Velocity Carbon Discord
Bridging [Carbon](https://modrinth.com/plugin/carbon) chat channels to Discord.

Carbon must be installed on the proxy to use this plugin. If you use Carbon on your backend servers, please use their DiscordSRV compatibility.

## Features
– Highly configurable
– Webhooks or bot messages for chat
– Display player count in bot status
– Ping discord users from in-game
– Reply to in-game messages from Discord
– Handle separate chat channel mappings (E.g. one channel for global chat, one channel for staff chat)
– Customisable Minecraft Avatar display
– Link discord attachments in-game
– Status messages on server start and shutdown, as well as player join, leave or change server
– Formats Xaero’s Minimap shared waypoints in Discord

## Installation
1. Create a discord bot application [here](https://discordapp.com/developers/applications/)
– Click `Add application` and then go to the `Bot` tab
2. Enable the `SERVER MEMBERS INTENT` and `MESSAGE CONTENT INTENT` under `Privileged Gateway Intents`
3. Go to the `OAuth2` tab and copy the `CLIENT ID`
4. Create an invite link for your new bot [here](https://discordapi.com/permissions.html)
– Enable permissions: `View Channels`, `Send Messages` and `Read Message History`
– Paste the copied `CLIENT ID` into the field on the page
– Click the generated link to invite your bot to your discord server
3. Go to the `Bot` tab and copy the bot token, you may need to click `Reset Token` first
4. Install the plugin on your server, start the server once to generate the config and stop the server again.
5. Open the plugin config files at `plugins/velocitycarbondiscord/config.yaml`
6. Replace where it says `TOKEN` with the bot token you copied previously
7. Edit the channel mapping to include the carbon channels and discord channels IDs you want to link
8. Set any additional config options you want
9. Start the server

## Support

Support for Carbon and Velocity Carbon Discord can be obtained in the [Carbon discord server](https://discord.gg/S8s75Yf). For Velocity Carbon Discord issues, please ping `@Jarva`

## Configuration
Default config generated on startup:
“`yaml
discord:
token: ‘TOKEN’
# Available placeholders:
messages:
# Additional placeholders:
chat_message: ‘: ‘
# Additional placeholders:
join_message: ‘** joined **’
leave_message: ‘** left **’
# Additional placeholders: N/A
disconnect_message: ‘** was disconnected**’
# Additional placeholders:
disconnect_server_message: ‘** was disconnected from **’
# Additional placeholders:
server_switch_message: ‘** moved from to **’
# Available placeholders: N/A
shutdown_message: ‘**Proxy shutting down**’
start_message: ‘**Ready for connections**’
# Additional placeholders: