Boomerang

Essential Commands

Current Version: 3.7 for 1.8 to 1.8.7

Features

Version 3.x (for 1.8.x)

• Server Spawnpoint
• Home commands
• TPA commands
• Warp command
• Portals between worlds
• Random teleports to locations with minimum and maximum round radius.
• Built-in vote listener. No other plugin needed.
• Logon welcome messages and commands for new and returning players.
• Utility commands: fly, info, mute
• Fixes tab-complete for fill and related commands
• Fixes player chat name color

Biome teleport and permissions system coming soon!

Version 2.4 (for 1.7.x)

• Server hub spawn point
• Warps
• Portals between worlds.
• Random teleports.
• Random biome specific teleports.
• Skyblock or parkour fall portals. (version 2.4)

Installation

1. Copy Boomerang.jar to your plugins folder.
2. Restart server or run the Bukkit /reload command.

Boomerang will create folder plugins/Boomerang which will contain config.yml

Configuration

Version 3.x (for 1.8.x)

• homes_max: The maximum number of homes a non-op player may set. Default is 5.
• tprequest_expire: Number of seconds until a TP request expires. Default is 30.
• tprequest_cooldown: Currently not implemented.
• vote_listener_port: TCP port vote listener listens on. Default is 0 - disabled.
• prevent_boat_collision_break: When set to true, boats break only when player attcks it. Default is true.
• mute_minutes: Default minutes the mute command mutes a player if duration is not specified. Defalt is 5.

When world spawn is set, the following configuration will exist in config.yml.

• spawn.world
• spawn.x
• spawn.y
• spawn.z
• spawn.yaw
• spawn.pitch

Version 2.4 (for 1.7.x)

• biomeCollect.world: World inwhich to collect locations and classify by biome.
• biomeCollect.min.x and biomeCollect.min.y: Minimum X and Y coordinates to include in collection.
• biomeCollect.max.x and biomeCollect.max.y: Maximum X and Y coordinates to include in collection.
• biomeCollect.listLength: Maximum length of list to keep for each biome collected.
• biomeCollect.interval: Number of seconds between collection sample.
• biomeCollect.saveInterval: Number of minutes between save of location collection into rtp.yml.

Commands

Version 3.x (for 1.8.x) Commands (link)

In addition to the above commands, Boomerang 3 also allows you to send custom welcome messages and commands for new and returning players.

Note: Macro @p will be replaced with player's name.

For new players, edit commands_new_join.txt, i.e.:

title @p title {"text":"","extra":[{"text":"Welcome to ","color":"gold"},{"text":"Chrisbot","color":"yellow"},{"text":"!","color":"gold"}]}

scoreboard teams join Players @p

give @p minecraft:written_book 1 0 {display:{Name:Chrisbot Manual},title:'Player\'s Guide',author:'Owner',generation:3,pages:["{text:'‡ Chrisbot Manual ‡\n',color:dark_blue,bold:true,extra:[{text:'\n Rules\n\n',color:dark_aqua,bold:true},{text:' No griefing\n',color:black,bold:false},{text:' Respect others\n',color:black,bold:false},{text:' Do not spam chat\n',color:black,bold:false},{text:' No foul language\n',color:black,bold:false},{text:' Do not harass others\n',color:black,bold:false},{text:' Do not repeatedly ask for things\n',color:black,bold:false},{text:'\n (Teleports)',color:gray,bold:false}]}","{text:'\n Teleports\n\n',color:dark_aqua,bold:true,underlined:false,extra:[{text:'Click link to teleport.\n\n',color:black,bold:false,underlined:false},{text:'Spawn\n',color:blue,bold:false,underlined:true,clickEvent:{action:'run_command',value:'/spawn'}},{text:'\n\n\n\n\n\n\n(Rules) (Support)',color:gray,bold:false,underlined:false}]}","{text:' Support Site\n',color:dark_aqua,bold:true,underlined:false,extra:[{text:'\nClick a link below to visit topic on Chrisbot.net.\n\n',color:black,bold:false,underlined:false},{text:'Chrisbot.net Home\n\n',color:blue,bold:false,underlined:true,clickEvent:{action:'open_url',value:'http://www.chrisbot.net'}},{text:'HomeStick Request\n\n\n\n\n',color:blue,bold:false,underlined:true,clickEvent:{action:'open_url',value:'http://www.chrisbot.net/homestick'}},{text:'(Teleports)',color:gray,bold:false,underlined:false}]}"]}

give @p bread 32

For existing players, edit commands_join.txt, i.e.:

tellraw @p ["",{"text":"[MOTD] ","color":"gold"},{"text":"Welcome back! We now have a ","color":"aqua"},{"text":"/spawn ","color":"yellow"},{"text":"command. More coming soon!","color":"aqua"}]

Version 2.4 (for 1.7.x) Commands (link)

Vote Listener

By default, the vote listener is turned off. To enable, set vote_listener_port in config.yml in the Boomerang plugin folder to an available TCP port. Restart or reload your server. In the Boomerang plugin folder there will be a folder named "vote".

privateKey.pem and publicKey.pem are the encryption keys used to decode the vote server's message. Each time they are generated they are unique. No other server will have these keys. If you want to change your keys, delete both files and new keys will be generated.

publicKey.txt is the text version of the public key you provide a vote server.

command.txt is a plain test file in which each line is a command that is run when a vote is received. Any command may be used. Macro @p will be replaced by the voting player's name. Macro @s will be replaced by the vote server name.

log.txt contains time-stamped entries of the commands run when a vote is received.