Join Commands

RocketJoin allows you to execute commands automatically when players join your server. This is useful for giving starter items, setting up new players, or running any server commands.

Overview

Join commands are executed from the console when a player joins. You can use the {player} placeholder in commands to reference the joining player.

Basic Configuration

Commands are configured in the main config.yml file under the commands section:

commands:
  - "say Welcome {player}!"
  - "give {player} bread 5"

Disabling Commands

To disable join commands, simply set the commands list to empty:

commands: []

Placeholders

Player Placeholder

The {player} placeholder is replaced with the joining player’s username. Example:

commands:
  - "say Welcome {player} to the server!"
  - "give {player} diamond 1"

When a player named “Steve” joins, these commands will execute as:

say Welcome Steve to the server!
give Steve diamond 1

Common Use Cases

Starter Kit

Give new players a starter kit when they join:

commands:
  - "give {player} bread 10"
  - "give {player} wooden_sword 1"
  - "give {player} leather_helmet 1"
  - "give {player} leather_chestplate 1"
  - "give {player} leather_leggings 1"
  - "give {player} leather_boots 1"

Welcome Message

Send a welcome message to all players:

commands:
  - "say Welcome {player} to the server!"
  - "broadcast {player} has joined for the first time!"

Teleport to Spawn

Teleport players to spawn when they join:

commands:
  - "spawn {player}"

Set Player Properties

Set various player properties:

commands:
  - "gamemode survival {player}"
  - "heal {player}"
  - "feed {player}"

Commands in Conditions

You can also set commands for specific conditions. This allows you to execute different commands based on player permissions or other criteria.

Example: VIP Starter Kit

conditions:
  vip:
    type: PERMISSION
    value: "rocketjoin.vip"
    join: "&e&lVIP &7{player} joined!"
    commands:
      - "give {player} diamond 5"
      - "give {player} iron_sword 1"
      - "give {player} golden_apple 3"

Example: First Join Commands

conditions:
  first-join:
    type: FIRST
    join: "&a&lWelcome {player}!"
    commands:
      - "give {player} bread 10"
      - "give {player} wooden_sword 1"
      - "say Welcome {player} to the server! Check out /help!"

Advanced Examples

Conditional Commands with Multiple Actions

commands:
  - "say Welcome {player}!"
  - "give {player} bread 5"
  - "spawn {player}"

Integration with Other Plugins

You can integrate with other plugins’ commands:

commands:
  - "lp user {player} parent set default"
  - "essentials:kit starter {player}"
  - "towny:town new {player} MyTown"

Make sure the plugins you’re integrating with support console command execution and the {player} placeholder format.

Best Practices

Test commands first - Always test commands in-game before adding them to the config to ensure they work as expected.
Use appropriate permissions - Some commands may require specific permissions. Make sure your server console has the necessary permissions.
Avoid lag-inducing commands - Be careful with commands that might cause server lag, especially if you have many players joining.
Order matters - Commands execute in the order they’re listed. Place important commands first.
Use condition-specific commands - For player-specific actions, use commands in conditions rather than global commands.

Troubleshooting

Q: Commands aren’t executing
A: Check that:

The commands section is not set to []
The commands are properly formatted in YAML
Your server console has permissions to execute the commands
The plugin is properly loaded

Q: Placeholders aren’t working
A: Make sure you’re using {player} (with curly braces) and that the player name is being properly substituted. Q: Commands execute but fail
A: Verify that:

The command syntax is correct
Required plugins are installed and enabled
The server has necessary permissions

Security Considerations

Be careful with commands that modify player data or server state. Always test commands in a safe environment first.

Avoid commands that could be exploited
Don’t give excessive items or permissions
Review commands regularly for security issues

Configuration - General configuration guide
Conditions - Learn about condition-specific commands

RocketJoin

RocketPlaceholders

MultiLang

Join Commands

Join Commands

Overview

Basic Configuration

Disabling Commands

Placeholders

Player Placeholder

Common Use Cases

Starter Kit

Welcome Message

Teleport to Spawn

Set Player Properties

Commands in Conditions

Example: VIP Starter Kit

Example: First Join Commands

Advanced Examples

Conditional Commands with Multiple Actions

Integration with Other Plugins

Best Practices

Troubleshooting

Security Considerations

​Join Commands

​Overview

​Basic Configuration

​Disabling Commands

​Placeholders

​Player Placeholder

​Common Use Cases

​Starter Kit

​Welcome Message

​Teleport to Spawn

​Set Player Properties

​Commands in Conditions

​Example: VIP Starter Kit

​Example: First Join Commands

​Advanced Examples

​Conditional Commands with Multiple Actions

​Integration with Other Plugins

​Best Practices

​Troubleshooting

​Security Considerations

​Related Guides

Join Commands

Overview

Basic Configuration

Disabling Commands

Placeholders

Player Placeholder

Common Use Cases

Starter Kit

Welcome Message

Teleport to Spawn

Set Player Properties

Commands in Conditions

Example: VIP Starter Kit

Example: First Join Commands

Advanced Examples

Conditional Commands with Multiple Actions

Integration with Other Plugins

Best Practices

Troubleshooting

Security Considerations

Related Guides