Configuration

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

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

island-distribution: Specifies how islands are distributed in the world. There are currently 3 options:

• com.github.hoqhuuep.islandcraft.core.HexagonalIslandDistribution <island-size> <ocean-size> (islands arranged in a pattern such that each has 6 neighbors)
• com.github.hoqhuuep.islandcraft.core.SquareIslandDistribution <island-size> <ocean-size> (islands arranged in square rows and columns)
• com.github.hoqhuuep.islandcraft.core.EmptyIslandDistribution (no islands at all, you could use this to create a world with only one biome)

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

island-generators: List of generators to use for generating the new islands. Currently there are 2 options:

• com.github.hoqhuuep.islandcraft.core.ConstantIslandGenerator <biome> (big rectangle of single biome)
• com.github.hoqhuuep.islandcraft.core.IslandGeneratorAlpha <normal> <mountains> <hills> <hills-mountains> <forest> <forest-mountains> <outer-coast> <inner-coast> <river> (as seen in screenshots, rivers not yet implemented)

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.