Options
Index of useful info
- Installation... Start Here!
- Options... (you are here)
- Styles...
- Schematics...
- Commands...
- Version info...
- Tools I used to make this...
- Copyright...
Options
A Config.yml file is generated when CityWorld first runs and each time it is told to create a new world. These options only affect "new generation", changing them after a world has been generated will produce some odd results.
I have tried to ensure these options all work together but the number of permutations are pretty large. Also some options are exclusive of other options, for example if you decide to not include buildings then asking for the buildings, that you have excluded, to be decayed doesn't make much sense.
Note: Here is what I normally do when creating a new world. It is a little awkward but it works for me.
- Startup your server and create the new world (via whatever technique you like), remember to read the Installation instructions, this will make CityWorld generate the associated configuration section in plugins/CityWorld/config.yml.
- Next I shut down the server go change those newly created settings to what I really want the world to be like.
- Then I delete the previously created world and restart my server. If all goes well the newly created world should be regenerated but now using those new options I picked.
If you are wanting to create a particular world style, like floating, take a look at the Installation instructions. Note: that certain world styles will turn off/on some of the options listed below.
Observations:
- If you regenerate the world using the same version, options and seed (how you set this depends on your multiverse manager works), you should get a nearly identical world, where only foliage might change. Keep in mind when there is a CityWorld version change, all bets are off though. Similar seeds might/will generated wholly new worlds.
- Two worlds with the same seed but slightly different options very well could create very similar worlds. For example, assuming the seed and all other options are the same, two worlds only differing in the inclusion of the IncludeDecayedBuildings option will create two parallel worlds: One normal, one destroyed.
- If you generate a new world there might not be a city nearby (or mountains, or seas, etc.). That is the nature of Random. If you don't like what you get, trash the world and generate a new one (with a different seed). Keep in mind though, the city of your dreams might be just on the other side of that mountain so go forth and explore!
- Except where otherwise stated, all options default to true and simply control the inclusion or exclusion of a certain feature or not.
Man made features
Option | Description |
---|---|
IncludeRoads | Generate roads |
IncludeRoundabouts | If roads are generated, then optionally generate roundabouts |
IncludeSewers | If roads are generated, then generate a maze of sewers under them |
IncludeBuildings | Generate buildings |
IncludeBasements | If buildings are generated, then optionally generate basements |
IncludeHouses | Generate houses |
IncludeFarms | Generate farms |
IncludeCisterns | if buildings are generated, then generate cisterns under the parks |
IncludeMines | Generate maze of mine shafts underground |
IncludeBunkers | Generate something somewhere... It is a secret |
Natural features
Option | Description |
---|---|
IncludeSeas | Generate sea basins between the mountains and cities |
IncludeMountains | Generate mountainous bumps between the seas and cities |
IncludeLavaFields | Include lava pools way down below |
IncludeCaves | Hollow out caves in the ground |
IncludeOres | Randomly place ores underground |
IncludeBones | Randomly place fossils underground and in museums |
Trick or Treat
Option | Description |
---|---|
SpawnersInSewers | If there are sewers then include spawners in them |
SpawnersInMines | If there are mines then include spawners in them |
SpawnersInBunkers | If there are bunkers then include spawners in them |
TreasuresInSewers | If there are sewers then include treasure chests in them |
TreasuresInMines | If there are mines then include treasure chests in them |
TreasuresInBunkers | If there are bunkers then include treasure chests in them |
Modifiers
Option | Description | Default |
---|---|---|
IncludeUndergroundFluids | If ores are generated, then generate water and lava as well | true |
IncludeAbovegroundFluids | If sea basins are generated, then generate water in them | true |
IncludeWorkingLights | Where lights are made, try to make sure the generate light | true |
IncludeNamedRoads | If roads are generated, add road signs to the intersections | true |
IncludeDecayedRoads | If roads are generated, destroy them a little | false |
IncludeDecayedBuildings | If buildings are generated, destroy them a little | false |
IncludeDecayedNature | Where nature is generated, destroy it a little. This will also force all biomes to be Desert | false |
IncludeBuildingInteriors | Put stuff inside of buildings | true |
ForceLoadWorldEdit | Ignores WorldEdit version numbers | false |
BroadcastSpecialPlaces | WriteOut the location of each special structure as it generates | false |
Option | Description | Default | Values |
---|---|---|---|
TreeStyle | Specifies how trees generate | NORMAL | NORMAL, SPOOKY, CRYSTAL |
SubSurfaceStyle | Specifies what gets generated below a floating CityWorld | LAND | NONE, LAND, CLOUD, LAVA |
Note: Some of the above options will default a different way in worlds generated in the Nether or The_End.
Generation Range
Option | Description |
---|---|
ConstructChunkRadius | How far do isolated construct chunks generate (oil platforms, radio towers, shacks, etc.), in chunks from the world's center point) |
RoadChunkRadius | How far do roads chunks generate, in chunks from the world's center point |
CityChunkRadius | How far do cities chunks generate, in chunks from the world's center point |
CenterPointOfChunkRadiusX | Where is the center point of the above options, defaults to 0 |
CenterPointOfChunkRadiusZ | Where is the center point of the above options, defaults to 0 |
BuildOutsideRadius | Generates things outside a circle of nature, instead of the other way around (totally inverts all the range limits logic) |
Note: If the road radius is larger than the city radius, the roads generate without lights, lines, sewers, etc.
In the above picture the inner circle, centered on world's 0,0, represents the CityChunkRadius (in this case 10 chunks), the outer ring shows the RoadChunkRadius (20 chunks).
Note: that the bridges and tunnels will stop generating abruptly when they hit the road radius specified.
Material Generation
Option | Description |
---|---|
Random_Materials_For_Bunker_Chests | List of items that can be in a bunker's chest, a random subset will be used |
Random_Materials_For_Mine_Chests | List of items that can be in a mine's chest, a random subset will be used |
Random_Materials_For_Sewer_Chests | List of items that can be in a sewer's chest, a random subset will be used |
Random_Materials_For_Storage_Shed_Chests | List of items that can be in a storage shed's chest, a random subset will be used |
Random_Materials_For_Farm_Chests | List of items that can be in a farm's chest, a random subset will be used |
Random_Materials_For_Farm_Output_Chests | List of items that can be in a farm's output chest, a random subset will be used |
Random_Materials_For_Lumber_Chests | List of items that can be in a lumber yard's chest, a random subset will be used |
Random_Materials_For_Lumber_Output_Chests | List of items that can be in a lumber yard's output chest, a random subset will be used |
Random_Materials_For_Quary_Chests | List of items that can be in a quary's chest, a random subset will be used |
Random_Materials_For_Quary_Output_Chests | List of items that can be in a quary's output chest, a random subset will be used |
Option | Description |
---|---|
Materials_For_BuildingWalls | List of materials that can be used to make a building's wall, a random material from this list will be used |
Materials_For_BuildingCeilings | List of materials that can be used to make a building's ceilings, a random material from this list will be used |
Materials_For_BuildingRoofs | List of materials that can be used to make a building's roofs, a random material from this list will be used |
Materials_For_UnfinishedBuildings | List of materials that can be used to make a unfinished building's cross beams, a random material from this list will be used |
Materials_For_HouseWalls | List of materials that can be used to make a house's wall, a random material from this list will be used |
Materials_For_HouseFloors | List of materials that can be used to make a house's floor, a random material from this list will be used |
Materials_For_HouseCeilings | List of materials that can be used to make a house's ceiling, a random material from this list will be used |
Materials_For_HouseRoofs | List of materials that can be used to make a house's roof, a random material from this list will be used |
Materials_For_ShackWalls | List of materials that can be used to make a shack's wall, a random material from this list will be used |
Materials_For_ShackRoofs | List of materials that can be used to make a shack's roof, a random material from this list will be used |
Materials_For_ShedWalls | List of materials that can be used to make a shet's wall, a random material from this list will be used |
Materials_For_ShedRoofs | List of materials that can be used to make a shed's roof, a random material from this list will be used |
Materials_For_QuaryPiles | List of materials that can be used to make a quary's pile, a random material from this list will be sprinkled in |
Materials_For_Castles | List of materials that can be used to make a castle, a random material from this list will be used |
Option | Description |
---|---|
Materials_List_For_MazeWalls | Ordered list of materials that will be used to make the mazes |
Materials_List_For_Roads | Ordered list of materials that will be used to make the roads |
Materials_List_For_NormalOres | Ordered list of materials that will be sprinkled in the ground |
Materials_List_For_NetherOres | Ordered list of materials that will be sprinkled in the ground |
Materials_List_For_TheEndOres | Ordered list of materials that will be sprinkled in the ground |
If you want to reset one of the above lists back to its default, simply remove it from the configuration file and the defaults will be written back out.
Deprecated options
Option | Workaround |
---|---|
IncludeWoolRoads | CityWorld now uses stained clay and quartz for roads |
IncludePavedRoads | See deprecated note for IncludeWoolRoads |
RoadRange | Use RoadChunkRadius instead |
CityRange | Use CityChunkRadius instead |
IncludeTekkitMaterials | Generating Tekkit materials removed as of 3.0 |
ForceLoadTekkit | Tekkit support removed as of 3.0 |
IncludeFloatingSubsurface | Use SubSurfaceStyle instead |