HarryPotterSpells Logo

Harry Potter Spells

  • [v1.1.4] Server owners are recommended to rename their current config.yml and let HPS generate a new one before migrating the contents of their current config.yml to their new one


HarryPotterSpells is the ultimate Harry Potter plugin. Whether you run a Harry Potter server, want to add magic to an RP server, or just an admin looking for a bit of fun, this plugin is for you!

Many of these options are configurable. If you don't want parts of the plugin, open the config.yml with your favorite text editor and disable anything you don't want.


  • Provides a complete Harry Potter experience
  • Can be used on a HarryPotter server, an RPG server, or just to play around
  • Has over forty spells, with more in progress
  • Cast spells quickly with your magical wand (default: stick)
  • Teach users spells with simple commands


Cast spells with your magic wand (by default, a stick). Right-click to scroll through your available spells, and left-click to cast! Server operators can "teach" and "unteach" other players (and themselves) spells.

For spell documentation, see the Spells page on our site.

Commands and Permissions

For information regarding commands and permissions, see the Commands page on the site.


If your not sure how to setup your config or if your looking for a more detailed version of your config, see the Config page on the site.

Regarding Locale

Currently there are only two language options. We are looking for more translates and looking to branch HPS into more different languages Please message jacklin213 if you are interested

Supported Languages:

  • us-english
  • nl-dutch

Locale based Errors

As of 1.1.4 HPS will attempt to do the following steps automatically, in the case that it is not able to please follow the steps bellow Important: For anybody using a linux operating system please do the following steps to install HPS if you get locale based errors:

  1. Stop your server
  2. Download hps.rar
  3. Extract the locale folder directly into your HarryPotterSpells folder
  4. Start your server

The locale based errors should go away and the plugin should function like normal. If the problem still persists please read the support section bellow


If you find a bug, or have a feature request that is NOT on our Trello board (see below), feel free to open an issue on GitHub (click "Tickets" on the top bar). You can also join our IRC channel, #harrypotterspells on irc.esper.net.
For more information regarding support, see the Contact page on the HarryPotterSpells site.


The source is available on GitHub, and we are always looking for help. Pull requests are really appreciated! If you'd like to help, please go here.

Development Builds

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.

To Do

Our entire to-do list has been moved to Trello. Anyone can vote on issues/features they'd like to see implemented. If you'd like to add an item, hop on our IRC channel (see the support section) and someone will access will add it for you.

Future Plans

We plan to add an extension system to HarryPotterSpells, allowing server owners to add various HarryPotter- and magic-themed "addons" to the HarryPotterSpells core plugin. However, to prepare for this, we have removed all code not related to casting spells. This includes some of our old features: Spell signs, SortingHat, and hooking into WorldGuard, Towny, and LogBlock. These will be available as extensions in the near future.

Special Thanks and Credits

This plugin would not be what it is today without some of these people. I (NP98765) originally asked Kezz101 to help me create this, but soon it grew into a group project. Many have spent time and effort helping to develop this. Thanks to jacklin213 for taking this project on board and keeping it updated since 1.7.x

Some developers who have helped (In order of first pull request, most recent to earliest):
jacklin213, Ampayne2, MrBluebear3, zachooo, evilmidget83, korikisulda, RingOfStorms

Thanks to drtshock for hosting the Jenkins.

Interested in Helping?

See this forum post and the Contribution Guide for more details.

Feel free to send jacklin213 a PM and he will sort you out

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

  • Avatar of Goldentoenail Goldentoenail Aug 26, 2015 at 18:53 UTC - 0 likes


    How is it going, is there any movement on the fixes?

    I really would like to use this plugin as it is meant to be working.

  • Avatar of Goldentoenail Goldentoenail Aug 01, 2015 at 08:52 UTC - 0 likes

    @jacklin213: Go

    Yes the errors are the same with 1.8.3 in offline mode, also without internet connection.

    I made the cooldown.yml read only and that stopped the overwrite. But not the '/teach all me' from teaching removed spells.(bauleo and bubble head charm)

    However when I tried to change the config.yml wand type to a stick once more. HPS threw a console error upon server reload. HPS was trying to save YML files.

    Here are the 2 server logs that were made during testing.




    Ah I see, /teach all me. The Teach class accesses the Spell package to retrieve the spells to be taught. As these spells are hard coded, the YML's have no control over the /teach all command. This means that unwanted spells will be taught.

    How about a /teach allknown <Player> option? So that only the spells, which servers wish to be used are taught.

    We intend to use Vouchers (Written Books) for players to redeem with staff members, who will teach the required spell.

    Last edited Aug 01, 2015 by Goldentoenail
  • Avatar of jacklin213 jacklin213 Jul 31, 2015 at 12:44 UTC - 0 likes

    @Goldentoenail: Go

    Sorry do you mind seeing if this still happens in a server version 1.8.3

    And for the YML try editing it with your server offline.

    I will look into the wand being a different material causing problems when casting spells


  • Avatar of Goldentoenail Goldentoenail Jul 31, 2015 at 10:56 UTC - 0 likes

    Oh that did not work very well.

    '/teach all' lists ALL the spells and when I try to edit the YML's they auto update and overwrite my changes.

    Also I tried to change the wand to be a blaze_rod, however it appears to work until you try and cast a spell. (The wand recipe is working fine).

  • Avatar of Goldentoenail Goldentoenail Jul 28, 2015 at 17:59 UTC - 0 likes

    Hey thanks for the reply jacklin.

    I am having a few problems at the moment with 3 spells. Here is the info http://pastebin.com/kWwUV3PD I have tested with both Spigot and CraftBukkit 1.8.7 with similar results.

    I also tried to overcome the first 2 by using the config.yml, Boolean - spell-particle-toggle: true/false. which seems to have no affect on the errors.

    To remove these spells, can I just delete their info from the spells.yml?

    EDIT I negated their permissions for now..

    ps. It would be better not to spam the console when players change spells on their wand.

    Last edited Jul 29, 2015 by Goldentoenail
  • Avatar of jacklin213 jacklin213 Jul 28, 2015 at 00:19 UTC - 0 likes

    @Goldentoenail: Go

    SpellBooks currently only supports one spell: Time.

    I am currently changing spell books into an Extension and I'll be releasing it soon after finishing it/testing it.

    There are currently no official extensions yet.

  • Avatar of Goldentoenail Goldentoenail Jul 27, 2015 at 20:45 UTC - 0 likes

    How do I craft a spell book?

    I would like to be able for players to obtain a Spell Book that contains one spell. The Spell Book should then 'Teach' the spell to the player who has received the book.

    Does it work this way? I see spells-craftable: true in the config.yml

    and I see SpellBookRecipe in the Jar file.

    Oh, and where are the Extensions?

    Last edited Jul 27, 2015 by Goldentoenail
  • Avatar of jacklin213 jacklin213 Jul 02, 2015 at 04:49 UTC - 0 likes

    @SubZeroCro: Go

    Do you have an error in console of what is happening?

    Last edited Jul 02, 2015 by jacklin213
  • Avatar of SubZeroCro SubZeroCro Jun 30, 2015 at 15:53 UTC - 0 likes

    I get a bug: invalid probability I use cauldron pls help

  • Avatar of jacklin213 jacklin213 Jun 29, 2015 at 02:49 UTC - 0 likes

    @Demonkleenr: Go

    It shouldn't be doing that, try downloading the latest BETA build from our jenkins


Date created
Aug 04, 2012
Last update
Jun 05, 2015
Development stage
  • enUS
HarryPotterSpells Custom License
Curse link
Recent files