FAQ - elBukkit/MagicPlugin GitHub Wiki
How do I customize spells and wands?
Answer
Do not edit the files in the "defaults" folder. The files in "plugins/Magic" will override the defaults, so put any customizations you want to make in there. This includes changing default spell behavior, disabling defaults, or adding new spells and wands.
Keep in mind that whatever you add to your customized files gets added to the defaults. If you'd like to start completely fresh with your own configs, and/or copy entire spells from the default configs, it's best to disable the defaults via "load_default_spells: false" in config.yml.
See the Customization Section for more information.
My broomstick won't move!
Answer
You're using Paper and have set armor_stand_tick to false. Set it back to true.
Broomsticks (and other things) in Magic use armor stands, so turning off their ability to move will break them.
How do I change the Spell Point Cooldown?
Answer
You can change the spell point cooldown globally or per-spell by editing the spell config. See SP Balancing for more information.
I'm getting errors from my configs!
Answer
First, check to make sure you are using spaces in your yaml configs, and not tabs.
It's a good idea to get an editor that understands Yaml, rather than using something like Notepad.
Also make sure you do not have any leading spaces at the top level, example: potter is good, example potter is not.
Try to use a Yaml validation tool to see where your errors are before asking for help.
The in-game editor (/mconfig editor) will also help spot these kind of errors.
My wand is acting weird in creative mode
Answer
Wands don't really work in creative mode, there's not much I can do about that.
How do I localize or change the text in this plugin?
Answer
All of Magic's in-game text can be changed in plugins/Magic/messages.yml
See the Messages Section for more information.
How do I turn on the Harry Potter/Star Wars/Bending/Guns?
Answer
See the Examples section.
How do I change shop prices?
Answer
See here for information on customizing shops: Shops
How can I start making my own spells, wands and recipes?
Answer
All of the survival configs can be seen here: https://github.com/elBukkit/MagicPlugin/tree/master/Magic/src/main/resources/examples/survival
This is a great place to start learning about the plugin. The best way to learn is to example a spell you are familiar with in-game to see how it works.
earthquake and singularity are good spells to look at if you're curious how some of the more complex spells work. The Customization section https://github.com/elBukkit/MagicPlugin/wiki/Customization is also a good place to start.
You can also visit the elMakers sandbox server for a live spell editor that has syntax highlighting error detection, auto-complete, and lets you test your spells out live on the server at sandbox.elmakers.com.
How can I see crafting recipes?
Answer
All of the survival crafting recipes can be seen here: crafting configs
They are also viewable on your server, in plugins/Magic/defaults/crafting.defaults.yml
Sometimes my wands randomly stop working!
Answer
If you are running on CraftBukkit/Spigot 1.7, make sure to use the special CB Build. In particular, creative mode and many plugins will destroy the special custom data attached to wands. Magic works much better on 1.8 servers.
If you are running on 1.8 or above, it may be a plugin that is improperly saving and restoring items.
I can't see spell icons they're just diamond axes!
Answer
You will need to use the Resource Pack for the spell and wand icons to show up properly.
What is the rank progression?
Answer
Wands progress from Beginner, to Student, Apprentice, Master, Engineer, Architect and Conduit. The Engineer and Architect ranks are not available by default, you have to add the engineering examples with /mconfig example add engineering. Conduit is further locked, you will get instructions on how to allow that if you want, when adding the engineering example.
A player has lost their wand, what can I do?
Answer
The "restore" command can be used to restore a player's bound wands. This only works if the wands are set to "bound" in the configs and have bound to the player.
/wandp <player> restore
Will restore a player's wands. Only one wand of each type is saved, so this may not work well for players that keep multiple different wands.
How do I allow spells to target NPCs?
Answer
Spells won't target NPCs by default. You can turn this on by adding "target_npc: true" to a spell's parameters. To turn this on for all spells, use the "default" entry in spells.yml, like so:
default:
parameters:
target_npc: true
How do I change it so players can't use specific spells in a region?
Answer
This can be done using WorldGuard 6.2 or higher, Magic will add some custom flags:
region flag arena -w world blocked-spells kill,torture
For more info see the Regions section.