====== 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.
===== 相关内容 =====

  * [[插件手册:Magic:玩家使用说明|玩家使用说明 For Players]]
  * [[插件手册:Magic:开发者使用说明|开发者使用说明 For Developers]]
  * [[插件手册:Magic:管理使用说明|管理使用说明 For Adimins]]
  * [[插件手册:Magic:权限|权限 Permissions]]
  * [[插件手册:Magic:配置|配置 configurations]]
  * [[插件手册:Magic:mmob指令|mmob指令 mmob commands]]
  * [[插件手册:Magic:魔法物品指令|魔法物品指令 mitems commands]]
  * [[插件手册:Magic:拼写参数|拼写参数文档 spell parameter files]]