VeinMiner minera um veio inteiro de minério assim que minas um único bloco dele. Em vez de bater quinze vezes no minério de diamante, bates uma vez, e os blocos ligados vêm atrás sozinhos. O plugin corre totalmente no servidor; os jogadores não precisam de mod nem de configuração no cliente. As capturas de ecrã vêm de um servidor de teste com Paper 1.21.1 e VeinMiner 2.x: um veio de diamante com quinze blocos, uma picareta de diamante, uma única mineração.

Requisitos

Instalas o VeinMiner no painel em Plugins → Browser. A pesquisa da Modrinth encontra duas variantes do mesmo projeto: o Plugin 2.x como ficheiro JAR para Paper, Purpur e Folia e o Datapack 1.x mais antigo. Este guia descreve o plugin 2.x; o assistente no painel reconhece a variante instalada e mostra-a no topo do cabeçalho. Depois de reiniciares, /veinminer settings maxChain sem valor mostra a configuração atual; assim verificas que o plugin está a correr.

Os comandos de administração pertencem a um grupo de moderação. Operadores podem tudo; para todos os outros, os nós veinminer.settings, veinminer.blocks, veinminer.groups e veinminer.toggle controlam quem pode alterar configurações, listas de blocos, grupos e o interruptor global do servidor. Jogadores normais só precisam de veinminer.use, e mesmo esse apenas se ativares permissionRestricted. Como grupos e nós funcionam está em LuckPerms: configurar permissões.

Como funciona a mineração

Logo após a instalação aplica-se isto: qualquer mineração com a ferramenta certa aciona o veio. needCorrectTool está em true, mustSneak em false, e maxChain permite até 100 blocos por acionamento. A busca percorre todos os blocos diretamente adjacentes do mesmo tipo (searchRadius 1), bloco a bloco, até o veio terminar ou o limite máximo ser atingido.

Um veio de diamante com quinze blocos antes da mineração, com a picareta de diamante na mão
Um veio de diamante com quinze blocos antes da mineração, com a picareta de diamante na mão

No exemplo, o veio está exposto como uma parede de cinco por três blocos de minério de diamante. O jogador parte exatamente um bloco no meio.

A mineração de um bloco faz o veio inteiro partir ao mesmo tempo, com os diamantes a saltarem da parede
A mineração de um bloco faz o veio inteiro partir ao mesmo tempo, com os diamantes a saltarem da parede

Todos os outros catorze blocos partem no mesmo momento, e os diamantes e orbes de experiência saltam da parede. A durabilidade da picareta desce um ponto por bloco (durabilityDecrease true); uma ferramenta quase partida, portanto, não sobrevive a um veio grande.

Os diamantes ficam reunidos à frente do jogador, a parede atrás deles está vazia
Os diamantes ficam reunidos à frente do jogador, a parede atrás deles está vazia

Depois, os diamantes ficam à frente do jogador, e a parede fica vazia. Com mergeItemDrops true, os itens caem como uma pilha no local do primeiro bloco, o que poupa entidades quando há muitos jogadores.

Configurações: assistente ou consola

O painel do servidor traz para o VeinMiner 2.x um assistente com duas predefinições, que define os valores pela consola do servidor em execução e deixa os grupos de blocos e ferramentas intactos:

  • Equilibrado (recomendado): no máximo 64 blocos por acionamento, 1 tick de atraso entre blocos, 20 ticks de tempo de recarga, agachar obrigatório, ferramenta correta obrigatória, drops individuais.
  • Performance (com muitos jogadores): no máximo 32 blocos, 2 ticks de atraso, 40 ticks de tempo de recarga, drops agrupados.

Ambas as predefinições desativam o auto-updater integrado do VeinMiner, porque as atualizações passam pela gestão de plugins do painel. Como abrir o assistente está em Assistentes de plugins no painel.

Também podes definir os mesmos valores à mão, no jogo com barra, na consola do painel sem barra:

/veinminer settings mustSneak true
/veinminer settings maxChain 64
/veinminer settings cooldown 20
/veinminer settings delay 1

mustSneak é a configuração mais importante num servidor de construção: se estiver em true, o veio só parte quando o jogador se agacha ao minerar. Quem quiser trabalhar numa parede de pedra sem levar metade da parede junto, trabalha simplesmente de pé. cooldown e delay são indicados em ticks; 20 ticks são um segundo.

Blocos e grupos

