Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

✦ OrbPlugin

Sistema de Modificação de Itens para Minecraft Java

Version Server API Java MMOItems MMOCore

Inspirado em Path of Exile 2 · Suporte a MMOCore e MMOItems · Temporada 1

📖 Wiki Completa · 📩 Contato para aquisição


O que é o OrbPlugin?

O OrbPlugin é um sistema completo de progressão de equipamentos para servidores Minecraft Java de RPG. Ele adiciona uma camada de profundidade estratégica inspirada em Path of Exile 2, onde cada item pode ser evoluído, modificado e polido por meio de Orbs consumíveis.

Jogadores constroem builds únicas combinando modificadores de categorias distintas, gerenciando raridades e tomando decisões estratégicas sobre quando e como usar cada Orb — o mesmo loop viciante dos ARPGs modernos, dentro do Minecraft.


✦ Destaques

  • 10 tipos de Orbs com comportamentos distintos e regras claras
  • 5 tipos de equipamento suportados: Arma, Armadura, Acessório, Ferramenta e Escudo
  • 50+ modificadores únicos distribuídos por categorias com pesos balanceados
  • Sistema de Polimento que amplifica stats em até +47% (com consequências permanentes)
  • 3 Mesas de Classe com mecânicas exclusivas: Alquimista, Ferreiro e Mercador
  • Dano e defesa elemental em 6 elementos: Fogo, Gelo, Raio, Terra, Água e Vento
  • Valores escaláveis por nível de classe via MMOCore — quanto mais forte o jogador, melhores os mods
  • Drop de equipamentos não identificados por mobs, com raridades e bônus por classe
  • Craft com aleatoriedade — itens craftados na bancada já saem com bônus e encantamentos
  • Totalmente configurável via YAML — sem necessidade de recompilar

🔮 As 10 Orbs

Orb Função Restrição
📜 Pergaminho de Identificação Revela os mods ocultos de um item não identificado Única que funciona em itens Únicos
🫙 Óleo de Polimento +8% em todos os mods por aplicação (máx. 5×). Trava os mods permanentemente Item deve ter mods; irreversível
🔵 Pedra de Encantamento Transforma item Comum → Mágico com 1–2 mods aleatórios Apenas Tier 0
Pedra de Reforço Adiciona 1 mod extra a um item Mágico com apenas 1 mod Apenas Tier 1 com < 2 mods
👑 Runa Nobre Promove Mágico → Raro, adicionando 1 mod extra Item Mágico com exatamente 2 mods
⚗️ Pedra de Refinamento Transforma Comum → Raro diretamente com 3–6 mods Apenas Tier 0
Runa de Poder Adiciona 1 mod extra a um item Raro com slots disponíveis Apenas Tier 2 com < 6 mods
🎲 Moeda da Sorte 75% Mágico · 23% Raro · 2% Único (mods 50% mais fortes) Apenas Tier 0
🧪 Pedra Corrosiva Remove 1 mod aleatório do item Não funciona em itens polidos
☠️ Orb de Corrupção Roleta terminal. Destrói o item (7% em Raro · 5% em Único) ou sorteia entre Sem Mudança / Reroll Caótico / Mod Corrompido / Ultrapassar Limites Apenas Raros e Únicos. O item corrompido nunca mais pode ser modificado

🏆 Sistema de Raridades (Tiers)

Tier 0 — Comum   [cinza]   0 mods · item base
Tier 1 — Mágico  [azul]    até 2 mods
Tier 2 — Raro    [amarelo] até 6 mods
Tier 3 — Único   [dourado] mods fixos com +50% de poder · só via Moeda da Sorte (2%)

Três rotas de evolução:

SEGURA    Comum ─[Pedra de Encantamento]→ Mágico ─[Runa Nobre]→ Raro
RÁPIDA    Comum ─[Pedra de Refinamento]───────────────────────→ Raro
DA SORTE  Comum ─[Moeda da Sorte]→ Mágico / Raro / ✦ Único ✦

🧬 Modificadores e Categorias

O sistema garante builds variados: cada item só pode ter um mod por categoria. O sistema sorteia a categoria (com peso) e depois um mod dentro dela.

Armas

Categoria Mods incluídos Peso
Dano Ataque, Físico, Mágico, de Arma
Crítico Chance e Poder de Crit, Skill Crit
Elemental Fogo, Gelo, Raio, Terra, Água, Vento
Dano de Skill Habilidades ativas
Velocidade de Ataque Attack Speed
Lifesteal Roubo de vida
PvE Dano contra mobs e bosses
Utilidade HP, Stamina, Sweeping, Knockback Res
Custo de Magia Vampirismo de feitiço

Armaduras

Categoria Mods incluídos Peso
Defesa Armor, Defense
HP Max HP, Absorção, Regeneração
Mitigação Block, Dodge, Parry Rating/Power
Tenacidade Armor Toughness
Resistências Knockback, Explosão, Queda
Defesa Elemental 6 elementos (até 3 por item)
Recursos Mana, Stamina e Regens
CDR Redução de Cooldown
XP Bônus Skill EXP, Vanilla EXP

Acessórios, Ferramentas e Escudos

Acessórios: Recursos (Mana/Stamina/Stellium), CDR, HP, Combate, Spell Elemental, Especial. Ferramentas: Mining Efficiency, Fortune, Durabilidade, Luck, XP. Escudos: Block Rating/Power, Armor/Defense, HP, Resistências, Defesa Elemental (até 2 por item).

