GITHUB • DOCUMENTATION • DISCORD

Resumen - lo que hace HiddenOre

El mineral es normalmente un bloque que se encuentra en tu mundo, lo que significa que cualquiera con un cliente de rayos X puede ver dónde está. HiddenOre mueve el valor a la piedra ordinaria en su lugar: cualquier ruptura de bloque gestionada puede otorgar un ítem, experiencia o un comando, decidido en base a lo que se configura en el momento en que se rompe el bloque.

• Recompensas ocultas La piedra y la piedra profunda son gestionadas por defecto. Una ruptura aplica tus reglas y paga como máximo una recompensa de ítem.

• Dos modelos de descubrimiento Los filones sembrados se encuentran en posiciones fijas derivadas de la semilla del mundo, por lo que otros plugins pueden detectarlos. La aleatoriedad pura aplica nuevas probabilidades en cada ruptura sin nada precolocado.

• Ítems, experiencia y comandos Cualquier regla puede entregar ítems, otorgar experiencia o ejecutar comandos a través del jugador o la consola.

• Eliminación de minerales opcional Elimina los minerales de vainilla configurados del terreno a medida que se genera.

• Consciente de la colocación Los bloques colocados por el jugador son rastreados en los datos del chunk y no se cuentan.

• Superficie de integración Un servicio público, un evento de ruptura cancelable y un evento de caída mutable.

Es una economía minera primero La eliminación de minerales es lo que lo convierte en una medida anti-rayos X, y está desactivada hasta que la actives. Desde el principio, ya es una economía funcional para carbón, cobre, hierro, oro, redstone, lapis, diamante y esmeralda.

Compatibilidad - tiempos de ejecución y Java

Un jar cubre los seis tiempos de ejecución, Minecraft 26.x+

• Paper se carga a través del PluginManager público del servidor.

• Purpur mismo camino de carga y descarga de la familia Paper.

• Leaf bifurcación de la familia Paper, tratada como Paper.

• Folia programación regionalizada, HiddenOre declara soporte para folia.

• Canvas bifurcación de Folia, mismas reglas regionalizadas.

• Spigot se carga a través de plugin.yml; los jars que solo envían paper-plugin.yml son rechazados.

Comandos y permisos

\/hiddenore Menú de ayuda paginado con hover y clic
\/hiddenore reload Valida y recarga config.yml y language.yml
\/hiddenore debug Alterna diagnósticos de recompensa por jugador

Un permiso cubre todo el árbol:

hiddenore.admin Da acceso a HiddenOre por defecto: op

Ningún subcomando toma argumentos. debug requiere un jugador, por lo que la consola no puede ejecutarlo, imprime lo que cada una de tus rupturas está rodando, que es la forma más rápida de ajustar una configuración.

Configuración - config.yml por defecto

auto_pickup_drops: false
suppress_block_drop_on_custom_drop: true
ore-removal:
  # Si está deshabilitado, no se harán cambios en la generación del mundo
  enabled: false
  # Configuraciones globales para todos los mundos excluyendo excepciones
  global:
    # Si es verdadero, por defecto todos los minerales serán eliminados de la generación del mundo
    default: true
    # Excepciones para un mineral específico del valor por defecto
    # las claves aceptadas son:
    # 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
  # Excepciones para mundos específicos, indexadas por su clave de mundo completamente calificada
  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
# En modo sembrado, los filones ocultos se derivan de la semilla del mundo: cada posición en el
# mundo contiene un bloque de filón o no, de manera determinista, y minar una posición de filón
# paga exactamente una vez, para siempre.
# NOTA: en modo sembrado, la colocación de filones se deriva del orden de la lista de caídas a continuación.
# Reordenar, insertar o eliminar entradas reorganiza todos los filones no descubiertos.
veins:
  # sembrado      - los filones existen en posiciones fijas antes de ser minados, por lo que otros plugins
  #               pueden detectarlos y delinearlos, y cada posición paga una vez, para siempre.
  # aleatorio_puro - nada está precolocado; cada ruptura de bloque elegible aplica nuevas probabilidades
  #               ajustadas a las mismas estadísticas por chunk (veins_per_chunk y vein
  #               sizes a continuación). La detección de filones siempre resulta vacía en este modo.
  generation: seeded
  # Si los bloques colocados por los jugadores pueden generar caídas ocultas. Cuando es falso, los bloques colocados por jugadores
  # son rastreados (pistones sobrevivientes y reinicios) y nunca pagan, cerrando la
  # explotación de colocar y volver a minar.
  allow_placed_blocks: false
  discovery_sound:
    sound: "BLOCK_BEACON_POWER_SELECT"
    volume: 1.0
    pitch: 1.0
