JE服务端

[1.20.5~26.3x]DeathZombie---僵尸末日

Ver_***Lv.1 新手上路 发表于 3 天前 IP:首尔 92 0
AI 速览2026-11-19 13:30 生成

Paper/Purpur 僵尸末日回合生存插件 DeathZombieV4 发布

DeathZombieV4 是一款运行在 Paper 或 Purpur 服务端上的多人合作回合制僵尸生存小游戏插件,支持 1.20.5 至 26.3+ 版本。它提供完整的守点流程、倒地救援与掉线重连、与 Shoot 枪械插件联动的金币系统,以及 26 种预设僵尸、22 种变异 Boss 和可自由组合 44 种技能的自定义怪物系统。插件内置游戏内 GUI 和本地网页后台,建图、刷怪、商店与怪物配置都能可视化完成,适合想在高版本服务端搭建僵尸生存玩法的服主。

获取方式
  • 论坛附件 deathzombiev4-1.5.0.jar,免费下载
  • 将 Shoot、DecentHolograms 与本插件 jar 一并放入 plugins 目录
  • 启动服务器后自动生成配置并启动网页后台
  • 需 Paper 或 Purpur 核心,不支持纯 CraftBukkit
  • 需 Java 21 及以上
  • 必装前置 Shoot v1.5.0+ 与 DecentHolograms
  • 可选前置 Multiverse-Core 用于多世界管理
  • 升级时建议同步替换配套版本的 Shoot 与本插件
本卡片由 AI 阅读本帖后生成,可能存在疏漏,请以帖子正文为准。
插件发布
中文名: 僵尸末日
外语名: DeathZombie
支持版本: 1.20.x 1.21.x 26.x 
适用服务端: Spigot Paper 
插件属性: 本体插件 
插件类型: 娱乐 
前置插件: Shoot,DecentHolograms
来源: 原创
原帖地址: -
下载地址: (本贴末尾或)https://www.spigotmc.org/resources/deathzombie.140685/
最后更新: 2026-11-17
本帖最后由 Ver_zhzh 于 2026-11-17 23:35 编辑

DeathZombieV4 — 多人合作回合制僵尸生存插件

版本
服务端
Java
前置

DeathZombieV4 是一款运行在 Paper / Purpur 服务端上的多人合作回合制僵尸生存小游戏插件,玩法参考了经典的“僵尸末日”,也考虑到做这个高版本的插件不多所以想着发个插件

因为自定义度比较高比较复杂,所以插件内置了大量的预设内容,并且游戏内配置菜单(/dzs gui)和本地网页管理后台(WebUI),从圈地建图、配置波次刷怪到捏制新 Boss 都可以直接通过GUI完成,无需手写冗长的 YAML 文件。

image.png


目录

  1. 主要功能概览

  2. 运行环境与安装说明

  3. 从零搭建一张地图(完整流程)

  4. 局内玩法机制与商店物品速查

  5. 怪物系统详解(ID / IDC / IDZ)

  6. 内置网页管理后台(WebUI)

  7. 指令与权限速查表

  8. 配置文件说明与调优建议

  9. 开发者 API 与事件接口

  10. 源码编译说明


1. 主要功能概览

  • 完整的回合守点流程

    支持多房间并行运行、人数凑齐自动倒计时开局、窗户破坏与修补、付费解锁门与按回合自动开门、墙面武器/护甲/道具/团队特技购买点、带悬浮翻转动画的幸运抽奖箱、全局电源总闸,以及按回合自动将全队传送到新场地的动态地图功能。

  • 倒地救援、回合复活与掉线重连

    玩家血量归零后不会立刻出局,而是倒地等待队友靠近蹲下救援;未救起者可在进入下一回合时自动复活到存活队友附近。中途掉线的玩家重进服务器后输入 /dzs rejoin 即可回到原对局。

  • 与 Shoot 枪械插件联动

    局内金币与 Shoot 插件互通。Shoot 中所有的预设枪械和服主自制的枪械都会自动同步到本插件的购买点、初始装备面板和幸运箱奖池中;怪物装备枪械后也会按枪械射速自动瞄准玩家开火。

  • 三套怪物系统与 44 种技能

    内置 26 种预设僵尸(id1 ~ id26)和 22 种变异生物与重型 Boss(idc1 ~ idc22);同时提供 IDZ 自定义怪物系统,支持选用任意原版生物(包括盔甲架等无 AI 实体)、突破原版 2048 血量上限、配置独立 Boss 血条、穿戴装备枪械、图形化配置药水与身体粒子,并从 44 种内置技能中自由组合参数。

  • 适合装在多世界服与混合服

    玩家进入房间时会自动保存原有的背包、护甲、经验、血量与药水效果,退房、对局结束或关服时自动还原;计分板与 Tab 列表默认只对局内玩家显示,不会覆盖生存世界或其他小游戏玩家的界面;怪物技能生成的蛛网、黑曜石等临时方块会在技能结束或对局结束时自动复原,不会破坏地图建筑。

  • 游戏内菜单 + 网页后台双端编辑

    游戏内可通过 /dzs gui <地图名> 和 /czm make gui <怪物名> 完成选点与日常修改;涉及几十个回合的刷怪表、预设权重、全局价格或自定义怪物细节时,可在浏览器打开内置网页后台可视化编辑,两边读写同一套配置文件。


2. 运行环境与安装说明

环境要求

| 项目 | 要求说明 |

| :--- | :--- |

| 服务端核心 | Paper、Purpur 及其分支核心(不支持纯 CraftBukkit,建议使用 Paper 获得完整寻路支持) |

| 游戏版本 | Minecraft 1.20.5 ~ 26.3+(单 JAR 跨版本兼容,含 1.20.6、1.21.x、26.1+ 等) |

| Java 版本 | Java 21 及以上 |

| 必装前置 | Shoot(v1.5.0+,负责枪械与局内金币底层)、DecentHolograms(负责买点、门窗、幸运箱及排行榜悬浮字) |

| 可选前置 | Multiverse-Core(多世界加载管理) |

安装步骤

  1. 将 Shoot、DecentHolograms 与 deathzombiev4-1.5.0.jar 一并放入服务端的 plugins/ 目录。

  2. 启动服务器,插件会自动生成默认配置文件、内置商店配置、预设怪物文件并启动本地网页后台。

  3. 后续升级版本时,建议将配套版本的 Shoot 与 DeathZombieV4 同时替换后再重启服务器。


3. 从零搭建一张地图(完整流程)

下面按实际做图的先后顺序介绍如何搭建一个可玩的房间。绝大部分步骤既可以在 /dzs gui <地图名> 图形菜单里点选,也可以直接敲指令完成。

第一步:设置全局退出大厅

站在主城或大厅的安全位置,执行:


/dzs lobby

所有房间对局结束或玩家执行 /dzs leave 退出时,都会回到这里。

第二步:创建房间并了解区域选择棒

站在准备好的游戏地图内,执行:


