Bukkit

As you might know, v2 totally changes the way bSpace handles world loading & creating. The plugin will no longer generate the worlds itself, which means it requires you to use a world manager or bukkit.yml to create spaceworlds.

Note: Bukkit.yml can be used ONLY when you want a space world to be the default world. It does NOT generate worlds unless it is the default.

But then we won't have awesome features!

You will. Now every time you use a world manager or bukkit.yml to generate a space world, the getDefaultWorldGenerator-method will add the world to the list of space worlds. This way every single space world will have the awesome features bSpace has to offer! No matter what the world manager, space worlds will work nicely. Sure we could also leave teleporting to them to the world managers, but we have people using bukkit.yml as well.

What are IDs?

IDs are a new way of modifying space world settings. Here are some quick features:

• 1 ID can be used with many space worlds
• Only define settings, name is up to you
• Just as easy to modify as the old worlds

If you take a dive into the default ids.yml file, you will notice there is an example ID already, but commented out. That is the default one that will be used if you specify an invalid or no ID at all. It has the exact same default settings as the old default world. So now that you know what IDs really are, I can show you an example ID:

ids:
   awesome:
        # World generation options
        generation:
            generateplanets: true
            generateasteroids: true
            generatesatellites: true
            generatefloor: true
            # If this is true, bSpace will look for schematics in plugins/bSpace/schematics! These will be used in world generation.
            generateschematics: true
            # From 1-200. These can be turned off with the generateasteroids-setting.
            glowstonechance: 12
            stonechance: 20
            # From 1-1337. This can be turned off with the generatesatellites-setting.
            satellitechance: 4
            # From 1-200. This can be turned off with the generateschematics-setting.
            schematicchance: 5
        # Spacesuit options
        suit:
            required: false
        # Spacehelmet options
        helmet:
            required: false
        # Breathing area options (the higher this is, the higher a "breathable" area can be.
        maxroomheight: 5
        # Miscellaneous options
        weather: true
        alwaysnight: true
        neutralmobs: true
        hostilemobs: false

NOTE: For the most up-to-date configuration file examples see Configuration.

So how do I use IDs when creating a space world?

Simple! You just make sure the ID is in the ids.yml-file and then use your favorite world manager or bukkit.yml, and where you would usually add a generator id, you put the name of the ID you want to use. Remember: If it's invalid, we'll make it use default settings! For example, if you wanted to use an ID called 'awesome', and create the world with Multiverse2, this is how: /mv create [NAME] [ENVIRONMENT] -g bSpace:awesome

It's that easy! Hopefully you now know a little bit about IDs and how they work!