Aetherium

Overview

Aetherium is a Fabric alternative to ProjectE, designed for Minecraft 26.2 and future releases as development continues. Rather than recreating ProjectE, Aetherium introduces its own interpretation of item transmutation. Every item has an Aetherium Value, allowing it to be converted into a universal resource and back again. Unlike ProjectE, Aetherium focuses on a steeper progression.

Features

To be Written

Modpack Support

1. Launch Minecraft once with Aetherium installed.
2. Close the game.
3. Navigate to config/Aetherium/
4. Open aetherium_values.json
5. Add or modify item values.

        {
          "_comment": "item id : Aetherium value. Decimal values are supported.",
          "minecraft:diamond": 30,
          "modid:custom_item": 42.26
        }

Mod Developer Support

This is going to be the most detailed section, to provide the best info I can.

1. Add Modrinth Maven to your repositories

repositories {
    exclusiveContent {
        forRepository {
            maven {
                name = "Modrinth"
                url = "https://api.modrinth.com/maven"
            }
        }
        filter {
            includeGroup "maven.modrinth"
        }
    }
}

2. Add Aetherium as a dependency using its latest version under dependencies (latest version always provided)

dependencies {
    implementation "maven.modrinth:aetherium:latest_release"
}

3. Create a new class anywhere as long as you register it with your Main class. (Example Provided)

  package com.example.mod_id;

import net.fabricmc.api.ModInitializer;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Aetherium implements ModInitializer {
	public static final String MOD_ID = "mod_id";
	public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);

	@Override
	public void onInitialize() {
		LOGGER.info("Hello Fabric World!");

		ModIdValuesInit.register();
	}

	public static Identifier id(String path) {
		return Identifier.fromNamespaceAndPath(MOD_ID, path);
	}
}

  package com.example.mod_id;

  import org.mythic_goose.aetherium.api.*; // Wildcard import for all Aetherium API classes

  public class ModIdValuesInit {
    public static void register() {

        Aeth naturalBase = Aeth.ofDecimalString("0.001");
        AethValues.set(Items.GRASS_BLOCK, naturalBase); // example of a predefined value being applied to a vanilla block
        AethValues.setTag(ItemTags.LEAVES, naturalBase); // same with item tags. Check AethValues for Documentation on all the methods available to you. 

        // Custom values defined seperately from a hub of multiple things.
        AethValues.setTag(ConventionalItemTags.OBSIDIANS, Aeth.ofDecimalString("149.992"));
        AethValues.set(Items.DRAGON_EGG, Aeth.ofDecimalString("15750.578"));

        // additionaly you can add ".multiply(2)" or ".divide(3)" to any Aeth value to multiply or divide it by a number. You can also use ".add()" and ".subtract()" to add or subtract Aeth values from each other. Check the Aeth class for more information on what you can do with Aeth values.
    }
  }

In v0.3.0 Aetherium introduced a new system that adds custom tool and armor materials that work similar to vanilla materials.

This will be a guide to help mod developers set this up

1. Custom Tools

Create a class named 'ModToolMaterials' - or similar

package com.example.mod_id;

import net.minecraft.tags.BlockTags;
import org.mythic_goose.aetherium.api.energy_system.materials.ChargedToolMaterial;
import org.mythic_goose.aetherium.api.Aeth;

public class ModToolMaterials {
    public static final ChargedToolMaterial EXAMPLE_MATERIAL = new ChargedToolMaterial(BlockTags.INCORRECT_FOR_NETHERITE_TOOL, 12.0F, 7.0F, 15,
                10000, 1, 1000, Aeth.ofUnits(40));

}

Charged Tool Materials example on how the method works

 EXAMPLE_MATERIAL = new ChargedToolMaterial(incorrectBlocksForDrops, baseSpeed, attackDamageBonus, enchantmentValue, maxCharge, chargePerUse, rechargeSegmentSize, rechargeSegmentCost);

Segments are how much charge is gained per recharge using 'V' (Default Key), SegmentCost is how much each recharge cost in Aetherium.

Heres how you create each tool using the example in Aetherium

  package org.mythic_goose.aetherium.init;

import net.minecraft.core.registries.BuiltInRegistries;
import net.minecraft.resources.ResourceKey;
import net.minecraft.tags.BlockTags;
import net.minecraft.world.item.*;
import org.mythic_goose.aetherium.api.energy_system.materials.ChargedToolMaterial;
import org.mythic_goose.aetherium.api.tools.ChargedAxeItem;
import org.mythic_goose.aetherium.api.tools.ChargedHoeItem;
import org.mythic_goose.aetherium.api.tools.ChargedShovelItem;
import org.mythic_goose.aetherium.api.tools.ChargedToolItem;
import org.mythic_goose.aetherium.registry.ItemRegistry;

public class AetheriumItems extends ItemRegistry {

    public static Item VOIDMASS_AXE;
    public static Item VOIDMASS_PICKAXE;
    public static Item VOIDMASS_SHOVEL;
    public static Item VOIDMASS_SPEAR;
    public static Item VOIDMASS_SWORD;
    public static Item VOIDMASS_HOE;