/dzs create 监狱惊魂

创建后会自动进入编辑模式并发放一根区域选择棒(平时可用 /dzs edit 监狱惊魂 随时进入或退出编辑模式,编辑模式下能看到已设置的门、窗、刷怪点提示):

  • 左键点击方块:设置选区第一个角点。

  • 右键点击方块:设置选区第二个角点。

  • 潜行(Shift)+ 左键(或执行 /dzs regionshape <rect|circle|ring>):在矩形、圆形、圆环选区之间切换。

第三步:设置玩家出生点与房间基础参数(其实下面都能用GUI可以无需指令)

  1. 站在地图初始房间的玩家出生位置,执行 /dzs setspawn 监狱惊魂(或在 /dzs gui 监狱惊魂 -> 出生点管理 中点击设置)。

  2. 打开 /dzs gui 监狱惊魂 -> 游戏控制(或使用指令),按需调整:

    • 最少开局人数:/dzs setminplayer 监狱惊魂 1

    • 最大玩家人数:/dzs setmaxplayers 监狱惊魂 4

    • 凑齐人数后的等待倒计时:/dzs setwaittime 监狱惊魂 15

    • 地图总回合数:/dzs setround 监狱惊魂 30

第四步:布置窗户防线与僵尸出生点

  1. 添加窗户:手持区域选择棒框选窗户位置的方块(如栅栏、铁栏杆、木板等),执行:

    
    /dzs setwindows 监狱惊魂 win_1
    

    也可在 GUI 的 窗户管理 中点击创建。对局中僵尸路过窗户会逐步破坏方块,玩家靠近窗户即可修复并获得金币。

  2. 添加僵尸刷怪点:站在窗外或房间刷怪位置,执行:

    
    /dzs setzombiespawn 监狱惊魂 spawn_start_1
    

    初始区域建议放 2~4 个刷怪点;需要锁在付费门后面的区域也可以先建好刷怪点,下一步绑定到门上。

第五步:设置付费门并关联门后刷怪点

  1. 用区域选择棒框选隔断两个房间的大门方块,执行:

    
    /dzs setdoor 监狱惊魂 door_lab lock 750
    

    这会把选区设为需要花费 750 金币解锁的门。开门时门体方块会自动清除,对局结束后自动恢复原状。

  2. 绑定刷怪点(重要):打开 /dzs gui 监狱惊魂 -> 门管理,点进 door_lab,把门后新区域的僵尸刷怪点关联到这扇门上。这样门没开的时候,门后不会刷怪;玩家花钱把门打开后,新区域的刷怪点才会投入使用。

  3. 按回合自动开门(可选):如果某扇门(例如最终 Boss 场地大门)希望到了指定回合自动免费打开,可执行:

    
    /dzs autodoor 监狱惊魂 door_boss 20
    

第六步:布置购买点、总电源与幸运箱

  1. 墙面购买点:打开 /dzs gui 监狱惊魂 -> 购买点管理 挑选商品,或直接输入指令后按提示敲击墙上的方块(如告示牌、展示框背后的方块、按钮等):

    
    /dzs buy 监狱惊魂 武器 霰弹枪 500
    
    /dzs buy 监狱惊魂 护甲 铁护甲套装 600
    
    /dzs buy 监狱惊魂 道具 通用弹药 250
    
    /dzs buy 监狱惊魂 特殊功能 全体回复1 800
    

    设置成功后方块前方会自动生成悬浮全息介绍,玩家在局内右键该方块即可购买。

  2. 全局电源总闸(可选):如果地图中布置了 特殊功能(SP) 类的团队增益买点,推荐设置一个电源开关:

    
    /dzs power 监狱惊魂 1500
    

    执行后敲击目标方块即可。只要地图里设置了电源,局内必须先有玩家花钱开启电源,全队才能购买所有 SP 类团队特技。

  3. 幸运抽奖箱(可选):在地图上放好普通箱子,执行:

    
    /dzs lucky 监狱惊魂 set box_1 1000
    

    再左键敲击该箱子即可绑定为 1000 金币抽一次的幸运箱。你也可以在 GUI 幸运箱管理 中调整抽取次数上限(抽够次数自动转移到下一个箱子点位)以及单地图禁用某些超模武器(/dzs weapon 监狱惊魂 disable <武器ID>)。

第七步:配置每回合刷怪方案

输入 /dzs gui 监狱惊魂 点击 出怪系统,里面包含 5 个子面板:

  1. 每回合生成总数:设置每个回合总共刷出多少只怪。

  2. 每回合刷怪速率:设置每隔多少秒刷出一批怪(支持按回合区间批量设置,后期回合可调快节奏)。

  3. 出怪预设设置:把几种怪和各自的出现权重保存为一个预设包(例如 前期普通群、中期远程混编、20波尸潮),方便反复套用。

  4. 出怪详细设置 / 批量快速设置:为第 1 ~ N 回合指定使用哪个预设包,或单独增减某回合的怪物与数量。

提示:如果地图有 20~30 个回合,直接在浏览器打开网页后台的 回合出怪设置 页面按表格填写会比在游戏箱子菜单里翻页快得多。

第八步:可选进阶项(初始装备 / 常驻 Buff / 动态转场)

  • 初始装备与槽位限制:执行 /dzs kitgui 监狱惊魂(或 GUI 装备配置),可修改玩家开局自带的近战武器、初始手枪、初始护甲,以及默认开放几个武器槽(其余槽位可留给玩家局内买“武器凭证”解锁)。

  • 地图常驻 Buff:在 GUI Buff 管理 中创建药水预设并绑定到地图,玩家开局后自动获得(例如昏暗地图给常驻夜视)。

  • 动态地图传送:在 GUI 动态地图 中可设置“第 X 回合结束时将全队传送至指定坐标”,适合制作多阶段推进式战役地图。

第九步:配置检查、启用与测试


/dzs check 监狱惊魂      # 检查出生点、大厅、刷怪点等必要项是否遗漏

/dzs enable 监狱惊魂     # 将房间设为启用状态,允许玩家加入

/dzs join 监狱惊魂       # 加入等待队列

/dzs jump 监狱惊魂       # (管理员测试用)无视最少人数直接开局

/dzs jump 监狱惊魂 10    # (管理员测试用)直接启动并跳到第 10 回合测试强度

4. 局内玩法机制与商店物品速查

/dzs gui <地图名> 13 个管理模块一览

| 所在行 | 菜单图标名称 | 用途简述 |

| :--- | :--- | :--- |

| 第一行(地图设施) | 门管理 | 创建/删除付费门、修改门材质与解锁价格、设置自动开门回合、绑定门后激活的刷怪点 |

| | 窗户管理 | 查看、传送、重命名或删除窗户防线区域 |

| | 出生点管理 | 设置玩家初始出生点,管理与删除各处僵尸刷怪点 |

| | 幸运箱管理 | 绑定幸运箱方块、设置单次抽奖价格、转移次数及全局奖池抽取权重 |

