Bukkit

Boomerang Spawn is the first in a series of plugins designed to let you pick the functionality you want from the Boomerang suite of plugins.

Features

Only the good parts.

• Versions 1.8.x and 1.9.
• Set server spawn. Optionally force spawn on join.
• Perform commands with macros when new players join, players return or players leave the game.
• Optionally set chat name color to team color.
• Quiet Join list enabled players to join and quite the server without being noticed.

Related Plugins

Installation and Configuration

Place BSpawn.jar in your plugins folder and then reload or restart the server. It is recommended that you test and configure any plugin on a test server. BSpawn is preconfigured with spawn unset, team colors in chat set and basic new join, join and quit commands.

A reference to macros can be found in config.txt inside the BSpawn plugin folder.

Macros

&x - color codes where x is the color code.

@p - player's name

@s - command user's name with using /spawn <player>

@( - player's team prefix (team color)

@) - player's team suffix

config.yml

Strings can be a challenging thing to enter into a config.yml. It is recommended you use single quotes ( ' ) around strings with other than alpha-numeric content such as tellraw messages.

Mac users may find it troubling to use double quotes as TextEdit tends to automatically alter closing quotes which won't play with YAML. To get around that, copy and paste quotes.

teleport_message

This message is displayed to the player using the /spawn command. It accepts amperstand (&) formatted color codes. If this entry is empty, no message is displayed to the player.

Example: teleport_message: '&eWoosh...'

teleport_other_message

This message is displayed to the teleporting player when when the player is spawned by another player. If this entry is empty, no message will be displayed to the player.

Example: teleport_other_message: '&e@s teleported you to spawn.'

use_team_colors

When set to true, uses team colors in chat.

For these examples, team color was set up like this:

/scoreboard teams add Default
/scoreboard teams option Default color aqua
/scoreboard teams join Default derp1999

Example: use_team_colors: false



Example: use_team_colors: true

new_join_commands

These commands are run when a player joins the game for the first time. To make building tellraw messages easier, visit Tellraw Generator on minecraftjson.com.

Example:
new_join_commands:
- give @p bread 10
- give @p emerald 5
- scoreboard teams join Default @p
- 'tellraw @p ["",{"text":"&eWelcome to the game, @(@p@)&e!","color":"gold"}]'
- 'tellraw @a[name!=@p] ["",{"text":"&eWelcome @(@p@)&e to the game!","color":"gold"}]'

join_commands

These commands are run when a player returns to the game.

Example:
- 'tellraw @p ["",{"text":"&eWelcome back, @(@p@)&e!","color":"gold"}]'
- 'tellraw @a[name!=@p] ["",{"text":"&eWelcome @(@p@)&e back to the game!","color":"gold"}]'

quit_commands

These commands are run when a player leaves the game.

Example:
quit_commands:
- 'tellraw @a ["",{"text":"@(@p@)&e has left the game.","color":"gold"}]'

quiet_join

Join and quite commands will not be run for players in this list.

Example:
quiet_join:
- redstonefiend

spawn

This setting is set by the /setspawn command. When force is true, returning players are forced to spawn.
Example:
spawn:
force: false
world: world
x: 73
y: 81
z: 138
yaw: -1
pitch: -1

Commands

setspawn

Set server spawn for new players. Optionally force all joining players to spawn. The spawn location includes your yaw and pitch so you can direct the player's attention to a specific direction.

Usage: setspawn [force]
Permission: bspawn.setspawn

unsetspawn

Unset server spawn for players. The spawn command will no longer work. Server spawn will follow default Minecraft rules.

Usage: unsetspawn
Permission: bspawn.unsetspawn

spawn

Teleport to spawn, teleport another player to spawn.

Usage: spawn [player]
Permission: All players have access to spawn command.

Examples:
/spawn - teleport self to spawn
/spawn derp1999 - teleport derp1999 to spawn

bspawn

Boomerang Spawn administrative commands. Used to view BSpawn verison, reload BSpawn configuration and add/remove players from Quiet Join list. Join and Leave commands are not run for players in Quiet Join list, therefore, those players can join and quit the server without being noticed.

Usage: bspawn [ver[sion] | [reload] | [quietjoin add|remove player_name]
Permission: bspawn.bspawn

Examples:
/bhome ver - Displays Boomerang Spawn's version.
/bhome reload - Reloads config.yml.
/bspawn quietjoin - List players in Quiet Join list
/bspawn quietjoin add <player> - Add player to Quiet Join list /bspawn quietjoin remove <player> - Remove player from Quiet Join list.