Curse

MagicSpells is a plugin that creates spells your players can use. Its main purpose is to give your players access to certain abilities that you might not want to give them unlimited access to. Each spell can be assigned customized reagent (item) costs, cooldowns. durations, ranges, and so on. Spells can be cast by using the /cast command, swinging a wand, or both. It's all customizable.

Confirmed Issues in Minecraft 1.2

• The minion spell will currently cause a lot of errors. It is recommended to disable it until this is fixed.

Manual

I've been working on a manual for this plugin. A lot of the information there is duplicated from here, but there is other information as well.

http://nisovin.com/magicspells/

Download

• Current Version (2.6) [1.2.4-R0]
• Default Config
• Previous Versions (Older)
• Development Builds
• Source

Usage

Spells can be cast either by using the /cast command or by using a wand item. To cast a spell, a player must first know the spell. Server operators know all spells by default. They can teach spells to other players by using the teach spell. For example, to teach bob the blink spell, an operator would type: /cast teach bob blink.

Bob can now use the blink spell. He can either cast it by command, by typing /cast blink, or he can cast it with a wand item. To select the spell, he holds the wand in his hand and right clicks. Right clicking will cycle through any spells assigned to the item he is holding. When he has the one he wants, he left clicks to cast.

If Bob does not have the required reagents for the spell, or if he has cast it recently and it is still on cooldown, he will not be able to cast the spell and will instead receive an error message.

If mana is enabled, a player can use the /mana command to see how much mana they currently have.

Spells

You can see a list of all of the spells currently available by viewing the Spell List page.

Configuration

The zip file contains a config.yml file that should go into the MagicSpells folder within your plugins directory. The default configuration has appropriate spell costs, durations, and messages for each spell. However, you will most likely want to customize this to fit your server.

You can modify the config.yml file directly, or you can choose to leave it intact and instead create an alternate config file, by default altConfig.yml. Any configuration values in this alternate file will override the values in the main config file.

To reload the configuration, simply cast the fake reload spell (/cast reload). Only server operators can do this (it can also be done from the command line).

• General Configuration Options - Options that affect the plugin in general
• Spell Configuration Options - Options that affect spells
• Spell Copies - Create copies of spells with different configurations
• Multi Spells - Create spells that combine multiple spell effects
• No-Magic Zones - Set up zones that prevent spells from being cast

Permissions

The ability for players to learn and cast spells can be fully configured using the available permissions nodes. You can use any permissions management plugin that supports Bukkit's built-in system. The permission management plugins currently available are PermissionsBukkit, and bPermissions, PermissionsEx (note that PermissionsEx doesn't seem to support temporary permissions, which can cause issues if you want to use that feature for external command spells).

I recommend bPermissions, since it seems to be the best-implemented permission plugin of the ones currently available.

I've also started a permissions plugin of my own, called YAPP. It is intended to be really powerful, yet fairly simple to use. It is still a work in progress, but it should work fine. If you find any problems with it, please send me a pm.

Addons

There are a couple addons available for MagicSpells. They are separate plugins, but are built for MagicSpells and rely on it to work.

MagicSpellsCastModifiers

This is an addon that allows you to modify when spell casting can occur and somewhat how it works. For example, you can restrict certain spells to only be cast at night, or while standing on a certain block. You can also make spells more powerful during the full moon. There are many possibilities.

MagicSpellsMemory

This is an addon that adds memory limitations to players. Spells can be configured to have a memory requirement, and players can be limited to a certain amount of memory. This makes it so you can limit players to having only a certain number of spells. To read more and download it, go here.

MagicSpellsShop

This is an addon that allows you to set up sign-based shops that sell spells. To read more and download it, go here.

MagicSpellsTowny

This addon makes the MagicSpells plugin respect towns from the Towny plugin. If PVP is disabled in a town, players will not be able to target other players in that town. Also, it includes a spell blacklist that will completely prevent those spells from being cast while in a town.

OceManaBar

This is an addon developed by oceanor that uses Spout to display a mana bar meter in the game. You can read more and download it here.

Frequently Asked Questions

Help me! Why isn't it working?

If - after reading through the information available on this website - you can't figure out why something isn't working, please take the time to submit a proper help request. You can post your request either on the Bukkit Forums thread or in the MagicSpells forum. You should provide the following information:

• The CraftBukkit version you're using.
• The MagicSpells version you're using.
• Which permissions plugin (if any) you are using.
• The error in the console, if there is one.
• Your config file(s). Please don't put them directly into the post, use a service like http://pastebin.com and just post the link here.

It says I need reagents whenever I cast a spell! Where do I get reagents?

One of the main ideas behind this plugin is to give players cool abilities, but with a cost. The reagents are the spell's cost. This can be configured in the config.yml file individually for every spell. The config option name is "cost". You can also add your name to the list of exceptions in the general.cast-for-free option.

Why can't my players cast spells? Why does it say "You cannot cast that spell right now" when I try to cast any spell?

Please make sure your permissions are all set up correctly. Look in the Configuration: Permissions section for more information. This is usually caused when you are missing magicspells.cast permissions.

I have a great spell idea! Will you add it?

Please tell me about it by submitting a ticket! I can't guarantee that I'll make it, but if it's a feasible idea, I'll definitely consider it. I'm always looking for new spell ideas. Note that I may not respond directly to your idea, but I always read the suggestions.

I know some Java, can I write my own spells?

Yes, you can! Please look at this custom spell creation guide to learn how.

I've found a bug! What do I do?

Please submit a ticket! Please include your CraftBukkit build number, any error in the console, the situation that caused the error (if known), and if you think it's applicable, the list of plugins you use.

Recent Changes

You can also view the complete change log.

Version 2.7 (May 18) [1.2.5-R2.0]

• New spells: Levitate, Armor, Tree, Silence, AreaEffect
• New graphical effects: itemspray, hearts, nova
• Added the incantations option to all spells, which is a list of chat messages that will trigger the spell
• The Projectile spell can now use any item as a projectile
• Spells can now be bound to multiple cast items instead of just one at a time
• Added require-cast-item-on-command option for spells (forces player to be holding the cast item even if using the /cast command)
• Added Residence support for no-magic zones
• Added show-mana-on-experience-bar and show-mana-on-hunger-bar options
• Added add-fire option to the Explode spell
• Added allowed-pass-thru-blocks to phase spell
• Added remove-scroll-when-depleted option to scroll spell
• API changes: Improved the ManaChangeEvent and added SpellSelectionChangedEvent
• Various bug fixes