CobbleGen - 圆石生成器

CobbleGen

一款允许你自定义/随机化圆石（玄武岩和石头）生成器的 Minecraft 模组。

关于

CobbleGen 是一款允许你自定义/随机化圆石（玄武岩和石头）生成器的 Minecraft 模组。

自 v5.0 起，CobbleGen 正式支持 Fabric 系和 Forge 系模组加载器。由于模组的设计方式，它应该能在未来版本的 Minecraft 中继续工作，但不要期望集成功能（例如 Create 模组集成、REI/EMI/JEI 集成）能正常工作。点击此处查看详细的版本追踪信息。

Fabric 版本的 JAR 文件应能在 Quilt 上运行，该模组设计时尽可能只依赖原版代码。

Forge 版本的 JAR 文件也应能在 NeoForge 上运行（仅限 MC 1.20.1）。对 Forge 的支持将在 MC 1.20.1 停止，请考虑迁移到 NeoForge 以在 MC 1.20.2 或更新版本中使用 CobbleGen！

功能特性

• 支持 Fabric/Quilt 和 NeoForge/Forge
• REI/EMI/JEI 集成
• 可自定义的圆石、石头和玄武岩生成器
• 使用可自定义的权重值随机化生成的方块
• 可自定义的修饰器，为玩家提供更多挑战
• 维度白名单/黑名单
• Y 轴高度限制器
• 支持标签（使用 #modid:tagid 代替 modid:blockid）
• 支持 Create 模组
• 管道/泵支持
• Fabric/Quilt 上的 Porting Lib 兼容性（修复石灰岩和火山渣生成器）
• 高级自定义生成器（自定义流体交互）
• 面向开发者的流体交互 API

更多功能即将推出！

计划中的功能

• 修饰器位置（不再局限于“生成方块下方”）
• 为整合包开发者提供易于配置生成器的 Web 应用
• 生物群系白名单/黑名单

使用方法

此模组主要是服务端模组，但建议在客户端也安装以支持 REI/EMI/JEI。

开箱即用时，该模组功能有限，它会生成默认配置，例如在深板岩层生成深板岩圆石，当生成方块下方有基岩时随机生成矿石等。要充分发挥模组的潜力，你需要自行配置。

配置

如果你不熟悉 JSON，可以尝试使用 CobbleGen 配置器，但请注意该网站仍在开发中，因此某些功能尚未在网站上实现。

该模组提供 3 层配置：默认、自定义和高级。

• 默认：最基本的修改，允许你替换原版生成的方块。例如，告诉生成器生成钻石块而不是圆石。
• 自定义：允许你修改生成器的修饰器，类似于生成玄武岩需要灵魂沙，但适用于任何类型的生成器。例如，告诉生成器当方块在基岩上方生成时生成矿石。
• 高级：允许你修改流体交互，你可以使用它来使用模组流体生成方块。例如，告诉生成器如果蜂蜜流体接触牛奶流体则生成钻石块。

配置文件位于 config/cobblegen.json5，格式应该相当直观：

格式

默认生成器格式

{
   "id":"mod_id:block_id",
   "weight":95.5,
   "dimensions":[
      "mod_id:dimension_id",
      "mod_id:dimension_id"
   ],
   "excludedDimensions":[
      "mod_id:dimension_id",
      "mod_id:dimension_id"
   ],
   "minY":0,
   "maxY":69
}

自定义生成器格式

{
   "generatorType (cobbleGen/stoneGen/basaltGen)":{
      "mod_id:modifier_block_id":[
         {
            "id":"mod_id:block_id",
            "weight":95.5,
            "dimensions":[
               "mod_id:dimension_id",
               "mod_id:dimension_id"
            ],
            "excludedDimensions":[
               "mod_id:dimension_id",
               "mod_id:dimension_id"
            ],
            "minY":0,
            "maxY":69
         }
      ]
   }
}

说明

• 除 id 和 weight 外，所有字段都是可选的，如果不需要可以删除它们，例如：

  {
    "id": "minecraft:bedrock",
    "weight": 1.0,  // 如你所见，这里只有 id 和 weight
  }

• 仅限自定义生成器：
• generatorType：需要替换为 cobbleGen、stoneGen 或 basaltGen 之一
• modid:modifierblock_id：需要替换为你选择的修饰器方块 ID（例如 minecraft:bedrock）
• id：生成方块的方块 ID（例如 minecraft:iron_ore）
• weight：生成方块的权重（数值越大 = 越常见）
• dimensions：方块可以生成的维度 ID 集合（这是一个数组！，例如 ["minecraft:the_end", "minecraft:nether"]）
• excludedDimensions：方块不能生成的维度 ID 集合（这是一个数组！，例如 ["minecraft:the_end", "minecraft:nether"]）
• minY：此方块可以生成的最低深度（例如 0 表示只能从世界高度上限到 Y=0（包含）生成）
• maxY：此方块可以生成的最高高度（例如 0 表示只能从基岩层到 Y=0（包含）生成）

