Turbo - DragonMineZ Addon
- By
Turbo Mode is a lightweight addon for DragonMineZ that adds a customizable "turbo mode for those who played DBC" with movement/combat bonuses and Ki visuals, without touching the original mod's balance.
# Turbo Mode — DragonMineZ Addon
**Version:** 0.1
**Compatible with:** DragonMineZ 2.2 | Minecraft 1.20.1 | Forge 47.4.10
**License:** GPLv3
---
## 📋 Description
Turbo Mode is a lightweight addon for **DragonMineZ** that adds a customizable "turbo mode" with movement/combat bonuses and Ki visuals, without touching the original mod's balance.
> **Not a cheat:** consumes Ki per second, auto-disables on death/relog/out of Ki, and bonuses are configurable (defaults +10–12%).
---
## ⚡ Features
### Turbo Mode (main key)
- **Permanent aura** around the player (configurable)
- **Passive bonuses** while active:
- Sprint speed (`runBonus`, default +12%)
- Jump height (`jumpBonus`, default +10%)
- Punch/melee damage (`punchBonus`, default +10%)
- **Cost:** `kiCostPercentPerSecond` % of max Ki per second (default 0.5%/s)
### Surge Visuals (modifier keys)
| Combo | Effect |
|-------|--------|
| `key` | Permanent aura |
| `Ctrl + key` | **Only** Ki surge visual (no permanent aura, no Ki cost) |
> Surge visual is **purely cosmetic** — no flight/speed bonuses, no cooldown.
## ⌨️ Controls
The key is **unbound by default**. Set it in:
**Options → Controls → Turbo Mode → "Toggle Turbo Mode"**
- **Key alone:** Toggle full Turbo
- **Ctrl + key:** Surge visual only
---
## ⚙️ Configuration (serverconfig/turbomode-server.toml)
```toml
[turbo]
# Ki cost per second (% of max Ki)
kiCostPercentPerSecond = 0.5
# Bonuses while Turbo is active
runBonus = 0.12
jumpBonus = 0.10
punchBonus = 0.10
# Permanent aura opacity in 1st person (0.0 = invisible, 1.0 = normal)
firstPersonAuraOpacity = 0.3
[kiSurge]
# EXTRA bonuses added on top of DMZ's DEFAULT Ki Surge (set higher than Turbo for Surge to feel stronger)
runBonus = 0.20
jumpBonus = 0.20
punchBonus = 0.30
[surgeVisual]
# Vignette/darkening intensity on screen edges (0.0 = off)
vignetteIntensity = 0.15
# Blue glow intensity on screen edges (0.0 = off)
glowIntensity = 0.08
```
---
## 🔧 Installation
1. Install **Minecraft 1.20.1 + Forge 47.4.10**
2. Install **DragonMineZ 2.2** (required)
3. Drop `TurboMode.jar` into `mods/` alongside DMZ
4. Launch and bind the key in Controls
---
## ⚠️ Known Limitations
- Surge-aura may **not show in 1st person** (arm uses separate DMZ renderer) and varies with shaders
---
## 🐛 Bug Reports / Suggestions
**Don't report base DMZ bugs here** — addon only.
---
## 📜 Credits
- **Turbo Button Mod** by *RayzinPL*
- **DragonMineZ** by *ezShokkoh* — base mod
- **SpongePowered Mixin** — bytecode injection
- **ForgeGradle / Parchment** — dev toolchain
---
**Made by a DMZ player, for DMZ players.**
Enjoy flying (metaphorically) with Ki! 🐉⚡
Turbo - DragonMineZ Addon Team