| | 电力系统 | 设置或移除全局电源开关位置与合闸价格 |

| | 购买点管理 | 分类浏览武器、护甲、道具、团队特技并一键绑定到墙面方块 |

| | 排行榜管理 | 在当前位置创建、查看或移除全息悬浮排行榜 |

| 第二行(规则配置) | 加入标题 | 自定义玩家进入该地图等待区时的主副标题文字 |

| | 出怪系统 | 内含详细设置、批量设置、怪物预设、每回合总怪数、每回合刷怪间隔 5 个面板 |

| | Buff 管理 | 创建自定义药水 Buff 并绑定为地图开局增益 |

| | 装备配置 | 配置地图初始武器、护甲以及开放的武器槽/道具槽数量 |

| | 游戏控制 | 调整人数上下限、等待秒数、总回合数、配置自检、启用/禁用或删除房间 |

| | 动态地图 | 配置特定回合结束后全队自动传送的新场地坐标 |

局内金币获取规则

可在 config.yml 的 game.money.getting_money_way 中切换(或用 /dzs testmoney <shoot|kill> 实时切换):

  • 射击命中模式(shoot,默认):子弹每次打中怪物都会给金币,短时间内的连射命中会自动合并结算。打中怪物头部区域默认享受 2.0 倍 爆头金币加成(可在 config.yml 调整爆头判定高度比例与倍率)。

  • 击杀结算模式(kill):按最后一击击杀怪物发放金币,支持为近战击杀与远程击杀分别设置额外百分比奖励。

  • 其他收入与扣费:修补窗户每块奖励金币、每回合顺利清场发放回合通关奖励、被僵尸击倒会扣除少量金币;如果某把高射速机枪刷钱太快,可在 config.yml 的 weapon_specific_rewards 里单独下调这把枪的金币倍率。

商店与初始装备物品 ID 速查

配置购买点(/dzs buy)或初始装备(/dzs kit)时,可直接使用中文名称或下表中的英文稳定 ID:

1. 武器类(WP)

武器数据直接同步自 Shoot 插件。玩家购买未持有的枪械会放入空闲武器槽(槽满时替换当前手持武器槽);对着已经持有的同款枪械购买点再次购买,会直接补满该枪弹药。

内置默认枪械 ID 对照:

  • 基础与常规枪械:pistol(手枪)、rifle(步枪)、shotgun(霰弹枪)、machine_gun(冲锋枪)、sniper_rifle(狙击枪)、assault_rifle(突击步枪)、smg(轻型冲锋枪)

  • 特效与重型武器:rocket_launcher(火箭筒)、electric_gun(电击枪)、freeze_gun(冰冻枪)、thunder_gun(雷击枪)、pressure_gun(高压气枪)、plasma_gun(等离子枪)、reaper(收割者)、destroyer(毁灭者)、super_laser_cannon(超级激光炮)、black_hole_devourer(黑洞吞噬者)、sonic_rifle(音波步枪)、energy_pulse_gun(能量脉冲枪)、rainbow_sprayer(彩虹喷射器)、teleport_gun(传送枪)、starlight_master(星光掌控者)、void_stardust(虚空星尘)、echo_cannon(回响加农炮)

  • 你在 Shoot 中通过 /shoot custom 新建的任何自定义枪械,也会自动出现在武器列表与幸运箱奖池中。

2. 护甲类(AR)

购买后自动穿戴到玩家护甲栏,支持整套购买或分上下半身购买:

| 整套护甲 ID | 名称 | 默认参考价 | 说明 |

| :--- | :--- | :---: | :--- |

| armor_bundle_leather | 皮革护甲套装 | 120 | 全套皮革护甲 |

| armor_bundle_leather_enchanted | 附魔皮革护甲套装 | 200 | 全套保护 I 皮革护甲 |

| armor_bundle_chainmail | 锁链护甲套装 | 300 | 全套锁链护甲 |

| armor_bundle_chainmail_enchanted | 附魔锁链护甲套装 | 420 | 全套保护 I 锁链护甲 |

| armor_bundle_iron | 铁护甲套装 | 520 | 全套铁护甲 |

| armor_bundle_iron_enchanted | 附魔铁护甲套装 | 700 | 全套保护 II 铁护甲 |

| armor_bundle_diamond | 钻石护甲套装 | 1000 | 全套钻石护甲 |

| armor_bundle_diamond_enchanted_i | 附魔钻石护甲套装 I | 1300 | 全套保护 I 钻石护甲 |

| armor_bundle_diamond_enchanted_ii | 附魔钻石护甲套装 II | 1650 | 全套保护 II 钻石护甲 |

| armor_bundle_netherite | 下界合金护甲套装 | 2200 | 全套下界合金护甲 |

| armor_bundle_netherite_enchanted | 附魔下界合金护甲套装 | 2800 | 全套保护 III 下界合金护甲 |

散件 ID 规则:将 bundle 替换为 upper(头盔+胸甲)或 lower(护腿+靴子)即可,例如 armor_upper_iron、armor_lower_diamond。

3. 战术道具类(IT)

包含即时弹药补给、武器扩容凭证、被动保命道具以及手持右键触发的主动道具:

| 道具 ID | 名称 | 默认参考价 | 作用说明 |

| :--- | :--- | :---: | :--- |

| item_universal_ammo | 通用弹药 | 动态计算 | 手持任意枪械购买,直接补满当前枪弹药(价格默认为该枪售价的一半) |

| item_bulk_universal_ammo | 大量通用弹药 | 800 | 一次性补满玩家背包内所有枪械的弹匣与备弹 |

| item_weapon_voucher | 武器凭证 | 1000 | 解锁 1 个处于锁定状态的额外武器槽位 |

| item_golden_apple | 金苹果 | 250 | 食用获得伤害吸收 II 与生命恢复 II |

| item_splash_healing_ii | 治疗药水 II(喷溅) | 300 | 投掷瞬间恢复范围内玩家生命值 |

| item_splash_speed_iii | 速度药水 III(喷溅) | 280 | 投掷赋予速度 III 持续 20 秒 |

| item_grenade | 手雷(x3) | 350 | 右键投掷,3 秒后引爆杀伤周围僵尸(不破坏地图方块) |

| item_enhanced_wind_charge | 强化风弹(x3) | 300 | 右键投掷,强力击退并吹散贴脸尸群 |

| item_medkit | 医疗箱 | 500 | 放在物品栏即被动生效(不消耗),蹲下救队友时间缩短至 2 秒 |

| item_door_control_close | 门控关闭 | 800 | 右键将本局所有已开启的门临时用红玻璃封锁 10 秒阻挡尸潮(冷却 60 秒,不消耗) |

| item_immortality_totem | 不死图腾 | 1500 | 受到致命伤害时自动原地满血复活并获得 10 秒高速与高抗性(每局限购 1 次) |

| item_lightning_enchant | 闪电附魔 | 900 | 右键后 30 秒内当前手持枪伤害翻倍,且子弹命中召唤落雷 |

