EIZZOs-Launchers

插件

· 作者 EIZZO1

自定义发射器,由上下两个方块组成 | 也适用于船只

0 本站下载 0 关注 更新于 9 个月前

最新 v1.1-InitialRelease · 1.21.11 · Paper / Spigot

一键开服(送7天)

EIZZOs-Launchers

发射平台系统,支持自定义速度、粒子效果、音效以及船只发射功能。


? 特性

? 发射机制

  • 双方块检测 - 站在两个相同的方块上即可触发发射
  • 双重发射模式 - 直接发射玩家或发射船只
  • 速度控制 - 可分别设置垂直和水平方向的力度
  • 基于朝向 - 按照你面对的方向进行发射

? 视觉与音效效果

  • 发射粒子 - 发射时产生双层粒子爆发效果
  • 轨迹粒子 - 飞行过程中产生两条平行的粒子流
  • 音效 - 可自定义发射音效
  • 粒子预设 - 提供 13 种以上的粒子类型供选择

⚙️ 管理功能

  • GUI 编辑器 - 可视化界面用于创建和编辑发射器
  • 游戏内调整 - 无需重载配置即可修改属性
  • 命令控制 - 通过命令设置属性
  • 自动保存 - 配置自动保存

? 命令

命令 参数 权限 描述
/launchers - eizzolaunchers.admin 打开发射器管理器 GUI
/launchers help - - 显示帮助菜单
/launchers reload - eizzolaunchers.admin 重新加载配置
/launchers set <material> <property> <value> 见下方属性列表 eizzolaunchers.admin 设置发射器属性

别名: /launcher, /el

Set 命令属性

属性 类型 描述 默认值
vertical 0-100 发射高度/向上速度倍率 50
horizontal 0-100 发射距离/向前速度倍率 50
boat true/false 启用/禁用船只发射模式 false
particle1 粒子名称 主要发射粒子效果 FLAME
particle2 粒子名称 次要发射粒子效果 CLOUD
trail_particle1 粒子名称 主要轨迹粒子(飞行时) SOUL_FIRE_FLAME
trail_particle2 粒子名称 次要轨迹粒子(飞行时) WHITE_ASH
sound 音效名称 发射音效 ENTITY_FIREWORK_ROCKET_LAUNCH

? 权限

权限 描述
eizzolaunchers.admin 访问所有发射器命令及 GUI 管理功能

?️ 配置

主配置文件 (config.yml)

config-version: 1.1

launchers:
  GOLD_BLOCK:
    vertical: 50              # 发射高度 (0-100)
    horizontal: 50            # 发射距离 (0-100)
    boat: false              # 启用船只发射
    particle1: FLAME         # 主要发射粒子
    particle2: CLOUD         # 次要发射粒子
    trail_particle1: SOUL_FIRE_FLAME  # 主要轨迹粒子
    trail_particle2: WHITE_ASH         # 次要轨迹粒子
    sound: ENTITY_FIREWORK_ROCKET_LAUNCH  # 发射音效

  EMERALD_BLOCK:
    vertical: 80
    horizontal: 20
    boat: false
    particle1: DRAGON_BREATH
    particle2: HAPPY_VILLAGER
    trail_particle1: SOUL_FIRE_FLAME
    trail_particle2: WHITE_ASH
    sound: ENTITY_FIREWORK_ROCKET_LAUNCH

配置说明:

  • 方块材质名称必须是有效的 Minecraft 方块名称
  • 数值范围建议为 0-100(用于缩放速度)
  • 无效的粒子/音效名称将回退到默认值
  • 版本变更时配置会自动迁移

⚡ 发射机制

激活条件

当满足以下条件时,发射器会被触发:

  1. 玩家/船只移动到发射器方块上
  2. 检测到两个连续的相同材质方块:
    • 脚部所在层(第 1 层)
    • 脚部下方层(第 2 层)
  3. 材质匹配配置的发射器类型

两种发射模式

模式 1:直接玩家发射(默认)

  • 激活方式: 行走/站立在发射器方块上
  • 方向: 玩家面朝方向(偏航角)
  • 速度计算:
    • 垂直方向:(vertical_config / 100.0) * 2.5 格/刻
    • 水平方向:(horizontal_config / 100.0) * 3.0 格/刻

模式 2:船只发射

  • 激活方式: 船只经过发射器方块(需开启 boat: true)
  • 方向: 船只有向方向
  • 速度计算:
    • 垂直方向:(vertical_config / 100.0) * 1.5 格/刻(低于玩家)
    • 水平方向:(horizontal_config / 100.0) * 4.0 格/刻(高于玩家)

冷却系统

  • 持续时间: 10 刻(0.5 秒)
  • 独立实体: 每个玩家/船只拥有独立的冷却时间
  • 目的: 防止快速穿过时重复触发发射

