Logo by Sy_Gibbon

MagicSpells is a Minecraft Bukkit plugin that creates magic 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. However, instead of just giving them access to boring commands, they instead get more interesting spells. Each spell can be configured in many ways:

  • Reagent costs (the cost of using the spell, including items, mana, health, hunger, experience, and item durability)
  • Cooldowns (the amount of time a player must wait between uses)
  • Durations (how long certain effects last)
  • Ranges (how far away spells can be used from their target)
  • Many more options, depending on the spell

Spells can be cast by using the /cast command, swinging a configurable wand item, or both. It's also possible to have them triggered from other actions the player may take. It's all customizable.


Before a player can cast a spell, they must already know it. There are several ways a player can learn a spell:

  • Taught with the teach spell
  • Learned from a spellbook
  • Learned from a tome
  • Gained from a grant permission
  • Purchased from a shop
  • Being a server op (they know all spells) For example, a server op can teach Bob the blink spell by typing: ''/cast teach bob blink''.

Once a spell is learned, it can be cast either by using the ''/cast'' command or by using a wand item. Now that Bob knows 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. Mana can also be configured so it is displayed on the experience bar.

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 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 and just post the link here.

But I need help urgently!

You can try joining the IRC channel #magicspells on EsperNet.

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 give yourself the magicspells.noreagents permission node.

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 at the permission page for more information. This is usually caused when you are missing magicspells.cast permissions.

Why can't I target players with spells?

There are two main reasons this occurs. Most targetable spells have a target-players option that usually defaults to false. You will need to change this to true to be able to target players with spells. Also make sure your players don't have the magicspells.notarget permission node.

Why don't temporary permissions work with WorldEdit/WorldGuard/CommandBook?

Open the wepif.yml file in your server's root folder. In the section under resolvers, remove all of the entries except DinnerPermsResolver. Then restart your server and see if it works now.

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

Please tell me about it by posting in the spell request forum! 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.


Upcoming Changes

Coming in version 3.0:

Recent Changes

View the complete change log.

Questions and Comments