| item_explosion_enchant | 爆裂附魔 | 950 | 右键后 30 秒内当前手持枪伤害翻倍,且子弹命中产生范围爆炸 |

| item_freeze_enchant | 冰冻附魔 | 800 | 右键后 30 秒内当前手持枪伤害 ×1.5,且子弹命中冻结减速敌人 |

| item_weapon_upgrade | 枪械升级 | 1200 | 右键后 20 秒内身上所有枪伤害 ×1.5、射击冷却缩短 30%、弹匣与备弹临时扩容 |

| item_team_ammo_refill | 全体弹药补给 | 1200 | 右键为局内所有存活队友补满全部枪械弹药 |

| item_team_revive | 全体复活包 | 1500 | 右键立即原地满血复活当前所有倒地的队友 |

| item_ultimate_damage | 终极伤害 | 2000 | 右键瞬间秒杀自身周围 12 格内的所有敌方怪物 |

| item_random_chest | 随机宝箱 | 600 | 右键随机抽取一件上述战术道具 |

4. 团队特技类(SP)

若地图设置了全局电源开关,必须先开启电源后方可购买;购买后立即对全队或个人生效:

| 特技 ID | 名称 | 默认参考价 | 作用说明 |

| :--- | :--- | :---: | :--- |

| sp_team_speed_boost | 全体加速 | 500 | 全队获得速度 II 持续 15 秒 |

| sp_team_heal_small | 全体回复 1 | 400 | 全队立即回复 6 点生命值(3 颗心) |

| sp_team_heal_medium | 全体回复 2 | 750 | 全队立即回复 12 点生命值(6 颗心) |

| sp_team_heal_large | 全体回复 3 | 1200 | 全队立即回满生命值 |

| sp_team_milk_cleanse | 大量牛奶 | 450 | 立即清除全队身上的中毒、缓慢、失明、凋零等负面药水效果 |

| sp_team_health_boost_small | 生命提升 1 | 800 | 购买者本局生命上限增加 4 点(2 颗心) |

| sp_team_health_boost_medium | 生命提升 2 | 1500 | 购买者本局生命上限增加 8 点(4 颗心) |

| sp_team_health_boost_large | 生命提升 3 | 2400 | 购买者本局生命上限增加 12 点(6 颗心) |

| sp_team_strength_boost | 全体力量 | 2500 | 全队获得本局常驻生命提升 IV |

| sp_quick_teleport | 召集队友 | 600 | 5 秒倒计时后将所有存活队友传送到购买者身边 |

| sp_invulnerability | 无敌时间 | 2000 | 全队获得 15 秒高额抗性与持续生命恢复 |

| sp_team_sharpness_boost | 全体锋利 | 1600 | 20 秒内全队所有玩家的枪械伤害翻倍 |

| sp_team_poison_strike | 全体剧毒 | 1400 | 全队成员的下一发子弹额外扣除目标当前生命值的 50% |

| sp_team_double_gold | 双倍金币 | 1500 | 20 秒内全队获取金币翻倍 |

| sp_team_advanced_ammo | 高级弹药补给 | 1200 | 立即补满全队所有武器的弹匣与备弹 |

怪物死亡掉落物(Power-Ups)

局内击杀怪物时,默认有 5% 概率(可在 config.yml 的 game.drops 修改,IDZ 怪物也可单独设掉落率)在原地生成带悬浮名字的发光掉落物,30 秒内走过去触碰即可拾取:

  • 全队增益类(8 种):全体秒杀(10 秒内一枪秒怪)、双倍金币(30 秒)、全弹药补满、全体加速、全体锋利、全体无敌、全体剧毒、全体复活。

  • 战术道具类(9 种):直接获得高爆手雷、强化风弹、闪电/爆裂/冰冻附魔、枪械升级、终极核爆、随机宝箱、不死图腾或医疗箱。

  • 个人即时补给(3 种):黄金苹果、敏捷喷溅药水、急救治疗喷溅药水。

排行榜统计项说明

玩家可通过 /dzs top <类型> 查看排名,管理员可通过 /dzs top holo set <类型> <全息图名> 在大厅放置自动刷新的全息排行榜。支持以下 7 种统计维度(指令里填英文简写或中文全称均可):

| 英文简写 | 中文统计名 | 是否需要填地图名 | 说明 |

| :--- | :--- | :---: | :--- |

| games | 总游戏次数 | 否 | 玩家累计参与的对局总场次 |

| kills | 累计击杀僵尸数 | 否 | 历史累计击杀怪物总数 |

| rounds | 累计生存回合数 | 否 | 历史累计打过的总回合数 |

| rescues | 累计救援队友数 | 否 | 历史累计蹲下救起倒地队友的次数 |

| money | 累计最高金钱数 | 否 | 单局曾经达到过的最高金币记录 |

| maprounds | 指定地图生存回合最大值 | 是 | 某张地图打到的最高回合纪录 |

| maptime | 最快单地图游戏耗时 | 是 | 某张地图完整通关的最快用时记录 |


5. 怪物系统详解(ID / IDC / IDZ)

插件内置了三套怪物配置体系,在波次刷怪、怪物预设包以及召唤技能里可以自由混搭使用。

第一类:预设僵尸系列(id1 ~ id26)

全部基于僵尸体型扩展,按前期杂兵、中期精英到后期小 Boss 梯度设计。默认属性开服即用;如需自己改血量、伤害、护甲和技能冷却,可在 zombie.yml 开启自定义覆盖(或执行 /czm spawnmode Zombie User on)并在网页后台修改。

| ID | 名称 | 特点简述 | ID | 名称 | 特点简述 |

| :--- | :--- | :--- | :--- | :--- | :--- |

| id1 | 普通僵尸 | 基础近战尸群杂兵 | id14 | 冰冻僵尸 | 攻击附带缓慢减速与寒冰粒子 |

| id2 | 小僵尸 | 体型小、移速快的突进杂兵 | id15 | 暗影僵尸 | 周期性瞬移贴近目标突袭 |

| id3 | 路障僵尸 | 佩戴护具,前期抗线肉盾 | id16 | 毁灭僵尸 | 高血量高攻重装推进精英 |

| id4 | 钻斧僵尸 | 手持钻石斧,近战破甲高伤 | id17 | 雷霆僵尸 | 攻击召唤落雷轰击玩家 |

| id5 | 剧毒僵尸 | 近战命中使玩家持续中毒 | id18 | 变异科学家 | 投掷药水并周期召唤实验体助战 |

| id6 | 双生僵尸 | 成对行动或亡语分裂增殖 | id19 | 变异法师 | 强化法术弹幕与范围减益控制 |

| id7 | 骷髅僵尸 | 远距离精准射箭压制 | id20 | 气球僵尸 | 浮空滑翔机动,越过低矮掩体追击 |

| id8 | 武装僵尸 | 全套盔甲持剑的近战精锐 | id21 | 迷雾僵尸 | 释放浓烟干扰视野并施加失明 |

