O VeinMiner consegue minerar automaticamente vários blocos conectados depois de quebrares um bloco inicial. Para a vossa pequena rodada de sobrevivência, a questão decisiva é: Que cadeia deve ser ativada, com qual ferramenta e para quais amigos? Um valor padrão alto ainda não é uma regra adequada para um servidor gratuito.

Este guia refere-se ao MiraculixxT Veinminer 2.x, no servidor Paper à sua versão como plugin. Outros projetos também se chamam VeinMiner. O datapack 1.x mais antigo tem um caminho de configuração diferente. Por isso, verifica primeiro o nome real do projeto e a versão carregada.

Verificado: 7 de outubro de 2026. As imagens existentes mostram um teste funcional anterior no Paper; para este artigo não foi executado nenhum novo teste de desempenho.

Combinar três regras antes da instalação

Decidam se todos os amigos podem usar a função ou apenas um grupo de jogo específico. Depois, decidam se é necessário agachar e se apenas ferramentas adequadas são aceites. Só então definem o comprimento máximo da cadeia.

Começai com um grupo de minérios pequeno e uma ferramenta com estado inicial conhecido. Um servidor gratuito de 2 GB não recebe poder de processamento adicional por causa do plugin. Grandes cadeias de mineração e muitos itens espalhados no chão podem gerar trabalho extra. Uma cadeia pequena é aqui uma precaução sugerida, não um valor de desempenho medido para o servidor gratuito.

Antes de fazer alterações, guardai o mundo completo e a configuração do Veinminer separadamente do teste.

A página do projeto Veinminer no Modrinth lista as variantes disponíveis. Para o Paper, instalas um arquivo de plugin compatível com a versão do Minecraft; um mod de Fabric, Quilt ou NeoForge não pertence à pasta de plugins do Paper. Depois de uma reinicialização ordenada, verifica o log de arranque e o autocompletar de comandos disponível.

O que os presets do MCF realmente configuram

O assistente do MCF oferece predefinições fixas para a versão 2.x suportada. Ele também altera configurações que definiram manualmente antes. Os valores a seguir vêm do assistente verificado, não de uma nova medição do seu efeito:

Predefinição do MCF Valores
Equilibrado Cadeia 64, atraso de 1 tick, cooldown de 20 ticks
Desempenho Cadeia 32, atraso de 2 ticks, cooldown de 40 ticks
Ambos Agachar e ferramenta adequada obrigatórios; raio de busca 1

Na predefinição "Desempenho", os drops de itens também são agrupados; em Equilibrado, essa opção está desativada. Os nomes das predefinições descrevem o seu objetivo. Eles não garantem um TPS específico nem um número máximo seguro de jogadores.

Importante para o vosso grupo de jogo: Ambos os presets desativam a restrição via veinminer.use. Se quiserem liberar o VeinMiner apenas para alguns amigos selecionados, ativem essa restrição novamente depois do preset e verifiquem-na. Mesmo uma troca posterior de predefinição pode repor a vossa decisão de acesso.

As permissões do painel para aplicar um preset são separadas das permissões no jogo. Os colegas de jogo não precisam de acesso ao console nem à gestão de plugins para minerar as cadeias de minérios permitidas.

Configurar uma cadeia menor própria

Se quiserem configurar manualmente, não comecem com uma veia de minério ilimitada. A seguinte seleção de exemplo própria define o valor padrão global da cadeia como 16 blocos. Isto não é uma terceira predefinição do MCF nem um valor mínimo ou máximo oficial:

veinminer settings mustSneak true
veinminer settings needCorrectTool true
veinminer settings maxChain 16
veinminer settings cooldown 20
veinminer settings delay 1

No console do servidor, digita sem a barra; no jogo, o comando começa com /veinminer. Antes de definir, verifica com o autocompletar de comandos se a vossa versão específica oferece as configurações mencionadas. O README do projeto descreve as opções básicas. Textos mais antigos e versões novas podem usar nomes diferentes para algumas configurações.

O atraso significa que a cadeia inteira não desaparece necessariamente no mesmo instante. Os valores de ticks descrevem o processamento do jogo. 20 ticks correspondem a aproximadamente um segundo apenas com 20 TPS; sob carga, não é um tempo de espera real fixo. Por isso, não divulgues um número de segundos garantido como regra de jogo.

As configurações globais são valores padrão, não valores garantidos para cada ação de mineração. Em jogadores com o addon de cliente opcional, podem aplicar-se substituições do cliente; as configurações do grupo de blocos realmente utilizado têm precedência sobre elas. Verificai especialmente mustSneak, maxChain, permissionRestricted e decreaseDurability para o vosso grupo de teste.

Os grupos de blocos e de ferramentas decidem além disso quais combinações se completam. Uma cadeia não precisa de ser formada, em todas as configurações, exclusivamente por um único tipo de bloco. Só ajusta esses grupos quando tiverem compreendido o comportamento básico; um raio de busca muito grande não substitui uma seleção clara de blocos.

Acesso apenas para os amigos combinados

Se apenas um grupo de jogo específico deve usar o VeinMiner, ativa a restrição correspondente depois do último preset utilizado:

