Skip to content

Configuration

Jump to bottom
oneachina edited this page Jul 12, 2026 · 1 revision

配置指南

配置文件位置：plugins/zombie-run/config/config.yml

修改后使用 /zr reload 热重载，无需重启服务器。

全局游戏参数

game:
  mode: zombie_run             # 游戏模式（当前仅 zombie_run）
  world: world                 # 地图世界名
  start-delay: 30              # 达到最小人数后等待秒数自动开局
  min-players: 8               # 自动开局最小玩家数
  max-players: 32              # 最大显示玩家数（PAPI 占位符，不限制加入）
  max-duration: 1800           # 单局最大秒数（1800 = 30分钟），超时平局

门定义

doors:
  door_1:
    x1: 10; y1: 64; z1: 10    # 对角坐标 1
    x2: 10; y2: 66; z2: 20    # 对角坐标 2
    door-number: 1             # 门编号（决定顺序）
    mode: normal               # normal / player / zombie / start
    delay: 5                   # 开门倒计时（秒）
    close-time: 15             # 关门倒计时（秒）
    material: STONE            # 关门时恢复的方块材质
    use-scan-data: true        # 使用扫描数据精确恢复方块（推荐）
mode 行为
normal 普通门，人类通过按钮触发
player 开局时自动对人类开启
zombie 开局延迟后对僵尸开启
start 游戏开始即开启

特殊传送行为

关门后自动触发电梯/地铁/机场专线传送：

doors:
  door_elevator:
    door-number: 7
    mode: normal
    special-behavior:
      type: ELEVATOR
      target-y: 48             # 电梯目标 Y 坐标
      countdown: 5             # 到达倒计时
      departure-msg: "&e电梯即将到达……"
      arrival-msg: "&a电梯已到达"

  door_subway:
    door-number: 8
    mode: normal
    special-behavior:
      type: SUBWAY
      target-x: 500            # 地铁目标坐标
      target-y: 20
      target-z: 500
      line-name: "1号线"
      countdown: 10            # 发车倒计时
      departure-msg: "&b%s即将发车，请站稳扶好……"
      arrival-msg: "&a%s已到站，请有序下车"

也可通过 /zr door behavior set 命令配置，无需手动编辑。详见 门系统。

按钮定义

按钮方块必须是 REDSTONE_LAMP 或 LEVER。

buttons:
  button_open_1:
    x: 5; y: 64; z: 5
    mode: normal              # normal / escape
    door-number: 1            # normal 模式需要

  button_escape:
    x: 100; y: 64; z: 100
    mode: escape              # 撤离按钮（直升机）

重生点定义

respawns:
  wait_lobby:
    x: 0; y: 64; z: 0
    type: WAIT                # 等待大厅

  player_spawn:
    x: 10; y: 64; z: 10
    type: PLAYER              # 人类出生点

  zombie_spawn:
    x: 100; y: 64; z: 100
    type: ZOMBIE              # 僵尸出生点

  alpha_spawn:
    x: 50; y: 20; z: 50
    type: ZOMBIE_MAIN         # 母体出生点

  door1_player:
    x: 20; y: 64; z: 20
    type: DOOR_PLAYER         # 门关闭时门外的玩家
    door-number: 1

  door1_zombie:
    x: 0; y: 64; z: 0
    type: DOOR_ZOMBIE         # 门关闭时门外的僵尸
    door-number: 1
type 用途
WAIT 等待大厅，玩家加入/游戏结束后的传送点
PLAYER 人类开局出生点
ZOMBIE 普通僵尸出生点
ZOMBIE_MAIN 母体僵尸出生点
DOOR_PLAYER 门关闭时，门外的玩家被传送到此
DOOR_ZOMBIE 门关闭时，门外的僵尸被传送到此

/zr spawn 命令会自动使用执行者当前站立坐标，更便捷。

弹药分类

ammo-categories:
  light:
    name: "&e轻型弹药"
    item-material: PAPER
    custom-model-data: 30001       # 需配合资源包
  heavy:
    name: "&9重型弹药"
    item-material: IRON_INGOT
    custom-model-data: 30002
  energy:
    name: "&d能量弹药"
    item-material: GLOWSTONE_DUST
    custom-model-data: 30003
  shotgun:
    name: "&6霰弹"
    item-material: GUNPOWDER
    custom-model-data: 30004

自定义枪械

custom-weapons:
  pistol:
    material: WOODEN_HOE
    custom-model-data: 10001
    name: "&a手枪"
    damage: 5.0
    ammo-category: light
    magazine-size: 12
    max-reserve: 60               # 最大备弹
    reload-time-ticks: 30        # 换弹时间（tick）
    price: 300                    # 商店价格
    cooldown-ticks: 10
    spread: 0.08                  # 散布（越小越准）
    ads-spread-mult: 0.5          # ADS 散布乘数
    ads-recoil-mult: 0.7         # ADS 后坐力乘数
    headshot-mult: 2.0           # 爆头倍率
    knockback: 0.3
    range: 30                     # 射程（方块）
    pellets: 1                    # 弹丸数（霰弹枪 >1）
    sound: ENTITY_GENERIC_EXPLODE
    hit-sound: ENTITY_ARROW_HIT_PLAYER
    recoil: [0.3, 0.5, 0.5, 0.7] # 后坐力数组
    automatic: false              # 全自动？

  rifle:
    material: WOODEN_HOE
    custom-model-data: 10003
    name: "&c步枪"
    damage: 8.0
    ammo-category: heavy
    magazine-size: 30
    max-reserve: 90
    reload-time-ticks: 60
    price: 1500
    cooldown-ticks: 4
    spread: 0.3
    ads-spread-mult: 0.4
    ads-recoil-mult: 0.7
    headshot-mult: 2.0
    range: 50
    sound: ENTITY_GENERIC_EXPLODE
    hit-sound: ENTITY_ARROW_HIT_PLAYER
    recoil: [0.5, 0.7, 1.0, 1.3, 1.3, 1.0, 0.8, 0.5]
    automatic: true               # 按住右键连射

详见 武器系统。

Clone this wiki locally