| id9 | 肥胖僵尸 | 高血量、高抗击退前排肉盾 | id22 | 变异雷霆僵尸 | 高频连锁落雷与范围电击压制 |

| id10 | 法师僵尸 | 远程法术攻击并削弱玩家 | id23 | 终极毁灭僵尸 | 超高血防与狂暴近战压制 |

| id11 | 自爆僵尸 | 贴脸读秒引爆,被杀亦触发自爆 | id24 | 变异暗影僵尸 | 隐身潜行瞬移背刺 |

| id12 | 毒箭僵尸 | 远距离发射剧毒箭矢 | id25 | 变异博士 | 7 重复合技能(召唤/电击/冰冻/电域)Boss |

| id13 | 电击僵尸 | 攻击附带麻痹电击伤害 | id26 | 尖叫僵尸 | 尖啸震慑周围玩家并呼唤尸潮 |

第二类:变异生物与重型 Boss 系列(idc1 ~ idc22)

涵盖烈焰人、劫掠兽、僵尸马、潜影贝、铁傀儡、监守者、凋零等不同原版生物外观与专属机制,可在 entity.yml 或网页后台“实体详细编辑”页面调整参数。

| ID | 名称 | 机制简述 | ID | 名称 | 机制简述 |

| :--- | :--- | :--- | :--- | :--- | :--- |

| idc1 | 变异僵尸01 | 强化移速与攻击力的进阶感染体 | idc12 | 变异尸壳 | 沙漠感染体,命中施加饥饿与虚弱 |

| idc2 | 变异僵尸02 | 高护甲抗线的重装感染体 | idc13 | 变异僵尸3 | 狂暴突进型精英僵尸 |

| idc3 | 变异烈焰人 | 浮空烈焰射线与火球连射 | idc14 | 变异僵尸04 | 复合增益高血量精英 |

| idc4 | 变异爬行者 | 高速贴近自爆(不破坏地图方块) | idc15 | 鲜血猪灵 | 近战狂暴高伤且带攻击吸血 |

| idc5 | 变异末影螨 | 极小受击体积,高频骚扰突袭 | idc16 | 暗影潜影贝 | 发射追踪导弹使玩家漂浮失控 |

| idc6 | 变异蜘蛛 | 攀爬突进并吐出临时蛛网封路 | idc17 | 变异雪傀儡 | 高速连射带击退与伤害的寒冰弹幕 |

| idc7 | 灾厄卫道士 | 高移速持斧冲锋破阵 | idc18 | 变异铁傀儡 | 巨型肉盾,高额伤害与大范围击飞 |

| idc8 | 灾厄唤魔者 | 召唤尖牙法阵与恼鬼群骚扰 | idc19 | 变异僵尸Max | 各项数值全面强化的重装统领 |

| idc9 | 灾厄劫掠兽 | 脚底暴击光环与强力冲撞击退 | idc20 | 灵魂坚守者 | 蓄力发射监守者穿透音爆射线 |

| idc10 | 变异僵尸马 | 疾驰冲刺撞飞沿途玩家 | idc21 | 凋零领主 | 凋零头颅齐射与全局凋零诅咒 Boss |

| idc11 | 变异岩浆怪 | 脚底火焰光环持续灼烧周围玩家 | idc22 | 异变之王 | 黑曜石地刺、末影水晶回血、龙息与陨石雨终极 Boss |

第三类:IDZ 自定义怪物制作系统

当内置的 48 种怪物不够用,或者你想做“拿加特林扫射的机甲骷髅”“骑马冲锋的死神”“多阶段召唤分身的关底 Boss”时,可以使用 IDZ 系统自己制作:

  1. 执行 /czm make create 机甲枪手 创建一个新模板(系统会自动分配如 idz1 的唯一 ID)。

  2. 执行 /czm make gui 机甲枪手 打开游戏内图形编辑面板(或者直接打开网页后台的 IDZ 怪物管理 页面编辑):

    • 基础属性与实体类型:可选任意原版生物种类;支持设置超过原版 2048 上限的万血 Boss 血池、移速、近战伤害、抗击退、防晒自燃以及顶部 Boss 血条颜色与分段样式。

    • 装备、头颅与持枪射击 AI:可直接放入护甲、玩家皮肤头颅;若主手放入 Shoot 的枪械,怪物生成后会自动按照枪械射程与冷却向玩家开枪射击。

    • 图形化药水编辑器:通过中文药水分类菜单直接点选常驻药水效果、等级与时长,也可一键套用预设。

    • 身体部位粒子特效:支持为头部、胸部、手部、腿部、脚底分别挂载常驻粒子预设(如环绕光环、火焰翼、毒雾、星尘轨迹),网页后台支持 3D 实时旋转预览。

    • 专属死亡掉落设置:可单独设置该 Boss 死后的 Power-Up 掉落概率(如必掉 100%)并勾选只掉哪几种奖励。

  3. 执行 /czm make spawn 机甲枪手 在脚下刷出一只实测手感;满意后即可在地图波次配置中直接填入 idz1 或显示名投入使用。

IDZ 内置 44 种可选技能一览

每项技能添加后都可以在 已选技能管理 中单独调整冷却时间、伤害数值、触发概率、作用半径等参数:

| 分类 | 可选技能(技能名称与效果简述) |

| :--- | :--- |

| 通用核心(2 种) | 敌对AI(让盔甲架、被动动物等无攻击 AI 实体主动追击并近战攻击玩家)、召唤(支持定时/受伤/残血/检测玩家/死亡触发召唤任意 ID/IDC/IDZ 或原版怪物,同一只怪可叠加多组不同条件的召唤) |

| 近战命中(5 种) | 剧毒攻击(概率中毒)、冰冻攻击(概率缓慢+挖掘疲劳)、狂暴攻击(命中后自身获得力量加成)、攻击吸血(按概率恢复生命)、物品栏混乱(打乱玩家快捷栏顺序) |

| 机动与爆破(6 种) | 撞击伤害(贴身或骑乘马匹冲撞造成伤害与击飞)、冲刺攻击(高速突进撞击)、传送突袭(瞬移至目标身边)、隐身背刺(隐去全身护甲潜行瞬移至背后破隐高伤)、浮空飞行(无重力升空悬停并滑翔俯冲追击)、自爆攻击(靠近读秒引爆 + 死亡自爆,不毁方块) |

| 远程弹幕(10 种) | 箭矢攻击、毒箭攻击、三连射箭(扇形三发冰霜箭)、烈焰攻击(烈焰束+火球)、三叉戟投掷、雪球弹幕(高速击退连射)、粒子机枪(扇形粒子子弹扫射)、潜影追踪弹(追踪漂浮弹)、DNA螺旋弹(双螺旋魔法弹)、远程魔法弹幕(可自选粒子/RGB颜色/扇形发数) |

