SiegeCannon

插件

· 作者 Luming77

适用于 Paper 1.21.11 合作 PvE 服务器的可骑乘单人操作 TNT 攻城炮。骑乘后,在扇形范围内瞄准并左键发射。

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

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

功能介绍

SiegeCannon 是一款可骑乘的 TNT 攻城炮,专为合作型 PvE 服务器设计。

与大多数依赖红石建造套件和多玩家装载组的火炮插件不同,SiegeCannon 采取相反的设计理念:一人一炮一触发,拥有扇形射击角度,更强调站位而非瞄准辅助。右键骑乘,潜行下马,左键开火。

特性

  • 骑乘与射击 — 右键骑乘,左键射击,潜行下马
  • ±45° 扇形角度 — 通过转身来瞄准,火炮本体不会自动旋转
  • 可破坏耐久度 — 火炮会受到爆炸和怪物伤害;被摧毁时会产生壮观的爆炸效果
  • 两级引信机制 — 左键触发保险窗口;TNT 在配置好的延迟后(默认 1 秒)实际发射
  • 方块分区处理 — 爆炸产生的掉落物分为“作为掉落物飞行 / 原版销毁 / 保留”三类,营造战场废墟感
  • 仅对怪物范围伤害 — 默认抑制友军伤害
  • 后坐力反馈 — 每次射击都会产生视角抖动和炮身后退效果
  • TPS 感知 — 全局设置掉落物生成上限,防止多炮齐射导致服务器卡顿
  • 可选资源包 — 开箱即用原版 TNT 模型;如果资源包提供了 siegecannon:cannon_tnt 则自动加载自定义模型
  • 双语支持 — 内置 zh_CN / en_US,根据玩家客户端语言自动切换
  • 公开 API — 提供 CannonFireEvent(可取消)和 CannonDestroyEvent 供第三方插件调用

安装方法

  1. 将 siegecannon-1.0.0.jar 放入服务器的 plugins/ 文件夹
  2. 启动服务器。plugins/SiegeCannon/config.yml 和 lang/{zh_CN,en_US}.yml 会自动生成
  3. 运行 /cannon spawn(默认情况下所有玩家都有权限使用)

⚠️ 在 1.0.0 版本中,火炮数据仅存储在内存中。 服务器重启会清除已生成的火炮。持久化功能已在开发计划中。

命令说明

命令 权限 描述
/cannon spawn siegecannon.use (默认开启) 在你脚下生成一门火炮
/cannon spawn <x> <y> <z> [world] siegecannon.admin 在指定坐标生成火炮
/cannon remove siegecannon.use 移除最近的一门火炮(6 格范围内)
/cannon list siegecannon.admin 列出所有已生成的火炮
/cannon removeall siegecannon.admin 移除世界中的所有火炮
/cannon reload siegecannon.admin 重新加载 config.yml

别名:/sc, /siegecannon。

配置说明

大多数服务器只需调整四个“核心”参数即可:

cannon:
  tnt:
    cooldown-seconds: 2.5      # 开火冷却时间
    yaw-limit-deg: 45.0        # 扇形角度半角
    damage-multiplier: 1.0     # 对怪物的伤害倍率
    hp: 100.0                  # 火炮耐久度
    protect-blocks: false      # true = 爆炸不会损坏地图方块
  model:
    use-custom: true           # false = 仅使用原版 TNT 模型
language:
  default: en_US

超出范围的数值会在加载时被限制到安全边界内,并记录为警告日志——插件不会因为配置错误导致服务器崩溃。

API 示例

// 在禁火区内取消开火
@EventHandler
public void onFire(CannonFireEvent event) {
    if (isInsideSafeZone(event.getMuzzle())) {
        event.setCancelled(true);
    }
}

// 统计被摧毁的火炮数量
@EventHandler
public void onDestroy(CannonDestroyEvent event) {
    statsService.recordCannonLoss(event.getLocation());
}

资源包

插件默认使用原版 TNT 模型。若要使用自定义模型:请提供一个包含 assets/siegecannon/models/item/cannon_tnt.json 模型的资源包,并将 cannon.model.use-custom 设置为 true。没有该资源包的客户端会自动无缝回退到原版 TNT 模型。社区资源包已在开发计划中。

指标统计

本插件使用 bStats 收集匿名的安装量和版本统计数据。可通过编辑 plugins/bStats/config.yml 选择退出。

开发计划

  • 附带自定义火炮模型的整合资源包
  • 持久化存储:火炮数据可跨服务器重启保留
  • 演示 GIF / 视频
  • CannonRegistry:允许第三方插件注册自定义火炮类型
  • PlaceholderAPI 集成
  • WorldGuard 区域标志支持 (siegecannon-allowed)
  • 多类型火炮变体(重型 / 轻型 / 穿甲型)
  • 更多语言支持(欢迎社区翻译)

开源协议

MIT — 允许分叉、修改和再分发。建议注明出处,但非强制要求。

源代码

github.com/Yangzhiganlu7/siegecannon — 欢迎提交 Issue / PR。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源