SkyBukkit
SkyBukkit
General
SkyBukkit seamlessly brings SkyBlock to Bukkit servers. It allows players to easily and effectively play SkyBlock alone or with their friends on any Bukkit server, even when a survival world already exists.
For example, on a standard Bukkit server, a player might decide that he has had enough survival gameplay for the day. By simply typing “/island home” the player can teleport to his completely-separate SkyBlock and get to work there. Furthermore, the player would automatically have his inventory, armor, xp, hunger, health, saturation and exhaustion switched, just like he had logged onto another, SkyBlock-dedicated, server.
This same player could then just use “/island spawn” to jump right back into his normal survival environment, while all of his items, etc. are switched back.
While plugins like this do already exist, they all have far fewer features and those projects are outdated with their authors vanished off of the face of the earth. This project attempts to remedy the problem, while offering a server experience like no other.
This plugin has been re-written completely from scratch to achieve maximum performance and compatibility on Bukkit servers.
News
SkyBukkit Release v0.6.0
Release v0.6.0 contains a number of accessibility fixes.
SkyBukkit Release v0.5.14
Release v0.5.14 removes some super-hacky CB-dependant code, amoung other things.
SkyBukkit Release v0.5.13
Release v0.5.13 contains serveral technical fixes as well as some anti-cheat item duplicaiton protection.
Use
Prerequisites
SkyBukkit depends on WorldGuard for it's island protection ability. Please ensure you have it (and WorldEdit, which WorldGuard depends on) installed.
You are also probably going to want to install a plugin like MultiVerse, which will allow you to create a separate world for SkyBlock instances.
PLEASE NOTE: It is highly inadvisable to make your SkyBukkit world an existing survival world. If you do, it will create a host of problems, for example:
- When a player creates a SkyBlock, a giant area of land will become un-editable by other players, as it infringes on their protected SkyBlock land area.
- When a player deletes a SkyBlock, a giant area of land from sky to bedrock will be deleted, creating a massive void pit.
Instead, a separate world should be created (using a plugin similar to MultiVerse) which is using the cleanroom world generator.
Introduction
Simply place the plugin in the standard Bukkit plugin directory and it will automatically generate its configuration the next time the server is run. The default configuration is fine for normal use, but feel free to tweak it for a unique server experience (all available options are available below).
Players simply use “/island create” to create their own SkyBlock instance. They are automatically teleported to their new island and their inventory is switched for them. To delete or replace the SkyBlock they use “/island destroy” or "/island replace" respectively.
Say a player wanted to invite his friend over to his SkyBlock so they could play together. Said player would use a party. Just by typing “/island invite <friend>” they can create a new party and invite the friend to join. The friend would accept or decline the invitation be using “/island accept” or “/island decline”, respectively. The friend could leave at any time with “/island leave”.
That is just a snapshot of all available commands. They, with their accompanying descriptions and permission nodes, can be found further down.
Configuration
Please Note: All of the below configuration options are compulsory. If any are omitted, they will be re-generated next time the server starts.
Name | Default | Description |
---|---|---|
center: x: | 0 | X co-ordinate of where the center island should be placed. |
center: z: | 0 | Z co-ordinate of where the center island should be placed. |
pvpEnabled: | false | Whether or not PVP is allows on islands. |
switchInventories: | true | Whether or not SkyBukkit will auto-switch inventories. |
world: | world | Name of the world where the islands should be stored. |
partyMaxSize: | 0 | The maximum number of players allowed in a single party if INF (0) |
islandHeight: | 128 | Y co-ordinate of where newly-generated islands should be placed. |
islandSpacing: | 120 | Distance between generated islands. |
islandSize: | 100 | Size of the protection “bubble” between SkyBlocks. |
items: | (LIST) | List of all items in the SkyBlock chest. |
items: id: | (INTEGER) | ID of an item in the chest. |
items: dmg: | (INTEGER) | Damage value of an item in the chest. |
items: qty: | (INTEGER) | Quantity of an item in the chest. |
A sample configuration file containing the default values can be found below:
center: x: 0 z: 0 pvpEnabled: false switchInventories: true world: world partyMaxSize: 0 islandHeight: 160 islandSpacing: 120 islandSize: 100 items: - id: 287 dmg: 0 qty: 12 - id: 327 dmg: 0 qty: 1 - id: 352 dmg: 0 qty: 1 - id: 338 dmg: 0 qty: 1 - id: 40 dmg: 0 qty: 1 - id: 79 dmg: 0 qty: 2 - id: 361 dmg: 0 qty: 1 - id: 39 dmg: 0 qty: 1 - id: 360 dmg: 0 qty: 1 - id: 81 dmg: 0 qty: 1 - id: 323 dmg: 0 qty: 1
Commands
Please Note: Wildcard *s are valid in permission nodes. Commands may also be prefixed with the alias /is instead of /island.
Command | Permission | Description |
---|---|---|
/island create | skybukkit.island.create | Create a new SkyBlock. |
/island destroy | skybukkit.island.destroy | Destroy your current SkyBlock. |
/island replace | skybukkit.island.replace | Replace your current SkyBlock. |
/island home | skybukkit.tp.home | Teleport to your SkyBlock, and save your inventory. |
/island spawn | skybukkit.tp.spawn | Teleport to the main world, restoring your inventory. |
/island invite <player> | skybukkit.party.invite | Invite <player> to your SkyBlock, creating a party. |
/island kick <player> | skybukkit.party.kick | Kick <player> from your party. |
/island promote <player> | skybukkit.party.promote | Make <player> the party leader. |
/island accept | skybukkit.party.accept | Accept a pending invitation. |
/island decline | skybukkit.party.decline | Decline a pending inviation. |
/island leave | skybukkit.party.leave | Leave your current party. |
/island leader | skybukkit.party.leader | Display your party leader. |
/island members | skybukkit.party.members | Display your party's members. |
/island admin destroy <player> | skybukkit.admin.destroy | Destroy <player>'s SkyBlock. |
/island admin tp <player> | skybukkit.admin.tp | Teleport to <player>'s SkyBlock. |
/island help | N/A | Display this help message. |
Download
The latest plugin build can be downloaded here.
Latest Changes
Features
- More feedback towards players when using commands or playing
- Perform check when issuing /island home
- Resend Chunks When an Island is created/destroyed.
- Extreme Server Tick Lag. Do the "heavy-lifting" in a worker.
- Max Players per Party
- Configurable Items and Quantities
- Option to disable inventory management
- Added /is command alias
- Shortened all "/island party *" commands to just "/island *"
- Deny disallowed players entry
- /island world -> /island spawn
- Leave the sky when you use /island leave
- Go to the sky when you use /island accept
- Inform implicitly promoted players that they have been promoted
- Inform party members when a member leaves their party
- Inform promoted players that they have been promoted
Bug Fixes
- Enabled maven resource filtering for plugin.yml
- Removed super hacky cb refs
- Changed pom
- Fixed maven dependancies
- Fixed a fatal island creation bug
- Fixed an entity removal bug
- Fixed an island protection bug
- Fixed an island respawning bug
- Fixed another island respawning bug
- Fixed a island creation tick lag bug
- Fixed teleportation and other random bugs
- Fixed protection regions not being removed
- Save WG Regions
- Fixed syntax errors
- Fixed potential CCE
- Made config error messages more user-friendly
- Spelling error correction
- Fixed Deserialization NPE
- Fixed Island Un-Protection Exceptions
- Made party max sizes work
- Fixed another NPE
- Fix docs
- Fixed party commands
- Fixed NPE
- Fixed spelling
- Properly color player names
Planned Features
v1.0.0
SkyBukkit is in a preliminary phase, so please feel free to file a ticket for any feature requests you may have.
How Can I Help?
The plugin is developed solely by me in my free time so:
- If you are a developer would like to contribute to this project, or any of my other projects, please PM me or email me at [email protected].
- If you are a not developer but would still like to contribute somehow, please consider donating. Donations are highly valued and much appreciated.
About
Developer: Keeley Hoek (escortkeel)
How come when someone creates and island nobody in the server can talk or anything? Using latest v0.4.0 ver
How does the word generate or do i have to make one? And if so name it what?
Why doesn't the config generate for me?
I've notice something with the newest version v0.4.0
-/island help 1 it says /island tp sky and /island tp home which you change tp /island home and /island world which i think you know already.
-When you delete a island thats not in world but lets say skyblockworld it tps you to world and than skyblockworld in a blink of a eye, almost like when you delete the island you it moves you away to a different world for a sec and back for safety.
Some suggestions yet again xD
-Maybe change the commands Renamed /island home and /island world to /island join to /island leave, because im finding it very hard to get used to /island world and /island home. I know you just change the commands im sorry.
-Also I think You should add these things to config because when you do /island world it tps you to your last know world.
spawn-world: id
spawn-coords: ids
skyblock-world: id
Thanks For Your Time,
-GoldenWarrior
@mycraftnetwork
If you aren't running as Op on your server, then you'll have to setup some permissions for destroying the island (skybukkit.island.destroy)
If you are trying to delete the world with worldedit. FIrst you have to /world unload world then you can /world delete world
Just curious, why are you deleting the world? So far I haven't had the need to delete my world. Only the config files, to get a fresh start.
i am getting a bit of memory spikes with this plugin. Also when i destory an island and try and delete the world it dosent let me :/
@escortkeel
Worked like a charm :D
Any ideas why I lag when placing a dirt block? I haven't tried other blocks yet, I don't have any, but this is odd for my server. It doesn't lag in any other world.
I'm running with 8Gigs of Ram dedicated to the server. Solid state drive. 3.3GHz 6Core CPU.
@tuvazeock
Just change the "islandHeight" in your config. ;)
Now if only I can figure out how to spawn the island above or well below the clouds. Right now they are floating one block above my dirt :/
@dynamicdude
I've found that sometimes after you've been messing with things, it's best to just delete your skybukkit folder and let it generate a new one when you reload/restart your server.
Also, if you are using creative/fly mode and you have already used the command /island home. Then you fly to a new location ( the ground / Spawn area ) and use /island world. Skybukkit notes your last "home" location as being the ground or spawn you were just at.
So now when you use /island home, you will be taken back to the ground/spawn you were at, instead of your island.
This is again why after tinkering around, I just delete my skybukkit folder and start fresh. With no problems.
@escortkeel
the world im using has no land or anything it is just nothing but sky and a big black nothing below but it still messed it up
@dynamicdude
Yeah, thats the idea. See, when you destroy, the entire protected area is cleared of blocks. This isn't a problem when the world that you are using has no world generator though.
Skyblock is mean to be used like that ^ (in a world that is completely filled with void.)
~
Keeley@escortkeel
wow big problem when destroying island it messes up the world to the point when trying to warp to it it comes up error: hole in floor
@fazaro
All of your suggestions should be coming in v0.5.0! :D (I have already added the command renaming stuff though ;) )
~
Keeley@dynamicdude
Cool!
@escortkeel
ok trying it now let u know how it goes
@tuvazeock
@dynamicdude
@Housticka
@kwek20
@Theothecreator
Hey everyone! :D
I've just put version v0.4.0 out! Hoorah! :)
Enjoy,
Keeley :D
@tuvazeock
No problem! :D Thanks for your support too. ;)
I put out the super super alpha version of the plugin 2 days ago, there are a ton of bugs =/ but hopefully we can get rid of all of them ASAP. :D
Thanks again for your support,
Keeley :)
Thanks escortkeel for working so hard at this. I've looked around for a good skyblock plugin for muliplayer and I can't find another one that is still being supported.
It looks like you only have a few minor kinks to work out. In fact, I already had the island working before this next update you're about to release.
Notch did a great job at creating Minecraft, but it has been the independent developers who have really driven this thing to greatness.
Thanks again!
@escortkeel
Ok, I'm changing the tp commands to /island home and /island world