Bukkit

@ShadowWolf294

No worries! I wish I had more time to work on documentation :)

The "paths" are how wands level up, basically.

The default set up defines a progression like this:

beginner->student->apprentice->master

Each step in that chain is a path. Each path has its own set of spells and rules for advancement (gaining mana, etc). When a player collects all of the spells in a path, they advance to the next one.

Advancement to a path may have its own bonuses, like changing wand appearance, or putting players in a new permission group.

Paths may also be "locked"- meaning a player can't naturally progress to the next path. The default configs come with two locked paths- engineer and architect.

To progress from Master to Engineer, the player must acquire the Rollback spell- which is not naturally available. This is to allow admins to easily control these (much more powerful) ranks. Players cannot obtain engineering spells unless you sell or give out the Rollback spell, in other words.

Architect is locked on the "Absorb" spell in a similar way.

NPCs can be set up to allow players to buy these lock spells only when they're ready- like at the end of the Master path to buy Rollback, or the end of the Engineer path to buy Absorb.

@ShadowWolf294

Funnily enough (maybe?) the reason I went with using the enchanting system was to try and make Magic feel as much like an extension of Vanilla mechanics as possible :)

I think it worked really well when enchanting was purely XP-based .. this makes sense, earn XP, level up wand, learn new spells, etc. I wish that Mojang hadn't messed with enchanting so badly.

@ShadowWolf294

I've actually got pretty decent documentation on the NPCs (I need to work on docs- I'll try and take some time to do that after I finish this projectile work!)

https://github.com/elBukkit/MagicPlugin/wiki/NPC

Basically you can add a "magic" trait to Citizens NPCs, allowing the NPC to cast a spell on player right-click.

I have some "spells" in the default configs that are meant for NPCs and aren't really spells at all. One such spell is "spellshop" - this allows player to spend physical or digital currency on spells.

The spellshop works via the same enchanting configs as wand enchanting- it is meant to emulate or replace enchanting, allowing the player to progress by purchasing all of the spells at their current level, before moving on to the next.

Now, I have to admit, you've got me thinking :)

I've been wanting to re-do the way progression works, in a future version of Magic I aim to support players "knowing" spells, rather than spells being attached only to wand items.

I also haven't been really happy with the enchanting mechanics since 1.8 - having to factor Lapis in threw off the whole balance of everything.

So.. that said, I'm going to think about this! A system where players acquired "magic skill points" or something for successful spell casts, and then could spend those points at something like the spell shop to gain new spells- I could see this being a great replacement for enchanting. I'm going to be thinking about it! I can't promise anything soon, but this seems like it could be an excellent system.

@HlgBruski

Like ShadowWolf said, for the colors you put "color" in the effect lib block. This will only work with redstone, spell_mob and spell_mob_ambient.

Some effects use other color parameters- and this is unfortunately not documented very well. DNAEffect, for instance, can take colorHelix, colorBase1 and colorBase2 parameters. In general I've tried to allow separate colors for each particle used in an effect, when more than one are used.

Here is an example:

https://github.com/elBukkit/MagicPlugin/blob/master/src/main/resources/defaults/spells.defaults.yml#L5908

Additionally, you can use the player's wand color for one effectlib color by using the "colorOverride" parameter- this goes in the main effect block, above the effectlib params.

This will take your wand's color, and pass it down to whichever effectlib parameter you provide- the most common use is "colorOverride: color", like in Magic Missile:

https://github.com/elBukkit/MagicPlugin/blob/master/src/main/resources/defaults/spells.defaults.yml#L5796

The HP configs don't really come with more than one wand, except for the Elder - you can see them all here:

http://mine.elmakers.com/?example=potter#wands

Or look directly at the configs here:

https://github.com/elBukkit/MagicPlugin/blob/master/src/main/resources/examples/potter/wands.yml

Editing them works like normal Magic configuration- add new wands to wands.yml, or override existing wands by adding your modifications to wands.yml. See the wiki for general customization info:

https://github.com/elBukkit/MagicPlugin/wiki/Customization

@ShadowWolf294

Hi! Thanks for your compliments!

The only thing right now that will let players progress simply by casting are spell levels. Individual spells can level up when cast. In the configs, these are the spells with a "|" character- a pipe. The number to the right of the spell name is the level, spells progress from the base spell (level 1) to level 2, and so on.

Otherwise there is no system for earning new spells other than enchanting, NPC's, or whatever custom thing you want to set up.

I hope that helps!

@HlgBruski

Just put "example: potter" in config.yml. See the wiki for more info:

https://github.com/elBukkit/MagicPlugin/wiki/Examples

Sounds like the plugin failed to load. Check your server logs, make sure there are no Magic errors.

If you see something about "deep magic" failing, you may have the wrong plugin for your server version. Magic doesn't run on Forge or any of its derivatives.

Sorry I missed your edit!

You unlock Engineer by getting the Rollback spell, and Architect by getting Absorb. There are built in shops for both - right now they are locked because they are cheaty and OP. 

That is what the "spellshop" spell does- see the wiki for how to set up an NPC as a Spell Shop:

https://github.com/elBukkit/MagicPlugin/wiki/NPC

To prevent melee damage entirely, you can add the following to config.yml:

prevent_melee_damage: true

I can't help too much with MythicMobs- things have changed a lot since 2.0, I think you just have to re-tweak their speeds. 

Ah, I think I see your confusion- the potter example is set up with each year requiring a speciifc spell to graduate.

These spells don't appear in the spell shop, it is intended that players take an exam or finish a quest to graduate.

You can customize this if you want, though- either remove spell requirements from each year (path), or add "show_required: true" to your spellsho configs. 

The examples are just that, examples - they are meant to give you an idea of what you can do, but they are not all that you can do.