CobbleAction: Action Combat

🇬🇧 ENGLISH

Cobblemon Real-Time Battle

Turn Cobblemon’s turn-based wild battles into real-time arena fights, where you control your Pokémon directly.

Fabric · Minecraft 1.21.1 · Requires Cobblemon · Prototype v0.1.0

What is it?

Cobblemon Real-Time Battle is an add-on for Cobblemon that replaces the classic turn-based menu with a fast, action-style arena. When you start a battle against a wild Pokémon, the camera moves behind your Pokémon, and you move it with WASD, jump, aim, and fire off moves with hotkeys or clickable buttons. Your opponent does the same, thinking, dodging, and fighting back in real time.

The server is fully authoritative: the client only sends intent (movement, aim, move slot), and the server handles physics, damage, cooldowns, and status effects. Because it runs on real Cobblemon data, your Pokémon’s stats, moves, PP, XP, and EVs all carry over to the normal game.

Features

🎮 Direct control

• Move your Pokémon with WASD and jump with Space. Movement uses custom server-side physics (gravity, jumping, collisions, water), independent of Minecraft mob AI.
• Walking speed comes from the Pokémon’s real Speed stat, and is affected by stat stages and paralysis.
• Free third-person camera behind your Pokémon, with three zoom levels (close / medium / far) that scale with the Pokémon’s size.
• Your own body stays still during the fight, so you can’t accidentally interact with the world.

⚔️ Real-time moves

• Physical moves are melee dashes of about 4 blocks toward your aim. Special moves are projectiles with type-based particles and sounds.
• Attack and Defense (physical) or Sp. Atk and Sp. Def (special) feed into the damage formula, along with STAB, the full type-effectiveness chart, stat stages, random variance, and critical hits (about 1 in 24, ×1.5).
• Hits cause knockback, and a melee dash stops when it connects.

🎯 Smart aiming

• Free aim: moves go where you look, with aim-assist if the opponent is within about 20°.
• Aim lock (Q): the camera follows the opponent and projectiles lead their movement.
• On-screen crosshair (turns red when a hit is likely), an opponent marker showing distance, and an arrow pointing at the opponent when they’re off-screen.

⏱️ Real PP + cooldowns

• Every move uses 1 real Cobblemon PP, which persists outside battle. No PP means the move stops working until you restore it.
• Each move has a cooldown of at least 3.5 s that grows with its power (power 40 = 3.5 s, 90 ≈ 7.5 s, 120 ≈ 10 s, 150+ = 12 s), plus a short 0.4 s global cooldown.
• When every move is out of PP, you use Struggle: melee, power 50, typeless, 5 s cooldown, and 25% max-HP recoil.
• The HUD shows the cooldown rising on each button, the time left, and the current PP.

🌀 Status moves that actually work

• Heals (Recover, Roost…), buffs (Swords Dance, Calm Mind, Shell Smash…), debuffs (Growl, Leer, Screech…), and status moves on the foe (Thunder Wave, Will-O-Wisp, Toxic, Sleep Powder, Hypnosis…), fired as projectiles.
• Stat stages range from −6 to +6 and affect damage and speed.
• Damaging moves can inflict status, using per-move data plus type-based defaults.

🔥 Temporary battle statuses

Type immunities apply (Fire can’t burn, Electric can’t be paralyzed, Grass is immune to powders, etc.), and waking up or thawing grants 6 s of protection.

🎒 Bag

• Open the item table with B. It lists the usable Cobblemon items in your inventory, and you click a row to use one.
• Supported: Potions (Potion → Full Restore), Revive / Max Revive, status cures, Ether/Elixir (PP restore), X-items (+2), and Oran, Sitrus, Cheri, Chesto, Pecha, Rawst, Aspear, Lum, and Leppa berries.
• 5 s item cooldown. Items are only consumed if they have an effect (not in Creative), and the server validates everything.

🔁 Party swapping

• Cycle through your team with R / G (5 s cooldown). When your Pokémon faints, the next healthy one is sent in automatically.

🧠 Opponent AI

• Scores moves by power, STAB, effectiveness, and the target’s stats.
• Keeps its distance with ranged moves or when low on HP, rushes in with melee moves, and heals when hurt.
• Leads its shots, dodges your projectiles (more attentively when you’re aiming at it), and uses PP, cooldowns, buffs, and status moves like you do.

🏆 Rewards

• Real XP (base yield × level / 5, split among surviving participants) and real EVs from the species’ EV yield.

Controls (all rebindable)

Commands

• /rtbattle toggle (OP) switches the mod ON/OFF, so you can go back to the original turn-based battles at any time.

Requirements

• Minecraft 1.21.1, Fabric Loader ≥ 0.16, Java 21+
• Fabric API, Fabric Language Kotlin
• Cobblemon ≥ 1.8.2
• Needed on both client and server.

Current limitations (prototype)

• Only player vs wild Pokémon, with no PvP, NPC trainers, or capture yet.
• No accuracy checks, weather, abilities, or held items.
• Status moves not yet in the effects table show “But nothing happened…” and can be added easily.
• A battle ends if you and the wild Pokémon get more than 48 blocks apart or if you disconnect.

🇧🇷 PORTUGUÊS

Cobblemon Batalha em Tempo Real

Transforme as batalhas por turnos contra Pokémon selvagens do Cobblemon em lutas de arena em tempo real, onde você controla o seu Pokémon.

Fabric · Minecraft 1.21.1 · Requer Cobblemon · Protótipo v0.1.0

O que é?

