aekey

Author: gardenevery

CHANGELOG.md

@@ -1,21 +1,30 @@
-## TemplateDevEnv
-_For Kotlin see [TemplateDevEnvKt](https://github.com/CleanroomMC/TemplateDevEnvKt)_
+## AEKey Legacy
+1.20.1 Applied Energistics 2's AEKey API port, adapted as much as possible to the 1.12.2 environment (e.g., metadata, OreDictionary)
 
-Template workspace for modding Minecraft 1.12.2. Licensed under MIT, it is made for public use.
+### License
 
-This template runs on **Java 25**, **Gradle 9.2.1** + **[RetroFuturaGradle](https://github.com/GTNewHorizons/RetroFuturaGradle) 2.0.2** + **Forge 14.23.5.2847**.
+#### Applied Energistics 2 API
+**(c) 2013 - 2020 AlgorithmX2 et al**  
+**[![License](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](http://opensource.org/licenses/MIT)**
 
-With **coremod and mixin support** that is easy to configure.
+**Directory:**
+- `aekeylegacy.api`
 
-### Instructions:
+---
 
-1. Click `use this template` at the top.
-2. Clone the repository that you have created with this template to your local machine.
-3. Make sure IDEA is using Java 25 for Gradle before you sync the project. Verify this by going to IDEA's `Settings > Build, Execution, Deployment > Build Tools > Gradle > Gradle JVM`.
-4. Open the project folder in IDEA. When prompted, click "Load Gradle Project" as it detects the `build.gradle`, if you weren't prompted, right-click the project's `build.gradle` in IDEA, select `Link Gradle Project`, after completion, hit `Refresh All` in the gradle tab on the right.
-5. Run gradle tasks such as `runClient` and `runServer` in the IDEA gradle tab, or use the auto-imported run configurations like `1. Run Client`.
+#### Applied Energistics 2
+**(c) 2013 - 2020 AlgorithmX2 et al**  
+**[![License](https://img.shields.io/badge/License-LGPLv3-blue.svg?style=flat-square)](https://raw.githubusercontent.com/AppliedEnergistics/Applied-Energistics-2/rv2/LICENSE)**
 
-### Notes:
-- Dependencies script in [gradle/scripts/dependencies.gradle](gradle/scripts/dependencies.gradle), explanations are commented in the file.
-- Publishing script in [gradle/scripts/publishing.gradle](gradle/scripts/publishing.gradle).
-- When writing Mixins on IntelliJ, it is advisable to use latest [MinecraftDev Fork for RetroFuturaGradle](https://github.com/eigenraven/MinecraftDev/releases).
+**Directories:**
+- `aekeylegacy.client`
+- `aekeylegacy.init`
+- `aekeylegacy.items`
+- `aekeylegacy.util`
+
+---
+
+### Credit
+
+**ForgeDevEnv**  
+**[![License](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://github.com/CleanroomMC/ForgeDevEnv/blob/master/LICENSE)**

LICENSE

@@ -2,7 +2,6 @@
  * It is advised that you do not edit anything in the build.gradle; unless you are sure of what you are doing
  */
 import com.gtnewhorizons.retrofuturagradle.mcp.InjectTagsTask
-import org.jetbrains.changelog.Changelog
 import org.jetbrains.gradle.ext.Gradle
 
 plugins {
@@ -110,6 +109,7 @@ repositories {
 }
 
 dependencies {
+    compileOnlyApi 'org.jetbrains:annotations:24.1.0'
     if (propertyBool('use_modern_java_syntax')) {
         annotationProcessor 'com.github.bsideup.jabel:jabel-javac-plugin:1.0.0'
         // Workaround for https://github.com/bsideup/jabel/issues/174
@@ -271,19 +271,6 @@ test {
     }
 }
 
-String parserChangelog() {
-    if (!file('CHANGELOG.md').exists()) {
-        throw new GradleException('publish_with_changelog is true, but CHANGELOG.md does not exist in the workspace!')
-    }
-    String parsedChangelog = changelog.renderItem(
-            changelog.get(propertyString('mod_version')).withHeader(false).withEmptySections(false),
-            Changelog.OutputType.MARKDOWN)
-    if (parsedChangelog.isEmpty()) {
-        throw new GradleException('publish_with_changelog is true, but the changelog for the latest version is empty!')
-    }
-    return parsedChangelog
-}
-
 tasks.register('generateMixinJson') {
     group 'cleanroom helpers'
     def missingConfig = propertyStringList('mixin_configs').findAll(config -> !file("src/main/resources/mixins.${config}.json").exists())

README.md

@@ -3,7 +3,7 @@ org.gradle.jvmargs = -Xmx3G
 
 # Source Options
 # Use Modern Java(9+) Syntax (Courtesy of Jabel)
-use_modern_java_syntax = false
+use_modern_java_syntax = true
 
 # Compilation Options
 generate_sources_jar = true
@@ -16,9 +16,9 @@ show_testing_output = false
 # Mod Information
 # HIGHLY RECOMMEND complying with SemVer for mod_version: https://semver.org/
 mod_version = 1.0.0
-root_package = com.example
-mod_id = modid
-mod_name = Mod Name
+root_package = aekeylegacy
+mod_id = aekeylegacy
+mod_name = AEKey Legacy
 
 # Mod Metadata (Optional)
 mod_description =

build.gradle

@@ -0,0 +1,46 @@
+package aekeylegacy;
+
+import java.util.Objects;
+
+import net.minecraft.client.renderer.block.model.ModelResourceLocation;
+import net.minecraft.item.Item;
+import net.minecraftforge.client.event.ModelRegistryEvent;
+import net.minecraftforge.client.model.ModelLoader;
+import net.minecraftforge.event.RegistryEvent;
+import net.minecraftforge.fml.common.Mod;
+import net.minecraftforge.fml.common.event.FMLPreInitializationEvent;
+import net.minecraftforge.fml.common.eventhandler.SubscribeEvent;
+import net.minecraftforge.fml.relauncher.Side;
+import net.minecraftforge.fml.relauncher.SideOnly;
+
+import aekeylegacy.aekeylegacy.Tags;
+import aekeylegacy.init.InitKeyTypes;
+import aekeylegacy.items.WrappedGenericStack;
+
+@Mod(modid = Tags.MOD_ID, name = Tags.MOD_NAME, version = Tags.VERSION)
+public class AEKeyLegacy {
+
+    @Mod.EventHandler
+    public void preInit(FMLPreInitializationEvent event) {
+        InitKeyTypes.init();
+    }
+
+    @Mod.EventBusSubscriber(modid = Tags.MOD_ID)
+    public static class RegistrationHandler {
+        @SubscribeEvent
+        public static void registerItems(RegistryEvent.Register<Item> event) {
+            var item = new WrappedGenericStack()
+                    .setRegistryName(Tags.MOD_ID, "wrapped_generic_stack")
+                    .setTranslationKey(Tags.MOD_ID + ".wrapped_generic_stack");
+            event.getRegistry().register(item);
+        }
+
+        @SideOnly(Side.CLIENT)
+        @SubscribeEvent
+        public static void registerModels(ModelRegistryEvent event) {
+            var item = aekeylegacy.items.WrappedGenericStack.getItem();
+            ModelLoader.setCustomModelResourceLocation(item, 0,
+                    new ModelResourceLocation(Objects.requireNonNull(item.getRegistryName()), "inventory"));
+        }
+    }
+}

gradle.properties

@@ -0,0 +1,22 @@
+package aekeylegacy;
+
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.LogManager;
+
+import aekeylegacy.aekeylegacy.Tags;
+
+public class AELog {
+    public static final Logger LOGGER = LogManager.getLogger(Tags.MOD_NAME);
+
+    public static void warn(String message, Object... params) {
+        LOGGER.warn(message, params);
+    }
+
+    public static void error(String message, Object... params) {
+        LOGGER.error(message, params);
+    }
+
+    public static void debug(String message, Object... params) {
+        LOGGER.debug(message, params);
+    }
+}

src/main/java/aekeylegacy/AEKeyLegacy.java

@@ -0,0 +1,82 @@
+package aekeylegacy;
+
+import java.lang.invoke.MethodHandle;
+import java.lang.invoke.MethodHandles;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Stream;
+import javax.annotation.Nonnull;
+
+import net.minecraft.item.Item;
+import net.minecraftforge.oredict.OreDictionary;
+
+public class OreDictUtil {
+    private static final MethodHandle STACK_TO_ID_HANDLE;
+    private static final MethodHandle ID_TO_NAME_HANDLE;
+    static {
+        try {
+            var stackToIdField = OreDictionary.class.getDeclaredField("stackToId");
+            stackToIdField.setAccessible(true);
+            STACK_TO_ID_HANDLE = MethodHandles.lookup().unreflectGetter(stackToIdField);
+            var idToNameField = OreDictionary.class.getDeclaredField("idToName");
+            idToNameField.setAccessible(true);
+            ID_TO_NAME_HANDLE = MethodHandles.lookup().unreflectGetter(idToNameField);
+        } catch (Exception exception) {
+            throw new RuntimeException("Failed to access OreDictionary private fields", exception);
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    private static Map<Integer, List<Integer>> getStackToId() {
+        try {
+            return (Map<Integer, List<Integer>>) STACK_TO_ID_HANDLE.invokeExact();
+        } catch (Throwable e) {
+            throw new RuntimeException("Failed to get stackToId", e);
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    private static List<String> getIdToName() {
+        try {
+            return (List<String>) ID_TO_NAME_HANDLE.invokeExact();
+        } catch (Throwable e) {
+            throw new RuntimeException("Failed to get idToName", e);
+        }
+    }
+
+    private OreDictUtil() {
+    }
+
+    public static Stream<String> getOreNames() {
+        return getIdToName().stream();
+    }
+
+    public static boolean hasTag(@Nonnull Item item, int metadata, @Nonnull String tag) {
+        int itemId = Item.REGISTRY.getIDForObject(item);
+        int effectiveMeta = item.getHasSubtypes() ? metadata : 0;
+        var idToName = getIdToName();
+        int tagId = -1;
+
+        for (int i = 0; i < idToName.size(); i++) {
+            if (tag.equals(idToName.get(i))) {
+                tagId = i;
+                break;
+            }
+        }
+
+        if (tagId == -1) {
+            return false;
+        }
+
+        var stackToId = getStackToId();
+        var wildcardIds = stackToId.get(itemId);
+        if (wildcardIds != null && wildcardIds.contains(tagId)) {
+            return true;
+        }
+
+        int exactKey = itemId | ((effectiveMeta + 1) << 16);
+        var exactIds = stackToId.get(exactKey);
+
+        return exactIds != null && exactIds.contains(tagId);
+    }
+}

src/main/java/aekeylegacy/AELog.java

@@ -0,0 +1,26 @@
+
+Some packages have a different license, please see the corresponding LICENSE files
+in those packages.
+
+----
+
+The MIT License (MIT)
+
+Copyright (c) 2023 Team Applied Energistics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

src/main/java/aekeylegacy/OreDictUtil.java

@@ -0,0 +1,68 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2013 AlgorithmX2
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+ * the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+ * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package aekeylegacy.api.config;
+
+public enum FuzzyMode {
+    /**
+     * Matches any item from undamaged to including 0% durability, but not negative durability (where item damage
+     * exceeds maxdamage).
+     */
+    IGNORE_ALL(-1),
+    /**
+     * Matches items that have less than 100% durability (that is, at least 1 damage point) if a damaged item is used as
+     * the filter, or undamaged items otherwise.
+     */
+    PERCENT_99(0),
+    /**
+     * If an item with less than 75% durability is used as the filter, items with less than 75% durability are matched.
+     * Otherwise items with 75% durability or more are matched.
+     */
+    PERCENT_75(25),
+    /**
+     * If an item with less than 50% durability is used as the filter, items with less than 50% durability are matched.
+     * Otherwise items with 50% durability or more are matched.
+     */
+    PERCENT_50(50),
+    /**
+     * If an item with less than 25% durability is used as the filter, items with less than 50% durability are matched.
+     * Otherwise items with 25% durability or more are matched.
+     */
+    PERCENT_25(75);
+
+    public final float breakPoint;
+    /**
+     * Note this is percentage "damaged". It's the inverse of percentage durability.
+     */
+    public final float percentage;
+
+    FuzzyMode(float p) {
+        this.percentage = p;
+        this.breakPoint = p / 100.0f;
+    }
+
+    public int calculateBreakPoint(int maxDamage) {
+        return (int) (this.percentage * maxDamage / 100.0f);
+    }
+
+}