这是本文档旧的修订版！
Magic 插件文档
说明
这个是Magic提供的wiki，由mashal1004翻译改编。 原始英文文档请参阅https://github.com/elBukkit/MagicPlugin/wiki
Magic 是一个魔法插件，它可以给你的服务器提供法杖和物品。Magic还包括升级系统(growing progression system)，自定义mob(custom mobs)，制造(crafting)，图像地图(image maps)和其他一些列功能。
插件更多菜单使用方式，请参阅http://mine.elmakers.com/reference/
所有指令 commands
defaul权限给了op一些指令。可以使用 tab-completion (e.g. /mgive ) 在游戏中获得帮助。
请阅读权限permissions页面获得详细的权限信息。
法杖指令 wand command
- /wand : 创建一个新的，空白的法杖
- /wand <name> : 从定义好的预存法杖（wands.yml）中创建一个新的法杖
- /wand list : 列出所有wand.yml文件中可以提供的法杖
- /wand enchant [#levels] : 给法杖随机加入魔咒和属性
- /wand add <spell> : 为当下手持的法杖加入新的魔咒
- /wand restore : 找回丢失的玩家法杖
- /wand organize : 重新组织法杖上的魔咒
- /wand fill : 给法杖填充所有已知（且允许的）魔咒
- /wand remove <spell> : 从手持的法杖上移除一个魔咒
- /wand configure <property> <value> : 为法杖配置属性（见下）
- /wand upgrade <property> <value> : 配置法杖属性，但从不降低任何数值value（见下）
- /wand override <parameter> <value> : 改变法杖施魔咒的途径way
- /wand bind : 让法杖隐身，这样就只有你自己能够拿着它
- /wand unbind : 现身法杖，包括保存的备份
- /wand save <name> : 保存一个法杖到新的配置模板
- /wand delete <id> : 删除一个以保存的法杖模板
- /wand combine <wand> : 加入一个法杖模板到已存法杖中（给它升级）
- /wand add brush <material> : 给正手持的法杖加入新材料
- /wand remove brush <material> : 给正手持的法杖移除一个材料
- /wand name <name> : 命名法杖（注意，你也可以在铁毡上进行）
- /wand describe : 列出所有法杖的属性，配合“configure”使用
- /wand unlock : 解锁一个被锁的法杖让其变为可编辑模式 (“/wand configure locked “为已上锁)
- /wand create : 从你持有的物品中创建一个魔杖
- /wand destroy : 去附魔（毁坏）你持有的法杖
- /wand duplicate : 复制你持有的法杖
- /wand enchant xp : 将所有的经验（消耗经验）添加到法杖中。可用于调平系统的命令块中（Can be used in command blocks for a leveling system）
- /wandp <player> <etc…> : 在特定的玩家身上用 /wand commands
法杖配置指标 “configure” 和 “upgrade”: https://github.com/elBukkit/MagicPlugin/wiki/WandParameters
mgive 指令
mgive命令的工作原理与普通命令、esssentials的/give命令非常相似。它可以用来给任何玩家任何物品，包括法杖、魔咒和升级等。它还可以用来给玩家提供xp，目前可能需要它来解决/xp命令给经验与法杖经验相冲突的问题
- /mgive [player] <item> [amount] : 命令的通用、灵活格式。“item”是唯一必需的参数。
- /mgive NathanWolf elder : 给 NathanWolf 一个 Elder 法杖
- /mgive NathanWolf sp 100 : 给 NathanWolf 100 经验值（Sp）
- /mgive NathanWolf sp:100 : 给 NathanWolf 一个价值 100 SP的物品
- /mgive fling 32 : 给你自己 32 “fling” 魔咒. 魔咒会堆叠起来，可以放在箱子里或者给玩家<这是啥意思，我也不太懂—by mashal1004>
- /mgive NathanWolf xp 200 : 给 NathanWolf 200 经验值, 即使他拿着法杖也能用
- /mgive NathanWolf gold_nugget 32 : 给 NathanWolf 32 金块。 项目格式必须遵循Bukkit的材料
- /mgive spell:wolf : 给你自己 “wolf” 魔咒。 此 “spell:”, “wand:”, 和 “upgrade:” 前缀 可用于区分同名物品item
- /mgive book:engineering : “book:<category>” 物品将创建一个 “Spell Book” （意为魔法书）包括所有在归类中的魔咒，及其知识和成本的描述内容
- /mgive book:all : 给一个 “master” 魔咒书，包括所有魔咒，组织好的分类
/mmob 指令
详情参阅魔法mob Magic Mobs指令内容！https://github.com/elBukkit/MagicPlugin/wiki/MagicMobs
/mitem 指令
详情参阅魔法物品 Custom Items指令内容！https://github.com/elBukkit/MagicPlugin/wiki/CustomItems
实用程序指令
- /magic load : 重启config文件, 升级魔咒配置 spell configurations
- /magic save : 强制保存玩家数据。同时保存其他数据，例如法杖和图像地图
- /magic commit : 提交所有更改（如对所有玩家强制执行“提交”）
- /magic cancel : 取消所有在建工程批次
- /magic list [wands | automata | maps | tasks] <player> : 列出所有丢失的法杖，地图和自动机。 “tasks” 参数可用于检查任何插件中的失控任务
- /magic clean <player> : 清除无主丢失的魔杖或特定玩家丢失的魔杖
- /magic clean ALL : 清除所有世界的魔杖
- /spells : 列出玩家知道的所有魔咒。玩家可以查看他们有权施放的任何魔咒的详细信息。这个命令对玩家来说是安全的，尽管它丧失了一些神秘感。玩家可以在游戏中看到与法杖上的魔咒相同的信息（通过知识工具提示）。
法师指令
The mage command can be used to check or modify specific player informatino.
/mage check <player> : Check permissions for a player given their location and active spell /mage debug <player> : Toggle debug output for a specific player /mage describe <player> [spell/data] : Dump information about a player- spell casts, stored data, etc. /mage configure <player> <spell/data> <value> : Set player information, change spell casts, etc /mage reset <player> : Completely reset all stored data for a player
施法指令
The /cast in-game command is very powerful. It lets you cast any spell directly, but (more importantly) it lets you use “command line parameters” to play around with the configurable spell system. Many spells in Magic are based on the same “building block” spell, using parameters. By tweaking those parameters yourself, you can create some interesting and powerful spells. A server admin can then make them “official” spells by adding them to spells.yml, so players can use the new spell on their wands.
As an example, the “boom”, “kamikazee”, “kaboom” and “nuke” spells are all variants of “BoomSpell”, tweaking the “size” parameter (mainly). A “nuke” for instance is “size 20” - want to see what a 10x nuke would look like? Try /cast boom size 200 … but be forewarned, it's not pretty!
Parameters to the cast command follow the same name and format as in spells.yml, and are passed in pairs - e.g. /cast <spell> <param> <value> <param> <value>. Browsing through the default spells.yml is the best way to get a feel for what your options are.
Detailed spell parameter documentation
Debugging Utilities
While working on new spells, you may find a few useful utilities:
/cast The cast command can be used to quickly try out different parameters for spells. See above.
/wand override The /wand override command can be used to modify the way a specific wand casts a spell. Examples:
# Make all spells cast by this wand permanent (dangerous!) /wand override bypass_undo true # Decrease the cooldown on only the blink spell /wand override blink.cooldown 0 # Slow down Magic Missile /wand override missile.velocity 5 /mage debug This will enable debug output for spells cast by the specified player. A number can be provided to increase level of detail of output.
# Toggle debug on/off. /mage debug NathanWolf # Show a ton of information, may flood your chat /mage debug NathanWolf 20 /mage check Useful for debugging issues with permissions. If a spell seems randomly uncastable by a player, use this command on them while they are holding a wand with that spell active.
/wand save If you have created or modified a wand in-game, you can save it to a configuration file. For instance ”/wand save awesome” will save the wand in your hand to a new config file in “plugins/Magic/wands/awesome.yml”. The wand will be available to spawn as normal using /wand or /mgive.