Cobblemon Batalha em Tempo Real é um complemento para o Cobblemon que troca o menu clássico por turnos por uma arena rápida, estilo ação. Ao iniciar uma batalha contra um Pokémon selvagem, a câmera passa para trás do seu Pokémon, e você o move com WASD, pula, mira e usa golpes por teclas ou botões clicáveis. O oponente faz o mesmo: pensa, desvia e revida em tempo real.

O servidor é a autoridade total: o cliente envia só a intenção (movimento, mira, golpe), e o servidor cuida de física, dano, cooldowns e status. Como tudo roda sobre dados reais do Cobblemon, status, golpes, PP, XP e EVs do seu Pokémon continuam valendo no jogo normal.

Recursos

🎮 Controle direto

• Mova o Pokémon com WASD e pule com Espaço. O movimento usa física própria no servidor (gravidade, pulo, colisão, água), sem depender da IA dos mobs do Minecraft.
• A velocidade vem do atributo Velocidade real do Pokémon, e é afetada por estágios de atributo e paralisia.
• Câmera livre em terceira pessoa atrás do Pokémon, com três distâncias (perto / média / longe) que se adaptam ao tamanho dele.
• Seu corpo fica parado durante a luta, então você não interage com o mundo sem querer.

⚔️ Golpes em tempo real

• Golpes físicos são investidas corpo a corpo de uns 4 blocos na direção da mira. Golpes especiais são projéteis, com partículas e sons por tipo.
• Atk/Def (físico) ou Atq. Esp./Def. Esp. (especial) entram na fórmula de dano, junto com STAB, a tabela completa de efetividade de tipos, estágios de atributo, variação aleatória e críticos (cerca de 1 em 24, ×1,5).
• Os golpes causam recuo, e a investida para ao acertar.

🎯 Mira inteligente

• Mira livre: o golpe sai para onde você olha, com aim-assist se o oponente estiver a cerca de 20°.
• Mira travada (Q): a câmera acompanha o oponente e os projéteis antecipam o movimento dele.
• Mira central na tela (vermelha quando provavelmente acerta), marcador do oponente com a distância e uma seta indicando o lado quando ele sai da tela.

⏱️ PP real + cooldown

• Cada golpe gasta 1 PP real do Cobblemon, que persiste fora da batalha. Sem PP, o golpe deixa de funcionar até você restaurar.
• Cada golpe tem cooldown de no mínimo 3,5 s, que cresce com o poder (poder 40 = 3,5 s, 90 ≈ 7,5 s, 120 ≈ 10 s, 150+ = 12 s), além de um cooldown global curto de 0,4 s.
• Quando todos os golpes ficam sem PP, você usa o Esforço (Struggle): corpo a corpo, poder 50, sem tipo, cooldown de 5 s e recuo de 25% da vida máxima.
• O HUD mostra a faixa de cooldown subindo em cada botão, o tempo restante e o PP atual.

🌀 Golpes de status que funcionam de verdade

• Curas (Recover, Roost…), buffs (Swords Dance, Calm Mind, Shell Smash…), debuffs (Growl, Leer, Screech…) e status no oponente (Thunder Wave, Will-O-Wisp, Toxic, Sleep Powder, Hypnosis…), lançados como projétil.
• Estágios de atributo vão de −6 a +6 e afetam dano e velocidade.
• Golpes de dano podem causar status, com dados por golpe e padrões por tipo.

🔥 Status temporários de batalha

As imunidades por tipo valem (Fogo não queima, Elétrico não paralisa, Planta é imune a pós etc.), e ao acordar ou descongelar há 6 s de proteção.

🎒 Mochila

• Abra a tabela de itens com B. Ela lista os itens do Cobblemon utilizáveis no seu inventário, e você clica numa linha para usar.
• Suportados: Poções (Potion → Full Restore), Revive / Max Revive, curas de status, Ether/Elixir (PP), itens X (+2) e as berries Oran, Sitrus, Cheri, Chesto, Pecha, Rawst, Aspear, Lum e Leppa.
• Cooldown de 5 s entre itens. O item só é gasto se tiver efeito (e não no Criativo), e o servidor valida tudo.

🔁 Troca de Pokémon

• Alterne entre os Pokémon da equipe com R / G (cooldown de 5 s). Se o seu Pokémon desmaiar, o próximo saudável entra automaticamente.

🧠 IA do oponente

• Avalia os golpes por poder, STAB, efetividade e atributos do alvo.
• Mantém distância com golpes à distância ou com pouca vida, parte para cima com golpes de contato e se cura quando está ferido.
• Antecipa sua posição ao mirar, desvia dos seus projéteis (mais atento quando você mira nele) e usa PP, cooldowns, buffs e status como você.

🏆 Recompensas

• XP real (base × nível / 5, dividido entre os participantes que não desmaiaram) e EVs reais conforme o evYield da espécie.

Controles (todos remapeáveis)

Comandos

• /rtbattle toggle (OP) liga/desliga o mod, para voltar às batalhas por turnos originais a qualquer momento.

Requisitos

• Minecraft 1.21.1, Fabric Loader ≥ 0.16, Java 21+
• Fabric API, Fabric Language Kotlin
• Cobblemon ≥ 1.8.2
• Necessário no cliente e no servidor.

Limitações atuais (protótipo)

• Só jogador × Pokémon selvagem: ainda não há PvP, treinadores NPC nem captura.
• Sem precisão, clima, habilidades ou itens seguros.
• Golpes de status que ainda não estão na tabela mostram “Mas nada aconteceu...” e podem ser adicionados com facilidade.
• A batalha termina se você e o selvagem ficarem a mais de 48 blocos de distância ou se você se desconectar.