Home
Randomly generated islands in an endless ocean for Minecraft.
- Download CraftBukkit from: https://dl.bukkit.org/downloads/craftbukkit/
- NOTE: IslandCraft is currently compatible with all versions from 1.4.7 to 1.7.10
- Follow these instructions to set up your server: http://wiki.bukkit.org/Setting_up_a_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" with "world" in the config file 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 you're there 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 NORMALthen/mv tp world_islandcraft - For Multiworld use:
/mw create world_islandcraftthen/mw load world_islandcraftthen/mw goto world_islandcraft - Notice that you want to tell it 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 any of: "distribution", "island-size", "ocean-size" or "ocean-biome" 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-Core/IslandCraft-Core.db" and the folder "server/world_islandcraft". And then recreate the world using Multiverse or Multiworld. You can safely change the other parameters without needing to reset.
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: Specifies which world to enable IslandCraft on. You can change this to "world" if you want IslandCraft to replace the default world.
distribution: Specifies how islands are distributed in the world. There are currently 2 options:
com.github.hoqhuuep.islandcraft.core.HexagonalIslandDistributioncom.github.hoqhuuep.islandcraft.core.SquareIslandDistribution
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.
generator: The generator to use for generating the random islands. Currently there is only 1 option:
com.github.hoqhuuep.islandcraft.core.IslandGeneratorAlpha
If you're a plugin developer, you can make your own generators. Stay tuned for the documentation for the API.
ocean-biome: The biome to use between islands. 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: https://github.com/hoqhuuep/IslandCraft/blob/master/IslandCraft-Api/src/main/java/com/github/hoqhuuep/islandcraft/api/ICBiome.java
parameters: This section contains parameters which are passed to the island generator. When a new island is created one of the parameters in this section is randomly chosen based on the world seed. For now the parameters specify only 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 parameters specify only islands with related biomes, but you can mix them up any way you like. The names of the sections (e.g. `birch-forest) are not important, they just need to be unique, you can add as many sections as 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.
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.