[FabledRealms] 晶洞

Geodes 是一个轻量级模组，在挖掘石头时会额外掉落物品。掉落表可以轻松配置，并且该模组正在持续更新与开发中。

该模组引入了基于深度的掉落缩放、加权掉落表以及可配置的挖掘条件，为玩家提供更丰厚的挖掘体验。

配置选项：

如果您使用托管服务器，配置文件位于您的根目录/config/geodes/geodes.json

如果您使用单人世界，配置文件位于您的 UserData/Saves/<世界名称>/config/geodes/geodes.json

========================
配置字段说明
========================

geodeItemId (字符串)
- 触发晶洞掉落时掉落的物品。
- 示例："Geode"

cooldownSeconds (数字)
- 每个玩家两次晶洞掉落之间的最小时间间隔。
- 防止使用快速工具或范围挖掘进行刷取。
- 示例：0.25 = 最多每 0.25 秒掉落一个晶洞

requiredBlockIds (字符串数组)
- 允许掉落晶洞的方块 ID 列表。
- 玩家必须挖掘这些方块之一才能触发晶洞掉落判定。
- 示例：["rock_stone"]

surfaceDropChance (数字 0–1)
- 地表附近掉落晶洞的基础概率。
- 示例：0.0025 = 0.25% 概率

deepDropChance (数字 0–1)
- 最深处掉落晶洞的最大概率。
- 示例：0.02 = 2% 概率

chanceStartDepthY (整数)
- 概率开始随深度变化的 Y 轴高度。
- 高于此高度 → 始终使用 surfaceDropChance

minDepthY (整数)
- 掉落概率达到最大值的 Y 轴高度。
- 低于或等于此高度 → 始终使用 deepDropChance

depthExponent (数字)
- 控制随着深度增加，掉落概率提升的速度。

  内部计算方式：
  normalizedDepth = (startDepth - currentY) / (startDepth - minDepth)
  finalChance = surfaceChance + (deepChance - surfaceChance) * pow(normalizedDepth, depthExponent)

  较低的值 (~1.0) = 线性缩放
  较高的值 (>2.0) = 地表附近稀有，深处概率激增

gems (加权列表)
- 定义打开晶洞后可能产出的物品。
- 每个条目包含一个 itemId 和一个 weight。

  示例条目：
  {
    "itemId": "Rock_Gem_Diamond",
    "weight": 8
  }

- 所有权重值相加得到总权重。
- 每个物品的掉落概率 = weight / totalWeight。

权重越高 = 越常见  
权重越低 = 越稀有

========================
默认战利品等级
========================

小水晶 (每个权重 20)
→ 常见奖励

宝石 (每个权重 8)
→ 少见奖励

矿石 (每个权重 3)
→ 稀有奖励

注意：您可以通过添加、修改或删除掉落物品 ID 来修改掉落表

========================
晶洞互动 (自定义物品)
========================

默认情况下，晶洞使用互动 ID：

geodes:open_geode

这个互动允许玩家右键点击（或互动）一个晶洞物品来打开它并抽取掉落表。

如果您正在创建自定义物品，可以通过将此互动 ID 添加到物品的互动列表中，使它们能够打开晶洞。

示例 (伪物品配置)：

{
  "itemId": "My_Custom_Geode",
  "interactions": [
    "geodes:open_geode"
  ]
}

任何拥有此互动的物品都会：
- 触发晶洞开启逻辑
- 从配置的掉落表中抽取奖励
- 消耗该物品 (除非被您自己的逻辑覆盖)

这允许您：
• 创建自定义晶洞 (例如：冰晶洞、火山晶洞、虚空晶洞)
• 创建与游戏进程相关的等级化晶洞
• 将晶洞开启功能与自定义工具或机制关联

========================
调优建议
========================

让晶洞更常见：
- 增加 surfaceDropChance 和/或 deepDropChance

让深层挖掘回报更丰厚：
- 增加 depthExponent

让晶洞总体更稀有：
- 降低两个掉落概率

让更好的战利品更频繁出现：
- 增加宝石条目的权重
- 降低水晶条目的权重

让模组作用于更多方块：
- 在 requiredBlockIds 中添加更多 ID