# swarm-drones

**Repository Path**: he666zz/swarm-drones

## Basic Information

- **Project Name**: swarm-drones
- **Description**: minecarft mod

- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-01
- **Last Updated**: 2026-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Swarm Drones（蜂群无人机）

Minecraft **1.20.1 / Forge** 模组 —— 一键召唤式蜂群空袭：一架大型运输机掠顶而过，投放一群攻击无人机与氛围无人机，黑云压城、铺天盖地。

> 作者：HE666zz ｜ 许可证：MIT

## ✨ 功能

- **一键召唤**：使用「蜂群无人机」手机召唤，8 秒倒计时后母机掠顶投放，蜂群从机尾结群涌出再散开（如蜜蜂出巢）。
- **攻击无人机**：优先攻击距玩家最近的敌对目标，锁定后高速俯冲、手动写实爆炸；击杀归属玩家。
- **氛围无人机**：数十上百架分层巡飞，多高度覆盖，形成「黑云压城城欲摧」的压迫感。
- **母机**：涡扇引擎声、夜间航灯、投放前干扰弹、天空闷雷。
- **全图可闻嗡鸣**：投放后整个天空持续嗡嗡作响（程序合成低频群蜂音效）。
- **6 种召唤播报语音**：英文 / 中文 / 甜美女声 / 酷辣女生 / 文言男声 / 英文女声，可配置（默认英文）。
- **头顶标记**：攻击机 billboard 菱形标记，颜色（标准红/蓝/黄/紫/白/自定义）与大小均可配置。
- **独立配置界面**：游戏中直接调整，无需手改 JSON。

### 💥 2.0 新增：电影级爆炸与镜头震动

- **自定义特效管线**：爆炸不再调用原版 `sendParticles`，服务端只发一个 32 字节触发包，
  客户端用自研 `RenderType` + 顶点缓冲直接绘制，一帧最多 2 次 draw call。
- **四层爆炸结构**：扩散冲击波圆环 → 3 层翻涌火球球壳 → 弹片碎片 → 体积尘云。
- **镜头震动**：Mixin 注入 `Camera.setup`，世界与视角一起位移 + 旋转（创伤值模型，连爆自然叠加）。
- **性能自适应**：同时爆炸数超过 12 个时自动降一档细节，可在配置里锁死质量档位。


## 📥 依赖

| 项目 | 版本 |
| --- | --- |
| Minecraft | 1.20.1 |
| Forge | 1.20.1-47.4.x |

## 🚀 安装

1. 安装 Forge 1.20.1-47.4.x。
2. 将 `swarm_drones-2.0.1.jar` 放入 `.minecraft/mods` 文件夹。
3. 启动游戏，即可手持「蜂群无人机」右键召唤。

## ⚙️ 配置

游戏内 Mod Options → Swarm Drones 打开配置界面：

- 是否显示 BossBar
- 攻击无人机数量（10–50，默认 20）
- 是否显示头顶标记、标记颜色 / 大小
- 投放前天空闷雷开关
- 召唤播报语音（6 种）
- 自定义爆炸特效开关 / 特效质量（低·中·高）
- 镜头震动强度（0–200，0 = 关闭）

### 兼容性说明（2.0）

- **Sodium / Embeddium**：特效走的是同一套立即绘制缓冲，不依赖区块渲染管线；镜头震动只改
  `Camera` 的位置与朝向，不与 Sodium 冲突。
- **光影（Iris / Oculus）**：自定义几何体在光影包下仍会绘制，但不会参与光影包的后处理与光照，
  观感会比原版渲染略平；如需完全一致的画面，可在光影设置里关闭本模组的自定义特效。
- **其它模组**：`Camera` 注入点是 `setup` 的 RETURN，注入失败会直接报错而不是静默失效
  （配合 `swarm_drones.refmap.json` 做 SRG 映射）。

## 📢 版权与素材声明（重要）

本模组坚持「零侵权」素材原则：

- **音效**：全部为程序合成（numpy）或 AI 合成人声，**无任何第三方采样**。
- **模型**：无人机 / 母机 / 手机模型均为**自绘原创几何体**，非导入第三方模型。
- **贴图**：全部自建 / 程序生成。
- 模组仅依赖 Forge 与 Minecraft 原版框架，未嵌入任何第三方版权资源。

## 📄 许可证

本项目采用 **MIT 许可证**，详见 [LICENSE](LICENSE)。