はじめに

鉱石を追加し、ワールド生成時に鉱石が生成されるようにしてみます。

今回、参考サイトを通りに手順を進め、鉱石を生成させることに成功しましたが、
自分の理解が追い付きませんでした。

ソースコードを眺め、ある程度調べてみましたが、推測を多く含みます。
分かり次第、記事を更新していく予定です。

参考
Ore Generation - Minecraft Modding Tutorial for MC 1.14/1.14.3 (Old)
Ore Generation - Minecraft Modding Tutorial for MC 1.14/1.14.4

💻開発環境

ここでは環境は以下のようにします。

Windows 10
JDK 8u211
Minecraft 1.14.4
Minecraft Forge 1.14.4 (28.1.0)
IntelliJ IDEA 2019.2.3

鉱石ブロックの追加

Minecraft 1.14.4 Forge Modの作成その4 【ブロックの追加】
を参考にブロックを追加します。

琵琶鉱石

琵琶湖ォーツ

パッケージ、クラスファイルの作成

jp/yuyu/biwako_mod/configフォルダを作成し、
フォルダ内に、Config.java、OregenConfig.javaファイルを作成します。

jp/yuyu/biwako_mod/worldフォルダを作成し、
フォルダ内に、OreGeneration.javaファイルを作成します。

Loggerをpublicに修正する

BiwakoMod.java

public static final Logger LOGGER = LogManager.getLogger(MOD_ID);

Config.java

ソースコード

ソースコード内のBiwakoModの部分を各自変更してください。

Config.java

package jp.yuyu.biwako_mod.config;

import java.io.File;

import com.electronwill.nightconfig.core.file.CommentedFileConfig;
import com.electronwill.nightconfig.core.io.WritingMode;

import jp.yuyu.biwako_mod.BiwakoMod;
import net.minecraftforge.common.ForgeConfigSpec;
import net.minecraftforge.fml.common.Mod;

@Mod.EventBusSubscriber
public class Config
{
    private static final ForgeConfigSpec.Builder SERVER_BUILDER = new ForgeConfigSpec.Builder();
    public static final ForgeConfigSpec SERVER;

    private static final ForgeConfigSpec.Builder CLIENT_BUILDER = new ForgeConfigSpec.Builder();
    public static final ForgeConfigSpec CLIENT;

    static
    {
        OregenConfig.init(SERVER_BUILDER, CLIENT_BUILDER);

        SERVER = SERVER_BUILDER.build();
        CLIENT = CLIENT_BUILDER.build();
    }

    public static void loadConfig(ForgeConfigSpec config, String path)
    {
        BiwakoMod.LOGGER.info("Loading config: " + path);
        final CommentedFileConfig file = CommentedFileConfig.builder(new File(path)).sync().autosave().writingMode(WritingMode.REPLACE).build();
        BiwakoMod.LOGGER.info("Built config: " + path);
        file.load();
        BiwakoMod.LOGGER.info("Loaded config: " + path);
        config.setConfig(file);
    }
}

役割

runClient実行時に生成されるrunフォルダ内にconfigフォルダがあり、
その中に、forge-client.tomlファイルがあります。

中身はこんな感じ。

forge-client.toml


# Client only settings, mostly things related to rendering
[client]
	#Disable culling of hidden faces next to stairs and slabs. Causes extra rendering, but may fix some resource packs that exploit this vanilla mechanic.
	disableStairSlabCulling = false
	#Allow item rendering to detect emissive quads and draw them properly. This allows glowing blocks to look the same in item form, but incurs a very slight performance hit.
	allowEmissiveItems = true
	#Toggle off to make missing model text in the gui fit inside the slot.
	zoomInMissingModelTextInGui = false
	#Enable forge to queue all chunk updates to the Chunk Update thread.
	#May increase FPS significantly, but may also cause weird rendering lag.
	#Not recommended for computers without a significant number of cores available.
	alwaysSetupTerrainOffThread = false
	#Enable the forge block rendering pipeline - fixes the lighting of custom models.
	forgeLightPipelineEnabled = true
	#When enabled, forge will show any warnings that occurred during loading
	showLoadWarnings = true
	#Enable uploading cloud geometry to the GPU for faster rendering.
	forgeCloudsEnabled = true
	#When enabled, makes specific reload tasks such as language changing quicker to run.
	selectiveResourceReloadEnabled = true

おそらく、Config.javaはこのコンフィグファイルを扱うために用意する必要があるのだと思います。
Serverのコンフィグはこの時は生成されない（？）みたいです

OregenConfig

ソースコード

各自変更しておく部分は、

ForgeConfigSpec.IntValueの変数名
ForgeConfigSpec.Builder.commentメソッドの引数
ForgeConfigSpec.Builder.defineInRangeメソッドの引数

です。解説はこの下に記載しています。

OregenConfig.java

package jp.yuyu.biwako_mod.config;

import jp.yuyu.biwako_mod.BiwakoMod;
import net.minecraftforge.common.ForgeConfigSpec;

public class OregenConfig
{
    public static ForgeConfigSpec.IntValue biwako_ore_chance;
    public static ForgeConfigSpec.BooleanValue generate_overworld;

    public static void init(ForgeConfigSpec.Builder server, ForgeConfigSpec.Builder client)
    {
        BiwakoMod.LOGGER.info("OregenConfig init");
        server.comment("Oregen Config");

        biwako_ore_chance = server
                .comment("Maximum number of ore veins of the biwako ore that can spawn in one chunk.")
                .defineInRange("oregen.biwako_ore_chance", 20, 1, 1000000);

        generate_overworld = server
                .comment("Decide if you want Biwako Mod ores to spawn in the overworld")
                .define("oregen.generate_overworld", true);
    }
}

