DolphinSpleef
DolphinSpleef
Features & Info
DolphinSpleef is an advanced, easy-to-use Spleef plugin, Perfect for every server out there!
It requires WorldEdit to set the arenas, and WorldGuard (or anything similar) to protect them.
Features:
- Easy to setup
- Easy to understand for your server's players
- Permissions
- Power Items (Explained below)
- Lots of configurable settings
- Updated frequently
GUYS PLEASE GIVE ME YOUR SERVER'S IP SO I CAN SEE HOW THE PLUGIN IS BEING USED, AND TO MAKE IMPROVEMENTS AND FEATURES. THANKS :)
PLUGIN ORIGINALLY DESIGNED FOR MY SERVER - RAVAGE-CRAFT.NET
How to use
Setting up an arena
Deleting an arena
To delete an arena, Type /Spleef delete <ID>.
NOTE: It will be gone forever. :(
Creating an arena
To create an arena, Type /Spleef create.
It will create an arena and give you the ID of it.
Setting the floor
Once an arena is created, you need to set the "spleefing floor" for it.
To do this, select the area (including the Y-axis) of all the blocks you want to be in the destroy range using WorldEdit, and type /Spleef setfloor <ID>.
Setting the breakable blocks
Now you need to set which blocks may be destroyed by players in-game.
Type /Spleef setfloorblocks <ID> <Breakable blocks>.
For example, you can do either the block ID's or Material names, seperated by a comma (So like diamond_block,46,mycel would be Diamond blocks, TNT and mycelium can be destroyed).
Setting the spawn points
You need to set the locations players get teleported to. It is set by where you are standing, and where you are looking.
Do /Spleef setspawn <ID> to set where the players get teleported to when they join a game.
Do /Spleef setgamespawn <ID> to set where the players get teleported to when the game begins.
Do /Spleef setlosespawn <ID> to set where the players get teleported to when they lose or leave the game.
Do /Spleef setwinspawn <ID> to set where the winner gets teleported to.
Protecting the arena
To protect the arena from griefers, you NEED a world protection plugin, like WorldGuard.
Players required
This will set the minimum number of players required for the arena to begin.
/Spleef setminplayers <ID> <Min Players> will set this.
Maximum Players allowed
This will set the maximum number of players (By default 35) that there can be in an arena at one time.
/Spleef setmaxplayers <ID> <Max Players> will set this.
Fall distance
This will set how many blocks you fall before you fall out of the arena (By default 3).
/Spleef setfall <ID> <Fall Distance> will set this.
Ready block
The ready block is what players can punch to tag them as 'ready' for the game to start.
To set this, type /Spleef setreadyblock <ID> <Block>. The block can be either the ID or the item name. (57 would be the same as diamond_block)
Block break effect
This will set if blocks show the breaking particles when broken (By default enabled).
It is useful to turn this off if there are lots of players (which may cause client lag), or if the arena has breakable blocks like wool, which, unfortunately, Bukkit can't handle, so only shows white wool breaking, not the actual colour of the block.
/Spleef enablebreakeffect <ID> will enable this.
/Spleef disablebreakeffect <ID> will disable this.
Reward prizes
Rewards will be given to the player when they win a game.
To set economy rewards, you need to have Vault installed.
To set an economy reward: Type /Spleef setrewardcash <ID> <Cash> to set the cash won.
To set an item reward: Type /Spleef setrewardprizes <ID> <Prizes>. The layout for the prizes is: ID:SUBID:AMMOUNT, so to make the reward 8 iron ingots and 4 red wool, we would possibly do iron_ingot:0:8,35:14:4
Power Items
Power items (Disabled by default) are an additional feature, to make the game more exciting.
Power items (Which can be set), when right clicked on a block, will cause an explosion of a set radius (By default 6) to appear in the floor on that layer. The item will disappear into thin air after every use.
/Spleef enablepoweritems <ID> will enable them.
/Spleef disablepoweritems <ID> will disable them.
To set the items which can be used as power items, type /Spleef setpoweritems <ID> <Power Items>. For example, you can do either the item ID's or Material names, seperated by a comma (So like diamond,269,iron_ingot would be Diamonds, Wooden shovels and Iron ingots that can be used as power items).
Arena Management
Enabling or Disabling arenas
To enable an arena, type /Spleef enable <ID>. The arena must be configured correctly, or it wont allow you to enable it.
To disable an arena, type /Spleef disable <ID>.
Starting an arena
Arenas can start one of two ways:
- A 'ready' system
A player will get tagged as ready when they type /Spleef ready, or punch the block specified. The arena will only start once all the players in the arena are tagged as ready, and there is over the minimum ammount of players.
- A command system
To start the arena the player is in, type /Spleef start.
To start an external arena, type /Spleef start <ID>.
There must be the required minimum ammount of players for the arena to start.
Signs
Note: You need the dolphinspleef.manageArenas permission to create signs.
Single signs:
For a single sign, put this into a sign
[Spleef]
Join/Spectate
ARENA ID
Large signs:
To make these, make a row of signs, select them all with a WorldEdit axe and type /Spleef setsigns ID
Commands n' stuff
User Commands
- Join an arena - /Spleef join <ID>.
- Leave the current arena - /Spleef leave.
- Spectate an arena - /Spleef spectate <ID>.
- Be tagged as ready to start - /Spleef ready.
- See what players are ingame, and who is ready - /Spleef list (ID) (When in a game, unless the ID is specified).
- See which arenas are enabled - /Spleef list (When not in a game).
Permissions
- dolphinspleef.manageArenas
- Used for: Used to manage and setup arenas.
- Default: OP.
- dolphinspleef.startArena
- Used for: To start the arena the player is currently in.
- Default: OP.
- dolphinspleef.joinArena
- Used for: To join a game.
- Default: Yes.
- dolphinspleef.spectateArena
- Used for: To spectate a game.
- Default: Yes.
PLEASE READ
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.
@Wolf2323
DOWNLOAD IT QUICK INCASE IT GETS DECLINED.
By BukkitDev regulations (again), I MUST put this here:
It is not yet approved, and BukkitDev/Bukkit hold no responsibility for what happens with the plugin. (although i'm 100% sure its safe)
:( when came update then ?
@Wolf2323
They took it down because it didnt comply with their rules. Apparently reading from a URL (to check for updates) isnt allowed. O_o
when i klick on "here"
We're sorry, you've attempted to access a page that doesn't appear to exist. If you find this to be in error, please notify the administrators.
?
@thebigdolphin1
Awesome Addings Keep Up mate i Loved the plugin :)
@Wolf2323
I've released a fix for it, but bukkit has not yet approved it. If you wish to download it, click By BukkitDev regulations, I MUST put this here: It is not yet approved, and bukkitdev hold no responsibility for what happens with the plugin. (although im 100% sure its safe)
@Dasko222
I've released a fix for it, but bukkit has not yet approved it. If you wish to download it, click By BukkitDev regulations, I MUST put this here: It is not yet approved, and bukkitdev hold no responsibility for what happens with the plugin. (although im 100% sure its safe)
your plugin is not compatiblr with mcMMO
can you make a bug fix ?
When might the plugin update? There are 1-2 plugins that broke because of this plugin is causing :(
@thebigdolphin1
That might actually be a result of this. Not that it's a bad idea to clean up after yourself anyway, but it would appear that bukkit makes its best attempt at doing so for you.
@Glitchfinder
Putting
in onEnable seems to work fine.
@thebigdolphin1
If you want to stop all the tasks for your plugin, I would recommend this function, which will cancel all tasks for the plugin you send it as an argument. Note that it has to be an instance of the plugin to work. I would also like to note that your current location for that call is rather pointless. It might be better to put it in the onDisable call, so that it can work off of the current instance of the plugin. If it gets reloaded with /reload, that will catch existing tasks, while putting it in onEnable won't.
@Glitchfinder
Thanks! I just got notified of this from a server, it will be fixed shortly. I read somewhere that stopalltasks only does it for the plugin... Guess that was wrong.
You need to release a new version that doesn't cancel all tasks as soon as the plugin loads. This currently breaks several other plugins, most notably WorldBorder and mcMMO. (I have a log with both being broken by your plugin. Note lines 143 and 307. Also note mcMMO-related player chat starting at line 341. That chat is describing an issue in mcMMO caused by one of our tasks not running. That isn't my server, it's provided by someone reporting that bug to us over at the mcMMO team.) That call, the first line in your onEnable function, will cancel every active task filed by every active plugin.
WARNING: This plugin will break many other plugins, some of which are very common and considered essential.
@The_French_Fries
Oh ok
@thebigdolphin1
I didn't launch the server yet, so I can't give the IP right now. Sorry...
@brsbro879
Whats your servers ip?
Great plugin, the only one that i could find that worked, but could you make a way to give someone a power item at begging of game
but again AMAZING PLUGIN
@TheFrenchFries
Yeah, when you select the floor, make sure you include the Y-Axis.
Also, can I have your servers IP please? (so I can see how its being used, fixes, new stuff for updates, etc)
Great plugin, but I can't make multiple floors. Is there anyway to make multiple floors? Thanks =D