Skip to main content

Configuration

RocketJoin’s configuration is straightforward and powerful. This guide will walk you through all available options.

Configuration Overview

The config file is located at plugins/RocketJoin/config.yml. For each message string such as the message one, you can use a list to let the plugin choose a random one each time.

Random Messages Example

Each time a player joins, RocketJoin will randomly select one of these messages.

Default Configuration

Here’s the complete default configuration with explanations:

Configuration Options Explained

Basic Settings

prefix - The prefix shown before messages. Supports color codes. update-message - Enable or disable update notifications when joining the server.

Join Messages

join.enabled - Enable or disable join messages globally. join.message - The message displayed when a player joins. Available placeholders:
  • {player} - Player’s name
  • {DisplayPlayer} - Player’s display name
  • Any PlaceholderAPI placeholders (if installed)
join.otherServerMessage - Message shown on proxy servers when a player joins from another server. Additional placeholder:
  • {server} - The server name the player joined from
join.enable-title - Enable or disable the welcome title. join.title - The main title text shown to the player. join.subtitle - The subtitle text shown below the title.

Leave Messages

leave.enabled - Enable or disable leave messages globally. leave.message - The message displayed when a player leaves. leave.otherServerMessage - Message shown on proxy servers when a player leaves to another server.

Server Switch Messages

Server switch messages are only available on Velocity or BungeeCord proxy servers.
serverSwitch.enabled - Enable or disable server switch messages. serverSwitch.messageFrom - Message shown on the server the player left from. Placeholders:
  • {oldServer} - Server the player left
  • {newServer} - Server the player joined
serverSwitch.messageTo - Message shown on the server the player joined.

Join Commands

commands - List of commands executed from console when a player joins. Use {player} placeholder in commands. Set to [] to disable. See the Join Commands guide for more details.

Hide Feature

enable-hide - Enable the hide feature. Players with the hide permission won’t have join/leave messages shown. hide-permission - Permission node for the hide feature (default: rocketjoin.silent).

Custom Conditions

conditions - Define custom conditions for special join/leave messages. See the Conditions guide for detailed information. Each condition can have:
  • join - Custom join message
  • leave - Custom leave message
  • sound - Play a sound (true/false)
  • sound-type - Sound type (see Bukkit Sound enum)
  • fireworks - Spawn fireworks (true/false)
  • fireworks-amount - Number of fireworks to spawn
  • commands - Commands to execute on join

Welcome Message

welcome - A welcome message sent to players when they join. Use \n for new lines. Set to "disable" to disable this feature.