[PCD]EnchantmentAPI & EnchantmentPack插件Wiki翻译

本帖最后由 mimimis 于 2018-2-17 21:11 编辑

EnchantmentAPI·插件Wiki

—— 原文地址 | 站内搬运帖 ——

相关链接：

插件主要功能概述：

原版附魔	修改原版附魔的各种属性，包括最高等级，获取条件，可以被附魔的物品等等。
自定义附魔	提供一个简单方便的API来让您编写您的自定义附魔。
附魔的技能	使用SkillAPI插件提供的技能，并通过配置创建新的附魔
附魔	你可以自定义每一种附魔的可附魔物品、概率等。
钓鱼	你可以设置玩家钓鱼能够钓上来一个带有自定义附魔的物品。
任意物品	你可以设置不可附魔的物品能够被附魔，如刀杆，棍棒，食物或任何你想要的东西
铁毡	控制任意类型的铁砧可以将附魔合并并且物品可以获得彩色名称。
附魔扩展包	免费提供一个预设50个自定义附魔的插件。

命令：

/enchants add <附魔名称> <等级>	添加指定的附魔到手中的物品上。
/enchants book	给你一本书与笔，上面列出了所有的自定义附魔和它们的描述。
/enchants graph <material> <enchant>	列出一个图表，显示在附魔等级I至XXX的特定物品上获得每个等级的附魔概率。
/enchants remove\|reload	移除/重载所有附魔。

权限:

EnchantmentAPI.admin	使用插件命令。
EnchantmentAPI.enchant	允许使用所有自定义附魔。
EnchantmentAPI.enchant.<附魔名字>	允许使用指定自定义附魔。
EnchantmentAPI.enchant.vanilla	允许使用所有原版附魔。
EnchantmentAPI.enchant.vanilla.<附魔名字>	允许使用指定原版附魔。

铁毡

自定义附魔

EnchantmentAPI提供了一个简单方便的API，让你创建自己的自定义附魔。

创建一个附魔：
创建一个新的附魔需要做的第一件事是创建一个自定义附魔的新类。
别忘了"构建路径"导入插件本体。
新的附魔类需要继承CustomEnchantment类，你可以像这样写：

public class LifestealEnchantment extends CustomEnchantment

复制代码

构造函数需要以下参数：

String参数	附魔的名字。（对于其他自定义附魔必须是唯一的名称，否则它可能不会被注册）
String参数	附魔的详细介绍。

其他的设置：
CustomEnchantment类提供了许多Setter来设置你的自定义附魔，你可以在你的构造函数中调用以下任何一个方法：

普通物品	addNaturalItems(Material...)	哪些类型的物品可以得到这个附魔。
附魔难度	setWeight(double) setWeight(Material, double)	你可以设置物品能够得到这个附魔的难度。方法一默认所有物品，方法二可指定物品。
附魔组别	setGroup(String)	设置附魔的组别，同一个组别的附魔在同一个物品上无法同时存在多个。
叠加使用	setCanStack(Boolean)	拥有多个附魔效果的物品的附魔效果是否能同时发动。
附魔台使用	setTableEnabled(Boolean)	是否可以通过附魔台进行附魔获得。
最大等级	setMaxLevel(int) setMaxLevel(int, int)	可以通过附魔台或铁毡附魔到的最高等级。方法一同时设置两者，方法二分别是附魔台、铁毡。
铁毡耗费	setCombineCostPerLevel(int)	设置附魔等级每一级的铁毡经验耗费。
最低等级	setMinEnchantingLevel(double)	设置通过附魔台附魔的最低等级需求。
增长因子	setEnchantLevelScaleFactor(double)	每增加一个附魔等级额外需要的附魔等级。
最大延展数	setEnchantLevelBuffer(double)	最大附魔因子增长数。

附魔效果设置：
接下来，您可以通过重写一个或多个方法来为你的自定义附魔创建任何效果。

//攻击实体
applyOnHit(LivingEntity, LivingEntity, int, EntityDamageByEntityEvent)
//被实体攻击
applyDefense(LivingEntity, LivingEntity, int, EntityDamageEvent)
//破坏方块
applyBreak(Player, Block, int BlockEvent)
//方块交互
applyInteractBlock(Player, int, PlayerInteractEvent)
//装备物品
applyEquip(Player, int)
//卸下物品
applyUnequip(Player, int)
//实体交互
applyInteractEntity(Player, int, PlayerInteractEntityEvent)
//弹射物发射
applyProjectile(LivingEntity, int, ProjectileLaunchEvent)

复制代码

每种方法都是可选的，但您可以根据需要使用尽可能多的方法（例如，胸甲在攻击时会召唤闪电，在受到攻击时会反弹伤害，并且会使你破坏的每一个方块都掉落钻石，这些都可以通过一个附魔实现）。我们使用其中的一个，只需重写它并抛出所需的任何效果，下面是详细示例：