veinminer settings permissionRestricted true

Com o LuckPerms, podes depois dar a permissão de jogo a um grupo escolhido de propósito. O exemplo pressupõe um grupo freund já existente:

lp group freund permission set veinminer.use true

Não dês aos colegas de jogo normais um wildcard de administração nem OP só para esta função. A atribuição concreta a contas e o caminho de volta estão em LuckPerms para amigos.

Testa com duas contas normais tuas: uma recebe o grupo previsto, a outra não. Ambas mineram, na mesma pequena área de teste, um bloco inicial adequado. Apenas a conta liberada deve ativar a cadeia. Se ambas conseguirem, verifica permissionRestricted, outros grupos e a versão realmente carregada. Um valor de permissão positivo, por si só, não prova que a proteção de acesso funciona.

Testar o desgaste da ferramenta e os drops em conjunto

Usa uma ferramenta adequada e anota o seu estado. Primeiro, minera sem agachar um único bloco inicial; depois, agachado, um pequeno grupo de minérios conectados. Compara os resultados com a vossa regra combinada.

Pequeno grupo preparado de minério de diamante com picareta, sem nomes de jogadores nem chat
Pequeno grupo preparado de minério de diamante com picareta, sem nomes de jogadores nem chat

Teste anterior no Paper 1.21.1 com a versão 2.x: um grupo de minérios pequeno para comparação antes da mineração.

Mineração ativada do grupo de minérios de teste com itens e experiência visíveis
Mineração ativada do grupo de minérios de teste com itens e experiência visíveis

A captura mostra a cadeia ativada. Ela não mede nem a carga de ticks nem o custo da ferramenta da vossa configuração atual.

Verifica se o desgaste da ferramenta ativado corresponde à regra de sobrevivência esperada. Ferramenta, encantamentos, regras de grupo e versão podem influenciar o resultado. Não prometas de forma geral um ponto de durabilidade por bloco removido. Não desatives o desgaste por mera suspeita só porque uma cadeia saiu maior do que o esperado; corrige primeiro o comprimento da cadeia e os grupos.

O código de configuração do projeto atual chama a opção de ferramenta decreaseDurability; a documentação mais antiga fala em durabilityDecrease. Usa o nome que a tua versão instalada realmente oferece. O preset do MCF não define explicitamente esta opção no fluxo verificado.

Estado após a mineração histórica com itens recolhidos, sem nomes de jogadores
Estado após a mineração histórica com itens recolhidos, sem nomes de jogadores

Compara o estado inicial, os drops e a ferramenta no vosso próprio pequeno teste. Destas imagens não resulta nenhum rendimento garantido.

Se algo funcionar de forma diferente do combinado

Se, apesar de agachares, apenas um bloco for minerado, verifica primeiro o projeto, a versão, o tipo de ferramenta adequado, o grupo de blocos, o cooldown e a permissão. Não atribuas OP como primeira medida. Se a cadeia apanhar blocos indesejados, pausa a tentativa e verifica os grupos de blocos e o raio de busca.

Com carga alta, reduzem o comprimento da cadeia e testam de novo uma pequena ação. Cadeias ativadas ao mesmo tempo e drops que ficam no chão podem criar condições diferentes do vosso primeiro teste individual. Se as regras não puderem ser aplicadas de forma fiável, desativem a função por agora na rodada e restaurem o estado de configuração guardado; em caso de grandes alterações inesperadas no mundo, só ajuda um backup completo do mundo, pois a cópia da configuração não desfaz os blocos minerados.

Após cada troca de preset do MCF, verificam novamente a restrição de acesso. Funções de jogador e uma whitelist são coisas separadas: a whitelist decide sobre a entrada, as permissões do VeinMiner decidem sobre uma função depois da entrada.

FAQ

Todos os amigos precisam de um mod no cliente?

Para a função básica do plugin Paper aqui descrita, não é necessário nenhum mod próprio no cliente. Outras variantes e funções adicionais do cliente podem ter outros requisitos.

Por que de repente todos conseguem fazer veinmining depois de um preset?

Ambos os presets do MCF verificados definem permissionRestricted como false. Ativa a restrição novamente depois, se apenas contas de jogo selecionadas devem ter acesso.

A pequena cadeia de 16 blocos é um limite testado para o servidor gratuito?

Não. É um valor inicial próprio e moderado para o vosso teste. A carga real depende do mundo, da versão, das extensões e do jogo simultâneo.

O VeinMiner minera sempre apenas o mesmo minério?

Isso depende dos grupos de blocos e de outras configurações. Verifica o vosso grupo real numa pequena área de teste mista antes de minerarem jazidas extensas.

O mesmo comando vale para o datapack antigo?

Não. O assistente do MCF mostra /function veinminer:_config para o caminho do datapack 1.x mais antigo. Não transfiras às cegas os comandos de plugin da versão 2.x para ele.

Por que mais RAM não ajuda automaticamente contra todo atraso de mineração?

Recursos adicionais não resolvem grupos, permissões ou regras de ferramenta incorretos. Verifica primeiro a ação concreta e a sua carga; o âmbito gratuito continua limitado.

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