-
Notifications
You must be signed in to change notification settings - Fork 14
Home
Changes the biome distribution of the world to create an ocean with islands.
- Download CraftBukkit from here
- NOTE: IslandCraft is currently compatible with all versions from 1.4.7 to 1.7.10
- Follow these instructions to set up your server
- Place the IslandCraft JAR file in your plugins folder
- Place either Multiverse or Multiworld in your plugins folder (or you can replace
world_islandcraft
withworld
in config.yml when you get to that step below to make IslandCraft replace the default world). - Run the server once to allow IslandCraft to extract it's configuration files
- While it's running, give yourself OP with
op <yourname>
in the console - Stop the server again
- Follow the steps in the Configuration section below to configure IslandCraft to your liking
- Start the server again and create your world using Multiverse or Multiworld
- For Multiverse use:
/mv create world_islandcraft NORMAL
then/mv tp world_islandcraft
- For Multiworld use:
/mw create world_islandcraft
then/mw load world_islandcraft
then/mw goto world_islandcraft
- Notice that you want to tell Multiverse to use the vanilla generator. IslandCraft will automatically hack itself in as the generator when the world is created. This is because IslandCraft only modifies the biome distribution but otherwise uses the vanilla generator.
IMPORTANT: After changing "ocean" or "island-distribution" you must reset your IslandCraft world. So make sure you get these right before spending much time playing on the world. To reset the IslandCraft world, you need to delete the file "server/plugins/IslandCraft/IslandCraft.db" and the folder "server/world_islandcraft". And then recreate the world using Multiverse or Multiworld. You can safely add/remove/modify the "island-generators" without needing to reset your world. Islands which have already been generated or partially generated will continue to use whatever settings you had when they were created. Islands in newly explored chunks will adopt the new settings.
config-version
: Specifies which version of the config format is being used. Do not change this value.
worlds
: You can add extra sections to this if you want to enable IslandCraft on multiple worlds.
world_islandcraft
: Name of the world to enable IslandCraft on. You can change this to "world" if you want IslandCraft to replace the default world.
ocean
: Specifies how the ocean should be generated. There is currently only 1 option:
com.github.hoqhuuep.islandcraft.core.ConstantBiomeDistribution <biome>
<biome>
: The biome to use. Doesn't actually have to be an ocean biome, you could use DESERT for example. If you're using an earlier version of Minecraft than 1.7 you will want to change this to OCEAN
as DEEP_OCEAN
does not exist. Available biome names can be seen here
island-distribution
: Specifies how islands are distributed in the world. There are currently 2 options:
com.github.hoqhuuep.islandcraft.core.HexagonalIslandDistribution <island-size> <ocean-size>
com.github.hoqhuuep.islandcraft.core.SquareIslandDistribution <island-size> <ocean-size>
com.github.hoqhuuep.islandcraft.core.EmptyIslandDistribution
If you're a plugin developer, you can make your own distributions. Stay tuned for the documentation for the API.
<island-size>
: The width and length of each island's region in blocks. Must be a positive multiple of 32. Note that each island contains some ocean within its region so the actual islands will be slightly smaller, this is just an upper bound.
<ocean-size>
: The width of the section of ocean between islands. Must be a positive multiple of 32. Note that each island contains some ocean within its region so the actual ocean will be slightly larger, this is just a lower bound.
island-generators
: List of generators to use for generating the new islands. Currently there are 2 options:
com.github.hoqhuuep.islandcraft.core.ConstantIslandGenerator <biome>
com.github.hoqhuuep.islandcraft.core.IslandGeneratorAlpha <normal> <mountains> <hills> <hills-mountains> <forest> <forest-mountains> <outer-coast> <inner-coast> <river>
When a new island is created one of the generators in this section is randomly chosen based on the world seed. For now the parameters specify which biomes should be used to generate the island. If you don't know what to put for any value just use ~
, this will tell the generator to use a default value, for example if you use ~
for hills
it will just use the normal
value instead. The default config.yml specifies only islands with related biomes, but you can mix them up any way you like. If you are using an earlier version of Minecraft than 1.7 you will want to remove biomes which did not exist then.
If you're a plugin developer, you can make your own generators. Stay tuned for the documentation for the API.
IslandCraft has no commands.
While in alpha, IslandCraft included some chat and other miscellaneous features. These have all been removed as there are other plugins you can use for this purpose. Going forward, IslandCraft will have a much narrower feature set focusing on just the islands.
The RealEstate features (including Vault, WorldGuard and Dynmap integration) will be making a return in a new separate plugin. Separating these from the terrain generation provides a number of benefits. It helps me to keep them on separate release cycles, so I can release updates for the terrain generation very quickly as new versions come out. It has forced me to create an API so the plugins can cooperate, this will also allow others to make plugins which integrate with IslandCraft.