Magic/Commands

Commands 命令

默认地，有几项命令的权限已经给予OP。试试看用TAB补全一下指令吧！(e.g. /mgive TAB) 查看游戏内的帮助

请点开 The page on permissions(Permissions权限) 以查看更多权限相关的细节

Wand Commands 法杖命令

• /wand : 创建一个新的、空的法杖.
• /wand <名字> : 创建一个法杖，但是基于wands.yml中已经预设的法杖
• /wand list : 列出wands.yml中可用的法杖列表模版
• /wand enchant [#等级] : 随机添加技能和配置到法杖
• /wand add \技能名> : 在手持的法杖上面添加一个技能
• /wand restore : 恢复玩家丢失的法杖
• /wand organize : 重构法杖上的技能
• /wand fill : 把所有已知的（而且有权限的）技能绑定到法杖上面
• /wand remove <技能名> : 清除当前手持法杖上全部技能
• /wand configure <属性> <数值> : 编辑法杖的可配置项(详见下文)
• /wand upgrade <属性> <数值> : 编辑法杖的可配置项，但是不会降低任何数值（见下文）
• /wand override <参数> <数值> : 修改法杖释放技能的方式
• /wand bind : 绑定法杖，这样就只有你自己才能用了
• /wand unbind : 取消绑定, 包括已经保存的备份
• /wand save <名字> : 储存法杖并添加到新配置模板
• /wand delete <id> : 删除一个法杖模版
• /wand combine <法杖> : 向现有的模版套入新的法杖(更新覆盖)
• /wand add brush <材质> : 添加当前手持法杖的新材质
• /wand remove brush <材质> : 移除当前手持法杖的一个材质
• /wand name <名字> : 命名法杖(你也可以通过铁砧改名)
• /wand describe : 列出法杖的所有配置项，与 "configure"一同使用
• /wand unlock : 解锁一个锁定的法杖，以便于编辑 ("/wand configure locked "可以锁定)
• /wand create : 基于你手持的物品创建一个新法杖
• /wand destroy : 取消手持法杖的附带效果 (相当于摧毁)
• /wand duplicate : 创建一个你手上法杖的副本
• /wand enchant xp : 提升你所有的XP等级(消耗XP)到法杖。可通过命令方块制作一个升级系统
• /wandp <玩家> <...> : 这样就可以使用/wand 系命令来指定玩家使用/wand命令了

用于配置和升级的法杖可用的参数Wand configuration parameters for "configure" and "upgrade":

法杖参数

The mgive Command Mgive命令

/mgive 命令运作时类似于原版或Ess的/give命令。可以通过这一命令给予玩家任何物品，包括魔法物品如法杖、技能或升级。同样地，可以给予玩家XP, 同时这个命令或许还可以解决/xp命令的无效故障

• /mgive [玩家] <物品> [数量] : 最基本的命令格式。只有物品是必填项
• /mgive [玩家] elder : 给予[玩家] 一个“Elder”法杖
• /mgive [玩家] sp 100 : 给予[玩家] 100 技能点
• /mgive [玩家] sp:100 : 给予[玩家] 一个价值100技能点的物品
• /mgive fling 32 : 给你自己 32次 "fling" 技能的使用权。这个使用权可以堆叠，也可以放到箱子里面或者丢给其他玩家
• /mgive [玩家] xp 200 : 给予 [玩家] 200 XP, 即便他手持着法杖也有效
• /mgive [玩家] gold_nugget 32 : 给予 [玩家] 32 金粒。物品格式必须遵从Bukkit's材质
• /mgive spell:wolf :给你自己"wolf" 法术。“spell:”、“wand:”、“upgrade:”这类前缀可用来区分同名项
• /mgive book:engineering : "book:<类别>" 的物品将会创建一本技能书，所有属于这一类别的技能都会被囊括在内，同时标明Lore和消耗
• /mgive book:all : 创建一本无所不能的技能书，按技能排列、囊括全部的技能

The /mmob command Mmob指令

请参见MagicMobs部分!

The /mitem command Mitem指令

请参见CustomItems部分

Utility Commands 实用命令

• /magic load : 重载配置文件，包括技能的配置
• /magic save : 强制储存一次玩家数据、其他数据（如遗失的法杖或图片地图）
• /magic commit : 提交所有的更改 (相当于对所有玩家都使用一次"Commit"技能)
• /magic cancel : 【取消所有的制作中的？？】Cancel all in-progress construction batches.
• /magic list [wands | automata | maps | tasks] <玩家> : 列出所有遗失的法杖、地图或自动装置(可能这个词不准确)。"tasks"模式则可以检测所有运行中的失效插件任务
• /magic clean <玩家> : 清除玩家未拥有的的遗失的法杖
• /magic clean ALL : 清除所有世界的所有法杖
• /spells : 列出玩家已知的全部技能。玩家可以查看他们有权限释放的的所有法术的详细信息。虽然已经移除了一些奇异的的东西，此命令仍可安全给予玩家。玩家可以看到有关法杖上技能的信息，和游戏里面看到的一样（譬如通过Lore Tooltips展示）

The Mage Command Mage命令

此类命令可以检查或修改玩家的数据(Information)

• /mage check <玩家> : 检查玩家的权限，展示他们的位置和可用的技能
• /mage debug <玩家> : 切换该玩家的Debug输出模式
• /mage describe <玩家> [spell/data] : 转储玩家的施法信息、存储数据等
• /mage configure <玩家> <spell/data> <数值> : 设置玩家的某个数据,如修改施法等
• /mage reset <玩家> :完全重设一个玩家所有的存储数据

The Cast Command 施法命令

/cast 命令在前台游戏中十分有用。可以让你直接释放任何法术，但是它也可以让你使用命令参数制作可配置的法术系统。
许多法术都需要基于某个法术配合参数。你可以自行调整参数以实现法术的多样化而无需动用后台配置。掌控服务器后台的人可以把配置好的技能储存在spells.yml里(只要放到spells文件夹就可以)，这样玩家就能使用新的法术了。

例如"boom", "kamikazee", "kaboom" 和 "nuke" 这几个技能都是"BoomSpell"的迭代或变形产物, 它们的区别可能只是修改了"size"这一个参数而已。譬如"nuke"设置的Size值是20，但是你又想临时把它调大10倍玩玩，那么请使用 /cast boom size 200 即可

在施法命令里面调整的参数和在spells.yml里面的一样，都会对该技能中声明过的全体起效，例如 /cast <技能名> <参数1> <数值1> <参数2> <数值2>.浏览起来和spells.yml里面的别无二致，该怎么设置就是什么样的效果
更多技能可用参数的细节文档

Debugging Utilities Debug实用命令

制作好一个新技能，用/cast命令可以快速释放，上面我们说过了

/cast

cast的命令可以快速检测不同参数的效果，上面也是提过的

/wand override

/wand override 命令可用来修改指定法杖释放法术的方式。

例如:

# 让所有的法术必须通过下面这个法杖参数释放 (慎用!)
/wand override bypass_undo true
# 只是减少“Blink”法术的冷却时间
/wand override blink.cooldown 0
# 让“Missile”技能的导弹飞行速度降低为5
/wand override missile.velocity 5

/mage debug

此命令会开启指定玩家的Debug输出，后面跟进一个等级数可以调整输出的强度，等级越高输出越详细。

# 开启或关闭Debug
/mage debug [玩家]
# 显示一大堆信息,这样做可能会刷屏
/mage debug [玩家] 20

/mage check

通过权限有效检测问题。如果玩家有时没法施法，用这个命令在他们手持法杖并且技能激活时使用可以查一下原因

/wand save

如果你在前台游戏新建或者修改了一个法杖，最好保存一下到配置文件里面。"/wand save Test" 就会在"plugins/Magic/wands/Test.yml"路径创建一个新的法杖模版文件。这个新的法杖当然可以使用/wand或者/mgive召唤出来