//一个攻击时的附魔效果示例
@Override
public void applyOnHit(LivingEntity user, LivingEntity target, int enchantLevel, EntityDamageByEntityEvent, event) {
//根据附魔等级，偷取生命值
user.setHealth(Math.max(user.getMaxHealth(), user.getHealth() + enchantLevel));
}

复制代码

每种类型的附魔都带有激活附魔的事件，所以你可以改变事件的结果，比如造成的伤害或者立即破坏一个方块。
更多的示例，请参考基于本API所写的插件：EnchantmentPack

附魔台附魔

附魔扩展包

EnchantmentPack可以说是一个附加组件，它提供了50种新的附魔来帮助你入门，所有的附魔下面已列出：

链接：
Spigot Page - 待更新
GitHub Source
Bukkit Page

附魔列表：

附魔名称	可附魔物品	最高等级	介绍
激动	所有护腿	5	攻击时造成额外伤害。
垂钓者	鱼竿	5	钓鱼时获得更多的鱼。
屏障阵地	所有锹类	5	右键生成一个法阵，推开所有接近它的敌人。
狂暴	所有斧类	5	攻击时获得力量效果。
盲目	所有镐类	5	攻击敌人并施加失明效果。
爆炸阵地	所有锹类	5	右键生成一个法阵，当有敌人进入时发生爆炸并造成伤害。
光亮	所有头盔	5	给攻击你的敌人施加失明效果。
诅咒	所有胸甲	5	给攻击你的敌人施加凋零效果。
冲撞	所有剑类	5	右键向前冲刺，对沿途的敌人造成伤害。

低落	所有胸甲	5	给攻击你的敌人施加虚弱效果
消失	所有锄类	5	攻击时，可以获得隐身效果。
热情	所有剑类	5	攻击时，获得速度效果。
火球	烈焰棒	10	右键发射火球。
火焰阵地	所有锹类	5	右键生成一个法阵，当敌人进入时引燃敌人。
强力	所有斧类	6	攻击时，给一定半径内的敌人造成额外伤害并推开敌人。
油炸	鱼竿	1	钓到鱼时，自动烹饪为熟鱼。
冻结	所有护腿	5	给攻击你的敌人施加缓慢效果。
抓钩	鱼竿	5	将你拉向浮标所处位置。
引力	所有剑类	6	攻击时，给一定半径内敌人造成额外伤害并推开敌人。

治愈	烈焰棒	5	右键为自己或他人恢复生命值。
寒冰阵地	所有锹类	5	生成一个魔法阵，阻止阵内的敌人离开阵地。
跳跃	所有靴子	2	获得跳跃提升效果。
敲击	所有剑类	4	攻击时，有概率把敌人打向空中。
发射阵地	所有铲子	5	右键生成一个法阵，当敌人进入后，立即将敌人弹射至空中。
生命	所有胸甲	6	装备时，获得额外生命值上限。
吸血	所有锄类	5	攻击时，恢复生命值。
闪电	所有斧类	5	攻击时有概率出现闪电。
闪电阵地	所有锹类	5	右键生成一个法阵，当敌人进入后，立即被闪电击中。
活跃	所有靴子	5	被敌人攻击时，获得速度效果。

夜视	所有头盔	2	穿戴后立即获得夜视效果。
幻影	所有靴子	5	被敌人攻击时，获得隐身效果。
剧毒	所有锄类	5	攻击敌人时，给敌人施加剧毒效果。
剧毒阵地	所有锹类	5	当敌人进入时，立即给敌人施加剧毒效果。
拉扯	所有镐类	5	把面朝你的敌人全部拉向你。
快速	所有弓	5	提高弓箭精准度。
反射	所有胸甲	10	有概率反射敌人对你造成的伤害。
重生	所有胸甲	3	每秒恢复生命值。
恢复	所有食物	5	吃下后直接恢复生命值。
击退	所有剑类	5	攻击时，直接将敌人向后推开较远的距离。

袭影	所有护腿	5	有概率在一定范围内进行随机传送，并给敌人施加失明效果。
缓慢	所有锄类	5	攻击时，给敌人施加缓慢效果。
缓慢阵地	所有锹类	5	右键生成一个法阵，进入法阵的所有敌人都会被施加缓慢效果。
吸收	所有剑类	5	右键将目标吸收，再次右键放出。
毒剂	所有胸甲	5	给攻击你的敌人施加剧毒效果。
涡流	所有镐类	5	把一定范围内的所有敌人拉向你。
软弱	所有锹类	5	攻击时，给敌人施加虚弱效果。
虚弱阵地	所有锹类	5	右键生成一个法阵，给进入的所有人造成虚弱效果。
蛛网阵地	所有锹类	5	右键生成一个法阵，给进入的第一个敌人周围放置蜘蛛网。
凋零	所有剑类	5	给敌人施加凋零效果。

钓鱼

附魔效果

原版附魔修改

[groupid=1330]PluginsCDTribe[/groupid]

回复: