ABOUT
Activate buttons on your faction cannons, or anywhere in the world, through a command! This eliminates you having to stand next to your faction cannon to fire it.
This can be used for purposes other than factions.
- Control distance through permissions
- Press buttons for specified ticks
- Release pressed buttons
- Per-world support
- Economy support
- Various supported versions
- Customization of messages
- ActionBar messages
- Update checker
- Selection of stone or wooden buttons
- Various settings to tweak
- Developer API
DEPENDENCIES ** = required
** System Dependency: Java 8 **
- Vault - With economy provider
COMMANDS (and aliases)
/remotecannons (view all commands and usage)
/remotecannons press
/remotecannons hold <ticks> (max in config. ultimate max is 6 hours)
/remotecannons remove
/remotecannons view
/remotecannons release
/remotecannons reload
aliases: [rc, remotec, rcannons]
PERMISSIONS
Press command: remotecannons.command.press
Hold command: remotecannons.command.hold
Remove command: remotecannons.command.remove
Reload command: remotecannons.command.reload
View command: remotecannons.command.view
Release command: remotecannons.command.release
Help command: remotecannons.command.help
Help command admin: remotecannons.command.help.admin
Button press distance: remotecannons.press.distance.<INTEGER>
Button hold distance: remotecannons.hold.distance.<INTEGER>
Update notification: remotecannons.updatecheck
* Set <INTEGER> to -2 to allow for infinite distance. Server operators have this by default.
CONFIGURATION
Code (YAML):
messages:
prefix: '&4[RemoteCannons]'
hold-success: '%prefix% &7You have pressed your last button for &a%time% &aticks&7.'
press-success: '%prefix% &7You have pressed your last button.'
button-removed: '%prefix% &7Your last pressed button was removed.'
button-already-on: '%prefix% &7The button is already pressed.'
button-already-off: '%prefix% &7The button is already released.'
button-already-spamming: '%prefix% &7You are already spamming your button.'
no-button-recently-clicked: '%prefix% &7You have not recently clicked a button.'
button-no-longer-tracked: '%prefix% &7You have removed tracking of your last pressed button.'
economy-withdraw: '%prefix% &7You were deducted &c$%amount%&7.'
economy-insufficient-balance: '%prefix% &7You do not have enough money.'
no-permission: '%prefix% &7You do not have permission.'
config-reloaded: '%prefix% &7Config reloaded (&a%time%&7).'
invalid-command-arguments: '%prefix% &7Invalid command arguments.'
command-help: '&8&m------------------------------------\n%prefix%\n&f \n&a/rc press &8- &7Presses your last button\n&a/rc hold <ticks> &8- &7Presses your last button for certain ticks.\n&a/rc remove &8- &7Removes your tracked button.\n&a/rc view &8- &7Views your tracked button location.\n&a/rc release &8- &7Releases your tracked button.\n&8&m------------------------------------'
command-help-admin: '&8&m------------------------------------\n%prefix%\n&f \n&a/rc press &8- &7Presses your last button\n&a/rc hold <ticks> &8- &7Presses your last button for certain ticks.\n&a/rc remove &8- &7Removes your tracked button.\n&a/rc reload &8- &7Reloads the configuration\n&a/rc view &8- &7Views your tracked button location.\n&a/rc release &8- &7Releases your tracked button.\n&8&m------------------------------------'
duration-too-long: '%prefix% &7You can only hold it for &a%max%&7 ticks.'
distance-too-far: '%prefix% &7You are too far from your button, you need to be within &c%distance% blocks&7.'
spam-too-long: '%prefix% &7You can only spam &a%max%&7 times.'
not-same-world: '%prefix% &7You are not in the same world as your button.'
hold-ticks-action-bar: '%prefix% &7Ticks left: &c%ticks%'
spam-action-bar: '%prefix% &7Spams: &c%spams%&4/&c%max%'
button-view: '%prefix% &7Your button location is at: &8[&a%x%&7, &a%y%&7, &a%z%&8]&7 in &a%world%&7.'
button-released: '%prefix% &7Your button has been released.'
button-spam: '%prefix% &7You are spamming your button for &a%spams%&7 times.'
button-removed-death: '%prefix% &7Your last pressed button was &cuntracked&7 because you died.'
settings:
cross-world-press: false
stone-button-enabled: true
wooden-button-enabled: true
check-updates: true
press-distance: true
hold-distance: true
spam-distance: true
max-hold-ticks: 100
max-spam-amount: 10
minimum-press-distance: 100
minimum-hold-distance: 100
minimum-spam-distance: 100
hold-ticks-action-bar: true
spam-action-bar: true
economy-enabled: true
remove-tracking-on-death: true
press-money-amount: 100.0
hold-money-amount: 300.0
spam-money-amount: 400.0
ticks-between-spams: 10
disabled-worlds:
- 'example'
* Leave messages blank or empty to show no message. Use multiple lines with \n
* Money amounts of 0 or less, will not be treated as having money deducted.
API
For usage on the API, grab the service through Bukkit's services manager.
Code (Java):
RemoteCannonsAPI remoteCannonsAPI = Bukkit.getServicesManager().getRegistration(RemoteCannonsAPI.class).getProvider();
EVENT API
- ButtonHoldEvent - When a player holds a button (commnd)
- ButtonPressEvent - When a player presses a button (physically or command)
- ButtonReleaseEvent -When a button is released through the plugin, not globally
Soon:
Spamming feature for buttons
BUGS
If you discover a bug I may have missed, you can feel free to discuss the problem in the discussion page.
