矿石产量
⚠️ 重要 — 客户端要求
Ore Yield 默认情况下是客户端可选的,通常仅能安装在服务器上。
但是,如果启用了以下任一设置,或者你希望成就(advancements)正常工作(我不知道如何让它们仅在服务器端生效),每个玩家也必须在他们的客户端安装匹配的 Ore Yield 版本:
generator_tracking_blocks_enabled = true
enable_anti_cheese_mechanics = true
enable_mineral_pockets = true (无需在客户端安装即可工作,但关于发现矿脉的消息将不可读并显示通用代码)
这些选项使用自定义标记方块,Minecraft 必须将这些方块同步给已连接的玩家客户端。
保持 两个设置均为 false 可使 Ore Yield 保持客户端可选状态。
当禁用生成器追踪方块时,Stone Generator 本身不需要在客户端安装 Ore Yield —— 它将仅生成普通的原版宿主方块。
更改任一追踪设置后,请重启服务器和所有模组客户端。
反作弊机制(Anti-Cheese Mechanics)在 1.2.1 及更高版本中默认禁用。它们在 1.2.0 中默认启用。
原版矿石生成
原版矿石移除功能 默认处于禁用状态。
使用默认配置时,原版矿石会继续正常生成,并且类石方块可以提供 Ore Yield 掉落物。
这可以通过配置文件或配置界面进行更改。
当启用原版或兼容模组的矿石生成移除功能时,它仅影响 新生成的区块。现有区块和已生成的矿石方块不会被移除。
Ore Yield 为 Minecraft 添加了一个可配置的基于概率的采矿系统。
不再仅仅依赖可见的矿石矿脉,挖掘普通的类石方块也可以根据可配置的几率、Y 轴高度、维度、挖掘要求和宿主方块来奖励矿石。
每个已配置的矿石都会在符合条件的方块被破坏时执行各自的掉落检查。内置的 坏运气消除器(Bad Luck Eliminator) 还可以防止极长的倒霉连击。
Ore Yield 专为普通生存世界、整合包和服务器设计,提供广泛的配置选项,适用于简单和重度定制的设置。
支持的加载器和版本
| 加载器 |
支持的 Minecraft 版本 |
| Forge |
1.20.1 |
| Fabric |
1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2 |
| NeoForge |
1.21.1, 1.21.11, 26.1.2, 26.2 |
工作原理
- 挖掘受支持的宿主方块,如 Stone(石头)、Deepslate(深板岩)、Tuff(凝灰岩)、Netherrack(下界岩)、Blackstone(黑石)等。
- 每个已配置的矿石都会检查其配置的掉落几率。
- 成功的掷骰会将相应的资源掉落添加到物品栏。
- 幸运附魔(Fortune)会在适当时自动应用。
- 成功获得矿石掉落时可以奖励经验值。
- 坏运气消除器 可以在经历足够长的倒霉连击后保证掉落。
- 探索末地以发现一些惊喜...
特性
- 可配置的基于概率的类石方块矿石掉落。
- 可选的原版矿石生成移除。
- 可选的兼容模组矿石生成移除。
- 高度可配置的矿石几率、掉落数量、Y 轴高度、维度和宿主方块。
- 内置 坏运气消除器(Bad Luck Eliminator)。
- 完整的幸运附魔支持。
- 可配置的经验值奖励。
- 最低镐子等级要求。
- 通过配置完全自定义矿石的支持。
- 可选的自动检测模组矿石和类石方块。
- 自动检测额外维度。
- 针对几种流行内容模组的精选兼容性。
- Forge 和 NeoForge 配置界面。
- 通过 Mod Menu 提供 Fabric 配置支持。
- 内置 Stone Generator(石头生成器)。
- 可配置的生成器冷却时间和 Ore Yield 倍率。
- 生成器自动化和防爆安全措施。
- 可选的生成器追踪方块。
- 可选的玩家放置反作弊系统。
- 可选的 稀有矿物矿脉(Rare Mineral Pockets)。
- 可搜索的矿石配置。
- 游戏内配置验证。
- Alt+F12 诊断报告。
- 现有 Ore Yield 配置文件的自动迁移。
- 旨在保持轻量级,适合普通生存游戏玩法。
石头生成器
Ore Yield 包含一个可配置的 Stone Generator(石头生成器),默认情况下 已启用。
它由 围绕一个 End Stone(末地石)的八个钻石 合成而成。
经过配置的冷却时间后,生成器会尝试在其正上方创建一个宿主方块:
- 主世界: Stone(石头)
- 下界: Netherrack(下界岩)
- 末地: End Stone(末地石)
它永远不会替换已被占据的方块。
生成器可以配置以下内容:
- 自定义冷却时间。
- Ore Yield 奖励倍率。
- 生成器 Ore Yield 启用/禁用选项。
- 自动化收割控制。
- 爆炸收割控制。
- 自定义配方原料。
- 生成器追踪方块。
当使用 Diamond Pickaxe(钻石镐) 或 Netherite Pickaxe(下界合金镐) 挖掘时,Stone Generator 会明确掉落自身。
⚠️ 生成器追踪警告
正常的 Stone Generator 仍然与仅服务器端的安装兼容。
但是,启用:
generator_tracking_blocks_enabled = true
会使用自定义的追踪标记方块,因此需要 在每个连接的客户端上都安装 Ore Yield。
如果你希望客户端在不安装 Ore Yield 的情况下加入游戏,请保持此选项禁用。
稀有矿物矿脉
稀有矿物矿脉是可选的,默认情况下处于禁用状态。
启用后,它们在符合条件的方块被破坏后偶尔提供大量额外的资源掉落。
矿物矿脉:
- 支持独立配置的概率和掉落数量。
- 支持煤炭、金属、珍贵、宝石和古代类别。
- 可以为金属口袋和宝石口袋选择多个已安装的模组资源。
- 不使用或推进坏运气消除器(Bad Luck Eliminator)。
- 不受幸运附魔的影响。
- 无法由爆炸触发。
- 在主世界生效。
- 可选择性地在中枢界生效。
- 故意排除在下界生效。
- 可以独立允许或禁止生成器和自动化采集。
模组兼容性
Ore Yield 包含以下模组的精选兼容性:
Create
Mekanism
- Tin
- Osmium
- Uranium
- Fluorite
- Lead
Ice and Fire
Better Tools and Armor
- Ruby
- Sapphire
- Topaz
- End Titanium
Simple Ores
- Adamantium
- Tin
- Mythril
- Onyx
Netherrocks
- Argonite
- Ashstone
- Dragonstone
- Fyrite
- Illumenite
- Malachite
Tinkers' Construct
The Aether / Aether Redux / Deep Aether
- Gravitite
- Zanite
- Ambrosium
- Sentrite
- Skyjade
- Veridium
或者,可选的自动兼容性系统可以在启动时扫描模组矿石和石头方块。
自动检测到的矿石条目是可配置的,默认禁用。
更改自动兼容性设置后需要重启游戏。
维度支持
Ore Yield 可以自动检测其他模组安装的额外维度。
检测到的维度可以使用与主世界相同的矿石集:
- 掉落概率。
- Y 轴高度范围。
- 峰值分布。
- 坏运气消除器行为。
自动检测到的维度也可以通过配置文件手动移除或添加。
精选维度(例如由 Aether 系列提供的)由其专用的兼容性配置单独处理。
配置
主配置文件为:
config/ore_yield.toml
Ore Yield 的几乎每个部分都可以自定义:
- 启用或禁用特定矿石。
- 配置矿石掉落概率。
- 配置最小和最大掉落数量。
- 配置 Y 轴高度范围。
- 配置峰值 Y 轴高度分布。
- 限制矿石到特定维度。
- 选择符合条件的宿主方块。
- 配置所需的最小镐子等级。
- 选择幸运附魔的行为。
- 配置经验值奖励。
- 无需编写代码即可添加全新的矿石。
- 配置支持的额外维度。
- 配置石头生成器。
- 配置生成器追踪。
- 配置防作弊行为。
- 配置矿物口袋。
- 配置原版及兼容模组矿石的世界生成移除。
当引入新设置时,现有的 ore_yield.toml 文件会自动迁移。
配置的值会被保留,同时会添加新设置的设置和内置矿石部分。自定义矿石部分和无法识别的旧字段会被保留。
配置界面
Forge / NeoForge
使用标题屏幕中可用的 Ore Yield Config 按钮。
Fabric
安装 Mod Menu 以从模组列表访问 Ore Yield 配置界面。
原版矿石移除
remove_vanilla_ore_generation = false
是默认值。
false
原版矿石继续正常生成,而符合条件的类石头方块还可以提供 Ore Yield 掉落物。
true
移除原版矿石生成,Ore Yield 的石头掉落系统成为获取这些资源的主要方式。
世界生成移除仅影响新区块。
现有区块和已生成的矿石方块保持不变。
兼容模组的世界生成也可以单独控制。
调试工具
在游戏中按下:
Alt + F12
以生成 Ore Yield 诊断报告。
报告包括以下信息:
- 注册的矿石方块。
- 配置的矿石。
- 缺失的矿石。
- 检测到的模组矿石。
- 当前配置。
报告写入到:
ore_yield_debug.txt
在游戏目录中。
报告问题
发现 bug、兼容性问题或有功能请求?
请在 GitHub 仓库上提交问题,并尽可能包含更多信息:
- Minecraft 版本
- Forge、Fabric 或 NeoForge 版本
- Ore Yield 版本
- Java 版本
- 模组列表
- 相关配置设置
- 崩溃报告或最新日志(如果适用)
这使得问题更容易复现和修复。
⚠️ 已知问题
Ore Yield 1.2.1 存在重复的进度。
这是一个已知问题,计划在未来的更新中修复。
支持版本
Ore Yield 目前支持选定的 Minecraft 版本,从 1.20.1 到 26.2。
加载器的可用性取决于 Minecraft 版本,因此在下载前请查看上方的兼容性表。
欢迎提出建议、兼容性请求、错误报告和想法!
Ore Yield
⚠️ Important — Client Requirement
Ore Yield is client-optional by default and can normally be installed only on the server.
However, every player must also install the matching Ore Yield version on their client if either of these settings is enabled or if you want advancments to work properly (I do not know how to make them server-side only):
generator_tracking_blocks_enabled = true
enable_anti_cheese_mechanics = true
enable_mineral_pockets = true (works without it installed on clients, but message about discovery of pockets are not readable and display generic code)
These options use custom marker blocks that Minecraft must synchronize with connected clients.
Leave both settings set to false to keep Ore Yield client-optional.
The Stone Generator itself does NOT require Ore Yield on clients when Generator Tracking Blocks are disabled — it will simply generate normal vanilla host blocks.
After changing either tracking setting, restart the server and all modded clients.
Anti-Cheese Mechanics are disabled by default in 1.2.1 and newer. They were enabled by default in 1.2.0.
Vanilla Ore Generation
Vanilla ore removal is disabled by default.
With the default configuration, vanilla ores continue generating normally and stone-like blocks can provide Ore Yield drops.
This can be changed through the config file or configuration screen.
When vanilla or compatible ore generation removal is enabled, it affects newly generated chunks only. Existing chunks and already-generated ore blocks are not removed.
Ore Yield adds a configurable probability-based mining system to Minecraft.
Instead of relying only on visible ore veins, mining ordinary stone-like blocks can reward ores according to configurable chances, Y-levels, dimensions, mining requirements, and host blocks.
Each configured ore performs its own drop check when an eligible block is broken. The built-in Bad Luck Eliminator can additionally prevent extremely long unlucky streaks.
Ore Yield is designed for normal survival worlds, modpacks, and servers, with extensive configuration for both simple and heavily customized setups.
Supported Loaders and Versions
| Loader |
Supported Minecraft Versions |
| Forge |
1.20.1 |
| Fabric |
1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2 |
| NeoForge |
1.21.1, 1.21.11, 26.1.2, 26.2 |
How It Works
- Mine a supported host block such as Stone, Deepslate, Tuff, Netherrack, Blackstone, and more.
- Every configured ore checks its configured drop chance.
- Successful rolls add the corresponding resource drops.
- Fortune is applied automatically where appropriate.
- Experience can be awarded for successful ore drops.
- The Bad Luck Eliminator can guarantee drops after sufficiently long unlucky streaks.
- Explore the End for a few surprises...
Features
- Configurable probability-based ore drops from stone-like blocks.
- Optional removal of vanilla ore generation.
- Optional removal of compatible modded ore generation.
- Highly configurable ore chances, drop counts, Y-levels, dimensions, and host blocks.
- Built-in Bad Luck Eliminator.
- Full Fortune enchantment support.
- Configurable experience rewards.
- Minimum pickaxe-tier requirements.
- Support for entirely custom ores through configuration.
- Optional automatic detection of modded ores and stone blocks.
- Automatic detection of additional dimensions.
- Curated compatibility for several popular content mods.
- Forge and NeoForge configuration screens.
- Fabric configuration support through Mod Menu.
- Built-in Stone Generator.
- Configurable generator cooldown and Ore Yield multiplier.
- Generator automation and explosion safeguards.
- Optional Generator Tracking Blocks.
- Optional player-placement anti-cheese system.
- Optional Rare Mineral Pockets.
- Searchable ore configuration.
- In-game configuration validation.
- Alt+F12 diagnostics report.
- Automatic migration of existing Ore Yield configuration files.
- Designed to remain lightweight and suitable for normal survival gameplay.
Stone Generator
Ore Yield includes a configurable Stone Generator, which is enabled by default.
It is crafted using eight diamonds surrounding one End Stone.
After its configured cooldown, the generator attempts to create a host block directly above itself:
- Overworld: Stone
- Nether: Netherrack
- End: End Stone
It will never replace an occupied block.
The generator can be configured with:
- Custom cooldown.
- Ore Yield reward multiplier.
- Generator Ore Yield enable/disable option.
- Automation harvesting controls.
- Explosion harvesting controls.
- Custom recipe ingredients.
- Generator Tracking Blocks.
The Stone Generator explicitly drops itself when mined with a Diamond or Netherite Pickaxe.
⚠️ Generator Tracking Warning
The normal Stone Generator remains compatible with server-side-only installations.
However, enabling:
generator_tracking_blocks_enabled = true
uses custom tracked marker blocks and therefore requires Ore Yield to be installed on every connecting client.
Keep this option disabled if you want clients to join without installing Ore Yield.
Rare Mineral Pockets
Rare Mineral Pockets are optional and disabled by default.
When enabled, they provide occasional large bonus resource drops after eligible block breaks.
Mineral Pockets:
- Have independently configurable probabilities and reward amounts.
- Support Coal, Metal, Precious, Gem, and Ancient categories.
- Can select multiple installed resources for Metal and Gem pockets.
- Do not use or advance the Bad Luck Eliminator.
- Are not affected by Fortune.
- Cannot be triggered by explosions.
- Work in the Overworld.
- Can optionally work in the End.
- Are intentionally excluded from the Nether.
- Can independently allow or disallow generator and automated harvesting.
Mod Compatibility
Ore Yield includes curated compatibility for the following mods:
Create
Mekanism
- Tin
- Osmium
- Uranium
- Fluorite
- Lead
Ice and Fire
Better Tools and Armor
- Ruby
- Sapphire
- Topaz
- End Titanium
Simple Ores
- Adamantium
- Tin
- Mythril
- Onyx
Netherrocks
- Argonite
- Ashstone
- Dragonstone
- Fyrite
- Illumenite
- Malachite
Tinkers' Construct
The Aether / Aether Redux / Deep Aether
- Gravitite
- Zanite
- Ambrosium
- Sentrite
- Skyjade
- Veridium
Alternatively, the optional automatic compatibility system can scan for modded ores and stone blocks at startup.
Automatically detected ore entries are configurable and disabled by default.
A restart is required after changing automatic compatibility settings.
Dimension Support
Ore Yield can automatically detect additional dimensions installed by other mods.
Detected dimensions can use the Overworld ore set with the same:
- Drop chances.
- Y-level ranges.
- Peak distribution.
- Bad Luck Eliminator behaviour.
Automatically detected dimensions can also be manually removed or added through the configuration.
Curated dimensions such as those provided by the Aether family are handled separately by their dedicated compatibility configuration.
Configuration
The main configuration file is:
config/ore_yield.toml
Nearly every part of Ore Yield can be customized:
- Enable or disable individual ores.
- Configure ore drop chances.
- Configure minimum and maximum drop counts.
- Configure Y-level ranges.
- Configure peak Y-level distribution.
- Restrict ores to specific dimensions.
- Select eligible host blocks.
- Configure minimum pickaxe tiers.
- Choose Fortune behaviour.
- Configure XP rewards.
- Add entirely new ores without writing code.
- Configure additional supported dimensions.
- Configure the Stone Generator.
- Configure Generator Tracking.
- Configure anti-cheese behaviour.
- Configure Mineral Pockets.
- Configure vanilla and compatible ore world generation removal.
Existing ore_yield.toml files are migrated automatically when new settings are introduced.
Configured values are preserved, while newly added settings and built-in ore sections can be added to the configuration. Custom ore sections and unrecognized legacy fields are retained.
Configuration Screens
Forge / NeoForge
Use the Ore Yield Config button available from the title screen.
Fabric
Install Mod Menu to access the Ore Yield configuration screen from the mod list.
Vanilla Ore Removal
remove_vanilla_ore_generation = false
is the default.
false
Vanilla ores continue generating normally, while eligible stone-like blocks can additionally provide Ore Yield drops.
true
Vanilla ore generation is removed and the Ore Yield stone-drop system becomes the primary way of obtaining those resources.
World generation removal affects new chunks only.
Existing chunks and already-generated ore blocks remain unchanged.
Compatible modded world generation can also be controlled separately.
Debug Tool
Press:
Alt + F12
in-game to generate an Ore Yield diagnostics report.
The report includes information about:
- Registered ore blocks.
- Configured ores.
- Missing ores.
- Detected modded ores.
- Current configuration.
The report is written to:
ore_yield_debug.txt
in the game directory.
Reporting Issues
Found a bug, compatibility issue, or have a feature request?
Please open an issue on the GitHub repository and include as much information as possible:
- Minecraft version
- Forge, Fabric, or NeoForge version
- Ore Yield version
- Java version
- Mod list
- Relevant configuration settings
- Crash report or latest log, if applicable
This makes issues much easier to reproduce and fix.
⚠️ Known Issue
Ore Yield 1.2.1 has a duplicate advancement.
This is a known issue and is planned to be fixed in a future update.
Supported Versions
Ore Yield currently supports selected Minecraft versions from 1.20.1 through 26.2.
Loader availability depends on the Minecraft version, so check the compatibility table above before downloading.
Suggestions, compatibility requests, bug reports, and feature ideas are always welcome!
评论 0
登录后参与评分
还没有评论,来抢沙发吧