解説

鉱石生成時のパラメータを設定するために用意するものと思われます。
先ほど作成したConfig.javaにより、サーバー向けコンフィグを追加しています。

commentメソッドにて、コンフィグファイルに記述されるコメントを設定します。
defineメソッドでコンフィグのPathと値、
defineInRangeではコンフィグのPathとデフォルト値、値の取りうる最小値・最大値を設定します。

このコンフィグはforge-client.tomlのようにファイル等の形で記憶され、ユーザが後から変更する
ことができるようになっているのだと思います。

Minecraft起動後、Mod一覧でModを選択した際にある設定がおそらく、これに当たると思うけど、
ソースコードを用意しないことには変更できないみたいです。

biwako_ore_chance

琵琶鉱石が生成されたときその周りに何個の鉱石を生成させるか、設定します。

バニラ鉱石を例に挙げると、

石炭 17
鉄鉱石金 9
ダイヤモンドレッドストーン 8
ラピスラズリ 7

です。今回はデフォルト値に20を設定したので、石炭のように大きな鉱脈が生成されるはずです。
また、取りうる値の範囲は1~1000000と設定しましたが、現状、デフォルト値以外に変更されないので、
常に20がbiwako_ore_chance変数に格納されています。

実際のワールドには、この値を最大値としたランダムな個数の鉱脈が生成されるようになっています。

generate_overworld

オーバーワールドに鉱石を生成するか、設定します。

OreGeneration

ソースコード

OreGeneration.java

package jp.yuyu.biwako_mod.world;

import jp.yuyu.biwako_mod.BiwakoMod;
import jp.yuyu.biwako_mod.config.OregenConfig;
import jp.yuyu.biwako_mod.lists.BlockList;
import net.minecraft.world.biome.Biome;
import net.minecraft.world.gen.GenerationStage;
import net.minecraft.world.gen.feature.Feature;
import net.minecraft.world.gen.feature.OreFeatureConfig;
import net.minecraft.world.gen.placement.CountRangeConfig;
import net.minecraft.world.gen.placement.Placement;
import net.minecraftforge.registries.ForgeRegistries;

public class OreGeneration {
    public static void setupOreGeneration() {
        if (OregenConfig.generate_overworld.get()) {
            for (Biome biome : ForgeRegistries.BIOMES) {
                biome.addFeature(
                        GenerationStage.Decoration.UNDERGROUND_ORES,
                        Biome.createDecoratedFeature(
                                Feature.ORE,
                                new OreFeatureConfig(
                                        OreFeatureConfig.FillerBlockType.NATURAL_STONE,
                                        BlockList.BiwakoOre.getDefaultState(),
                                        OregenConfig.biwako_ore_chance.get()),
                                Placement.COUNT_RANGE,
                                new CountRangeConfig(10, 20, 0, 100)));
                biome.addFeature(
                        GenerationStage.Decoration.UNDERGROUND_ORES,
                        Biome.createDecoratedFeature(
                                Feature.ORE,
                                new OreFeatureConfig(
                                        OreFeatureConfig.FillerBlockType.NETHERRACK,
                                        BlockList.BiwakoQuartzOre.getDefaultState(),
                                        OregenConfig.biwako_ore_chance.get()),
                                Placement.COUNT_RANGE,
                                new CountRangeConfig(10, 20, 0, 100)));
            }
        }
    }
}

解説

全部のバイオーム(Forest,River,Nezer,The End,...)を取得し、それぞれのバイオームに鉱石を生成させるようにします。

addFeatureメソッドの解説をします。

第1引数 Decoration decorationStage

バイオームに追加する特徴のタイプ。地下の鉱石以外にも地上の建造物、地下の建造物などがある。

今回は、GenerationStage.Decoration.UNDERGROUND_ORESで地下の鉱石を追加する。

第2引数 ConfiguredFeature> featureIn

具体的な鉱石の特徴を設定する。

OreFeatureConfig.FillerBlockType.NATURAL_STONEで鉱石の周りには、
自然のブロック(石・安山岩,...)で埋め尽くされて生成されます。
その後に洞窟が生成されるから、問題ないのかな？

BlockList.BiwakoOre.getDefaultState()で生成されたときのブロックの状態を設定します。
今回はデフォルトの状態を取得し、設定しています。

OregenConfig.biwako_ore_chance.get()で、1鉱脈に生成される鉱石の個数を設定します。

Placement.COUNT_RANGEは調査中です、よくわかっていません

CountRangeConfig(10, 20, 0, 100))で、生成される高さ、鉱脈の個数を設定している気がします。
第1引数:count,第2引数:bottomOffset,第3引数:topOffset,第4引数:maximumです。
第4引数生成されるy座標の最大値を表していることだけ分かりましたが、
それ以外の値がどう影響してくるのかは現在調査中です。

鉱石生成メソッドの呼び出し

最後に、BiwakoMod.javaのsetup()で鉱石を生成するセットアップメソッドを呼び出します。

BiwakoMod.java

    private void setup(final FMLCommonSetupEvent event) {
        OreGeneration.setupOreGeneration();
        LOGGER.info("HELLO FROM PREINIT");
    }

Minecraftの起動

ちゃんと生成されていました！

Githubにてプロジェクトを公開しています。