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 Oct 15, 2015 at 08:48 UTC - 0 likes

    For anyone having difficulty using the permissions.

    Here is an example of how I used the HP permission nodes with PermissionsEx.


    The Admin should use - /teach all me - To learn all of the HP spells and then the Admin would 'teach' the Mod, They can teach the Apprentice and the Magician. The Mod and the Magician can only teach the spells they have been taught.

    For further information see the Commands page as linked in the description 'Commands and Permissions' section above.

    Last edited Oct 19, 2015 by Goldentoenail
  • Avatar of AccioJennifer AccioJennifer Sep 29, 2015 at 12:51 UTC - 0 likes

    @jacklin213: Go

    Like when I try to teach myself a spell, it says "I cannot teach AccioJennifer (spell) because I do not know it." and same goes for when I try to teach a player a spell. I tried the teach all command like I saw in a few videos but it just spammed the chat with that same message all over again.

  • Avatar of jacklin213 jacklin213 Sep 29, 2015 at 11:35 UTC - 0 likes

    @AccioJennifer: Go

    So when u teach yourself a spell, and u try to teach that spell to another person does it say something like "I cannot teach (player) (spell) as you do not know it."


  • Avatar of AccioJennifer AccioJennifer Sep 28, 2015 at 20:04 UTC - 0 likes

    @jacklin213: Go

    Hm. I don't have the permission node. I've tried teaching myself the spells but it says the same thing.

  • Avatar of jacklin213 jacklin213 Sep 28, 2015 at 02:29 UTC - 0 likes

    @AccioJennifer: Go

    3 ways to avoid this (independent of each other)

    1. If you have the permission node: "harrypotterspells.teach.known" remove it
    2. Teach yourself the spell first before teaching it to someone else
    3. Give yourself the '*' permission (not recommended)
  • Avatar of AccioJennifer AccioJennifer Sep 27, 2015 at 13:35 UTC - 0 likes

    Hello! I really enjoy the plugin from what I've been able to do so far, but I am unable to "teach" any spells. I keep getting an error saying "I cannot teach (player) (spell) as you do not know it." Am I doing something incorrectly?


    Last edited Sep 27, 2015 by AccioJennifer
  • Avatar of jacklin213 jacklin213 Sep 18, 2015 at 21:36 UTC - 0 likes

    @SnakerCZ: Go

    Sorry the current 2 languages that we support are English and Dutch. If you would like to help us translate to czech that would be awesome.

    Btw your config.yml isn't formatted correctly, here's the fixed version http://pastebin.com/GnDegKeJ

    Last edited Sep 18, 2015 by jacklin213
  • Avatar of SnakerCZ SnakerCZ Sep 18, 2015 at 15:11 UTC - 0 likes

    Please help. I changed my config.yml to czech version (my language), and it ´does not work. Why? Log: http://pastebin.com/1J42UW8P Config.yml: http://pastebin.com/KfMHef4U Build #105

    What i doing wrong?


    Last edited Sep 18, 2015 by SnakerCZ: i added the build
  • Avatar of jacklin213 jacklin213 Sep 12, 2015 at 22:45 UTC - 0 likes

    @Goldentoenail: Go

    Thanks for that, there happened to be another bug as well so ill try get those fixed asap

  • Avatar of Goldentoenail Goldentoenail Sep 12, 2015 at 15:54 UTC - 0 likes

    OK I turned on debug.

    My first test log was too large to post, so I made a shorter test. and here is the log.



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