| 领域光环(7 种) | 伤害光环(脚底法阵持续扣血)、火焰光环(点燃周围玩家)、冰霜光环(减速冻结光环)、暴击光环(范围伤害+普攻概率高倍暴击)、战吼光环(强化周围友方怪物力量与抗性)、致盲烟幕(范围失明)、瘟疫领域(范围反胃眩晕与减速) |

| 雷电与重型 Boss 技(14 种) | 闪电攻击(支持连锁跳跃雷电)、瞬移雷击、全局雷电(轰击本局全体存活玩家)、全局诅咒(全队施加虚弱/中毒/凋零等)、蜘蛛网陷阱(脚下生成临时蛛网,到期自动清除)、收缩尖牙阵(三圈由外向内唤魔者尖牙)、声波弹攻击(监守者穿透音爆)、黑曜石地刺(直线地刺冲击定身)、击飞黑曜石柱(击飞并升起临时黑曜石柱)、凋零头颅齐射、下界栅栏射线(五向临时栅栏封路减速)、末影水晶阵(环绕水晶弹幕并为 Boss 回血)、龙息轰炸、黑曜石陨石雨、末影减速场 |


6. 内置网页管理后台(WebUI)

除了在游戏里用箱子菜单配置外,插件内置了一个轻量级本地网页后台,适合做大批量表格编辑。