? 视觉与音效效果

发射效果

发射时,玩家将体验以下效果:

效果 详情
粒子 1 20 个粒子,扩散范围 0.2,速度 0.1
粒子 2 15 个粒子,扩散范围 0.3,速度 0.05
音效 音量 1.0,音调 1.2(玩家)/ 0.8(船只)

轨迹效果(飞行中)

  • 持续时间: 直到着陆或进入液体前,每刻运行一次
  • 最小滞空时间: 着陆检测前需至少 3 刻
  • 粒子流: 左右两侧各有一条平行轨迹
  • 侧向偏移: 沿飞行方向垂直偏移 0.3 格
  • 着陆检测: 玩家接触地面或进入液体

? 发射器管理器 GUI

主菜单

使用 /launchers 打开 - 显示所有已配置的发射器。

操作:

  • 左键点击 发射器 → 打开编辑器
  • 右键点击 发射器 → 移除发射器
  • 点击绿宝石(槽位 25)→ 添加新发射器(手持方块)
  • 点击屏障(槽位 26)→ 关闭菜单

编辑器菜单

编辑所选发射器的属性:

槽位 物品 功能
10 拉杆 垂直高度: +10(左)/ -10(右)
19 羽毛 水平偏移: +10(左)/ -10(右)
13 船 切换船模式开启/关闭
22 唱片机 循环切换声音预设
15 烈焰粉 循环大粒子效果(粒子 1)
24 白色染料 循环大粒子效果(粒子 2)
16 萤石粉 循环小粒子效果(轨迹 1)
25 火药 循环小粒子效果(轨迹 2)
40 箭 返回主菜单
42 屏障 关闭编辑器

GUI 行为:

  • 数值限制在 0-100 范围内
  • 关闭时自动保存
  • 所有点击均有声音反馈

? 粒子与声音预设

大粒子(发射效果)

FLAME, SOUL_FIRE_FLAME, DRAGON_BREATH, HEART, ENCHANT,
HAPPY_VILLAGER, CLOUD, REDSTONE, SOUL, TOTEM_OF_UNDYING,
WITCH, LAVA, GLOW

小粒子(轨迹效果)

WITCH, CRIT, ENCHANTED_HIT, WHITE_ASH, ASH,
REVERSE_PORTAL, SOUL_FIRE_FLAME, FLAME, HAPPY_VILLAGER, GLOW

声音预设

ENTITY_FIREWORK_ROCKET_LAUNCH, ENTITY_EXPERIENCE_ORB_PICKUP,
ENTITY_PLAYER_LEVELUP, BLOCK_NOTE_BLOCK_CHIME,
ENTITY_ENDER_DRAGON_FLAP, ENTITY_WITHER_SHOOT

? 示例

基础弹跳板

# 垂直放置两个金块
# 站在上面测试默认发射器(50/50)
/launchers set GOLD_BLOCK vertical 60
/launchers set GOLD_BLOCK horizontal 40

结果: 中等高度,中等距离的发射

超级弹跳板

/launchers set EMERALD_BLOCK vertical 100
/launchers set EMERALD_BLOCK horizontal 20
/launchers set EMERALD_BLOCK particle1 DRAGON_BREATH
/launchers set EMERALD_BLOCK sound ENTITY_ENDER_DRAGON_FLAP

结果: 极高的跳跃,极小的前冲位移,史诗般的特效

水道船发射器

/launchers set DIAMOND_BLOCK boat true
/launchers set DIAMOND_BLOCK vertical 30
/launchers set DIAMOND_BLOCK horizontal 80
/launchers set DIAMOND_BLOCK particle1 SOUL_FIRE_FLAME
/launchers set DIAMOND_BLOCK particle2 CLOUD

结果: 船只以较低的弧线在水面上远距发射

跑酷关卡发射器

# 短距离跳跃发射器
/launchers set QUARTZ_BLOCK vertical 40
/launchers set QUARTZ_BLOCK horizontal 50
/launchers set QUARTZ_BLOCK particle1 ENCHANT
/launchers set QUARTZ_BLOCK trail_particle1 HAPPY_VILLAGER

结果: 用于跑酷关卡的精准跳跃,带有视觉轨迹

多发射器系统

为不同目的创建不同的发射器:

# 低功率(初学者)
/launchers set COAL_BLOCK vertical 30
/launchers set COAL_BLOCK horizontal 30

# 中功率(进阶)
/launchers set IRON_BLOCK vertical 60
/launchers set IRON_BLOCK horizontal 50

# 高功率(专家)
/launchers set NETHERITE_BLOCK vertical 90
/launchers set NETHERITE_BLOCK horizontal 70

? 故障排除