Os blocos que o VeinMiner trata como veio ficam em grupos. Cada grupo liga uma lista de blocos às ferramentas que podem acioná-los. /veinminer blocks mostra os blocos válidos para todas as ferramentas; /veinminer presets carrega grupos prontos, por exemplo para minérios ou madeira. Criar o teu próprio grupo faz-se assim:

/veinminer groups create erze diamond_ore
/veinminer groups edit erze add-block deepslate_diamond_ore
/veinminer groups edit erze add-tool diamond_pickaxe

Assim, um veio de diamante só parte com uma picareta de diamante. Folhas ou madeira ficam bem num grupo com o machado; pedra é melhor não incluir, senão paredes inteiras desaparecem ao escavar túneis.

Erros comuns

  • Ao construir, parte mais do que querias. Define mustSneak true ou remove o bloco do grupo. As predefinições do assistente já exigem agachar.
  • O servidor engasga com veios grandes. Baixa maxChain e aumenta delay; a predefinição “Performance" distribui a mineração por mais ticks.
  • A picareta partiu de repente. Cada bloco custa durabilidade. Avisa os jogadores ou define durabilityDecrease false; nesse caso, o veio inteiro custa só um ponto.
  • O assistente mostra “Datapack 1.x". Então as predefinições 2.x não se aplicam; configuras o datapack no jogo como operador com /function veinminer:_config.
  • VeinMiner comunica uma atualização na consola. Isso é o updater integrado. As atualizações passam pela gestão de plugins; autoUpdate false acaba com a mensagem.
  • VeinMiner deve ficar desligado por um momento. /veinminer toggle desativa e reativa o plugin em todo o servidor sem perder as configurações.

FAQ

Os meus jogadores precisam de um mod ou de uma configuração no cliente?

Não. VeinMiner corre totalmente no servidor. Quem conseguir entrar normalmente usa-o de imediato — também jogadores via Geyser com um cliente Bedrock, porque apenas a mineração do lado do servidor é avaliada.

Ao construir, parte mais do que eu queria — o que ajuda?

/veinminer settings mustSneak true. Depois disso, o veio só é acionado quando o jogador se agacha ao minerar; de pé, trabalhas bloco a bloco como de costume. Em servidores de construção, esta é a configuração mais importante, e as predefinições do assistente já a exigem.

Tenho o plugin 2.x ou o Datapack 1.x?

O assistente no painel mostra a variante detetada no topo do cabeçalho. Sem painel, /veinminer settings maxChain dá a resposta: se o comando responder com um valor, o plugin 2.x está a correr. Em vez disso, configuras o Datapack 1.x como operador com /function veinminer:_config.

A ferramenta desgasta-se mais depressa?

Sim, por padrão cada bloco minerado custa um ponto de durabilidade (durabilityDecrease true) — por isso, um veio grande destrói uma picareta quase gasta. Com durabilityDecrease false, o acionamento completo custa só um ponto.

Como desligo temporariamente o VeinMiner?

/veinminer toggle desliga-o e volta a ligá-lo em todo o servidor, sem perder configurações, listas de blocos ou grupos. É a forma mais rápida quando queres trabalhar sem interrupções durante um projeto de construção ou um evento.

Guias adicionais

Como os plugins entram no painel e são atualizados é mostrado em Instalar e gerir plugins. Se um veio grande causa mesmo lag, mede com spark: analisar lag antes de alterares as configurações.

Fontes

VeinMiner: ver exemplo

Gravações próprias de um ambiente de demonstração. A versão e a configuração mostradas podem diferir do teu servidor.

  1. Um veio de diamante, uma picareta.
  2. Um bloco é minerado. O veio inteiro segue.
  3. Os drops ficam reunidos à tua frente.
Um veio de diamante exposto antes da mineração. A picareta está pronta.
Um veio de diamante exposto antes da mineração. A picareta está pronta.

VeinMiner 2.4.4 · Paper 1.21.1 · 2026-09-14

Uma única quebra aciona o veio inteiro: os blocos mais afastados quebram também.
Uma única quebra aciona o veio inteiro: os blocos mais afastados quebram também.

VeinMiner 2.4.4 · Paper 1.21.1 · 2026-09-14

Os diamantes ficam reunidos à frente do jogador; o veio desapareceu.
Os diamantes ficam reunidos à frente do jogador; o veio desapareceu.

VeinMiner 2.4.4 · Paper 1.21.1 · 2026-09-14