创建 EliteMobs 内容
EliteMobs 允许您通过 YAML 配置文件为服务器创建丰富的自定义内容。所有内容都是通过将格式正确的 .yml 文件放置在 EliteMobs 插件目录中的特定文件夹中来创建的。
内容类型
EliteMobs 支持 8 种主要内容类型:
- 自定义Boss - 创建具有自定义能力、装备和技能的独特精英生物
- 自定义物品 - 设计带有附魔的自定义武器、护甲和物品
- 自定义任务 - 构建带有目标和奖励的任务链
- 自定义事件 - 设置定时或触发的Boss事件
- 自定义NPC - 添加任务发布者、商店和互动NPC
- 宝藏箱 - 放置带有自定义奖励和宝箱怪机制的战利品箱
- 竞技场 - 设计带有Boss遭遇的波次战斗挑战
- 虫洞 - 创建位置之间的传送门
每种内容类型都有自己的配置文件夹和字段结构。
快速入门
所有自定义内容都遵循以下模式:
- 创建带有 .yml 扩展名的 YAML 文件
- 使用 lowercase_with_underscores.yml 格式命名
- 将其放置在适当的文件夹中
- 使用 YAML 字段配置内容
- 重新加载 EliteMobs 或重启服务器
文件位置
每种内容类型都存储在其自己的文件夹中:
- 自定义Boss:~/plugins/EliteMobs/custombosses/
- 自定义物品:~/plugins/EliteMobs/customitems/
- 自定义任务:~/plugins/EliteMobs/customquests/
- 自定义事件:~/plugins/EliteMobs/customevents/
- 自定义NPC:~/plugins/EliteMobs/npcs/
- 宝藏箱:~/plugins/EliteMobs/customtreasurechests/
- 竞技场:~/plugins/EliteMobs/customarenas/
- 虫洞:~/plugins/EliteMobs/wormholes/
内容创建工具
WebApp(推荐初学者使用)
使用 EliteMobs WebApp 通过可视化界面生成配置文件。此工具使过程更快,并有助于避免语法错误。
手动 YAML 配置
对于高级用户,手动创建 YAML 文件以完全控制所有可用字段和选项。
YAML 文件格式
所有 EliteMobs 配置都使用 YAML 格式。关键规则:
- 使用空格而非制表符进行缩进
- 带有颜色代码的字符串需要单引号
- 列表使用连字符格式或方括号格式
- 必需字段:所有内容类型中的 isEnabled: true
- 文件名应使用 lowercase_with_underscores.yml 格式
有关详细的 YAML 语法帮助,请参阅配置文件指南。
内容类型概述
自定义Boss
自定义Boss是具有增强能力、自定义装备和特殊能力的精英生物。Boss系统支持 60 多个配置字段,包括:
- 实体类型和等级
- 生命值和伤害倍数
- 装备(护甲和武器)
- 精英能力和技能
- 战利品表和掉落物
- 生成/死亡消息和命令
- 多阶段机制
- 自定义模型和伪装
基础Boss示例:
isEnabled: true
entityType: ZOMBIE
name: '&e测试Boss'
level: dynamic
healthMultiplier: 2.0
damageMultiplier: 0.5
helmet: GOLDEN_HELMET
chestplate: IRON_CHESTPLATE
mainHand: GOLDEN_AXE
powers:
- invulnerability_knockback.yml
spawnMessage: 一个测试Boss已生成!
deathMessage: 一个测试Boss被 $players 击杀!
自定义物品
自定义物品允许您创建具有自定义附魔和效果的独特武器、护甲和工具。物品系统支持 15 个配置字段,包括:
- 材料类型
- 显示名称和说明
- 附魔列表
- 药水效果
- 自定义模型ID
- 掉落权重和缩放
- 等级和灵魂绑定设置
基础物品示例:
isEnabled: true
material: DIAMOND_SWORD
name: '&4传奇之刃'
lore:
- '&7一把强大的武器'
- '&7在龙焰中锻造'
enchantments:
- DAMAGE_ALL,5
- FIRE_ASPECT,2
level: 10
soulbound: true
自定义任务
自定义任务为玩家创建目标,完成后可获得奖励。任务系统支持 17 个配置字段,包括:
- 任务目标和类型
- 奖励(物品、金钱、权限)
- 接受/完成对话
- NPC交付要求
- 任务锁定计时器
- 追踪和声音
自定义事件
自定义事件基于时间、几率或其他条件触发Boss生成。事件系统支持 18 个配置字段,包括:
- 事件类型和Boss列表
- 触发几率和权重
- 开始/结束消息和命令
- 冷却计时器(本地和全局)
- 最少玩家数量
- 事件持续时间
自定义NPC
自定义NPC为任务、商店和竞技场提供互动角色。NPC系统支持 18 个配置字段,包括:
- NPC名称、角色和职业
- 生成位置
- 对话(问候、对话、告别)
- 互动类型
- 任务和竞技场引用
- 自定义模型和伪装
宝藏箱
宝藏箱提供战利品奖励,具有可自定义的补货计时器和宝箱怪机制。箱子系统支持 15 个配置字段,包括:
- 箱子类型和方向
- 位置坐标
- 战利品表
- 补货计时器
- 宝箱怪几率和Boss列表
- 视觉效果
竞技场
竞技场创建带有Boss遭遇的波次战斗挑战。竞技场系统支持 19 个配置字段,包括:
- 竞技场边界(corner1、corner2)
- 波次数量和延迟
- Boss列表和生成点
- 奖励和玩家限制
- 竞技场消息
- 间歇波次
虫洞
虫洞在两个位置之间创建传送门。虫洞系统支持 11 个配置字段,包括:
- 两个位置端点
- 每个位置的显示文本
- 视觉风格和粒子颜色
- 硬币成本和权限
- 致盲效果和大小倍数
常见模式
引用内容
内容类型使用文件名相互引用:
- 在Boss中引用能力: power_name.yml
- 在战利品中引用物品: item_name.yml:quantity
- 在事件中引用Boss: boss_filename.yml
- 在NPC中引用任务: quest_filename.yml
占位符
在消息中使用这些占位符:
- $players - 击败Boss的玩家列表
- $distance - 到Boss位置的距离
- $eventBossLevel - 动态事件Boss等级
颜色代码
在名称和消息中使用 Minecraft 颜色代码。颜色代码必须用单引号括起来。
标准 Minecraft 颜色代码:
- &0 - 黑色
- &1 - 深蓝色
- &2 - 深绿色
- &3 - 深青色
- &4 - 深红色
- &5 - 深紫色
- &6 - 金色
- &7 - 灰色
- &8 - 深灰色
- &9 - 蓝色
- &a - 绿色
- &b - 青色
- &c - 红色
- &d - 浅紫色
- &e - 黄色
- &f - 白色
格式代码:
- &l - 粗体
- &m - 删除线
- &n - 下划线
- &o - 斜体
- &r - 重置
精英能力系统
EliteMobs 包含 60 多种可以分配给自定义Boss的精英能力。能力在Boss配置中通过文件名引用。
能力类别
攻击/战斗能力:
- ArrowFireworks、ArrowRain、AttackArrow、AttackFireball、AttackLightning
- AttackPush、AttackVacuum、BulletHell、DeathSlice、ProjectileDamage
元素能力:
- Firestorm、FlamePyre、Flamethrower、FrostCone、FrostWalker
- LightningBolts、Thunderstorm、PhotonRay、PlasmaBlaster
防御能力:
- ShieldWall、InvulnerabilityArrow、InvulnerabilityFallDamage
- InvulnerabilityFireworks、InvulnerabilityKnockback
- ChannelHealing、SpiritWalk
特殊技能:
- GroundPound、Implosion、MeteorShower、GoldExplosion、GoldShotgun
- SkeletonPillar、SkeletonTrackingArrow、TrackingFireball、Taze、Taunt
- ZombieBloat、ZombieFriends、ZombieNecronomicon、ZombieParents
- SummonEmbers、SummonTheReturned、MovementSpeed
末影龙专属能力:
- AimedFireball、ArrowBombardment、DiscoFireballs、EmpoweredLightning
- Shockwave、Tornado(共11个龙专属能力)
战利品能力:
- BonusCoins、BonusLoot、HyperLoot
使用 powers 列表字段将能力添加到Boss:
powers:
- invulnerability_knockback.yml
- flame_pyre.yml
- spirit_walk.yml
高级功能
多阶段Boss
Boss可以有多个阶段,每个阶段使用单独的配置文件。使用 phases 字段引用阶段Boss文件,使用 phaseSpawnLocation 设置阶段转换发生的位置。
精英脚本
精英脚本通过事件驱动的动作、条件和冷却时间提供高级自定义Boss能力。脚本使用Boss配置中的 eliteScript 字段进行配置。
自定义模型
可以使用 customModel 字段将自定义模型应用于Boss、NPC和物品。这需要额外的模型集成设置。
Boss装备
Boss可以穿戴自定义护甲并手持武器:
helmet: DIAMOND_HELMET
chestplate: IRON_CHESTPLATE
leggings: LEATHER_LEGGINGS
boots: CHAINMAIL_BOOTS
mainHand: GOLDEN_AXE
offHand: SHIELD
命令执行
Boss可以在特定事件执行命令:
- onSpawnCommands - Boss生成时执行
- onDeathCommands - Boss被击败时执行
- onCombatEnterCommands - 战斗开始时执行
- onCombatLeaveCommands - 战斗结束时执行
Boss消息
自定义Boss公告:
- spawnMessage - Boss生成时广播
- deathMessage - Boss被击败时广播(支持 $players 占位符)
- escapeMessage - Boss逃脱时广播
- locationMessage - 显示到Boss的距离(支持 $distance 占位符)
- deathMessages - 随机死亡消息变体列表
公告优先级(0-3)控制广播范围。使用 announcementPriority 字段。
区域Boss
区域Boss使用 isRegionalBoss 字段,可以有拴绳半径、生成限制和方块状态更改:
- leashRadius - 距离生成点的最大距离
- onSpawnBlockStates - Boss生成时的方块更改
- onRemoveBlockStates - Boss被移除时的方块更改
战利品配置
控制Boss掉落:
- dropsEliteMobsLoot - 启用自定义战利品掉落(默认:true)
- dropsVanillaLoot - 启用原版掉落(默认:true)
- dropsRandomLoot - 启用随机战利品(默认:true)
- uniqueLootList - 带数量的特定战利品物品
示例:
uniqueLootList:
- custom_sword.yml:1
- rare_helmet.yml:1
预制内容
EliteMobs 包含 134 多个预制Boss配置和所有内容类型的模板。这些可以在相应的 /premade/ 文件夹中找到,并作为创建您自己的自定义内容的示例。
获取帮助
- 查看侧边栏以获取特定的内容创建指南
- 访问 EliteMobs Discord 获取社区支持
- 查看 GitHub 仓库 获取源代码示例