默认生成器示例（圆石/石头/玄武岩）

{
  // 圆石生成器
  // { "id": "mod_id:block_id", "weight": 95.5 }
  "cobbleGen": [
    {
      "id": "minecraft:cobbled_deepslate",
      "weight": 100.0,
      "maxY": 0
    }
  ],
  // 石头生成器
  // { "id": "mod_id:block_id", "weight": 95.5 }
  "stoneGen": [
    {
      "id": "minecraft:stone",
      "weight": 100.0
    }
  ],
  // 玄武岩生成器
  // { "id": "mod_id:block_id", "weight": 95.5 }
  "basaltGen": [
    {
      "id": "minecraft:basalt",
      "weight": 100.0
    }
  ]
}

自定义生成器示例（带修饰器）

{
  // 自定义生成器
  // : { : [ { "id": , "weight":  }, ... ] }
  "customGen": {
    // 圆石生成器
    // { "id": "mod_id:block_id", "weight": 95.5 }
    "cobbleGen": {
      "minecraft:bedrock": [
        {
          "id": "minecraft:emerald_ore",
          "weight": 2.0
        },
        {
          "id": "minecraft:diamond_ore",
          "weight": 5.0
        },
        {
          "id": "minecraft:lapis_ore",
          "weight": 8.0
        },
        {
          "id": "minecraft:gold_ore",
          "weight": 10.0
        },
        {
          "id": "minecraft:iron_ore",
          "weight": 15.0
        },
        {
          "id": "minecraft:coal_ore",
          "weight": 20.0
        },
        {
          "id": "minecraft:cobblestone",
          "weight": 40.0
        }
      ]
    },
    // 石头生成器
    // { "id": "mod_id:block_id", "weight": 95.5 }
    "stoneGen": {
      "minecraft:bedrock": [
        {
          "id": "minecraft:stone",
          "weight": 40.0
        },
        {
          "id": "minecraft:diorite",
          "weight": 20.0
        },
        {
          "id": "minecraft:andesite",
          "weight": 20.0
        },
        {
          "id": "minecraft:granite",
          "weight": 20.0
        }
      ]
    },
    // 玄武岩生成器
    // { "id": "mod_id:block_id", "weight": 95.5 }
    "basaltGen": {
      "minecraft:bedrock": [
        {
          "id": "minecraft:end_stone",
          "weight": 100.0,
          "dimensions": [
            "minecraft:the_end"
          ]
        },
        {
          "id": "minecraft:blackstone",
          "weight": 100.0,
          "excludedDimensions": [
            "minecraft:the_end"
          ]
        }
      ]
    }
  }
}

高级自定义生成器（自定义流体交互）示例

{
  // 高级自定义生成器（自定义流体交互）
  // 基本格式：
  // "advanced": { : { : { results: {: [ { "id": , "weight":  }, ... ] } } } }
  "advanced": {
    // 请确保为此使用流体的静止版本，
    // - "minecraft:lava" 而不是 "minecraft:flowing_lava"
    // - "milk:still_milk" 而不是 "milk:flowing_milk"
    // 流体 ID 的构造方式取决于相应模组作者的实现。
    "minecraft:lava": {
      // 复制 Minecraft 圆石和石头生成器
      // 这个可以是流体的流动或静止版本，如果静止版本无效，请尝试流动版本。
      "minecraft:water": {
        // 石头生成器
        "resultsFromTop": {
          "*": [  // 通配符，接受任何方块作为修饰器
            {
              "id": "minecraft:stone",
              "weight": 100.0,
            }
          ]
        },
        // 圆石生成器
        "results": {
          "*": [  // 通配符，接受任何方块作为修饰器
            {
              "id": "minecraft:cobblestone",
              "weight": 100.0,
            }
          ]
        }
      },
      // 复制 Minecraft 玄武岩生成器
      "b:minecraft:blue_ice": {
        "results": {
          "minecraft:soul_soil": [
            {
              "id": "minecraft:basalt",
              "weight": 100.0,
            }
          ]
        }
      },
      // 使用玄武岩生成器方法的自定义安山岩生成器
      "b:minecraft:water_cauldron": {
        "silent": true,  // 防止播放熄灭声音
        "results": {
          "*": [
            {
              "id": "minecraft:andesite",
              "weight": 100.0,
            }
          ]
        }
      }
    },
    "milk:still_milk": {
      "b:minecraft:cobblestone": {
        "results": {
          "*": [
            {
              "id": "minecraft:diorite",
              "weight": 100.0,
            }
          ]
        }
      }
    }
  }
}

兼容性

~~任何修改流体交互行为的模组都可能与 CobbleGen 发生冲突。Porting Lib（Create 模组）除外。~~

从 v4.0 开始，CobbleGen 已重写，以尽可能减少模组不兼容性。