Home

Introduction

MagicWorlds was born from Magic's chest populator. It is now a stand-alone plugin with some powerful world modification features that you can use to create customized alternate realities on your own server.

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Bugs, Features, Issues

Please use our issue tracker for all bug reports, issues, feature requests, etc. It is searchable, so you can see if your problem is already known, or maybe your idea already had :) Installing

MagicWorlds requires either Magic or MagicLib to function. If Magic is present, MagicWorlds will also be able to cast spells and create wands. The entity and block replacement functionality can still be used if only MagicLib is present. Do not install both MagicLib and Magic, they are redundant and may conflict with one another!

Configuration

No configuration is required, though the plugin is extremely customizable. It can be simply dropped into your plugins folder to start finding wands in chests!

See the default configuration to get an idea of what the plugin will do if left uncustomized:

https://raw.githubusercontent.com/elBukkit/MagicWorlds/master/src/main/resources/config.yml

If the Magic plugin is not present, the default configuration of MagicWorlds will do nothing.

Customized Worlds

A MagicWorld can be customized in the following ways:

• Magic Wands added to naturally-spawned chests at random
• Override entity spawning (replace types)
• Override normal chunk generation (replace blocks)

Using this plugin for a customized world may cause additional server lag on chunk generation, you've been warned! This will hopefully be resolved by 1.0.

This plugin is *not* meant to be yet another world generator. The idea with the block replacement is a very specific one- to create a "parallel" world for use with the Phase spell. This world would have the same seed as the Overworld, but look very different (though the terrain is still recognizeable).

Commands and Permissions

This plugin currently has only one command, "magicw load", to reload the configuration. The permissions is op-only by default, and the pnode is "Magic.commands.magicw.load".

Configuration

See here for "The Other Side" setup:

https://github.com/elBukkit/MagicWorlds/tree/master/src/main/resources/examples/otherside

When combined with a custom version of the Phase spell:

https://raw.githubusercontent.com/elBukkit/MagicWorlds/master/src/main/resources/examples/otherside/magic/spells/otherside_phase.yml

MagicWorlds will give players a strange, alternate dimension to travel to. Using the same seed for both the normal and "other" world creates a cool effect when traveling back and forth:

Metrics Collection

{{http://mcstats.org/signature/magicworlds.png|MagicWorlds Metrics}}

This plugin uses Hidendra's plugin metrics system. The information sent to mcstats.org is completely anonymous, publicly viewable, and includes the following metrics:

• A unique identifier
• The server's version of Java
• Whether the server is in offline or online mode
• The plugin's version
• The server's version
• The OS version/name and architecture
• The core count for the CPU
• The number of players online
• The Metrics version

Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true, or by editing this plugin's config.yml and changing "metrics_level" to 0.

Changelog

Full changelog can be viewed here