-
Notifications
You must be signed in to change notification settings - Fork 14
Home
Randomly generated islands in an endless ocean for Minecraft.
TODO
- 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
- Run the server once to allow IslandCraft to extract it's configuration files
- Stop the server again
- Follow the steps in the Configuration section below to configure IslandCraft to your liking
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.IslandGeneratorAlphaIf 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. 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.
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.