⚠️ Todos os tipos suportam modificadores negativos para criar tradeoffs estratégicos.


🔥 Sistema de Polimento

Aplicações Ganho total
+8,0%
+16,6%
+26,0%
+36,0%
+46,9%

Após o 1º polimento, os mods ficam permanentemente travados — Augment, Exalt e Annul não funcionam mais.


🏗️ Mesas de Classe

🧪 Mesa da Transmutação — Alquimista (nível mín. 5/25)

Converte equipamentos em Orbs. Rendimento escala com o ambiente: +1% por estante (máx. +40%) e +5% por jogador próximo (máx. +25%). Total possível: +65%.

🔨 Mesa do Ferreiro — Ferreiro (nível mín. 5)

Mini-game de forja em 4 estágios sequenciais: Aquecimento → Modelagem → Resfriamento → Refinamento. A eficiência acumulada determina o breakpoint (0–5) e o bônus de melhoria nos stats (até +20%). Também repara equipamentos com materiais e fabrica Óleo de Polimento.

🏪 Mesa do Mercador — Mercador (nível mín. 1–15)

Identifica itens com custo em XP, encanta via livro com chance baseada em eficiência + nível, fabrica Pergaminhos / Poções de Retorno / Pedras de Refinamento e opera uma rede de Rotas Comerciais com teletransporte (até 5 waypoints, 3 passageiros, custo 50 Mana).


📦 Craft com Aleatoriedade

Itens craftados na bancada saem automaticamente com Tier 0, nível registrado, e rolagem de encantamentos + atributos bônus. 5% de Craft Luck adiciona +10 a +30 níveis extras ao item permanentemente.


⚔️ Drop de Mobs

72% Comum · 22% Mágico · 6% Raro

Mercadores têm multiplicador de drop de equipamentos e pergaminhos. Alquimistas têm chance de Pedra Corrosiva. A Orb de Corrupção dropa para todas as classes (0,8% · 1,1% para o Guerreiro). Item-level do drop calculado com variação aleatória.


📖 Documentação Completa (Wiki)

Página Conteúdo
O Que São Orbs? Conceitos fundamentais
Como Usar uma Orb Passo a passo, cooldown, feedback
Raridades e Tiers Os 4 Tiers e as 3 rotas de evolução
Guia das Orbs Funcionamento detalhado de cada Orb
Modificadores e Categorias Todos os mods por tipo de item
Sistema de Polimento Ganho acumulado e estratégia
Identificação de Itens Pergaminho, auto-identificação, drops
Craft e Bônus Automáticos Encantamentos, atributos, Craft Luck
Mesas de Classe Alquimista, Ferreiro e Mercador em detalhe
Estratégias Recomendadas Fluxos para builds eficientes
FAQ Respostas para as dúvidas mais comuns

⚙️ Requisitos Técnicos

Requisito Versão
Minecraft Java 1.21+
Server Software Paper (recomendado) ou Spigot
Java Runtime 21+

📦 Dependências do Plugin

Para o plugin funcionar no servidor, instale na pasta plugins/:

Obrigatórias (depend)

Plugin Versão mínima Onde obter
MMOItems 6.10+ SpigotMC / loja Lumine
MythicLib 1.7.1+ SpigotMC (vem junto com MMOItems)

Opcionais (softdepend)

Plugin Função Onde obter
MMOCore Habilita escala de stats por nível de classe (Alquimista, Ferreiro, Mercador, Guerreiro) SpigotMC
ProtocolLib Melhora alguns efeitos visuais SpigotMC

Sem MMOCore, os mods rolam com valores base (sem escala por nível). Sem MMOItems/MythicLib o plugin não inicia.


🚀 Como Instalar

  1. Baixe o NemonicOrbPlugin.jar (releases ou compile pelo passo abaixo).
  2. Coloque o arquivo dentro da pasta plugins/ do servidor.
  3. Instale também as dependências obrigatórias acima.
  4. Inicie o servidor uma vez para gerar plugins/NemonicOrbPlugin/config.yml e nemonicorp_orb_modifiers.yml.
  5. Edite os YAMLs conforme desejar e rode /norb reload (ou reinicie).

ℹ️ O nome do arquivo .jar, a pasta de configuração e o comando /norb mantêm os identificadores internos originais por compatibilidade com servidores já em produção.


🛠️ Como Compilar a partir do Código-Fonte

Pré-requisitos: JDK 21 e Maven 3.8+ instalados.

git clone https://github.com/GEPR1011/NemonicORB.git
cd NemonicORB
mvn clean package

O JAR final fica em target/NemonicOrbPlugin.jar.

Estrutura do projeto

NemonicORB/
├── pom.xml                                # configuração Maven + dependências
├── src/main/java/com/nemonicorp/orbs/     # código-fonte (.java)
└── src/main/resources/                    # config.yml, plugin.yml, modifiers

📄 Licença

Este plugin é um software proprietário. É proibida a redistribuição, cópia, modificação ou uso sem autorização explícita do autor. A licença é concedida individualmente por servidor.


📩 Contato

Licenças por servidor · Suporte técnico incluso · Configuração assistida disponível


Desenvolvido por Guilherme Elias (gepr) · Full Stack Dev @ NemonicRP

About

Sistema de modificacao de itens estilo ARPG para Minecraft Java. Orbs consumiveis, 50+ modificadores, raridades e mesas de classe. Integra MMOItems e MMOCore.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages