Bukkit

Config Files

Config files are stored in a separate config folder. If no files exist, default values are loaded and then saved upon server shut-down. Any changes to config files while the server running this plugin is running are overridden on shut-down.

Config.txt

This contains general configuration settings. At the minute, this file is empty. This will change in the future.

ManaStoreBlocks.csv

A CSV file containing simply, all block IDs and data values (-1 represents the data value being ignored) that can store mana/exp levels - and if so, how much each can store.

SpellEffects.txt

Each line defines a spell effect, using the spell effect definition name following by the effect's name, then followed by a set of parameters. For instance, one starting with "Heal.HolyHeal:" would create a spell effect using the "Heal" spell effect definition and call the spell effect "HolyHeal". Any spell effect definitions added by other plugins plugging into this one will be usable in the same way as the normal spell effect definitions added by this plugin.

The following are possible parameters (# represents a number):

• Damage.# - Defines the amount of damage associated with this spell effect. This may be harm, heal, etc.
• ManaCost.# - Defines the base amount of mana this spell effect should cost. May be manipulated by the effect definition.
• ManaCostPerTarget.# - Defines the amount of mana this spell effect should cost per target hit. May be manipulated by the effect definition.
• Glit.[colour] - Specifies the colour particle effects should be. Multiple can be used in conjunction. If none are specified, white is chosen by default.
• AffectsOnly.Mob.[mob name] - Specified which mob(s) should be affected by this effect. If none, then all mobs are affected.
• AreaSize.Small.#, AreaSize.Medium.#, AreaSize.Large.#, AreaSize.Huge.# - Specifies how big the area size should be for each AOE size option.

Possible glit colours: Black, blue, brown, cyan, grey, green, lightblue, lime, magenta, orange, pink, purple, red, silver, white, and yellow.

A note on AffectsOnly.Mob: This draws the mob name directly from the mob's type, rather than checking against an internal list of definitions (the only exception to this being that "player" is a valid entry). This should allow you to specify modded mob names as well as vanilla ones - although this is untested. You can find out a mob's name to use in this parameter by casting a ScryMob effect on them. The TurnUndead spell effect is included by default as an example of how to use this parameter, and how it can be used to add flexibility to spell effect definitions.

The following are spell effect definitions added as standard:

• Heal (uses Damage, ManaCost, ManaCostPerTarget, Glit, AreaSize, and AffectsOnly.Mob)
  • Heals targeted mobs by the amount specified under Damage.

• Harm (uses Damage, ManaCost, ManaCostPerTarget, Glit, AreaSize, and AffectsOnly.Mob)
  • Causes damage to the targeted mobs by the amount specified under Damage.

• ScryMob (uses ManaCost, ManaCostPerTarget, Glit, AreaSize, and AffectsOnly.Mob ... although that would kinda defeat the purpose ...)
  • Tells the caster the name of any mobs targeted, mostly for use in the config files.

• Fire (uses Damage, ManaCost, ManaCostPerTarget, Glit, AffectsOnly.Mob, and AreaSize)
  • Sets living entities on fire.

• Blink (uses Damage (on the caster), ManaCost, and Glit)
  • Teleports the caster to where the spell performs.

SpellWords.txt

Each entry in this file lists all of the spell words (comma separated) that can be used for a specified purpose.

"Indicator" specifies spell book indicators. At the moment, "All" is the only option. "Effect" specifies spell effects. The word following is the name of the spell effect, as defined in the SpellEffects file. "Target" specifies the spell words for each possible target. At the moment, possible entries as "Caster" (for casting on yourself), "Projectile" (for casting at the location/on the mob that a projectile version of the spell hits), and "Mine". (which is currently unimplemented). "AreaOfEffect" specifies the spell words used for each possible area of effect: "TargetOnly" (cast only on the targeted mob), "AreaAroundTarget" (cast in an area around the targeted mob), and "RingAroundTarget". (cast in an area around the targeted mob, but not on the targeted mob itself)

A note on area of effect: The area of effect is currently quite small: In a future version, I'll add different sizes of area of effect, along with the ability to configure their sizes.