# Límites de seguridad: hasta 64 filones por chunk y 256 bloques por filón para una regla,
# hasta 1,024 bloques objetivo en el peor de los casos en todas las reglas de ítems, y exp_drop hasta 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
  # Ejemplo de caída de comando (solo probabilidad porcentual, lanzada en el momento de la ruptura)
  # Puedes especificar si deseas que el comando sea ejecutado por el jugador o la consola usando "player:" y "console:"
  # Si no especificas cómo se ejecutará, se ajustará a lo que tengas configurado en execute_as
  - type: command
    commands:
      - "player:say ¡He obtenido un bono a nivel de jugador!"
      - "console:say %player% obtuvo un bono a nivel de servidor!"
      - "give %player% diamond 1"
    chance: 0.0005
    min_y: -64
    max_y: 320
    execute_as: console

Los comandos pueden usar %player% %uuid% %world% %x% %y% %z%, además de los marcadores de posición de PlaceholderAPI cuando está instalado. La configuración se recarga automáticamente al guardar el archivo.

drops:
  - item: itemname # Minúsculas lo que sigue a minecraft:raw_iron
    chance: 0.0069 # Máxima precisión de 6 decimales. Toma el porcentaje de spawn por chunk convertido a un decimal entre 0 y 1, y luego divide por 19,816. Esto hará que la caída se sienta realmente rara, pero hace que la minería resulte en la misma cantidad de material en promedio dado el mismo tiempo de minería. Sin embargo, esto asume un jugador minando a ciegas, pero buscan mineral, y tienen un instinto de dónde y cómo aparece, lo que significa que el descubrimiento real a veces es hasta 10 veces la probabilidad de caída calculada, y si no te preocupa mucho tu economía entre jugadores, puedes multiplicar la probabilidad calculada por hasta 10.
    min_y: 0 # Soporta un 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] # Elimina los niveles que no deseas que puedan minar esta caída.
    vein_max_size: 20 # Tamaño máximo posible de un filón
    exp_drop: 2

También puedes agregar comandos como caídas, por ejemplo, si deseas que haya una rara posibilidad de minar un ítem personalizado que necesita ser otorgado a través de un comando. Simplemente agrega lo siguiente en el objeto de caídas como un ítem:

# Ejemplo de caída de comando (solo probabilidad porcentual, no afectada por encantamientos/filones/XP)
  # Puedes especificar si deseas que el comando sea ejecutado por el jugador o la consola usando "player:" y "console:"
  # Si no especificas cómo se ejecutará, se ajustará a lo que tengas configurado en execute_as
  - type: command
    commands:
      - "player:say ¡He obtenido un bono a nivel de jugador!"
      - "console:say %player% obtuvo un bono a nivel de servidor!"
      - "give %player% diamond 1"
    chance: 0.0005
    min_y: -64
    max_y: 320
    execute_as: console

Eliminación de minerales, y lo que no es

Ocultar recompensas en piedra no ayuda si el verdadero mineral de diamante sigue en la pared. Establece ore-removal.enabled: true y HiddenOre reemplaza los minerales configurados con piedra, piedra profunda o netherrack a medida que se genera el terreno.

• Desactivado por defecto. Actívalo deliberadamente.

• Solo nuevos chunks. El terreno existente nunca se toca, y volver a desactivarlo no restaura nada que ya haya sido eliminado.

• Por mundo. Los valores por defecto dejan el End intacto y mantienen los minerales del Nether. Las claves de mundo deben estar completamente calificadas, como minecraft:the_nether una clave solo con nombre no pasa la validación.

• Las dimensiones de Iris pueden eliminar sus propios minerales con hideOresForHiddenOre.

Esto no es ofuscación de paquetes. HiddenOre no disfraza bloques en su camino hacia el cliente, los elimina del mundo. Un cliente de rayos X más inteligente no puede derrotar eso y, de igual manera, cualquier mineral que dejes habilitado permanece completamente visible para uno.

Marcadores de posición

PlaceholderAPI para marcadores de posición en comandos de recompensa. A continuación se presentan los marcadores de posición que HiddenOre incluye por defecto.

• %hiddenore_available% : verdadero o falso, si el tiempo de ejecución de HiddenOre está publicado y sirviendo.

• %hiddenore_seeded% : verdadero o falso, si veins.generation está configurado como sembrado.

• %hiddenore_drop-rules% : un número simple, el total de entradas bajo drops: en config.yml, reglas de ítems y reglas de comandos juntas.

Idiomas todos los 17 códigos de locales

El inglés está seleccionado por defecto. Para cambiar, establece locale en plugins/HiddenOre/language.yml:

locale: en_US

de_DE Alemán (Alemania)
es_ES Español (España)
fi_FI Finés (Finlandia)
fr_FR Francés (Francia)
he_IL Hebreo (Israel)
it_IT Italiano (Italia)
ja-JP Japonés (Japón)
ko_KR Coreano (Corea del Sur)
lt_LT Lituano (Lituania)
nl_NL Neerlandés (Países Bajos)
pl_PL Polaco (Polonia)
pt_PT Portugués (Portugal)
ru_RU Ruso (Rusia)
tr_TR Turco (Turquía)
vi_VI Vietnamita (Vietnam)
zh_CN Chino (Simplificado)
zh_TW Chino (Tradicional)