#世界生成 (Worldgen)

onEvent('worldgen.add', event => {
  event.addOre(ore => {
    // 首先让我们看一下所有的"简单"过滤器
    ore.biomes = 'minecraft:plains' 		// 仅在这个生物群系中生成
    ore.biomes = /^minecraft:.*/			// 在所有匹配给定模式的生物群系中生成（这里：任何以 minecraft: 开头的）
    ore.biomes = '#minecraft:is_forest' 	// [1.19+] 在所有标记为 'minecraft:is_forest' 的生物群系中生成
    ore.biomes = '^nether' 				// [仅1.18！] 在 'nether' 类别中的所有生物群系中生成（请参阅生物群系类别）
    ore.biomes = '$hot'					// [仅Forge 1.18！] 在所有具有 'hot' 生物群系类型的生物群系中生成（请参阅生物群系词典）
    // 过滤器可以使用 AND、OR 和 NOT 逻辑任意组合
    ore.biomes = {}						// 空的 AND 过滤器，始终为 true
    ore.biomes = []						// 空的 OR 过滤器，也始终为 true
    ore.biomes = { not: 'minecraft:ocean' } // 在所有不是 'minecraft:ocean' 的生物群系中生成
    // 由于 AND 过滤器表示为映射并期望字符串键，
    // 所有"原始"过滤器也可以表示为这样
    ore.biomes = {					// 请参阅上面了解这些过滤器的解释
      id: 'minecraft:plains',
      id: /^minecraft:.*/,			// 正则表达式（技术上也是 ID 过滤器）
      tag: '#minecraft:is_forest',
      category: '^nether',
      biome_type: '$hot',
    }
    // 请注意，上述所有语法可以单独混合和匹配
    // 例如，这将在任何生物群系中生成特性，该生物群系
    // 要么是平原，要么是不在下界或热带草原类别的炎热生物群系
    ore.biomes = [
      'minecraft:plains', {
        biome_type: '$hot',
        not: [
          '#nether',
          { category: 'savanna' }
        ]
      },
    ]
  })
})

onEvent('worldgen.add', event => {
  // 使用事件中的 anchors 辅助方法（注意：这需要较新版本的 KubeJS）
  // 如果您使用的是旧版本的 KubeJS，可以使用矿石属性类中的方法
  const { anchors } = event

  event.addOre(ore => {
    ore.id = 'kubejs:glowstone_test_lmao' // (可选，但推荐) 特性的自定义ID
    ore.biomes = {
      not: '^savanna' // 生物群系过滤器，见上文（技术上也是可选的）
    }

    // 如何使用目标的示例
    ore.addTarget('#minecraft:stone_ore_replaceables', 'minecraft:glowstone') // 将原版 stone_ore_replaceables 标签中的任何东西替换为荧石
    ore.addTarget('minecraft:deepslate', 'minecraft:nether_wart_block')       // 将深板岩替换为地狱疣方块
    ore.addTarget([
      'minecraft:gravel',     // 替换沙砾...
      /minecraft:(.*)_dirt/   // 或任何种类的泥土（包括粗泥土、缠根泥土等）...
    ], 'minecraft:tnt')       // 用 TNT 替换（相信我，会很有趣）

    ore.count([15, 50])             // 生成15到50个矿脉（随机选择），您可以在这里使用单个数字来表示固定数量的方块
      .squared()                    // 随机将矿石分散在区块中，而不是在一列中生成它们
      .triangleHeight(				    // 以三角形分布生成矿石，这意味着它更可能放置在锚点中心附近
        anchors.aboveBottom(32),    // 下限应该是世界底部上方32个方块，因此在这种情况下，Y = -32，因为 minY = -64
        anchors.absolute(96)	      // 上限恰好设置为 Y = 96
      )								            // 总的来说，矿石可以在 Y 级别 -32 和 96 之间找到，最可能在 Y = (96 + -32) / 2 = 32

    // 更多可选参数（此处显示默认值）
    ore.size = 9                            // 最大矿脉大小
    ore.noSurface = 0.5                     // 如果矿石暴露在空气中，丢弃的几率
    ore.worldgenLayer = 'underground_ores'  // 矿石应该在哪个生成步骤中生成（见下文）
    ore.chance = 0							// 如果 != 0 且 count 未设置，矿石每个区块有 1/n 的生成几率
  })

  // 哦对了，我提到湖泊也存在吗？
  // （至少目前是这样，Vanilla 将来可能会移除它们）
  event.addLake(lake => {
    lake.id = 'kubejs:funny_lake' // BlockStatePredicate
    lake.chance = 4
    lake.fluid = 'minecraft:lava'
    lake.barrier = 'minecraft:diamond_block'
  })
})

onEvent('worldgen.remove', event => {
  console.info('HELP')
  //console.debugEnabled = true

  // 打印给定生物群系过滤器的所有特性
  event.printFeatures('', 'minecraft:plains')

  event.removeOres(props => {
    // 与添加矿石非常相似，这支持按世界生成层过滤...
    props.worldgenLayer = 'underground_ores'
    // ...和按生物群系过滤
    props.biomes = [
      { category: 'icy' },
      { category: 'savanna' },
      { category: 'mesa' }
    ]

    // BlockStatePredicate 从给定生物群系中移除铁矿石和铜矿石
    // 不幸的是，这里不能使用标签...
    props.blocks = ['minecraft:iron_ore', 'minecraft:copper_ore']
  })

  // 按ID移除特性（第一个参数是生成步骤）
  event.removeFeatureById('underground_ores', ['minecraft:ore_coal_upper', 'minecraft:ore_coal_lower'])
})