tutorial:ores
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| tutorial:ores [2021/05/21 15:34] – themodderofall | tutorial:ores [2024/10/28 17:55] (current) – Fix new identifier vs Identifier.of cassiancc | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Generating Custom Ores [1.16.3] ====== | + | If you are looking for 1.19.3, ores should be done completely in jsons. A helpful tool to know is: [[https:// |
| + | |||
| + | ====== Generating Custom Ores [1.19.3+] ====== | ||
| + | A lot of mods add their own ores, and you'll need a way to place them in existing biomes for players to find. In this tutorial, we'll look at adding ores to existing biomes. There are 2 steps that are required to add ores to biomes. | ||
| + | * Make worldgen Features in JSON that define how and where the ore block is spawned. | ||
| + | * Use [[https:// | ||
| + | |||
| + | To simplify, we use vanilla end rod as ore, because it can be easily found and seen underground in spectator mode. | ||
| + | |||
| + | ==== Adding to the overworld biomes ==== | ||
| + | In this section, our goal will be spawning the ore in the overworld. | ||
| + | |||
| + | First, create two new JSON files in your mod's data directory: | ||
| + | |||
| + | <code JavaScript src\main\resources\data\tutorial\worldgen\configured_feature\ore_custom.json> | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | This Configured Feature tells the game the size of the ore veins, what fraction of the ore blocks should be removed due to air exposure, and, importantly, | ||
| + | |||
| + | <code JavaScript src\main\resources\data\tutorial\worldgen\placed_feature\ore_custom.json> | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | } | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | This Placed Feature tells the game how many ore veins to place in a chunk, what shape the ore veins are placed in, and at what y-levels the ore veins are placed in. Note that the first line of the Placed Feature references the Configured Feature that was created a moment ago. | ||
| + | |||
| + | Writing these JSON files by hand is strenuous and inefficient. Note that the bulk of the work can be skipped by using tools like this [[https:// | ||
| + | |||
| + | Now that our data is created, it's time for code! Thanks to the changes in Minecraft 1.19.3, adding ore to world generation requires much less Java code. All we need to do is register the feature, then use the Fabric Biome Modification API to tell Minecraft which dimension to generate the ore in (and during which stage of world generation to generate the ore). | ||
| + | |||
| + | First, at the class level, let's create a new '' | ||
| + | |||
| + | <code Java src/ | ||
| + | public class ExampleMod implements ModInitializer { | ||
| + | |||
| + | public static final RegistryKey< | ||
| + | |||
| + | @Override | ||
| + | public void onInitialize() { | ||
| + | |||
| + | //Your other code here... | ||
| + | |||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | Notice 2 things: | ||
| + | * '' | ||
| + | * our identifier uses the name " | ||
| + | |||
| + | Now to add the Feature to a biome: | ||
| + | |||
| + | <code Java src/ | ||
| + | |||
| + | @Override | ||
| + | public void onInitialize() { | ||
| + | |||
| + | //Your other code here... | ||
| + | BiomeModifications.addFeature(BiomeSelectors.foundInOverworld(), | ||
| + | } | ||
| + | |||
| + | </ | ||
| + | |||
| + | ==== Testing ==== | ||
| + | |||
| + | To test your new ore, generate a new world. You can also open existing world but have to go to new chunks. In this example of end rod, the ores can be directly seen underground in spectator mode. | ||
| + | |||
| + | ==== Adding to the Nether or End ==== | ||
| + | |||
| + | Adding your ore to the other dimensions is very similar to adding ore to the Overworld. This section assumes you have already created an ore block for the Nether and End. | ||
| + | |||
| + | As with the Overworld, we begin with the JSON files. Using vanilla' | ||
| + | |||
| + | <code JavaScript src/ | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | } | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | Notice how the only real difference is that the height ranges are described differently, | ||
| + | |||
| + | As before, we add a Configured Feature as well. | ||
| + | |||
| + | <code JavaScript src/ | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | In the Configured Feature, remember that the '' | ||
| + | |||
| + | Finally, back in our Java code, right after our other BiomeModification line, | ||
| + | |||
| + | <code Java src/ | ||
| + | BiomeModifications.addFeature(BiomeSelectors.foundInNether(), | ||
| + | </ | ||
| + | |||
| + | Extrapolating this process to add ore to the End is left as an exercise for the reader. | ||
| + | |||
| + | ====== Generating Custom Ores [1.18.2 / 1.19.2] ====== | ||
| A lot of mods add their own ores, and you'll need a way to place them in existing biomes for players to find. In this tutorial, we'll look at adding ores to existing biomes. There are 2 steps that are required to add ores to biomes. | A lot of mods add their own ores, and you'll need a way to place them in existing biomes for players to find. In this tutorial, we'll look at adding ores to existing biomes. There are 2 steps that are required to add ores to biomes. | ||
| - | * Make a ConfiguredFeatures. This defines how your ore block is spawned. | + | * Make a ConfiguredFeature. This defines how your ore block is spawned. |
| * Use [[https:// | * Use [[https:// | ||
| Line 18: | Line 208: | ||
| <code java> | <code java> | ||
| public class ExampleMod implements ModInitializer { | public class ExampleMod implements ModInitializer { | ||
| - | private static ConfiguredFeature<?, | + | private static ConfiguredFeature<?, |
| - | .configure(new OreFeatureConfig( | + | (Feature.ORE, new OreFeatureConfig( |
| - | | + | |
| - | Blocks.WHITE_WOOL.getDefaultState(), | + | Blocks.WHITE_WOOL.getDefaultState(), |
| - | 9)) // vein size | + | 9)); // vein size |
| - | .decorate(Decorator.RANGE.configure(new RangeDecoratorConfig( | + | |
| - | | + | public static PlacedFeature OVERWORLD_WOOL_ORE_PLACED_FEATURE = new PlacedFeature( |
| - | YOffset.fixed(0), | + | RegistryEntry.of(OVERWORLD_WOOL_ORE_CONFIGURED_FEATURE), |
| - | | + | Arrays.asList( |
| - | | + | CountPlacementModifier.of(20), // number of veins per chunk |
| - | .repeat(20); // number of veins per chunk | + | |
| + | | ||
| + | )); // height | ||
| @Override | @Override | ||
| public void onInitialize() { | public void onInitialize() { | ||
| - | | + | |
| - | new Identifier(" | + | new Identifier(" |
| - | Registry.register(BuiltinRegistries.CONFIGURED_FEATURE, oreWoolOverworld.getValue(), ORE_WOOL_OVERWORLD); | + | Registry.register(BuiltinRegistries.PLACED_FEATURE, new Identifier(" |
| - | BiomeModifications.addFeature(BiomeSelectors.foundInOverworld(), | + | OVERWORLD_WOOL_ORE_PLACED_FEATURE); |
| + | BiomeModifications.addFeature(BiomeSelectors.foundInOverworld(), | ||
| + | RegistryKey.of(Registry.PLACED_FEATURE_KEY, | ||
| + | new Identifier(" | ||
| } | } | ||
| } | } | ||
| Line 41: | Line 236: | ||
| === Result === | === Result === | ||
| - | You should see wool spawning in the overworld. You can use below command to remove stone blocks surrounding you. | + | Always create a new world when you check the world generation result. |
| < | < | ||
| /fill ~-8 0 ~-8 ~8 ~ ~8 minecraft: | /fill ~-8 0 ~-8 ~8 ~ ~8 minecraft: | ||
| Line 51: | Line 246: | ||
| In this section, based on the code in the previous section, we will add the ore to the nether biomes. | In this section, based on the code in the previous section, we will add the ore to the nether biomes. | ||
| - | We have to replace '' | + | We need to replace '' |
| - | because | + | because |
| <code java> | <code java> | ||
| public class ExampleMod implements ModInitializer { | public class ExampleMod implements ModInitializer { | ||
| - | private static ConfiguredFeature<?, | + | private static ConfiguredFeature<?, |
| - | .configure(new OreFeatureConfig( | + | (Feature.ORE, new OreFeatureConfig( |
| - | | + | |
| - | Blocks.WHITE_WOOL.getDefaultState(), | + | Blocks.WHITE_WOOL.getDefaultState(), |
| - | 9)) | + | 9)); |
| - | | + | |
| - | | + | public static PlacedFeature NETHER_WOOL_ORE_PLACED_FEATURE = new PlacedFeature( |
| - | | + | |
| - | 64))) | + | |
| - | .spreadHorizontally() | + | |
| - | .repeat(20); | + | |
| + | | ||
| @Override | @Override | ||
| public void onInitialize() { | public void onInitialize() { | ||
| - | | + | |
| - | new Identifier(" | + | new Identifier(" |
| - | Registry.register(BuiltinRegistries.CONFIGURED_FEATURE, oreWoolNether.getValue(), ORE_WOOL_NETHER); | + | Registry.register(BuiltinRegistries.PLACED_FEATURE, new Identifier(" |
| - | BiomeModifications.addFeature(BiomeSelectors.foundInTheNether(), | + | NETHER_WOOL_ORE_PLACED_FEATURE); |
| + | BiomeModifications.addFeature(BiomeSelectors.foundInTheNether(), | ||
| + | RegistryKey.of(Registry.PLACED_FEATURE_KEY, | ||
| + | new Identifier(" | ||
| } | } | ||
| } | } | ||
| Line 81: | Line 280: | ||
| In this section, based on the code in the overworld section, we will add the ore to the end biomes. | In this section, based on the code in the overworld section, we will add the ore to the end biomes. | ||
| - | We replace '' | + | We replace '' |
| - | because endstone is used as a base block in the end biomes. | + | |
| <code java> | <code java> | ||
| public class ExampleMod implements ModInitializer { | public class ExampleMod implements ModInitializer { | ||
| - | private static ConfiguredFeature<?, | + | private static ConfiguredFeature<?, |
| - | .configure(new OreFeatureConfig( | + | (Feature.ORE, new OreFeatureConfig( |
| - | new BlockMatchRuleTest(Blocks.END_STONE), | + | new BlockMatchRuleTest(Blocks.END_STONE), |
| - | Blocks.WHITE_WOOL.getDefaultState(), | + | Blocks.WHITE_WOOL.getDefaultState(), |
| - | 9)) | + | 9)); |
| - | | + | |
| - | | + | public static PlacedFeature END_WOOL_ORE_PLACED_FEATURE = new PlacedFeature( |
| - | | + | |
| - | 64))) | + | |
| - | .spreadHorizontally() | + | |
| - | .repeat(20); | + | |
| + | | ||
| @Override | @Override | ||
| public void onInitialize() { | public void onInitialize() { | ||
| - | | + | |
| - | new Identifier(" | + | new Identifier(" |
| - | Registry.register(BuiltinRegistries.CONFIGURED_FEATURE, oreWoolEnd.getValue(), ORE_WOOL_END); | + | Registry.register(BuiltinRegistries.PLACED_FEATURE, new Identifier(" |
| - | BiomeModifications.addFeature(BiomeSelectors.foundInTheEnd(), | + | END_WOOL_ORE_PLACED_FEATURE); |
| + | BiomeModifications.addFeature(BiomeSelectors.foundInTheEnd(), | ||
| + | RegistryKey.of(Registry.PLACED_FEATURE_KEY, | ||
| + | new Identifier(" | ||
| } | } | ||
| } | } | ||
| </ | </ | ||
tutorial/ores.1621611298.txt.gz · Last modified: 2021/05/21 15:34 by themodderofall