GITHUB • DOCUMENTAÇÃO • DISCORD

Visão geral - o que o HiddenOre faz

O minério normalmente é um bloco que está em seu mundo, o que significa que qualquer um com um cliente de raio-x pode ver onde ele está. O HiddenOre move o valor para a pedra comum: qualquer quebra de bloco gerenciada pode recompensar um item, experiência ou um comando, decidido com base no que está configurado no momento em que o bloco é quebrado.

• Recompensas ocultas Pedra e deepslate são gerenciados por padrão. Uma quebra aplica suas regras e paga no máximo uma recompensa de item.

• Dois modelos de descoberta Veios semeados estão em posições fixas derivadas da semente do mundo, para que outros plugins possam detectá-los. Rolagens puramente aleatórias são frescas a cada quebra, sem nada pré-colocado.

• Itens, experiência e comandos Qualquer regra pode entregar itens, conceder experiência ou executar comandos via jogador ou console.

• Remoção opcional de minério Remova minérios vanilla configurados do terreno à medida que ele é gerado.

• Ciente da colocação Blocos colocados pelo jogador são rastreados nos dados do chunk e não são contados.

• Superfície de integração Um serviço público, um evento de quebra cancelável e um evento de queda mutável.

É uma economia de mineração primeiro A remoção de minério é o que a torna uma medida anti-raio-x, e está desligada até que você a ative. Pronta para uso, já é uma economia funcional para carvão, cobre, ferro, ouro, redstone, lapis, diamante e esmeralda.

Compatibilidade - tempos de execução e Java

Um jar cobre todos os seis tempos de execução, Minecraft 26.x+

• Paper carrega através do PluginManager público do servidor

• Purpur mesmo caminho de carga e descarga da família Paper

• Leaf Fork da família Paper, tratado como Paper

• Folia agendamento regionalizado, HiddenOre declara suporte a folia

• Canvas Fork de Folia, mesmas regras regionalizadas

• Spigot carrega através do plugin.yml; jars que enviam apenas paper-plugin.yml são recusados

Comandos e permissões

\/hiddenore Menu de ajuda paginado com hover e clique
\/hiddenore reload Valida e recarrega config.yml e language.yml
\/hiddenore debug Alterna diagnósticos de rolagem de recompensa por jogador

Uma permissão cobre toda a árvore:

hiddenore.admin Dá acesso ao HiddenOre padrão: op

Nenhum subcomando aceita argumentos. debug requer um jogador, então o console não pode executá-lo, ele imprime o que cada uma de suas quebras está rolando, que é a maneira mais rápida de ajustar uma configuração.

Configuração - config.yml padrão

auto_pickup_drops: false
suppress_block_drop_on_custom_drop: true
ore-removal:
  # Se desativado, nenhuma alteração será feita na geração do mundo
  enabled: false
  # Configurações globais para todos os mundos, excluindo exceções
  global:
    # Se verdadeiro, por padrão todos os minérios serão removidos da geração do mundo
    default: true
    # Exceções para um minério específico do valor padrão
    # chaves aceitas são:
    # COAL_ORE, COPPER_ORE, IRON_ORE, GOLD_ORE, DIAMOND_ORE, REDSTONE_ORE, LAPIS_ORE, EMERALD_ORE
    # DEEPSLATE_COAL_ORE, DEEPSLATE_COPPER_ORE, DEEPSLATE_IRON_ORE, DEEPSLATE_GOLD_ORE, DEEPSLATE_DIAMOND_ORE, DEEPSLATE_REDSTONE_ORE, DEEPSLATE_LAPIS_ORE, DEEPSLATE_EMERALD_ORE
    # NETHER_GOLD_ORE, NETHER_QUARTZ_ORE, ANCIENT_DEBRIS
    NETHER_GOLD_ORE: false
    NETHER_QUARTZ_ORE: false
    ANCIENT_DEBRIS: false
  # Exceções para mundos específicos, indexadas por sua chave de mundo totalmente qualificada
  exceptions:
    "minecraft:the_end":
      default: false
    "minecraft:the_nether":
      default: false
      NETHER_GOLD_ORE: true
      NETHER_QUARTZ_ORE: true
      ANCIENT_DEBRIS: true
blocks:
  stone:
    drop: cobblestone
  deepslate:
    drop: cobbled_deepslate
