Shoot 射击插件:零前置、可视化造枪、支持 1.20.5 以上 Paper
Shoot 是一款面向 Paper 及衍生服务端的高自定义枪械与粒子技能插件,无需客户端 Mod 或强制材质包,放入 plugins 目录即可运行。它提供六种射击模式、十种可缩放投射物、七种弹道轨迹、三十一种粒子图层和上百种枪械技能事件,并带全中文游戏内 GUI 造枪工作台与开发者 API。帖子还给出安装步骤、指令权限、配置示例和 API 调用示例,适合想给生存服或小游戏服加入枪械玩法的服主与插件开发者参考。
- 需 Paper 或基于 Paper API 的核心,版本 1.20.5 至 1.21.x 及以上
- 需要 Java 21 及以上,兼容 Java 21 至 25
- 无必装前置,Vault 与 DeathZombieV4 为可选软依赖
- 生存服建议保持 legacy.allow_display_name_matching 为 false 以防伪造枪械
- 自定义工作台等管理指令默认仅 OP 可用
| 中文名: | 射击 |
|---|---|
| 外语名: | Shoot |
| 支持版本: | 1.20.x 1.21.x 26.x |
| 适用服务端: | Spigot Paper |
| 插件属性: | 本体插件 前置插件 |
| 插件类型: | 娱乐 |
| 前置插件: | 无前置 |
| 来源: | 原创 |
| 原帖地址: | - |
| 下载地址: | https://www.spigotmc.org/resources/shoot.140663/ |
| 最后更新: | 2026-11-17 |
本帖最后由 Ver_zhzh 于 2026-11-17 01:07 编辑 Shoot — 模块化枪械、制导弹道与粒子技能引擎Shoot 是一款面向现代 Paper 及其衍生服务端的高性能、零强依赖枪械与粒子技能插件。无需客户端 Mod 或强制材质包,即可在原版客户端中实现 6 种射击模式、10 种可缩放 3D 实体/粒子投射物、7 种制导与几何曲线弹道、31 种复合粒子几何图层、100 种可组合枪械技能事件,并提供全中文可视化游戏内 GUI 造枪工作台与完善的开发者 API。 核心特性
环境要求与安装
快速安装
基础操作指南
模块化武器引擎能力一览1. 六大射击模式(
|
| 指令 | 执行端 | 权限节点 | 说明 |
|---|---|---|---|
/shoot help |
玩家 / 控制台 | shoot.use |
查看当前权限可见的指令帮助 |
/shoot display <start\|hit\|reload> <on\|off> |
玩家 | shoot.use |
开关个人射击、命中、换弹屏幕 Title 提示 |
/shoot get <枪械ID或名称> |
玩家 | shoot.admin |
给自己发放指定预设枪或自定义枪(已持有则自动补满弹药) |
/shoot give <玩家> <枪械ID或名称> |
玩家 / 控制台 | shoot.admin |
向指定在线玩家发枪或补弹(可直接对接菜单、抽奖箱、命令方块) |
/shoot up |
玩家 | shoot.admin |
立即补满主手枪械的弹匣与备用弹药 |
/shoot gui |
玩家 | shoot.admin |
打开分页枪械库 GUI 点击取枪 |
/shoot reload |
玩家 / 控制台 | shoot.admin |
热重载 config.yml、preset_guns.yml、custom_guns.yml 并刷新在线玩家枪械显示 |
/shoot clean |
玩家 / 控制台 | shoot.admin |
立即清扫所有世界中残留的插件临时投射物实体并回滚临时陷阱方块 |
/shoot debuggun / /shoot debugfire |
玩家 | shoot.admin |
查看主手枪械解析状态 / 强制触发一次调试射击 |
自定义枪械工作台指令(/shoot make)
| 指令 | 执行端 | 权限节点 | 说明 |
|---|---|---|---|
/shoot make list |
玩家 | shoot.make |
打开「自定义枪械库」总览面板(支持新建、左键编辑、右键直接取枪试射) |
/shoot make create <gunId> |
玩家 | shoot.make |
打开可视化创建面板新建枪械(保存时自动规范化 custom_ 前缀) |
/shoot make edit [gunId] |
玩家 | shoot.make |
编辑指定枪械;省略参数时直接编辑当前主手所持自定义/导入枪械 |
/shoot make delete <gunId> |
玩家 | shoot.make |
删除指定自定义枪械 |
/shoot make give <玩家> <gunId> |
玩家 / 控制台 | shoot.make |
发放指定自定义或 API 导入枪械 |
/shoot make reload |
玩家 / 控制台 | shoot.make.reload |
单独热重载 custom_guns.yml |
权限节点说明
shoot.use(默认:true):允许使用/shoot help与/shoot displayshoot.make(默认:op):允许使用自定义枪械 GUI 工作台全部功能(包含shoot.make.reload)shoot.make.reload(默认:op):允许重载自定义枪械配置shoot.admin(默认:op):管理员全量权限(自动继承shoot.use、shoot.make、shoot.make.reload)
配置文件说明
1. config.yml
# 调试日志开关(生产环境请保持 false)
debug: false
# 防移动/防副手/防丢弃拦截时是否发送聊天框提示(false = 静默拦截)
error_messages:
enabled: false
# 弹药显示与生存服经验保护
ammo_display:
use_xp_bar: true
# 开启后切枪自动快照玩家真实生存经验,切回普通物品或退服时原样归还,且持枪期间禁止附魔台消耗虚拟等级
snapshot_survival_xp: true
# 旧版无 PDC 物品名称匹配兼容(生存服请务必保持 false,防止铁砧改名伪造枪械)
legacy:
allow_display_name_matching: false
# 密集战斗粒子限流
particles:
global_max: 8000
per_player_max: 400
fallback: FLAME
# 极简射击粒子模式(开启后仅保留命中瞬间粒子,最大化帧率与网络吞吐)
performance:
minimal_shoot_particles: false
2. custom_guns.yml 进阶配置示例
除了在游戏内使用 /shoot make 可视化编辑外,也可直接编写 YAML:
custom_guns:
star_seeker:
name: "&b&l星轨追猎者"
material: DIAMOND_HOE
lore:
- "&7发射自动索敌的末影水晶能量弹"
ammo: 180
clip_size: 18
reload_time: 2.2
cooldown: 0.35
damage: 120
special_damage: 80
range: 75
sounds:
shoot_start: "ENTITY_ILLUSIONER_CAST_SPELL"
shoot_hit: "ENTITY_GENERIC_EXPLODE"
volume: 1.0
pitch: 1.2
shoot_mode:
type: "SINGLE_BULLET"
speed: 2.2
range: 75
penetration: false
gravity: false
projectile:
type: "ENDER_CRYSTAL"
speed: 2.2
size: 0.6
lifetime: 5.0
trajectory:
enabled: true
pattern: "HOMING"
turn_rate: 0.18
lock_distance: 28.0
gun_events:
- type: "CHAIN_LIGHTNING"
trigger: "ON_HIT"
max_targets: 4
range: 8.0
damage_reduction: 0.6
- type: "SPEED_BOOST"
trigger: "ON_KILL"
duration: 3.0
level: 2
开发者 API 接入指南
Shoot 在启动时通过 Bukkit ServicesManager 注册了 org.Ver_zhzh.shoot.api.ShootApi 服务,第三方插件(如 RPG 怪物/Boss 插件、小游戏插件、商店插件)可零耦合接入:
1. plugin.yml 声明软依赖
softdepend: [Shoot]
2. 获取 ShootApi 实例与常用调用
import org.Ver_zhzh.shoot.api.ShootApi;
import org.bukkit.Bukkit;
import org.bukkit.entity.LivingEntity;
import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack;
import org.bukkit.util.Vector;
ShootApi shootApi = Bukkit.getServicesManager().load(ShootApi.class);
if (shootApi != null) {
// 1. 生成带标准防伪 PDC 签名的枪械物品,或直接向玩家发枪/补弹
ItemStack gunItem = shootApi.createGunItem("毁灭者");
shootApi.giveGun(player, "custom_lightning_rifle");
// 2. 让任意实体(玩家、自定义怪物、Boss)朝指定方向向量直接发射任意枪械!
Vector aimDirection = bossEntity.getLocation().getDirection();
shootApi.shootGun(bossEntity, "步枪", aimDirection);
// 3. 给玩家当前主手枪械施加 30 秒临时超载(1.5 倍伤害 + 0.8 倍冷却 + 额外弹匣 + 命中附带雷击)
var currentGun = shootApi.resolveGunFromItem(player.getInventory().getItemInMainHand());
if (currentGun != null) {
shootApi.applyTemporaryWeaponUpgrade(player, currentGun, 30, 1.5, 0.8, 10, 60, "LIGHTNING_STRIKE");
}
// 4. 一键补满玩家背包内所有枪械弹药
int refilledCount = shootApi.replenishAllPlayerGuns(player);
}
此外,ShootApi 还提供:
registerGunEvent(...)/registerSpecialEffect(...):注册外部自定义的枪械事件与特殊效果,自动融入 Shoot 执行链;registerImportedGun(Gun):动态注入外部插件定义的枪械,可在/shoot make list面板中查看与快照调参;applyAllGunsDamageBoost(...)/activateNextHitHealthPercentBonus(...)/activateMoneyMultiplier(...)/scheduleTeamRally(...):团队增益状态与倒计时 BossBar 托管。
从源码构建
需要 JDK 21+ 与 Maven 3.9+:
# 标准构建并运行全部单元测试(生成 target/shoot-1.5.0.jar)
mvn clean package
作者与许可
- 作者:
Ver_zhzh - 当前版本:
1.5.0
运行截图(部分的)
-
-
1.08 MB, 下载次数: 0
提升卡
观察者