# Turbo Mode — DragonMineZ 附属模组

**版本：**0.1

**兼容版本：**DragonMineZ 2.2 | Minecraft 1.20.1 | Forge 47.4.10

**许可证：**GPLv3

—

## 📋 描述

Turbo Mode 是一款轻量级的 **DragonMineZ** 附属模组，可添加可自定义的“Turbo Mode”，提供移动与战斗加成以及 Ki 视觉效果，同时不会影响原模组的平衡性。

> **不是作弊：**每秒消耗 Ki，死亡、重新登录或 Ki 耗尽时会自动关闭；加成可配置（默认 +10–12%）。

—

## ⚡ 功能

### Turbo Mode（主按键）

– 玩家周围会持续显示**光环**（可配置）

– 启用时获得**被动加成**：

– 冲刺速度（`runBonus`，默认 +12%）

– 跳跃高度（`jumpBonus`，默认 +10%）

– 拳击/近战伤害（`punchBonus`，默认 +10%）

– **消耗：**每秒消耗最大 Ki 的 `kiCostPercentPerSecond`%（默认 0.5%/秒）

### Surge 视觉效果（组合按键）

| 组合按键 | 效果 |

|——-|——–|

| `key` | 持续显示光环 |

| `Ctrl + key` | **仅**显示 Ki Surge 视觉效果（无持续光环，不消耗 Ki） |

> Surge 视觉效果**纯属装饰** — 不提供飞行/速度加成，也没有冷却时间。

## ⌨️ 控制

默认**未绑定按键**。请在此处设置：

**选项 → 控制 → Turbo Mode → “Toggle Turbo Mode”**

– **单独按下按键：**切换完整 Turbo 模式

– **Ctrl + 按键：**仅显示 Surge 视觉效果

—

## ⚙️ 配置（serverconfig/turbomode-server.toml）

“`toml

[turbo]

# 每秒 Ki 消耗（最大 Ki 的百分比）

kiCostPercentPerSecond = 0.5

# Turbo 启用时的加成

runBonus = 0.12

jumpBonus = 0.10

punchBonus = 0.10

# 第一人称视角下持续光环的不透明度（0.0 = 不可见，1.0 = 正常）

firstPersonAuraOpacity = 0.3

[kiSurge]

# 叠加在 DMZ 默认 Ki Surge 加成之上的额外加成（设得比 Turbo 高，Surge 才会更强）

runBonus = 0.20

jumpBonus = 0.20

punchBonus = 0.30

[surgeVisual]

# 屏幕边缘的暗角/变暗强度（0.0 = 关闭）

vignetteIntensity = 0.15

# 屏幕边缘的蓝色辉光强度（0.0 = 关闭）

glowIntensity = 0.08

“`

—

## 🔧 安装

1. 安装 **Minecraft 1.20.1 + Forge 47.4.10**

2. 安装 **DragonMineZ 2.2**（必需）

3. 将 `TurboMode.jar` 放入 `mods/`，与 DMZ 一同安装

4. 启动游戏，并在控制设置中绑定按键

—

## ⚠️ 已知限制

– Surge 光环在第一人称视角下**可能无法显示**（手臂使用独立的 DMZ 渲染器），且显示效果会随光影而变化

—

## 🐛 Bug 反馈 / 建议

**请勿在此反馈 DMZ 本体的 Bug** — 这里只处理附属模组相关问题。

—

## 📜 致谢

– *RayzinPL* 制作的 **Turbo Button Mod**

– *ezShokkoh* 制作的 **DragonMineZ** — 本体模组

– **SpongePowered Mixin** — 字节码注入

– **ForgeGradle / Parchment** — 开发工具链

—

**由 DMZ 玩家制作，献给 DMZ 玩家。**

祝你用 Ki 尽情飞行（比喻意义上）！🐉⚡

Turbo – DragonMineZ Addon

介绍

常见问题

Turbo – DragonMineZ Addon 支持哪些 Minecraft 版本？

Turbo – DragonMineZ Addon 怎么安装？

评论