    public static void init() {

        VOIDMASS_AXE = registerItem("voidmass_axe", properties -> new ChargedAxeItem(
                ChargedToolMaterial.VOIDMASS, 6f, 8f,
                properties.fireResistant().rarity(Rarity.RARE)));

        VOIDMASS_SHOVEL = registerItem("voidmass_shovel", properties -> new ChargedShovelItem(
                ChargedToolMaterial.VOIDMASS, 6f, -2.8f,
                properties.fireResistant().rarity(Rarity.RARE)));

        VOIDMASS_HOE = registerItem("voidmass_hoe", properties -> new ChargedHoeItem(
                ChargedToolMaterial.VOIDMASS, 6f, -2.8f,
                properties.fireResistant().rarity(Rarity.RARE)));

        VOIDMASS_PICKAXE = registerItem("voidmass_pickaxe", properties -> new ChargedToolItem(
                ChargedToolMaterial.VOIDMASS,
                ChargedToolMaterial.VOIDMASS.applyToolProperties(properties, BlockTags.MINEABLE_WITH_PICKAXE, 2.8f, 6f, 0f)
                        .fireResistant().rarity(Rarity.RARE)));

        VOIDMASS_SWORD = registerItem("voidmass_sword", properties -> new ChargedToolItem(
                ChargedToolMaterial.VOIDMASS,
                ChargedToolMaterial.VOIDMASS.applySwordProperties(properties, 6f, 12f)
                        .fireResistant().rarity(Rarity.RARE)));

        VOIDMASS_SPEAR = registerItem("voidmass_spear", properties -> new ChargedToolItem(
                ChargedToolMaterial.VOIDMASS,
                ChargedToolMaterial.VOIDMASS.applySpearProperties(properties,
                                1.15F, 2.5F, 0.4F, 2.5F, 9.0F, 5.5F, 5.1F, 8.75F, 4.6F)
                        .fireResistant().rarity(Rarity.RARE)));
    }

    public static ResourceKey getRK(Item item) {
        return BuiltInRegistries.ITEM.getResourceKey(item).get();
    }
}

ItemRegistry is how Aetherium registers its items. using the "registerItem" method

2. Custom Armor

Create a class named 'ModArmorMaterials' - or similar

package com.example.mod_id;

import net.minecraft.tags.BlockTags;
import org.mythic_goose.aetherium.api.energy_system.materials.ChargedArmorMaterial;
import org.mythic_goose.aetherium.api.Aeth;

public class ModArmorMaterials {
    public static final ResourceKey> REGISTRY_KEY =
            ResourceKey.createRegistryKey(Identifier.withDefaultNamespace("equipment_asset"));

    public static final ResourceKey EXAMPLE_KEY =
            ResourceKey.create(REGISTRY_KEY, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, "example"));



    public static final ChargedArmorMaterial EXAMPLE_MATERIAL = new ChargedArmorMaterial(
                ArmorMaterials.makeDefense(7, 13, 18, 7, 23), // helmet, chestplate, leggings, boots, body
                28, SoundEvents.ARMOR_EQUIP_NETHERITE, 5.0F, 0.35F,
                EXAMPLE_KEY,    // key
                10000, 5,       // maxCharge, chargePerHit
                1000, Aeth.ofUnits(40)); // rechargeSegmentSize, rechargeSegmentCost

}

Here another example of how to create a Charged Armor Material:

  package org.mythic_goose.aetherium.init;

import net.minecraft.core.registries.BuiltInRegistries;
import net.minecraft.resources.ResourceKey;
import net.minecraft.tags.BlockTags;
import net.minecraft.world.item.*;
import org.mythic_goose.aetherium.api.energy_system.materials.ChargedArmorMaterial;
import org.mythic_goose.aetherium.api.energy_system.armor.ChargedArmorItem;
import org.mythic_goose.aetherium.registry.ItemRegistry;

public class AetheriumItems extends ItemRegistry {

    public static Item VOIDMASS_HELMET;
    public static Item VOIDMASS_CHESTPLATE;
    public static Item VOIDMASS_LEGGINGS;
    public static Item VOIDMASS_BOOTS;

    public static void init() {

        VOIDMASS_HELMET = registerItem("voidmass_helmet", properties -> new ChargedArmorItem(
                ChargedArmorMaterial.VOIDMASS,
                ChargedArmorMaterial.VOIDMASS.applyArmorProperties(properties, ArmorType.HELMET)
                        .rarity(Rarity.RARE).fireResistant().stacksTo(1)));

        VOIDMASS_CHESTPLATE = registerItem("voidmass_chestplate", properties -> new ChargedArmorItem(
                ChargedArmorMaterial.VOIDMASS,
                ChargedArmorMaterial.VOIDMASS.applyArmorProperties(properties, ArmorType.CHESTPLATE)
                        .rarity(Rarity.RARE).fireResistant().stacksTo(1)));

        VOIDMASS_LEGGINGS = registerItem("voidmass_leggings", properties -> new ChargedArmorItem(
                ChargedArmorMaterial.VOIDMASS,
                ChargedArmorMaterial.VOIDMASS.applyArmorProperties(properties, ArmorType.LEGGINGS)
                        .rarity(Rarity.RARE).fireResistant().stacksTo(1)));

        VOIDMASS_BOOTS = registerItem("voidmass_boots", properties -> new ChargedArmorItem(
                ChargedArmorMaterial.VOIDMASS,
                ChargedArmorMaterial.VOIDMASS.applyArmorProperties(properties, ArmorType.BOOTS)
                        .rarity(Rarity.RARE).fireResistant().stacksTo(1)));
    }

    public static ResourceKey getRK(Item item) {
        return BuiltInRegistries.ITEM.getResourceKey(item).get();
    }
}

Make sure to register your ModItems class to make this all work.

1. Custom Item Tags can either be found locations provided below:

import net.minecraft.tags.ItemTags; // Minecraft's Provided Tags that are used by the game
import net.fabricmc.fabric.api.tag.convention.v2.ConventionalItemTags; // Fabric's Provided Tags that Minecraft doesn't use
import org.mythic_goose.aetherium.util.AetheriumItemTags; // Aetherium's Tags used to assist

2. More Soon