发射器不工作?

  • 确保两个相同材质的方块垂直堆叠
  • 检查玩家是否站在顶块上(而不是站在方块内部)
  • 验证配置文件中是否已配置该材质
  • 检查冷却时间(发射间隔 0.5 秒)

没有显示粒子?

  • 验证粒子名称是否为有效的 Minecraft 粒子类型
  • 粒子是客户端渲染的——如有需要请重启客户端
  • 检查控制台是否有无效粒子名称的错误
  • 如果粒子无效,插件将回退到 FLAME

声音未播放?

  • 验证声音名称是否为有效的 Minecraft 声音枚举值
  • 检查客户端声音设置(未被静音)
  • 如果声音无效,插件将回退到 ENTITY_FIREWORK_ROCKET_LAUNCH
  • 声音在发射位置播放,音量为 1.0

船发射器不工作?

  • 验证配置中该材质的 boat: true 设置
  • 船必须是在方块上移动(而非静止状态)
  • 检查船是否实际在水中(陆地也可用)
  • 船的俯仰角为 0.8(低于玩家的 1.2)

发射速度太弱/太强?

  • 调整垂直和水平数值(0-100)
  • 数值会与基础速度相乘:
    • 玩家:垂直 ×2.5,水平 ×3.0
    • 船:垂直 ×1.5,水平 ×4.0
  • 建议在创造模式下测试以确保安全

轨迹粒子未显示?

  • 轨迹仅在实体处于空中时出现
  • 落地检测前需在空中至少停留 3 个刻
  • 着陆或进入液体时轨迹停止
  • 检查 trail_particle1 和 trail_particle2 是否有效

无法添加新发射器?

  • 手持该方块
  • 点击 GUI 槽位 25 中的绿宝石
  • 该材质不能已经是发射器
  • 需要 eizzolaunchers.admin 权限

⚠️ 重要说明

关键信息

  1. 双方块要求: 发射器需要在脚部高度和下方一格都有匹配的方块
  2. 基于方向: 发射方向遵循玩家/船的朝向
  3. 冷却系统: 0.5 秒冷却时间防止重复发射
  4. GUI 阻塞: 打开背包 GUI 时禁止发射
  5. 速度缩放: 0-100 的数值会根据玩家/船的不同倍数进行缩放
  6. 轨迹渲染: 轨迹使用垂直偏移向量实现并排流效果
  7. 回退系统: 无效的粒子/声音会自动回退到默认值

速度倍数

玩家模式:

  • 垂直:config × 2.5 ÷ 100 格/刻
  • 水平:config × 3.0 ÷ 100 格/刻

船模式:

  • 垂直:config × 1.5 ÷ 100 格/刻(为了水上旅行降低高度)
  • 水平:config × 4.0 ÷ 100 格/刻(为了增加距离提高速度)

着陆检测

轨迹在以下情况停止:

  • 玩家/实体接触地面 (isOnGround())
  • 实体进入液体 (getBlock().isLiquid())
  • 实体被移除/消失

轨迹偏移计算

Vector dir = entity.getDirection().setY(0).normalize();
Vector sideOffset = new Vector(-dir.getZ(), 0, dir.getX()).normalize().multiply(0.3);
// 在以下位置生成粒子:
// - entity_location + sideOffset(右侧)
// - entity_location - sideOffset(左侧)

? 聊天格式

所有插件消息均使用带有渐变色彩的 MiniMessage 格式:

渐变: 亮红色 (#FF5555) → 暗红色 (#FF0000)

格式: [EIZZOs-Launchers] » Message

示例:

  • 帮助菜单标题
  • 属性变更确认
  • 错误信息
  • 管理员通知

? 配置示例

Speed Runner Course

launchers:
  GOLD_BLOCK:
    vertical: 45
    horizontal: 70
    boat: false
    particle1: SOUL_FIRE_FLAME
    particle2: FLAME
    trail_particle1: SOUL_FIRE_FLAME
    trail_particle2: CRIT
    sound: ENTITY_FIREWORK_ROCKET_LAUNCH

Water Park Ride

launchers:
  PRISMARINE:
    vertical: 35
    horizontal: 85
    boat: true
    particle1: CLOUD
    particle2: HAPPY_VILLAGER
    trail_particle1: WHITE_ASH
    trail_particle2: ASH
    sound: ENTITY_PLAYER_SPLASH

Vertical Cannon

launchers:
  REDSTONE_BLOCK:
    vertical: 95
    horizontal: 10
    boat: false
    particle1: LAVA
    particle2: FLAME
    trail_particle1: SOUL_FIRE_FLAME
    trail_particle2: WHITE_ASH
    sound: ENTITY_WITHER_SHOOT

? 许可证

属于 Minecraft 多人网络服务器使用的 EIZZOs 插件套件的一部分。


版本: 1.0-SNAPSHOT Minecraft: 1.21.1 (Paper) 作者: EIZZO

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源