Home

Welcome to the SuperOres wiki!

This wiki aims to give a high-level view on how to create and work with custom ores, and editing the default ores as well.

When you first start the game with Super Ores, a config folder called superores will generate. Inside this config you'll find 2 files, a common.toml and a client.toml.

• common.toml: This config has one field, generateDefaults. When this is set to true, Super Ores will attempt to generate and create the default supported ores in the mod. Once all ores are generated, generateDefaults will automatically be set back to false. You may set this to true anytime you want to reset the ore config values.

• client.toml: This config also has one field, generateLang. When this is set to true, the mod will generate an en_us.json Language for all configured ores. Make sure to set this to true after adding or removing and ores!

You should also see a respective ores folder. This is the core folder for every ore that exists in Super Ores. The mod will only load the ores that are in that folder. If you delete a default ore's config, the mod will not add it in until you generateDefaults again or manually add it in. To create a new ore, add a new .json file and copy the template below:

{
    //This is the name of your ore. Super ores will automatically suffix the name with "super_".
    //Each underscore will be replaced with a space, likewise each word after an underscore will be capitalized for Lang files
    "name": "iron_ore",
    //This value is optional, set it to true if you'd like a deepslate version of your ore
    "hasDeepslate": true,
    //These are required block properties
    //requiredTool can be: ["wood_pickaxe", "stone_pickaxe", "iron_pickaxe", "gold_pickaxe", "diamond_pickaxe" "netherite_pickaxe"]
    "properties": {
        "strength": 4.0,
        "requiredTool": "stone_pickaxe"
    },
    //What the block will drop once broken, this is required
    "drops": {
        //The ID of the block/item to drop
        "id": "minecraft:raw_iron",
        "rate": {
            //The minimum and maximum number of items that can be dropped
            "min_inclusive": 2,
            "max_inclusive": 5
        }
    },
    //How often the ore can spawn in the world, this is required
    "spawnRate": {
        //SpawnDimension can be: ["overworld", "nether", "end"]
        //If set to "overworld", ores will be spawnable in every biome and dimension other than "nether" and "end"
        "spawnDimension": "overworld",
        //The maximum number of ores in a vein
        "veinSize": 4,
        //The spawn frequency of the ore
        "spawnFrequency": 6,
        //The min and max Y levels an ore can be spawned at
        "minSpawnY": -63,
        "maxSpawnY": 50
    },
    //The texture properties of an ore, this is Optional
    //If an ore does not have a texture property, the mod will attempt to load a blockstate model for it
    //If you would like to create a blockstate model, they can be added in the "config/superores/resources/assets/superores" directory
    "texture": {
        //The color that the overlay will be set to. This is optional
        "color": "#FFFFFF",
        //The base texture for the ore, think netherrack, endstone, etc, whatever you like, can be modded textures as well
        "baseTexture": "block/stone",
        //The ore overlay texture, this can also be anything but superores ships with a default "superores:block/ore_overlay" for your convenience
        "overlayTexture": "superores:block/ore_overlay"
    }
}

Keep in mind, default ores can be removed by deleting their .json config in the ores directory. Likewise any value in there can also be edited