== **CityWorld** ==
If you want to learn the latest on CityWorld: //[[http://dev.bukkit.org/server-mods/cityworld/pages/dev-blog-ish-thing/|Dev-Blog-Ish-Thing]]//

===== //Version 0.56// =====
(if the new version of the plugin isn't available in files, just wait a bit while it goes through the approval process)

This effort started life as a [[http://forums.bukkit.org/threads/edit-sec-admn-worldedit-4-6-world-editing-de-griefing-1000.62/|WorldEdit ]] [[http://forum.sk89q.com/threads/fab-a-city-fabulous.556/|script]] that got a little out of hand. After a number of requests I have decided to reboot the effort, this time as a true world generator. 

{{http://dev.bukkit.org/media/images/35/422/2011-11-07_18.02.36.jpg|CityWorld}}

Todo
Add command to level a city block
Rivers and bridges
Subway/elevated rail roads
Terrain under the city
Bring back rural blocks
Park benches and other furniture
Need to fix bugs in building roofs

v0.56
Added occasional crane on unfinished buildings
Hacked my way around a number of roof issues, still more that can be done
Added nav lights onto the tallest antenna on a building, if it has any

v0.55
Theming of city blocks (highrise, midrise, lowrise, big parks, etc.)
First pass of roofs (peaks, edges, antennas, air conditioners, etc.)

v0.54
West is North... I really hope I have this issue nailed this time
Rounded buildings and doors seem to be happy at last!
Added unfinished buildings, just to add variety

v0.53
Stairs and rounded buildings are happy again
Still working on rounded building problems (doors, overhangs and missing blocks due to differences in insets

v0.52
Rounded buildings are back but I still need to get doors and stairs working with them better
Doors and stairs now position themselves better
Started support for unfinished buildings

v0.51
Turned off rounded buildings... for now

v0.50
Added rounded buildings.. but there are loads of issues remaining to be dealt with

v0.40
Added cisterns and most of the tops of parks
Added the command "CityWorld", which will teleport you to (and create) "CityWorld"
Added stairs back in (they might be missing in some buildings but that is pretty rare)
Added doors (like stairs they might be missing in some buildings)
Manholes are more functional (ladders and doors are down there now)
Roundabouts now have fountains, "ART!" or a bit of both
Got BlockPopulators working
Cleaned up the code considerably

v0.3
Added sewers and plumbing
Added vaults
Added basements
Removed stairs (coming back in next release)
Better road layouts
Better building layouts

v0.2
There is still much to do, but it is good beginning. We now have a little bit of color. There are basements and stairs but no doors... doh!. Still much to do... including: parks (real ones not the silly ones I have now), cisterns, neighborhoods, parking structures, sewers, farms and DOORS!

=== Heads up! ===

I am not sure exactly what is causing this but right now when you teleport into a newly created CityWorld world the spawn is kinda goofed up and it will appear like you are falling through twinkling stars. Eventually things will stabilize and you will find yourself standing in the new world. I will fix this "issue" once I figure out what the heck is going on. If anyone can enlighten me as to what is happening I am happy to learn.

----
=== Installing ===

This is purely a world generator, it does not add permissions or options to configure. If you need permissions, teleportation or world management support there are plenty of plugins that will do that for you. The Bukkit plugin ecosystem does not need more of those puppies. This is JUST A WORLD GENERATOR. :-)

To install it you will need to do three things...
# **Download the plugin and place it in Bukkit's plugin folder.** If you don't know where or what Bukkit's plugin folder is, read [[http://wiki.bukkit.org/Setting_up_a_server|this]].
# **Now start up Minecraft Server via Bukkit.** If you don't know how to do this, I recommend rereading [[http://wiki.bukkit.org/Setting_up_a_server|this]]).

At this point, you are asking yourself: **How do I get to the city.** There are two options...
# 


One of two things will need to happen at this point...
If you modified your bukkit.org, you will either be in a CityWorld because you made the default world use the CityWorld world generator (mind you might have to walk to a region/chunk you haven't been to before to get the CityWorld chunk generator to kick in. Or if you set up Bukkit to create a new world using CityWorld, you will need to teleport to it. Pick your favorite multi-world teleport [[http://dev.bukkit.org/server-mods/?category=teleportation|plugin]] and transport yourself to the world you specified in bukkit.yml.

...On the other hand, if you are using a multi-world plug in like [[http://dev.bukkit.org/server-mods/multiverse-core/|Multiverse]] then you will need to look at it's documentation on how to create a new world using a custom world generator. Then teleport into it.

=== Modifying Bukkit.yml ===

If you don't want to add a bunch of plugins or just like keeping things REAL simple then you can leverage Bukkit's built in world management via modifying it's bukkit.yml. For whatever reason this file is pretty undocumented and I am not going to attempt to do so here. For our purposes we only need to make a small modification/addition to it. A word of warning about YML files, the reader for them is pretty darn fragile. If you use tabs or goof up the indenting Bukkit will likely quit working or complain a bunch when started. 

To modify the default world used by Minecraft/Bukkit make the following change/addition to bukkit.yml
<<code lua>>
worlds:
    world:
        generator: CityWorld
<</code>>

To add a new world, "parallel" to your default world add this (if there is already a "##worlds:##" section just skip the initial "##worlds:##" line)
<<code lua>>
worlds:
    thecity:
        generator: CityWorld
<</code>>
