# NPC Fusion
**An addon for DragonMineZ that lets you fuse with NPCs — because fusion shouldn't need a friend online.**
---
## [ENGLISH]
### The gap this fills
DragonMineZ already has fusion: Metamoru (the Fusion Dance) and Potara. Both of them need
**two players online at the same time, in the same place**. If you play singleplayer, or
your server emptied out because your friends stopped logging in, that entire half of the
mod is content you will never once get to use.
NPC Fusion gives you the other side of it. Every NPC DragonMineZ already puts in your
world — Master Roshi, King Kai, Piccolo, the saga bosses, the quest NPCs — becomes a
fusion partner.
### Two ways to fuse
**Fusion Dance** — free, no item needed.
Walk up to any DragonMineZ NPC, empty your main hand, crouch and right-click it. Then
**keep holding crouch**. Purple and gold energy spirals around the two of you, a chime
rises in pitch, and after three and a half seconds the fusion snaps shut.
It can fail, and that is the point. Stand up, walk more than four blocks away, or take a
single hit mid-dance and the whole thing breaks and you have to start over. Fusing in the
middle of a fight is a real gamble.
Lasts **10 minutes**.
**NPC Potara** — a craftable earring (3 gold ingots, 1 amethyst shard, 1 eye of ender).
Right-click an NPC while holding it and you fuse instantly. No dance, no window for
anything to interrupt you, nothing to hold. The earring is consumed.
Lasts **30 minutes**.
Either way, there is a **5 minute cooldown** afterwards before you can fuse again.
### What it actually looks and feels like
While you are fused:
- **Your name changes.** It is the two names blended together, the way Vegetto and Gotenks
work. `Nkiko` + `Master Goku` becomes **Nkikoku**. `Nkiko` + `Perfect Cell` becomes
**Nkikell**. It shows above your head, in chat, and in the tab list — and other players
on the server see it too, not just you.
- **Your character changes color.** Body, hair and aura get mixed with a color that belongs
to that specific NPC type, so fusing with Frieza does not look like fusing with Krillin.
One of your eyes turns the partner's color and the other stays yours, like Fused Zamasu.
- **A timer sits in the top-right corner** showing your fusion name and how long is left,
and it warns you in chat ten seconds before it breaks.
Your original appearance is saved before anything is touched and put back at the end.
### The power you get is scaled to who you fused with
This is not a flat buff. The bonus is a **fraction of your own stats**, worked out from the
partner's battle power divided by yours, clamped between 10% and 100%, then multiplied by
0.75.
In practice:
- Fusing with **Master Roshi when you are already strong** barely moves the needle. He is
not going to carry you.
- Fusing with **Perfect Cell** gives you a lot — but it is capped, so you do not come out
the other side untouchable and bored.
- Fusing with something far above you is worth doing **early**, when the gap is biggest.
The bonus is applied to STR, SKP, RES, PWR, VIT and ENE through DragonMineZ's own bonus
system, so it shows up on its stat screens, feeds into your battle power, and your max
health updates immediately instead of after a relog.
Because it scales off a ratio instead of a hardcoded table, it keeps working sensibly when
DragonMineZ rebalances its numbers, and no single NPC becomes the mandatory one to farm.
### Your partner is not deleted
The NPC is stored whole — health, gear, name, everything — and **put back into the world
next to you** when the fusion ends, exactly as it was. It will not attack you for 15
seconds after it reappears, so you do not get jumped the instant you split.
The fusion ends when the timer runs out, when you run `/npcfusion end`, when you die, or
when a real DragonMineZ player-to-player fusion takes over. All four paths return the NPC.
It also survives logging out: the fusion is stored on your character, the NPC travels
inside it, and both are still there when you come back.
### Commands
| Command | What it does |
|---|---|
| `/npcfusion status` | Your current fusion and the time left |
| `/npcfusion end` | Split apart right now |
| `/npcfusion nearby` | Lists every valid fusion partner within 16 blocks, with distances |
| `/npcfusion restore` | Safety valve — puts your saved appearance back if it ever got stuck |
### Configurable
Everything above is a number in `config/npcfusion-server.toml`: both durations, the
cooldown, the dance length, the range, how much power fusion gives, whether your colors
change at all, and whether the NPC comes back.
You also control **who counts as a partner**. By default it is every DragonMineZ NPC except
the things that make no sense (dinosaurs, Nimbus clouds, ki projectiles, the punch machine).
Set `allow_any_mob = true` and you can fuse with anything alive, vanilla mobs and other
mods included. Androids cannot fuse, matching DragonMineZ's own rule — and that is a toggle
too.
### Requirements
- Minecraft **1.20.1**
- Forge **47+**
- **DragonMineZ 2.1+** — required. The game will not start without it.
---
## [PORTUGUÊS]
### O buraco que isto tapa
O DragonMineZ já tem fusão: Metamoru (a Dança da Fusão) e Potara. As duas precisam de
**dois jogadores online ao mesmo tempo, no mesmo sítio**. Quem joga sozinho, ou tem o
servidor vazio porque os amigos desistiram, nunca chega a usar essa metade do mod.
O NPC Fusion dá-te o outro lado. Todos os NPCs que o DragonMineZ já põe no teu mundo —
Mestre Kame, Kaio, Piccolo, os bosses das sagas, os NPCs de missão — passam a ser parceiros
de fusão.
### Duas maneiras de fundir
**Dança da Fusão** — de graça, sem item.
Chega-te a um NPC do DragonMineZ, esvazia a mão principal, agacha-te e carrega com o botão
direito. Depois **mantém o agachar**. Energia roxa e dourada gira à volta dos dois, um som
vai subindo de tom, e ao fim de três segundos e meio a fusão fecha.
Pode falhar, e é isso que a torna interessante. Levantas-te, afastas-te mais de quatro
blocos, ou levas um único golpe a meio — e rebenta tudo, tens de começar de novo. Fundir no
meio de uma luta é mesmo um risco.
Dura **10 minutos**.
**Potara de NPC** — um brinco que se constrói (3 lingotes de ouro, 1 fragmento de ametista,
1 olho do end).
Carrega no NPC com ele na mão e fundes na hora. Sem dança, sem janela para te
interromperem, sem nada para segurar. O brinco gasta-se.
Dura **30 minutos**.
Em qualquer dos casos há **5 minutos de espera** antes de poderes fundir outra vez.
### O que se vê e o que se sente
Enquanto estás fundido:
- **O teu nome muda.** É a mistura dos dois, como o Vegetto e o Gotenks. `Nkiko` +
`Master Goku` dá **Nkikoku**. `Nkiko` + `Perfect Cell` dá **Nkikell**. Aparece por cima
da cabeça, no chat e na tab list — e os outros jogadores no servidor também o veem, não
és só tu.
- **A tua personagem muda de cor.** Corpo, cabelo e aura são misturados com uma cor própria
daquele tipo de NPC, por isso fundir com o Freeza não fica igual a fundir com o Krillin.
Um dos olhos fica com a cor do parceiro e o outro continua teu, como o Zamasu fundido.
- **Um contador no canto superior direito** com o nome de fusão e o tempo que falta, e um
aviso no chat dez segundos antes de acabar.
A tua aparência original é guardada antes de se lhe tocar e reposta no fim.
### O poder é proporcional a quem fundiste
Não é um bónus fixo. É uma **fração dos teus próprios atributos**, calculada a partir do
battle power do parceiro a dividir pelo teu, limitada entre 10% e 100% e multiplicada por
0.75.
Na prática:
- Fundir com o **Mestre Kame quando já és forte** quase não muda nada. Ele não te vai
carregar.
- Fundir com o **Cell Perfeito** dá muito — mas há um tecto, para não saíres de lá
intocável e sem graça.
- Fundir com algo muito acima de ti compensa **cedo**, quando a diferença é maior.
O bónus entra em STR, SKP, RES, PWR, VIT e ENE pelo sistema de bónus do próprio
DragonMineZ, por isso aparece nos ecrãs dele, conta para o battle power, e a vida máxima
acerta na hora em vez de só depois de sair e voltar.
Como é uma razão e não uma tabela fixa, continua a fazer sentido quando o DragonMineZ
mexer nos números, e nenhum NPC passa a ser o obrigatório para farmar.
### O parceiro não é apagado
O NPC é guardado inteiro — vida, equipamento, nome, tudo — e **devolvido ao mundo ao teu
lado** quando a fusão acaba, tal como estava. Fica 15 segundos sem te atacar, para não
levares logo um murro assim que se separam.
A fusão acaba quando o tempo esgota, com `/npcfusion end`, quando morres, ou quando uma
fusão normal do DragonMineZ entre jogadores toma conta. Os quatro caminhos devolvem o NPC.
Também aguenta saíres do jogo: a fusão fica guardada na tua personagem, o NPC viaja lá
dentro, e estão os dois à tua espera quando voltares.
### Comandos
| Comando | O que faz |
|---|---|
| `/npcfusion status` | A fusão atual e o tempo que falta |
| `/npcfusion end` | Separa já |
| `/npcfusion nearby` | Lista os parceiros válidos num raio de 16 blocos, com as distâncias |
| `/npcfusion restore` | Rede de segurança — repõe a aparência guardada se tiver ficado presa |
### Tudo configurável
Tudo o que está aqui em cima é um número no `config/npcfusion-server.toml`: as duas
durações, a espera, o tempo de dança, o alcance, quanto poder a fusão dá, se as cores
mudam sequer, e se o NPC volta.
Também controlas **quem conta como parceiro**. Por omissão são todos os NPCs do
DragonMineZ menos o que não faz sentido (dinossauros, nimbus, projéteis de ki, a máquina de
socos). Com `allow_any_mob = true` passas a poder fundir com qualquer coisa viva, mobs do
Minecraft e de outros mods incluídos. Androides não fundem, tal como no DragonMineZ — e
isso também se desliga.
### Requisitos
- Minecraft **1.20.1**
- Forge **47+**
- **DragonMineZ 2.1+** — obrigatório. O jogo não arranca sem ele.
---
*by Frisguis Addons — MIT licensed*
npc FUNSION (DRAGONMINEZ) Team