# No modo semeado, veios ocultos são derivados da semente do mundo: cada posição no
# mundo ou tem um bloco de veios ou não, de forma determinística, e minerar uma posição de veios
# paga exatamente uma vez, para sempre.
# NOTA: no modo semeado, a colocação de veios é derivada da ordem da lista de quedas abaixo.
# Reordenar, inserir ou remover entradas reorganiza todos os veios não descobertos.
veins:
  # seeded      - veios existem em posições fixas antes de serem minerados, para que outros plugins
  #               possam detectá-los e contorná-los, e cada posição paga uma vez, para sempre.
  # pure_random - nada é pré-colocado; cada quebra de bloco elegível rola novas chances
  #               ajustadas para as mesmas estatísticas por chunk (veins_per_chunk e vein
  #               sizes abaixo). A detecção de veios sempre resulta em vazio neste modo.
  generation: seeded
  # Se blocos colocados por jogadores podem gerar quedas ocultas. Quando falso, blocos colocados por jogadores
  # são rastreados (pistões sobreviventes e reinicializações) e nunca pagam, fechando a
  # exploração de colocar e minerar novamente.
  allow_placed_blocks: false
  discovery_sound:
    sound: "BLOCK_BEACON_POWER_SELECT"
    volume: 1.0
    pitch: 1.0
