JoinMe-Velocity

 **JoinMe** is a powerful and engaging Velocity plugin designed to enhance player interaction on your proxy network. With JoinMe, players can share their current server with others, complete with a visually appealing avatar display and clickable commands to join instantly. The plugin includes a robust token system for rewarding players, customizable cooldowns, blacklisted servers, and detailed configuration options to tailor the experience to your network's needs. ### **Features** * **Server Sharing**: Players can broadcast their current server with a stylized message and optional avatar display. * **Token System**: Players can claim JoinMe Tokens, with configurable costs for using the /joinme command. * **Avatar Rendering**: Displays a player's Minecraft skin as a pixelated avatar in chat. * **Cooldowns & Permissions**: Prevent spam with customizable cooldowns and bypass permissions for VIPs or staff. * **Blacklisted Servers**: Restrict the /joinme command on specific servers (e.g., lobbies). * **Daily Token Claim**: Encourage engagement with a daily token claim system (configurable interval and amount). * **Customizable Messages**: Fully customizable messages using MiniMessage for rich formatting and clickable actions. * **Admin Tools**: Manage tokens, reload configurations, and monitor usage with detailed commands. * **bStats Integration**: Track plugin usage with lightweight metrics. * **Version Checker**: Automatically notifies admins about new plugin updates. ### **Commands** * **/joinme** * Broadcasts the player's current server with a stylized message. * Costs configurable JoinMe Tokens (default: 1, can be disabled). * Respects cooldowns and blacklisted servers. * **Permission**: *joinme.use* * **/joinme help** * Displays a help menu with all available commands. * **/joinme reload** * Reloads the plugin's configuration file. * **Permission**: *joinme.reload* * **/joinme tokens** * Shows the player's current JoinMe Token balance. * **/joinme tokens ** * Displays another player's token balance. * **/joinme tokens claim** * Claims daily JoinMe Tokens (configurable amount and interval). * **/joinme tokens give ** * Gives tokens to a specified player. * **Permission**: *joinme.tokens.manage* * **/joinme tokens remove ** * Removes tokens from a specified player. * **Permission**: *joinme.tokens.manage* ### **Configuration** JoinMe offers a highly customizable *config.yml* file where you can: * Set cooldown durations and token costs. * Define blacklisted servers. * Configure the daily token claim system (enabled/disabled, amount, interval). * Customize all messages with MiniMessage formatting. config ```yaml # =================================================== # JoinMe Plugin Configuration # =================================================== settings: # Cooldown in seconds before a player can use the /joinme command again. cooldown: 5 # Amount of JoinMe Tokens deducted when a player uses the /joinme command. # Set to 0 to disable the cost. token-cost: 1 # Configuration for blacklisted servers where the /joinme command cannot be used. blacklist: - lobby # Configuration for the daily token claim system. token-claim: # Whether the daily token claim system is enabled. enabled: true # Amount of tokens players receive when claiming. amount: 5 # Interval in hours between claims. interval-hours: 24 # =================================================== # Message Configuration # =================================================== messages: # Plugin prefix used in all messages. prefix: "[JoinMe]" # Message displayed when a player uses /joinme. join-message-line1: " %player% is playing on %server%!" join-message-line2: " Click HERE, to join him!" # Error messages. command-permission-message: "%prefix% You don't have permission for this!" command-player-only: "%prefix% This command can only be executed by players." cooldown-message: "%prefix% You can use this command again in %remaining_seconds% seconds." blacklist-message: "%prefix% This command cannot be used on this server." not-enough-tokens: "%prefix% You don't have enough JoinMe Tokens. Cost: %cost%" invalid-amount: "%prefix% Amount must be a positive number." invalid-number: "%prefix% Invalid number." # Token related messages. tokens-balance-self: "%prefix% Your JoinMe Tokens: %tokens%" tokens-balance-other: "%prefix% %player%'s JoinMe Tokens: %tokens%" tokens-given: "%prefix% You have given %amount% JoinMe Tokens to %player%." tokens-received: "%prefix% You have received %amount% JoinMe Tokens from %sender%." tokens-removed: "%prefix% You have removed %amount% JoinMe Tokens from %player%." tokens-claimed: "%prefix% You have claimed %amount% JoinMe Tokens." tokens-claim-cooldown: "%prefix% You can claim JoinMe Tokens again in %time_remaining%." tokens-claim-disabled: "%prefix% The daily token claim is currently disabled." token-cost: "%cost%" tokens-usage-admin: "%prefix% Usage: /joinme tokens " tokens-usage: "%prefix% Usage: /joinme tokens [claim | ]" permission-manage-tokens: "%prefix% You don't have permission to manage tokens." # Help command messages. help-header: "JoinMe Commands:" help-joinme: "/joinme - Shows your current server to other players." help-reload: "/joinme reload - Reloads the configuration." help-tokens-balance: "/joinme tokens - Shows your JoinMe Token balance." help-tokens-balance-other: "/joinme tokens - Shows the JoinMe Token balance of another player." help-tokens-give: "/joinme tokens give - Gives JoinMe Tokens to a player (Admin only)." help-tokens-remove: "/joinme tokens remove - Removes JoinMe Tokens from a player (Admin only)." help-tokens-claim: "/joinme tokens claim - Claims your daily JoinMe Tokens." # Reload command messages. reload-success: "%prefix% JoinMe configuration reloaded successfully!" reload-error: "%prefix% Error reloading JoinMe configuration. Check the console for details." ``` preview