登录与访问方式

  1. 插件启动后默认在 127.0.0.1:1777 启动网页服务;首次启动会自动生成一串 20 位随机登录密码并保存在 config.yml 的 web.password 中。

  2. 管理员在游戏内输入 /dzs web,聊天栏会直接显示访问地址和当前登录密码(出于安全考虑,服务端控制台日志不会明文打印密码)。

  3. 本机开服调试:直接在浏览器打开 [url=http://127.0.0.1:1777]http://127.0.0.1:1777`[/url] 输入密码登录即可。

  4. 远程云服务器访问建议:默认绑定 127.0.0.1 不会向公网暴露端口,防扫端更安全。推荐在自己电脑终端用一行 SSH 本地端口转发即可安全打开后台,无需开放防火墙端口:

    
    ssh -L 1777:127.0.0.1:1777 root@你的服务器IP
    

    连接保持期间,在你自己电脑浏览器访问 [url=http://127.0.0.1:1777]http://127.0.0.1:1777`[/url] 即可。如果确实需要改用局域网或公网直连,可将 config.yml 中的 web.host 改为 "0.0.0.0" 后执行 /dzs web start,并务必保留强密码或套一层 HTTPS 反向代理。

网页后台包含的 12 个功能页

  • 主页(地图总览):查看各房间状态、门禁关联、窗户与刷怪点信息,支持一键运行全局断链体检(排查失效的枪械 ID、不存在的预设引用等)。

  • 初始装备设置:拖拽或点选配置各张地图的开局武器、护甲与槽位锁。

  • 战备商城管理:修改 gameKit.yml 中所有护甲、战术道具、团队特技的图标、展示名、Lore、价格与效果参数。

  • 怪物预设管理:创建与维护刷怪预设包,调整包内各怪物权重。

  • 回合出怪设置:以表格形式批量编排每张地图第 1 ~ N 回合的刷怪总数、刷怪间隔与出怪组合。

  • 金钱与幸运箱:调整命中/击杀金币、爆头倍率、单把枪独立金币倍率,以及幸运箱动画和各武器抽取权重。

  • 实体详细编辑:调整 id1 ~ id26 与 idc1 ~ idc22 的自定义覆盖属性。

  • IDZ 怪物管理:全功能可视化捏怪编辑器,带 3D 身体粒子实时预览与 44 种技能参数表单。

  • 游戏 Buff 增益:管理自定义药水 Buff 预设及各房间绑定关系。

  • 提示与语言消息:集中修改 message.yml 中的聊天提示、标题文本与颜色代码。

  • 头颅 / 玩家 / 粒子库:管理怪物可穿戴的自定义皮肤头颅与粒子模板。

  • 全局配置管理:表单化修改 config.yml 的回合曲线、救援秒数、死亡掉落物与性能参数,保存后自动在服内热重载生效。


7. 指令与权限速查表

主命令 /dzs 支持别名 /dz、/deathzombie;自定义怪物命令 /czm 支持别名 /customzombie。所有命令均提供 Tab 自动补全。

普通玩家指令

| 指令格式 | 功能说明 |

| :--- | :--- |

| /dzs join [地图名] | 加入指定地图的等待队列(不填地图名时查看或提示可选房间) |

| /dzs leave | 离开当前等待队列或正在进行的对局,返回大厅并还原背包 |

| /dzs rejoin(或 /dzs rej) | 掉线重连后重新回到尚未结束的原对局 |

| /dzs top <统计类型> [地图名] [名次上限] | 在聊天栏查看排行榜(如 /dzs top kills 10、/dzs top maprounds 监狱惊魂 10) |

| /dzs displaySettings <kill\|shoot\|hit> <on\|off> | 个人开关:控制击杀金币、开火提示、命中提示的屏幕标题显示 |

管理员房间搭建与运维指令(/dzs)

| 指令格式 | 功能说明 |

| :--- | :--- |

| /dzs gui <地图名> | 打开指定地图的 13 合 1 游戏内图形配置主菜单 |

| /dzs lobby | 将管理员当前脚下位置设为全局退出大厅 |

| /dzs create <地图名> | 创建新游戏房间并自动进入编辑模式、获取区域选择棒 |

| /dzs edit <地图名> | 切换指定房间的编辑模式(显示点位标记并发放选择棒) |

| /dzs regionshape <rect\|circle\|ring> | 切换区域选择棒的选区形状(矩形 / 圆形 / 圆环) |

| /dzs setspawn <地图名> | 将当前站立位置设为地图的玩家初始出生点 |

| /dzs setzombiespawn <地图名> <刷怪点名> | 将当前站立位置添加为僵尸刷怪点 |

| /dzs setwindows <地图名> <窗户名> | 将当前选区保存为可破坏与修复的窗户防线 |

| /dzs setdoor <地图名> <门名> <lock\|unlock> [价格] | 将当前选区设为付费门(lock 需付费解锁,unlock 默认开启) |

| /dzs autodoor <地图名> <门名> <回合数\|off> | 设置某扇门在到达指定回合时自动免费打开(填 off 关闭) |

| /dzs doormaterial <地图名> <门名> [方块材质] | 修改付费门关闭状态时填充的方块材质 |

| /dzs power <地图名> [解锁价格] | 执行后破坏一个方块,将其设为全局电源总闸(默认 1000 金币) |

| /dzs buy <地图名> <类型> <物品名或ID> [价格] | 执行后敲击方块绑定购买点(类型填 武器/护甲/道具/特殊功能 或 wp/ar/it/sp) |

| /dzs lucky <地图名> <set\|add\|change\|open\|remove> <箱子名> ... | 管理地图幸运抽奖箱点位与抽奖价格 |

| /dzs weapon <地图名> <list\|enable\|disable> [武器ID] | 查看或单独启用/禁用某把枪在该地图的购买与幸运箱产出 |

| /dzs kitgui <地图名> | 打开该地图的初始装备与槽位锁配置菜单 |

| /dzs kit <地图名> <槽位0-8> <set\|remove> [物品ID] | 用指令直接设置或清空地图初始背包指定槽位的物品 |

| /dzs setminplayer <地图名> <人数> | 设置房间自动开局所需的最少玩家数 |

| /dzs setmaxplayers <地图名> <人数> | 设置房间允许进入的最大玩家数 |

| /dzs setwaittime <地图名> <秒数> | 设置达到最少人数后的开局倒计时秒数 |

| /dzs setround <地图名> <总回合数> | 设置地图的总回合波数 |

| /dzs game <地图名> setcount <回合> <数量> | 设置指定回合的最大刷怪总数 |

| /dzs game <地图名> spawnspeed <回合\|default> <秒数> | 设置指定回合或默认的每批刷怪间隔秒数 |

| /dzs buff <create\|add\|remove\|list> ... | 创建自定义药水 Buff 或将其绑定/解绑到指定地图 |

| /dzs remove <地图名> <shop\|door\|windows\|zombiespawn> | 移除管理员当前身边最近的购买点、门、窗户或刷怪点 |

| /dzs check <地图名> | 检查地图必填配置是否完整 |

| /dzs enable <地图名> | 切换房间的启用 / 禁用状态 |

| /dzs jump <地图名> [next\|目标回合] | 强制立即开局;运行中填 next 跳下一波,填数字直接跳到指定回合 |

| /dzs test <地图名> <回合数> [刷怪点名] | 不开局直接按某回合配置测试刷怪表现 |

| /dzs drop [地图名] <概率\|status\|reset> | 临时修改本局怪物死亡掉落 Power-Up 概率(如 /dzs drop 100%,对局结束自动恢复) |

| /dzs testmoney <shoot\|kill\|debug\|give> [金额] | 切换全局金币模式、开关爆头判定调试日志,或给自己加测试金币 |

| /dzs money <status\|reload> | 查看当前金币奖励配置摘要或热刷新金币与奖池缓存 |

| /dzs top holo <set\|remove\|list> ... | 创建、删除或列出大厅全息悬浮排行榜 |

| /dzs cleanHoloChest <player\|all\|game> [参数] | 清理异常残留的幸运箱悬浮全息图 |

| /dzs stop <地图名> | 强制终止正在运行的指定房间并结算还原玩家 |

| /dzs cleangame [地图名] | 强制重置指定房间或全部房间状态并清理残留实体(支持后台终端执行) |

| /dzs delete <地图名> | 删除指定游戏房间及其配置文件 |

| /dzs web [status\|start\|stop\|端口] | 查看 WebUI 地址与登录密码,或启动/停止网页服务(支持后台终端执行) |

| /dzs reload | 热重载插件配置文件、商店配置、语言文本与怪物数据 |

自定义怪物管理指令(/czm)

| 指令格式 | 功能说明 |

| :--- | :--- |

| /czm gui | 打开自定义怪物总览菜单 |

| /czm zombie <中文名或ID> | 在当前位置生成一只预设僵尸(支持 id1 ~ id26 或中文名补全) |

| /czm other <中文名或IDC> | 在当前位置生成一只变异实体(支持 idc1 ~ idc22 或中文名补全) |

| /czm make create <名称> | 创建一个新的 IDZ 自定义怪物并分配 ID |

| /czm make gui <名称> | 打开该 IDZ 怪物的游戏内属性、装备、药水、粒子与技能编辑器 |

| /czm make list | 列出当前已创建的所有 IDZ 自定义怪物及对应 ID |

| /czm make spawn <名称> [数量] | 在脚下生成指定数量的 IDZ 自定义怪物用于实测 |

| /czm make delete <名称> | 删除指定的 IDZ 自定义怪物 |

| /czm spawnmode <Zombie\|Entity> <User\|Normal\|InGame> <on\|off> | 切换 zombie.yml / entity.yml 使用默认数值还是用户自定义覆盖数值 |

权限节点说明

| 权限节点 | 默认归属 | 说明 |

| :--- | :---: | :--- |

| deathzombie.player | 所有玩家 | 允许加入/离开房间、掉线重连、查看排行榜与调整个人提示开关 |

| deathzombie.admin | OP | 允许使用全部 /dzs 建图与运维指令、/czm 怪物管理指令及查看 WebUI 密码(兼容别名 deathzombiev4.admin) |

| customzombie.admin | OP | 允许使用 /czm 系列自定义怪物指令 |


8. 配置文件说明与调优建议

数据目录结构(plugins/DeathZombieV4/)


plugins/DeathZombieV4/

├── config.yml              # 全局设置:回合时长、金币数值、掉落权重、救援、计分板、性能参数、Web 端口与密码

├── gameKit.yml             # 商店护甲(AR)、道具(IT)、团队特技(SP)定义与默认初始背包槽位模板

├── message.yml             # 局内聊天提示、标题文字与多语言提示配置

├── zombie.yml              # id1 ~ id26 预设僵尸自定义属性覆盖配置

├── entity.yml              # idc1 ~ idc22 变异生物与 Boss 自定义属性覆盖配置

├── buffs.yml               # 自定义开局药水 Buff 存储文件

├── leaderboards.yml        # 全息排行榜坐标与配置存储

├── game/                   # 单地图独立配置文件目录(每张地图一个 <地图名>.yml)

├── presets/                # 刷怪预设包目录

├── idz_monsters/           # IDZ 自定义怪物配置目录(每个怪物一个独立 yml)

├── player_stats/           # 玩家累计战绩统计数据

└── logs/                   # 插件运行与批量清怪日志

大地图与高波次实用调优建议

  1. 远处僵尸发呆不主动走过来怎么办?

    config.yml 中 game.monster_targeting.target_search_range 和 follow_range 默认设为 96 格。如果你的地图非常大,除了把这两个值调大以外,请同步检查服务端 config/paper-world-defaults.yml 中的 entity-activation-range.monsters(Paper 默认只有 32 格),将其调大到 64 ~ 96,否则远处的怪物会被服务端休眠降频导致原地不动。

  2. 后期 20+ 回合怪多且特效密集时怎么稳住 TPS 和客户端帧率?

    可在 config.yml 的 performance 与 monster_spawn 小节按需调整:

    • performance.particles.quality:默认 reduced(压缩冗余装饰粒子但保留技能攻击提示),低配服可改为 minimal 或 off。

    • game.monster_spawn.max_spawn_per_batch:控制每次刷怪最多同时生成几只(默认 3,想彻底平摊刷怪压力可把 one_per_burst 设为 true)。

    • game.monster_spawn.heavy_monster_extra_cooldown_seconds:刷出带复杂技能的精英/Boss 后自动多等几秒再刷下一批(默认 4.0 秒),防止同屏瞬间堆叠过多重型技能怪。

  3. 装在生存/小游戏混合服需要注意什么?

    保持 config.yml 中默认的 performance.scoreboard_in_game_only: true 和 tab_list_in_game_only: true 即可,插件不会改动非局内玩家的计分板、Tab 列表和原世界背包。


9. 开发者 API 与事件接口

插件通过 Bukkit ServicesManager 注册了对外接口 DeathZombieApi,方便附属插件查询房间状态、操作局内金币、生成受房间追踪的怪物、向商店注册新的自定义道具/护甲/团队特技,或监听对局生命周期事件。

说明:枪械本体归 Shoot 插件管理,如需通过代码注册新枪或监听开火事件请调用 ShootApi;本插件的 DeathZombieApi 主要负责房间流程、局内怪物以及 AR / IT / SP 三类战备扩展。

Maven 依赖配置

先在本地对本仓库执行 mvn install(或使用 <scope>system</scope> 引入构建好的插件包),在附属插件 pom.xml 中声明 provided 依赖,并在 plugin.yml 中添加 depend: [DeathZombieV4](或 softdepend):


<dependency>

    <groupId>org.Ver_zhzh</groupId>

    <artifactId>deathzombiev4</artifactId>

    <version>1.5.0</version>

    <scope>provided</scope>

</dependency>

获取 API 与常用代码示例


import org.Ver_zhzh.deathZombieV4.api.ConsumableActionResult;

import org.Ver_zhzh.deathZombieV4.api.DeathZombieApi;

import org.Ver_zhzh.deathZombieV4.api.ShopItemRegistration;

import org.Ver_zhzh.deathZombieV4.api.event.DeathZombieMonsterKillEvent;

import org.bukkit.Material;

import org.bukkit.entity.Player;

import org.bukkit.event.EventHandler;

import org.bukkit.event.Listener;

import org.bukkit.plugin.java.JavaPlugin;

import org.bukkit.potion.PotionEffect;

import org.bukkit.potion.PotionEffectType;

import java.util.List;

public class MyAddonPlugin extends JavaPlugin implements Listener {

    private DeathZombieApi dzApi;

    @Override

    public void onEnable() {

        this.dzApi = DeathZombieApi.get();

        if (this.dzApi == null) {

            getLogger().warning("未检测到 DeathZombieV4,附属功能未启用。");

            return;

        }

        // 1. 注册一个右键使用的自定义局内消耗品动作

        dzApi.registerConsumableAction(this, "adrenaline_shot", ctx -> {

            Player player = ctx.getPlayer();

            player.addPotionEffect(new PotionEffect(PotionEffectType.SPEED, 200, 2));

            player.setHealth(Math.min(player.getMaxHealth(), player.getHealth() + 8.0));

            player.sendMessage("§a已注射肾上腺素!");

            return ConsumableActionResult.CONSUME_ONE; // 触发成功后消耗 1 个

        });

        // 2. 将该物品注册进 DeathZombie 商店目录(之后可直接用 /dzs buy 绑定墙购点)

        ShopItemRegistration stim = ShopItemRegistration.consumableBuilder("addon_adrenaline")

                .displayName("&a&l肾上腺素针剂")

                .material(Material.SPECTRAL_ARROW)

                .defaultPrice(450)

                .lore(List.of("&7右键恢复 4 颗心并获得 10 秒速度 III"))

                .actionKey("adrenaline_shot")

                .cooldownSeconds(15)

                .build();

        dzApi.registerItem(this, stim);

        getServer().getPluginManager().registerEvents(this, this);

    }

    @EventHandler

    public void onMonsterKill(DeathZombieMonsterKillEvent event) {

        Player killer = event.getKiller();

        if (killer != null && dzApi.getCurrentRound(event.getGameName()) >= 15) {

            // 15 回合后每次击杀额外发放 5 金币(走 Earned 接口可正常享受局内双倍金币加成)

            dzApi.addEarnedPlayerMoney(killer, 5.0);

        }

    }

}

DeathZombieApi 核心方法分类速查

  • 对局状态与房间控制:isPlayerInActiveGame、getPlayerGame、isGameRunning、getCurrentRound、getRunningGames、getEnabledGames、getGamePlayerCount、getAliveMonsterCount、getGameTeammates、joinGame、leaveGame、startGame、stopGame

  • 玩家生存状态与历史战绩:isPlayerDowned、isPlayerPermanentlyDead、revivePlayer、getPlayerSessionKills、getPlayerTotalKills、getPlayerTotalRevives、getPlayerTotalGamesPlayed

  • 局内怪物查询与生成:isGameMonster、getMonsterGame、spawnGameMonster(gameName, monsterId, location)

  • 局内金币与直接发放:getPlayerMoney、trySpend、addPlayerMoney、addEarnedPlayerMoney、grantWeapon、grantItem、grantArmor、activateSpecial

  • 自定义扩展注册:registerItem、registerConsumableAction、registerArmorPiece、registerArmorBundle、registerSpecialAction、registerSpecialItem(及对应的 unregister* 方法)

可监听的 Bukkit 事件(包名 org.Ver_zhzh.deathZombieV4.api.event)

| 事件类名 | 触发时机与常用信息 |

| :--- | :--- |

| DeathZombieGameStartEvent | 游戏房间正式开局时触发(可获取房间名与参战玩家集合) |

| DeathZombieRoundChangeEvent | 回合推进切换时触发(可获取房间名、上一回合数与新回合数) |

| DeathZombieGameEndEvent | 游戏通关胜利、团灭失败或被强制停止时触发 |

| DeathZombieMonsterKillEvent | 局内怪物被击杀时触发(可获取房间名、死亡实体、怪物 ID 与击杀者) |

| DeathZombiePlayerDownedEvent | 局内玩家血量归零进入倒地待救状态时触发 |

| DeathZombiePlayerReviveEvent | 倒地玩家被队友救起、使用道具复活或新回合复活时触发 |

| DeathZombieShopPurchaseEvent | 玩家在购买点成功购买武器、护甲、道具或团队特技时触发 |

| DeathZombieDoorOpenEvent | 付费门被玩家花钱开启或到达指定回合自动开启时触发 |

| DeathZombiePowerActivateEvent | 玩家合上地图全局电源总闸时触发 |


10. 源码编译说明

本项目使用 Maven 构建(需 JDK 21+)。由于编译期依赖同工作区的 Shoot 插件 API,首次构建前请先将 Shoot 安装到本地 Maven 仓库:


# 1. 先在 Shoot 项目根目录执行:

mvn clean install -DskipTests

# 2. 再在 DeathZombie-latest 项目根目录执行:

mvn clean test package

编译完成后,生成的插件包位于 target/deathzombiev4-1.5.0.jar。


作者与反馈

deathzombiev4-1.5.0.jar

3.53 MB, 下载次数: 0

您需要登录后才可以回帖 登录 | 立即注册
本版积分规则