# Limites de segurança: até 64 veios por chunk e 256 blocos por veio para uma regra,
# até 1.024 blocos alvo no pior cenário em todas as regras de item, e exp_drop até 1.000.
drops:
  - item: coal
    veins_per_chunk: 2.2
    vein_min_size: 5
    vein_max_size: 20
    min_y: 0
    max_y: 320
    fortune_multiplier: true
    tool_tiers: [ WOODEN_PICKAXE, STONE_PICKAXE, COPPER_PICKAXE, IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 2
  - item: raw_copper
    veins_per_chunk: 1.6
    vein_min_size: 4
    vein_max_size: 12
    min_y: -16
    max_y: 112
    fortune_multiplier: true
    tool_tiers: [ COPPER_PICKAXE, IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 2
  - item: raw_iron
    veins_per_chunk: 1.8
    vein_min_size: 4
    vein_max_size: 12
    min_y: -64
    max_y: 320
    fortune_multiplier: false
    tool_tiers: [ COPPER_PICKAXE, IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 0
  - item: raw_gold
    veins_per_chunk: 0.6
    vein_min_size: 3
    vein_max_size: 8
    min_y: -64
    max_y: 32
    fortune_multiplier: false
    tool_tiers: [ IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 0
  - item: redstone
    veins_per_chunk: 0.9
    vein_min_size: 4
    vein_max_size: 8
    min_y: -64
    max_y: 16
    fortune_multiplier: true
    tool_tiers: [ IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 1
  - item: lapis_lazuli
    veins_per_chunk: 0.5
    vein_min_size: 3
    vein_max_size: 6
    min_y: -64
    max_y: 64
    fortune_multiplier: true
    tool_tiers: [ COPPER_PICKAXE, IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 5
  - item: diamond
    veins_per_chunk: 0.5
    vein_min_size: 3
    vein_max_size: 8
    min_y: -64
    max_y: 16
    fortune_multiplier: true
    tool_tiers: [ IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 7
  - item: emerald
    veins_per_chunk: 0.35
    vein_min_size: 1
    vein_max_size: 2
    min_y: -16
    max_y: 320
    fortune_multiplier: true
    tool_tiers: [ IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE ]
    exp_drop: 7
  # Exemplo de comando de queda (chance percentual apenas, rolada no momento da quebra)
  # Você pode especificar se deseja que o comando seja executado pelo jogador ou console usando "player:" e "console:"
  # Se você não especificar como será executado, ele será definido como o que você tem definido em execute_as
  - type: command
    commands:
      - "player:say Eu rolei um bônus de nível de jogador!"
      - "console:say %player% rolou um bônus de nível de servidor!"
      - "give %player% diamond 1"
    chance: 0.0005
    min_y: -64
    max_y: 320
    execute_as: console

Os comandos podem usar %player% %uuid% %world% %x% %y% %z%, além de placeholders do PlaceholderAPI quando ele estiver instalado. A configuração é recarregada automaticamente ao salvar o arquivo.

drops:
  - item: itemname # Minúsculas para tudo que segue minecraft:raw_iron
    chance: 0.0069 # Máxima precisão de 6 casas decimais. Pegue a porcentagem de spawn por chunk convertida em um decimal entre 0 e 1, e depois divida por 19.816. Isso vai fazer a queda parecer realmente rara, mas faz com que a mineração resulte na mesma quantidade de material em média, dado o mesmo tempo gasto minerando. No entanto, isso assume um jogador minerando às cegas, mas eles procuram por minério e têm um instinto de onde e como ele aparece, o que significa que a descoberta real às vezes é até 10 vezes a chance de queda calculada, e se você não está muito preocupado com sua economia entre jogadores, pode multiplicar a chance calculada por até 10.
    min_y: 0 # Suporta um valor Y negativo
    max_y: 320
    fortune_multiplier: true
    tool_tiers: [WOODEN_PICKAXE, STONE_PICKAXE, COPPER_PICKAXE, IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE] # Remova os níveis que você não quer que possam minerar essa queda.
    vein_max_size: 20 # Tamanho máximo possível de um veio
    exp_drop: 2

Você também pode adicionar comandos como quedas, por exemplo, se você quiser que haja uma chance rara de minerar um item personalizado que precisa ser dado via comando. Basta adicionar o seguinte ao objeto de quedas como um item:

# Exemplo de comando de queda (chance percentual apenas, não afetada por encantamentos/veios/XP)
  # Você pode especificar se deseja que o comando seja executado pelo jogador ou console usando "player:" e "console:"
  # Se você não especificar como será executado, ele será definido como o que você tem definido em execute_as
  - type: command
    commands:
      - "player:say Eu rolei um bônus de nível de jogador!"
      - "console:say %player% rolou um bônus de nível de servidor!"
      - "give %player% diamond 1"
    chance: 0.0005
    min_y: -64
    max_y: 320
    execute_as: console

Remoção de minério, e o que não é

Esconder recompensas na pedra não ajuda se o verdadeiro minério de diamante ainda estiver na parede. Defina ore-removal.enabled: true e o HiddenOre substitui os minérios configurados por pedra, deepslate ou netherrack à medida que o terreno é gerado.

• Desligado por padrão. Ative-o deliberadamente.

• Apenas novos chunks. O terreno existente nunca é tocado, e desligá-lo novamente não restaura nada que já foi removido.

• Por mundo. Os padrões deixam o End intocado e mantêm os minérios do Nether intactos. As chaves de mundo devem ser totalmente qualificadas, como minecraft:the_nether uma chave apenas com nome falha na validação.

• Dimensões Iris podem remover seus próprios minérios com hideOresForHiddenOre.

Isso não é ofuscação de pacotes. O HiddenOre não disfarça blocos a caminho do cliente, ele os remove do mundo. Um cliente de raio-x mais inteligente não pode derrotar isso e, igualmente, qualquer minério que você deixar habilitado permanece totalmente visível para um.

Placeholders

Opcional: PlaceholderAPI para placeholders em comandos de recompensa. Abaixo estão os placeholders que o HiddenOre fornece por padrão.

• %hiddenore_available% : verdadeiro ou falso, se o tempo de execução do HiddenOre está publicado e servindo.

• %hiddenore_seeded% : verdadeiro ou falso, se veins.generation está definido como semeado.

• %hiddenore_drop-rules% : um número simples, o total de entradas sob drops: em config.yml, regras de item e regras de comando juntas.

Idiomas todos os 17 códigos de localidade

O inglês é selecionado por padrão. Para mudar, defina locale em plugins/HiddenOre/language.yml:

locale: en_US

de_DE Alemão (Alemanha)
es_ES Espanhol (Espanha)
fi_FI Finlandês (Finlândia)
fr_FR Francês (França)
he_IL Hebraico (Israel)
it_IT Italiano (Itália)
ja-JP Japonês (Japão)
ko_KR Coreano (Coreia do Sul)
lt_LT Lituano (Lituânia)
nl_NL Holandês (Países Baixos)
pl_PL Polonês (Polônia)
pt_PT Português (Portugal)
ru_RU Russo (Rússia)
tr_TR Turco (Turquia)
vi_VI Vietnamita (Vietnã)
zh_CN Chinês (Simplificado)
zh_TW Chinês (Tradicional)