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 : 列出玩家知道的所有魔咒。玩家可以查看他们有权施放的任何魔咒的详细信息。这个命令对玩家来说是安全的，尽管它丧失了一些神秘感。玩家可以在游戏中看到与法杖上的魔咒相同的信息（通过知识工具提示）。
法师指令
mage命令可用于检查或修改特定的玩家信息。
- /mage check <player> : 根据玩家的位置和激活的魔咒检查其权限
- /mage debug <player> : 切换特定玩家的调试输出
- /mage describe <player> [spell/data] : 转储有关玩家的信息-魔咒转换、存储的数据等
- /mage configure <player> <spell/data> <value> : 设置玩家信息、更改施法等
- /mage reset <player> : 完全重置玩家的所有存储数据
施法指令
/cast命令在游戏中的作用非常强大。它允许你直接施放任何法术，但（更重要的是）它允许你使用“命令行参数”来使用可配置的法术系统。许多魔咒是基于相同的“积木”法术，使用参数。通过自己调整这些参数，您可以创建一些有趣且强大的魔咒。然后，服务器管理员可以将它们添加到spells.yml中，使它们成为“正式”的魔咒，这样玩家就可以在他们的法杖上使用新的魔咒。
例如，“boom”、“kamikazee”、“kaboom”和“nuke”都是“boomspell”的变体，主要是调整“size”参数。例如，“核弹”是“20号”——想看看10倍的核弹是什么样子的吗？尝试/cast boom size 200…但要事先警告，这不漂亮！
cast 命令的参数使用与spells.yml相同的名称和格式，并成对传递——例如/cast <spell> <param> <value> <param> <value>，浏览默认的spells.yml是了解参数格式的最佳方式。
详细的拼写参数spell parameter 文档 https://github.com/elBukkit/MagicPlugin/wiki/SpellParameters
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.