You are welcome to post comments here, but if you would like to ask a question or have any kind of discussion, I would prefer if you post on the MagicSpells forums. It is easier to keep track of posts and discussions there.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Sashy_Eliz Sashy_Eliz Oct 06, 2016 at 21:30 UTC - 0 likes

    berserk: upgrade_required_casts: 15 upgrade_required_path: student name: Ironskin icon: iron_block:116 icon_url: category: master tags: noduel worth: 100 earns_sp: 5 actions: cast: - class: PotionEffect effects: cast: - class: EffectSingle sound: magic.vanish - class: EffectTrail particle: smoke_normal - class: EffectRing particle: smoke_normal location: target parameters: target: self duration: 5000 cooldown: 0 effect_strength: 1 costs: mana: 50

    Why isnt this working? I can use effect_(whatever potion effect) and it will work but it doesn't like strength :/

  • Avatar of ndarwinnero ndarwinnero Oct 03, 2016 at 17:54 UTC - 0 likes

    We had been married for a while and things were OK, I was in love with her, she was crazy about me, but later on everything changed and by complicated exterior circumstances which did not have to do with us, we decided to pause for a while, but still remain friends. But in the end, she started getting cold: she treated me as if she did not know me, she acted too immature to the point where she did not even say hi to me when we bumped into each other (we had the same circle of friends). Of course, it hurt so badly, I wanted to kill her. Then out of nowhere she disappeared. I wrote her for her birthday and she replied little. Some of my “friends” saw she had left and started going cold with me too, as if it was my fault that she had left. The few that were still my close friends and still hers, told me she had moved on, that it was best not to make contact with her. Then out of the blue some months later she reappeared, but still acting like a douche. I was suffering emotionally of course, because we had never even had a divorce, it was just supposed to be a pause, so I did not know how to react, what to feel, what to do… anyway, she kept coming over and over on the weekends, and I had to deal with my “friends” who the moment they saw her, immediately left me and went over to her. Eventually, I decided to give up trying to restore anything with her as she was showing no signs of wanting me back, and started healing. Around four months after we had ended our relationship, I find out she is with another guy! That’s when I knew I had not gotten over her, because I cried, I was mad, it was just a feeling of “oh, poor me”. I could not stand losing her to some other guy, I decided to go diabolical (i.e. via spell). I got involved with a lot of fraudulent so-called spell casters on the internet who ripped me off my money without getting a result as to what I wanted. I almost lost my sanity. Just as I almost was giving up, one faithful morning, I received a mail from one of the spell castes I had applied for spell with but never got a reply all along. He made me to understand that he could not attend to all his costumers then because it was that time of the year for his annual fellowship with his ancestors for the renewal of his spiritual and supernatural gift. I told him not to worry about the spell anymore, that I was done with all of them fake spell casters. He assured me of his 100% genuine work of this gift which he possessed. I decided to give it a try. After spending about 2500 USD (which was due to my inability to provide a whole lot of materials which he needed for the spell process), I am happy to announce to the world that I have gotten back my wife and we are expecting our first baby. All thanks to Dr. Kene Dilli. All you out there tired of all these fraudsters that call themselves spell casters (seeking to rip were they have not sown) and you require legitimate spell for whatsoever purpose, contact Dr. Kene Dilli on his email address; kenedillitemples AT yahoo DOT com.RE-WRITE THE EMAIL ADDRESS IN IT’S STANDARD FORM.

  • Avatar of jacobems jacobems Jul 14, 2016 at 17:11 UTC - 0 likes
    Does anyone by chance have a version of this compatible with beta 1.7? XD

    I know that's unlikely but it's worth an ask. ======

    EDIT: Ignore my stupidity. I forgot there were multiple version pages. >.<

    Last edited Jul 14, 2016 by jacobems
  • Avatar of tcarey2015 tcarey2015 Jul 06, 2016 at 15:36 UTC - 0 likes

    Since nisovin has been away, I will post this here. There is a forked version compatible with 1.10. Just read the magicspells forums to find it. magicspells teams is being worked on.

  • Avatar of NikeWade1006 NikeWade1006 Jun 28, 2016 at 05:31 UTC - 0 likes

    Okay, sorry for all of my comments below.. I seem to have overlooked the forums page. Stupid mistake.. I still love the plugin <3

  • Avatar of NikeWade1006 NikeWade1006 Jun 26, 2016 at 20:00 UTC - 0 likes

    Update.. the magicspells teams does work.. Just the wiki is really sad and hard to use :c

  • Avatar of NikeWade1006 NikeWade1006 Jun 26, 2016 at 18:36 UTC - 0 likes

    annnnd. The magicspellsteams will not work. That's all I can say.. I've tried everything and it just doesn't work. Please fix these things as they are halting my server :c

  • Avatar of NikeWade1006 NikeWade1006 Jun 26, 2016 at 02:09 UTC - 0 likes

    Also explode spell.. is just broken xD.. The add fire doesnt work and its basically an insta kill even with damage multiplayer 1

  • Avatar of NikeWade1006 NikeWade1006 Jun 26, 2016 at 02:03 UTC - 0 likes

    Explode spells prevent block damage doesnt work... Figured this out the hard way lol.

  • Avatar of NikeWade1006 NikeWade1006 Jun 25, 2016 at 03:04 UTC - 0 likes

    Please fix the spell effects. They are glitchy, work maybe 10% of the time and the wiki doesn't really explain them. Also the modifier give damage doesn't work.


Date created
Aug 25, 2011
Last update
May 27, 2014
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: v3.3 for CB 1.7.9-R0.1 May 27, 2014
  • R: v3.1 for CB 1.7.2-R0.2 Jan 24, 2014
  • B: v3.0-b6 for CB 1.6.4-R1.0 Oct 24, 2013
  • B: v3.0-b5 for 1.6.4 Oct 01, 2013
  • B: v3.0-b4 for CB 1.6.2-R1.0 Sep 20, 2013



Optional dependency