HiddenOre - 채굴 드롭 제어
GITHUB • DOCUMENTATION • DISCORD
Overview - what HiddenOre does
광물은 일반적으로 당신의 세계에 있는 블록으로, 이는 X-ray 클라이언트를 가진 누구나 그 위치를 볼 수 있다는 것을 의미합니다. HiddenOre는 그 가치를 일반 돌로 이동시킵니다: 관리되는 블록 파괴는 블록이 파괴되는 순간 구성된 대로 아이템, 경험치 또는 명령을 지급할 수 있습니다.
숨겨진 보상 기본적으로 돌과 심층암이 관리됩니다. 파괴 시 규칙이 적용되고 최대 하나의 아이템 보상이 지급됩니다.
두 가지 발견 모델 고정된 위치에 있는 씨앗 광맥은 월드 씨드에서 파생되므로 다른 플러그인이 이를 감지할 수 있습니다. 순수 무작위는 매번 새로운 확률로 롤링되며 사전 배치된 것이 없습니다.
아이템, 경험치 및 명령 모든 규칙은 아이템을 지급하거나 경험치를 부여하거나 플레이어 또는 콘솔을 통해 명령을 실행할 수 있습니다.
선택적 광물 제거 생성되는 지형에서 구성된 일반 광물을 제거합니다.
배치 인식 플레이어가 배치한 블록은 청크 데이터에서 추적되며 카운트되지 않습니다.
통합 표면 공개 서비스, 취소 가능한 파괴 이벤트 및 변경 가능한 드롭 이벤트.
이것은 먼저 채굴 경제입니다. 광물 제거는 그것이 반 X-ray 조치가 되게 하며, 당신이 켜기 전까지는 꺼져 있습니다. 기본적으로 석탄, 구리, 철, 금, 레드스톤, 라피스, 다이아몬드 및 에메랄드에 대한 작동하는 경제입니다.
호환성 - 런타임 및 자바
하나의 JAR 파일이 모든 여섯 런타임을 포괄합니다, Minecraft 26.x+
Paper 서버의 공개 PluginManager를 통해 로드됩니다.
Purpur 동일한 Paper-family 로드 및 언로드 경로
Leaf Paper-family 포크, Paper처럼 처리됨
Folia 지역화된 스케줄링, HiddenOre는 folia 지원을 선언합니다.
Canvas Folia 포크, 동일한 지역화된 규칙
Spigot plugin.yml을 통해 로드됩니다; paper-plugin.yml만 포함된 JAR는 거부됩니다.
명령 및 권한
/hiddenore 페이지화된 호버 및 클릭 도움말 메뉴
/hiddenore reload config.yml 및 language.yml을 검증하고 다시 로드합니다.
/hiddenore debug 플레이어별 보상 롤 진단을 전환합니다.하나의 권한이 전체 트리를 커버합니다:
hiddenore.admin HiddenOre에 대한 접근을 부여합니다. 기본값: op
어떤 하위 명령도 인수를 받지 않습니다. debug는 플레이어가 필요하므로 콘솔에서는 실행할 수 없으며, 각 파괴가 롤링하는 내용을 출력합니다. 이는 구성을 조정하는 가장 빠른 방법입니다.
구성 - 기본 config.yml
auto_pickup_drops: false
suppress_block_drop_on_custom_drop: true
ore-removal:
# 비활성화되면 세계 생성에 변경이 없습니다.
enabled: false
# 예외를 제외한 모든 세계에 대한 전역 설정
global:
# true일 경우 기본적으로 모든 광물이 세계 생성에서 제거됩니다.
default: true
# 기본값에서 특정 광물에 대한 예외
# 허용된 키는:
# 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
# 특정 세계에 대한 예외, 완전한 자격이 있는 세계 키로 키가 지정됨
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
# 씨앗 모드에서 숨겨진 광맥은 월드 씨드에서 파생됩니다: 세계의 각 위치는 광맥 블록을 보유하거나 그렇지 않으며, 결정론적으로, 광맥 위치는 정확히 한 번 지급됩니다.
# 주의: 씨앗 모드에서 광맥 배치는 아래 드롭 목록의 순서에서 파생됩니다.
# 순서를 변경하거나 항목을 삽입하거나 제거하면 모든 발견되지 않은 광맥이 재배열됩니다.
veins:
# seeded - 광맥은 채굴되기 전에 고정된 위치에 존재하므로 다른 플러그인이 이를 감지하고 윤곽을 그릴 수 있으며, 각 위치는 정확히 한 번 지급됩니다.
# pure_random - 사전 배치된 것이 없습니다; 모든 적격 블록 파괴는 새로운 확률로 롤링됩니다.
# - 동일한 청크 통계(veins_per_chunk 및 vein 크기 아래)에 맞춰 조정됩니다. 이 모드에서는 광맥 감지가 항상 비어 있습니다.
generation: seeded
# 플레이어가 배치한 블록이 숨겨진 드롭을 생성할 수 있는지 여부. false일 경우, 플레이어가 배치한 블록은 추적되며(생존하는 피스톤 및 재시작) 절대 지급되지 않으며, 배치 및 재채굴 악용을 방지합니다.
allow_placed_blocks: false
discovery_sound:
sound: "BLOCK_BEACON_POWER_SELECT"
volume: 1.0
pitch: 1.0
# 안전 한계: 청크당 최대 64개의 광맥 및 하나의 규칙에 대해 256개의 블록, 모든 아이템 규칙에 대해 최대 1,024개의 최악의 경우 대상 블록, exp_drop 최대 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
# 예시 명령 드롭 (확률만, 파괴 시 롤링됨)
# 플레이어 또는 콘솔이 명령을 실행하도록 지정할 수 있습니다. "player:" 및 "console:" 사용
# 실행할 대상을 지정하지 않으면 execute_as에 설정된 대로 기본값이 됩니다.
- type: command
commands:
- "player:say I rolled a player-level bonus!"
- "console:say %player% rolled a server-level bonus!"
- "give %player% diamond 1"
chance: 0.0005
min_y: -64
max_y: 320
execute_as: console명령은 %player% %uuid% %world% %x% %y% %z%, PlaceholderAPI가 설치되면 플레이스홀더도 사용할 수 있습니다. 구성은 파일 저장 시 핫 리로드됩니다.
drops:
- item: itemname # minecraft:raw_iron 다음에 오는 모든 것을 소문자로
chance: 0.0069 # 최대 6자리 소수 정확도. 청크당 확률을 소수로 변환한 후 19,816으로 나누십시오. 이는 드롭이 매우 희귀하게 느껴지게 하지만, 동일한 시간 동안 채굴한 경우 평균적으로 동일한 양의 자재를 얻을 수 있게 합니다. 그러나 이는 플레이어가 맹목적으로 채굴한다고 가정하지만, 그들은 광물을 찾고 있으며, 어디서 어떻게 생성되는지에 대한 본능이 있으므로 실제 발견은 계산된 드롭 확률의 10배에 이를 수 있으며, 플레이어 간 경제에 대해 크게 걱정하지 않는다면 계산된 확률을 최대 10배까지 곱할 수 있습니다.
min_y: 0 # 음수 Y 값을 지원합니다.
max_y: 320
fortune_multiplier: true
tool_tiers: [WOODEN_PICKAXE, STONE_PICKAXE, COPPER_PICKAXE, IRON_PICKAXE, GOLDEN_PICKAXE, DIAMOND_PICKAXE, NETHERITE_PICKAXE] # 이 드롭을 채굴할 수 있는 티어를 제거하십시오.
vein_max_size: 20 # 광맥의 최대 가능한 크기
exp_drop: 2명령을 드롭으로 추가할 수도 있습니다. 예를 들어, 명령을 통해 제공해야 하는 사용자 정의 아이템을 채굴할 수 있는 희귀한 기회를 원한다면, 드롭 객체에 다음을 추가하십시오:
# 예시 명령 드롭 (확률만, 마법/광맥/XP의 영향을 받지 않음)
# 플레이어 또는 콘솔이 명령을 실행하도록 지정할 수 있습니다. "player:" 및 "console:" 사용
# 실행할 대상을 지정하지 않으면 execute_as에 설정된 대로 기본값이 됩니다.
- type: command
commands:
- "player:say I rolled a player-level bonus!"
- "console:say %player% rolled a server-level bonus!"
- "give %player% diamond 1"
chance: 0.0005
min_y: -64
max_y: 320
execute_as: console광물 제거, 그리고 그것이 아닌 것
돌 속에 보상을 숨기는 것은 실제 다이아몬드 광물이 벽에 여전히 있는 경우 도움이 되지 않습니다. ore-removal.enabled: true로 설정하면 HiddenOre가 구성된 광물을 돌, 심층암 또는 네더랙으로 교체하여 지형이 생성됩니다.
기본적으로 꺼져 있습니다. 의도적으로 켜야 합니다.
새 청크만. 기존 지형은 절대 건드리지 않으며, 다시 끄면 이미 제거된 것을 복원하지 않습니다.
세계별. 기본값은 엔드를 그대로 두고 네더 광물을 그대로 유지합니다. 세계 키는 완전 자격이 있어야 하며, 예를 들어 minecraft:the_nether 이름만 있는 키는 유효성 검사를 통과하지 못합니다.
Iris 차원은 hideOresForHiddenOre로 자신의 광물을 제거할 수 있습니다.
이것은 패킷 난독화가 아닙니다. HiddenOre는 클라이언트로 전송되는 블록을 숨기지 않으며, 그것들을 세계에서 제거합니다. 더 똑똑한 X-ray 클라이언트는 이를 무효화할 수 없으며, 또한 당신이 활성화한 모든 광물은 여전히 완전히 보입니다.
플레이스홀더
선택 사항: PlaceholderAPI를 통해 보상 명령에서 플레이스홀더를 사용할 수 있습니다. 아래는 HiddenOre가 기본적으로 제공하는 플레이스홀더입니다.
%hiddenore_available% : true 또는 false, HiddenOre의 런타임이 게시되고 제공되는지 여부.
%hiddenore_seeded% : true 또는 false, veins.generation이 씨앗으로 설정되어 있는지 여부.
%hiddenore_drop-rules% : 일반 숫자, config.yml의 drops: 아래의 총 항목 수, 아이템 규칙 및 명령 규칙을 함께 포함합니다.
모든 17개 로케일 코드의 언어
영어가 기본적으로 선택됩니다. 전환하려면 locale을 설정하십시오 plugins/HiddenOre/language.yml:
locale: en_US
de_DE 독일어 (독일)
es_ES 스페인어 (스페인)
fi_FI 핀란드어 (핀란드)
fr_FR 프랑스어 (프랑스)
he_IL 히브리어 (이스라엘)
it_IT 이탈리아어 (이탈리아)
ja-JP 일본어 (일본)
ko_KR 한국어 (대한민국)
lt_LT 리투아니아어 (리투아니아)
nl_NL 네덜란드어 (네덜란드)
pl_PL 폴란드어 (폴란드)
pt_PT 포르투갈어 (포르투갈)
ru_RU 러시아어 (러시아)
tr_TR 터키어 (터키)
vi_VI 베트남어 (베트남)
zh_CN 중국어 (간체)
zh_TW 중국어 (번체)