Initial commit - Grappling Hook mod

.gitignore

@@ -0,0 +1,21 @@
+# MacOS DS_Store files
+.DS_Store
+
+# Gradle cache folder
+.gradle
+
+# Gradle build folder
+build
+
+# IntelliJ
+out/
+.idea
+*.iml
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+# Common working directory
+run

build.gradle

@@ -0,0 +1,169 @@
+plugins {
+    id 'java-library'
+    id 'maven-publish'
+    id 'idea'
+    id 'net.neoforged.moddev' version '2.0.141'
+}
+
+version = mod_version
+group = mod_group_id
+
+repositories {
+    mavenLocal()
+}
+
+base {
+    archivesName = mod_id
+}
+
+java.toolchain.languageVersion = JavaLanguageVersion.of(21)
+
+neoForge {
+    // Specify the version of NeoForge to use.
+    version = project.neo_version
+
+    parchment {
+        mappingsVersion = project.parchment_mappings_version
+        minecraftVersion = project.parchment_minecraft_version
+    }
+
+    // This line is optional. Access Transformers are automatically detected
+    // accessTransformers.add('src/main/resources/META-INF/accesstransformer.cfg')
+
+    // Default run configurations.
+    // These can be tweaked, removed, or duplicated as needed.
+    runs {
+        client {
+            client()
+
+            // Comma-separated list of namespaces to load gametests from. Empty = all namespaces.
+            systemProperty 'neoforge.enabledGameTestNamespaces', project.mod_id
+        }
+
+        server {
+            server()
+            programArgument '--nogui'
+            systemProperty 'neoforge.enabledGameTestNamespaces', project.mod_id
+        }
+
+        // This run config launches GameTestServer and runs all registered gametests, then exits.
+        // By default, the server will crash when no gametests are provided.
+        // The gametest system is also enabled by default for other run configs under the /test command.
+        gameTestServer {
+            type = "gameTestServer"
+            systemProperty 'neoforge.enabledGameTestNamespaces', project.mod_id
+        }
+
+        data {
+                data()
+
+            // example of overriding the workingDirectory set in configureEach above, uncomment if you want to use it
+            // gameDirectory = project.file('run-data')
+
+            // Specify the modid for data generation, where to output the resulting resource, and where to look for existing resources.
+            programArguments.addAll '--mod', project.mod_id, '--all', '--output', file('src/generated/resources/').getAbsolutePath(), '--existing', file('src/main/resources/').getAbsolutePath()
+        }
+
+        // applies to all the run configs above
+        configureEach {
+            // Recommended logging data for a userdev environment
+            // The markers can be added/remove as needed separated by commas.
+            // "SCAN": For mods scan.
+            // "REGISTRIES": For firing of registry events.
+            // "REGISTRYDUMP": For getting the contents of all registries.
+            systemProperty 'forge.logging.markers', 'REGISTRIES'
+
+            // Recommended logging level for the console
+            // You can set various levels here.
+            // Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
+            logLevel = org.slf4j.event.Level.DEBUG
+        }
+    }
+
+    mods {
+        // define mod <-> source bindings
+        // these are used to tell the game which sources are for which mod
+        // mostly optional in a single mod project
+        // but multi mod projects should define one per mod
+        "${mod_id}" {
+            sourceSet(sourceSets.main)
+        }
+    }
+}
+
+// Include resources generated by data generators.
+sourceSets.main.resources { srcDir 'src/generated/resources' }
+
+
+dependencies {
+    // Example mod dependency with JEI
+    // The JEI API is declared for compile time use, while the full JEI artifact is used at runtime
+    // compileOnly "mezz.jei:jei-${mc_version}-common-api:${jei_version}"
+    // compileOnly "mezz.jei:jei-${mc_version}-forge-api:${jei_version}"
+    // runtimeOnly "mezz.jei:jei-${mc_version}-forge:${jei_version}"
+
+    // Example mod dependency using a mod jar from ./libs with a flat dir repository
+    // This maps to ./libs/coolmod-${mc_version}-${coolmod_version}.jar
+    // The group id is ignored when searching -- in this case, it is "blank"
+    // implementation "blank:coolmod-${mc_version}:${coolmod_version}"
+
+    // Example mod dependency using a file as dependency
+    // implementation files("libs/coolmod-${mc_version}-${coolmod_version}.jar")
+
+    // Example project dependency using a sister or child project:
+    // implementation project(":myproject")
+
+    // For more info:
+    // http://www.gradle.org/docs/current/userguide/artifact_dependencies_tutorial.html
+    // http://www.gradle.org/docs/current/userguide/dependency_management.html
+}
+
+// This block of code expands all declared replace properties in the specified resource targets.
+// A missing property will result in an error. Properties are expanded using ${} Groovy notation.
+var generateModMetadata = tasks.register("generateModMetadata", ProcessResources) {
+    var replaceProperties = [
+            minecraft_version      : minecraft_version,
+            minecraft_version_range: minecraft_version_range,
+            neo_version            : neo_version,
+            neo_version_range      : neo_version_range,
+            loader_version_range   : loader_version_range,
+            mod_id                 : mod_id,
+            mod_name               : mod_name,
+            mod_license            : mod_license,
+            mod_version            : mod_version,
+            mod_authors            : mod_authors,
+            mod_description        : mod_description
+    ]
+    inputs.properties replaceProperties
+    expand replaceProperties
+    from "src/main/templates"
+    into "build/generated/sources/modMetadata"
+}
+
+// Include the output of "generateModMetadata" as an input directory for the build
+// this works with both building through Gradle and the IDE.
+sourceSets.main.resources.srcDir generateModMetadata
+// To avoid having to run "generateModMetadata" manually, make it run on every project reload
+neoForge.ideSyncTask generateModMetadata
+
+// Example configuration to allow publishing using the maven-publish plugin
+publishing {
+    publications {
+        register('mavenJava', MavenPublication) {
+            from components.java
+        }
+    }
+    repositories {
+        maven {
+            url "file://${project.projectDir}/repo"
+        }
+    }
+}
+
+// IDEA no longer automatically downloads sources/javadoc jars for dependencies, so we need to explicitly enable the behavior.
+idea {
+    module {
+        downloadSources = true
+        downloadJavadoc = true
+    }
+}

gradle.properties

@@ -0,0 +1,44 @@
+# Sets default memory used for gradle commands. Can be overridden by user or command line properties.
+org.gradle.jvmargs=-Xmx2G
+org.gradle.daemon=true
+org.gradle.parallel=true
+org.gradle.caching=true
+org.gradle.configuration-cache=true
+
+## Environment Properties
+# You can find the latest versions here: https://projects.neoforged.net/neoforged/neoforge
+# The Minecraft version must agree with the Neo version to get a valid artifact
+minecraft_version=1.21.1
+# The Minecraft version range can use any release version of Minecraft as bounds.
+# Snapshots, pre-releases, and release candidates are not guaranteed to sort properly
+# as they do not follow standard versioning conventions.
+minecraft_version_range=[1.21.1,1.22)
+# The Neo version must agree with the Minecraft version to get a valid artifact
+neo_version=21.1.224
+# The Neo version range can use any version of Neo as bounds
+neo_version_range=[21,)
+# The loader version range can only use the major version of FML as bounds
+loader_version_range=[4,)
+
+parchment_minecraft_version=1.21.11
+parchment_mappings_version=2025.12.20
+
+## Mod Properties
+
+# The unique mod identifier for the mod. Must be lowercase in English locale. Must fit the regex [a-z][a-z0-9_]{1,63}
+# Must match the String constant located in the main mod class annotated with @Mod.
+mod_id=grappling_hook
+# The human-readable display name for the mod.
+mod_name=Grappling Hook
+# The license of the mod. Review your options at https://choosealicense.com/. All Rights Reserved is the default.
+mod_license=All Rights Reserved
+# The mod version. See https://semver.org/
+mod_version=1.0
+# The group ID for the mod. It is only important when publishing as an artifact to a Maven repository.
+# This should match the base package used for the mod sources.
+# See https://maven.apache.org/guides/mini/guide-naming-conventions.html
+mod_group_id=fr.jessydavid
+# The authors of the mod. This is a simple text string that is used for display purposes in the mod list.
+mod_authors=Jessy DAVID
+# The description of the mod. This is a simple multiline text string that is used for display purposes in the mod list.
+mod_description=Adds a functional grappling hook item to Minecraft.

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.8-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

@@ -0,0 +1,249 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd "${APP_HOME:-./}" > /dev/null && pwd -P ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

gradlew.bat

@@ -0,0 +1,92 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

settings.gradle

@@ -0,0 +1,11 @@
+pluginManagement {
+    repositories {
+        mavenLocal()
+        gradlePluginPortal()
+        maven { url = 'https://maven.neoforged.net/releases' }
+    }
+}
+
+plugins {
+    id 'org.gradle.toolchains.foojay-resolver-convention' version '0.8.0'
+}

src/main/java/fr/jessydavid/grappling_hook/GrapplingHook.java

@@ -0,0 +1,29 @@
+package fr.jessydavid.grappling_hook;
+
+import fr.jessydavid.grappling_hook.entity.ModEntities;
+import fr.jessydavid.grappling_hook.item.ModItems;
+import net.minecraft.world.item.CreativeModeTabs;
+import net.neoforged.bus.api.IEventBus;
+import net.neoforged.bus.api.SubscribeEvent;
+import net.neoforged.fml.common.EventBusSubscriber;
+import net.neoforged.fml.common.Mod;
+import net.neoforged.neoforge.event.BuildCreativeModeTabContentsEvent;
+
+@Mod(GrapplingHook.MODID)
+@EventBusSubscriber(modid = GrapplingHook.MODID)
+public class GrapplingHook {
+
+    public static final String MODID = "grappling_hook";
+
+    public GrapplingHook(IEventBus modEventBus) {
+        ModItems.ITEMS.register(modEventBus);
+        ModEntities.ENTITY_TYPES.register(modEventBus);
+    }
+
+    @SubscribeEvent
+    public static void buildCreativeTab(BuildCreativeModeTabContentsEvent event) {
+        if (event.getTabKey() == CreativeModeTabs.TOOLS_AND_UTILITIES) {
+            event.accept(ModItems.GRAPPLING_HOOK.get());
+        }
+    }
+}

src/main/java/fr/jessydavid/grappling_hook/client/ClientSetup.java

@@ -0,0 +1,202 @@
+package fr.jessydavid.grappling_hook.client;
+
+import com.mojang.blaze3d.vertex.PoseStack;
+import com.mojang.blaze3d.vertex.VertexConsumer;
+import fr.jessydavid.grappling_hook.GrapplingHook;
+import fr.jessydavid.grappling_hook.entity.GrapplingHookEntity;
+import fr.jessydavid.grappling_hook.entity.ModEntities;
+import net.minecraft.client.Minecraft;
+import net.minecraft.client.renderer.MultiBufferSource;
+import net.minecraft.client.renderer.RenderType;
+import net.minecraft.client.renderer.entity.EntityRenderer;
+import net.minecraft.client.renderer.entity.EntityRendererProvider;
+import net.minecraft.resources.ResourceLocation;
+import net.minecraft.util.Mth;
+import net.minecraft.world.entity.HumanoidArm;
+import net.minecraft.world.entity.player.Player;
+import net.neoforged.api.distmarker.Dist;
+import net.neoforged.bus.api.SubscribeEvent;
+import net.neoforged.fml.common.EventBusSubscriber;
+import net.neoforged.neoforge.client.event.EntityRenderersEvent;
+import org.joml.Matrix4f;
+import org.joml.Vector3f;
+
+@EventBusSubscriber(modid = GrapplingHook.MODID, value = Dist.CLIENT)
+public class ClientSetup {
+
+    @SubscribeEvent
+    public static void registerRenderers(EntityRenderersEvent.RegisterRenderers event) {
+        event.registerEntityRenderer(ModEntities.GRAPPLING_HOOK.get(), GrapplingHookRenderer::new);
+    }
+
+    public static class GrapplingHookRenderer extends EntityRenderer<GrapplingHookEntity> {
+
+        private static final ResourceLocation HOOK_TEXTURE =
+                ResourceLocation.fromNamespaceAndPath(GrapplingHook.MODID, "textures/item/hook.png");
+
+        private static final ResourceLocation CHAIN_TEXTURE =
+                ResourceLocation.withDefaultNamespace("textures/block/bamboo_stalk.png");
+
+        private static final float CHAIN_WIDTH = 0.025F;
+
+        public GrapplingHookRenderer(EntityRendererProvider.Context ctx) {
+            super(ctx);
+        }
+
+        @Override
+        public void render(GrapplingHookEntity entity, float entityYaw, float partialTicks,
+                           PoseStack poseStack, MultiBufferSource buffer, int packedLight) {
+
+            Player player = (Player) entity.getOwner();
+            if (player == null || !entity.isFocused()) return;
+
+            poseStack.pushPose();
+
+            poseStack.pushPose();
+            poseStack.mulPose(this.entityRenderDispatcher.cameraOrientation());
+            poseStack.scale(0.5F, 0.5F, 0.5F);
+
+            VertexConsumer hookConsumer = buffer.getBuffer(RenderType.entityTranslucentCull(HOOK_TEXTURE));
+            PoseStack.Pose hookPose = poseStack.last();
+
+            hookConsumer.addVertex(hookPose.pose(), -0.5F, -0.5F, 0.0F)
+                    .setColor(255, 255, 255, 255).setUv(0.0F, 1.0F)
+                    .setOverlay(0).setLight(packedLight).setNormal(hookPose, 0, 1, 0);
+            hookConsumer.addVertex(hookPose.pose(), 0.5F, -0.5F, 0.0F)
+                    .setColor(255, 255, 255, 255).setUv(1.0F, 1.0F)
+                    .setOverlay(0).setLight(packedLight).setNormal(hookPose, 0, 1, 0);
+            hookConsumer.addVertex(hookPose.pose(), 0.5F, 0.5F, 0.0F)
+                    .setColor(255, 255, 255, 255).setUv(1.0F, 0.0F)
+                    .setOverlay(0).setLight(packedLight).setNormal(hookPose, 0, 1, 0);
+            hookConsumer.addVertex(hookPose.pose(), -0.5F, 0.5F, 0.0F)
+                    .setColor(255, 255, 255, 255).setUv(0.0F, 0.0F)
+                    .setOverlay(0).setLight(packedLight).setNormal(hookPose, 0, 1, 0);
+
+            poseStack.popPose();
+
+            int handOffset = player.getMainArm() == HumanoidArm.RIGHT ? 1 : -1;
+            if (!player.getMainHandItem().is(entity.getItem().getItem())) {
+                handOffset = -handOffset;
+            }
+
+            float attackAnim = player.getAttackAnim(partialTicks);
+            float swingProgress = Mth.sin(Mth.sqrt(attackAnim) * (float) Math.PI);
+            float bodyYaw = Mth.lerp(partialTicks, player.yBodyRotO, player.yBodyRot) * ((float) Math.PI / 180F);
+            double sinYaw = Mth.sin(bodyYaw);
+            double cosYaw = Mth.cos(bodyYaw);
+            double handSide = handOffset * 0.35;
+
+            double handX, handY, handZ;
+            float crouchOffset;
+
+            if (this.entityRenderDispatcher.options.getCameraType().isFirstPerson()
+                    && player == Minecraft.getInstance().player) {
+                double fovScale = 960.0D / this.entityRenderDispatcher.options.fov().get().intValue();
+                net.minecraft.world.phys.Vec3 nearPlane = this.entityRenderDispatcher.camera.getNearPlane()
+                        .getPointOnPlane((float) handOffset * 0.825F, -0.08F);
+                nearPlane = nearPlane.scale(fovScale);
+                nearPlane = nearPlane.yRot(swingProgress * 0.5F);
+                nearPlane = nearPlane.xRot(-swingProgress * 0.7F);
+                handX = Mth.lerp(partialTicks, player.xo, player.getX()) + nearPlane.x;
+                handY = Mth.lerp(partialTicks, player.yo, player.getY()) + nearPlane.y;
+                handZ = Mth.lerp(partialTicks, player.zo, player.getZ()) + nearPlane.z;
+                crouchOffset = player.getEyeHeight();
+            } else {
+                handX = Mth.lerp(partialTicks, player.xo, player.getX()) - cosYaw * handSide - sinYaw * 0.8D;
+                handY = player.yo + player.getEyeHeight() + (player.getY() - player.yo) * partialTicks - 0.45D;
+                handZ = Mth.lerp(partialTicks, player.zo, player.getZ()) - sinYaw * handSide + cosYaw * 0.8D;
+                crouchOffset = player.isCrouching() ? -0.1875F : 0.0F;
+            }
+
+            double hookX = Mth.lerp(partialTicks, entity.xo, entity.getX());
+            double hookY = Mth.lerp(partialTicks, entity.yo, entity.getY()) + 0.25D;
+            double hookZ = Mth.lerp(partialTicks, entity.zo, entity.getZ());
+
+            float dx = (float) (handX - hookX);
+            float dy = (float) (handY - hookY) + crouchOffset;
+            float dz = (float) (handZ - hookZ);
+            float length = Mth.sqrt(dx * dx + dy * dy + dz * dz);
+
+            if (length < 0.01F) {
+                poseStack.popPose();
+                return;
+            }
+
+            VertexConsumer chainConsumer = buffer.getBuffer(RenderType.entityCutoutNoCull(CHAIN_TEXTURE));
+            PoseStack.Pose chainPose = poseStack.last();
+            Matrix4f mat = chainPose.pose();
+
+            float nx = dx / length;
+            float ny = dy / length;
+            float nz = dz / length;
+
+            Vector3f up = new Vector3f(0, 1, 0);
+            Vector3f dir = new Vector3f(nx, ny, nz);
+            Vector3f perp = new Vector3f();
+            dir.cross(up, perp);
+            if (perp.lengthSquared() < 0.001F) {
+                perp.set(1, 0, 0);
+            }
+            perp.normalize().mul(CHAIN_WIDTH);
+
+            int segments = Math.max(1, (int) (length / 0.5F));
+            float uvStep = length / segments;
+
+            for (int i = 0; i < segments; i++) {
+                float t0 = (float) i / segments;
+                float t1 = (float) (i + 1) / segments;
+
+                float x0 = dx * t0;
+                float y0 = dy * t0;
+                float z0 = dz * t0;
+                float x1 = dx * t1;
+                float y1 = dy * t1;
+                float z1 = dz * t1;
+
+                float u0 = i * uvStep;
+                float u1 = (i + 1) * uvStep;
+
+                // Side 1 (XY plane of the chain)
+                chainConsumer.addVertex(mat, x0 - perp.x, y0 - perp.y, z0 - perp.z)
+                        .setColor(255, 255, 255, 255).setUv(u0, 0.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+                chainConsumer.addVertex(mat, x1 - perp.x, y1 - perp.y, z1 - perp.z)
+                        .setColor(255, 255, 255, 255).setUv(u1, 0.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+                chainConsumer.addVertex(mat, x1 + perp.x, y1 + perp.y, z1 + perp.z)
+                        .setColor(255, 255, 255, 255).setUv(u1, 1.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+                chainConsumer.addVertex(mat, x0 + perp.x, y0 + perp.y, z0 + perp.z)
+                        .setColor(255, 255, 255, 255).setUv(u0, 1.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+
+                // Side 2 (perpendicular plane for 3D effect)
+                Vector3f perp2 = new Vector3f();
+                dir.cross(perp.normalize(new Vector3f()), perp2);
+                perp2.normalize().mul(CHAIN_WIDTH);
+
+                chainConsumer.addVertex(mat, x0 - perp2.x, y0 - perp2.y, z0 - perp2.z)
+                        .setColor(255, 255, 255, 255).setUv(u0, 0.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+                chainConsumer.addVertex(mat, x1 - perp2.x, y1 - perp2.y, z1 - perp2.z)
+                        .setColor(255, 255, 255, 255).setUv(u1, 0.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+                chainConsumer.addVertex(mat, x1 + perp2.x, y1 + perp2.y, z1 + perp2.z)
+                        .setColor(255, 255, 255, 255).setUv(u1, 1.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+                chainConsumer.addVertex(mat, x0 + perp2.x, y0 + perp2.y, z0 + perp2.z)
+                        .setColor(255, 255, 255, 255).setUv(u0, 1.0F)
+                        .setOverlay(0).setLight(packedLight).setNormal(chainPose, nx, ny, nz);
+            }
+
+            poseStack.popPose();
+
+            super.render(entity, entityYaw, partialTicks, poseStack, buffer, packedLight);
+        }
+
+        @Override
+        public ResourceLocation getTextureLocation(GrapplingHookEntity entity) {
+            return HOOK_TEXTURE;
+        }
+    }
+}

src/main/java/fr/jessydavid/grappling_hook/entity/GrapplingHookEntity.java

@@ -0,0 +1,124 @@
+package fr.jessydavid.grappling_hook.entity;
+
+import fr.jessydavid.grappling_hook.item.ModItems;
+import net.minecraft.sounds.SoundEvents;
+import net.minecraft.world.entity.EntityType;
+import net.minecraft.world.entity.MoverType;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.entity.projectile.ThrowableItemProjectile;
+import net.minecraft.world.item.Item;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.level.Level;
+import net.minecraft.world.phys.Vec3;
+import net.minecraft.world.phys.shapes.VoxelShape;
+
+public class GrapplingHookEntity extends ThrowableItemProjectile {
+
+    private static final double MAX_DISTANCE = 32.0D;
+    private static final double MAX_SPEED = 4.0D;
+
+    protected boolean isStick;
+    protected double stickLength;
+    private boolean addedToWorld;
+
+    public GrapplingHookEntity(EntityType<? extends GrapplingHookEntity> entityType, Level level) {
+        super(entityType, level);
+    }
+
+    public GrapplingHookEntity(Player owner, ItemStack ownerStack, Level level) {
+        super(ModEntities.GRAPPLING_HOOK.get(), level);
+        this.moveTo(owner.getX(), owner.getEyeY(), owner.getZ(), owner.getYHeadRot(), owner.getXRot());
+        this.setOwner(owner);
+        this.setItem(ownerStack);
+    }
+
+    @Override
+    protected Item getDefaultItem() {
+        return ModItems.GRAPPLING_HOOK.get();
+    }
+
+    @Override
+    public void tick() {
+        super.tick();
+
+        if (!addedToWorld) {
+            addedToWorld = true;
+        }
+
+        double offsetLengthSqr = distanceToSqr(getOwner());
+        double maxDistanceSqr = MAX_DISTANCE * MAX_DISTANCE;
+
+        if (!level().isClientSide() && (!isFocused() || offsetLengthSqr > maxDistanceSqr)) {
+            discard();
+            return;
+        }
+
+        // Collision detection with blocks
+        var collidableBox = getBoundingBox().inflate(0.25D);
+        var collisions = level().getBlockCollisions(this, collidableBox);
+
+        boolean willStick = false;
+        for (VoxelShape shape : collisions) {
+            if (!shape.isEmpty() && shape.bounds().intersects(collidableBox)) {
+                willStick = true;
+                break;
+            }
+        }
+
+        if (willStick && !isStick) {
+            stickLength = offsetLengthSqr;
+            playSound(SoundEvents.CHAIN_HIT);
+        }
+
+        isStick = willStick;
+
+        if (isStick && getOwner() != null) {
+            if (offsetLengthSqr > stickLength) {
+                var direction = position().subtract(getOwner().position()).normalize();
+                var scale = Math.min(MAX_SPEED, 0.01D * Math.sqrt(offsetLengthSqr));
+                if (scale >= 0) {
+                    getOwner().setDeltaMovement(getOwner().getDeltaMovement().add(direction.scale(scale)));
+                    getOwner().hurtMarked = true;
+                }
+            }
+            setDeltaMovement(0.0D, 0.0D, 0.0D);
+        } else {
+            setDeltaMovement(getDeltaMovement().scale(0.98D));
+            setDeltaMovement(getDeltaMovement().add(0.0D, -0.03D, 0.0D));
+        }
+
+        move(MoverType.SELF, getDeltaMovement());
+    }
+
+    // Pull
+    public void pull() {
+        if (getOwner() instanceof Player player && isStick) {
+            Vec3 direction = position().subtract(player.position()).normalize();
+            double distance = distanceTo(player);
+
+            double speed = Math.min(MAX_SPEED, Math.max(1.5D, distance * 0.5D));
+
+            player.setDeltaMovement(direction.scale(speed));
+            player.hurtMarked = true;
+            player.resetFallDistance();
+        }
+        discard();
+    }
+
+    public boolean isFocused() {
+        if (getOwner() instanceof Player player) {
+            return ItemStack.isSameItemSameComponents(player.getMainHandItem(), getItem())
+                    || ItemStack.isSameItemSameComponents(player.getOffhandItem(), getItem());
+        }
+        return false;
+    }
+
+    public boolean isStuck() {
+        return isStick;
+    }
+
+    @Override
+    public boolean shouldRenderAtSqrDistance(double distance) {
+        return distance < 4096.0D;
+    }
+}

src/main/java/fr/jessydavid/grappling_hook/entity/ModEntities.java

@@ -0,0 +1,25 @@
+package fr.jessydavid.grappling_hook.entity;
+
+import fr.jessydavid.grappling_hook.GrapplingHook;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.world.entity.EntityType;
+import net.minecraft.world.entity.MobCategory;
+import net.neoforged.neoforge.registries.DeferredHolder;
+import net.neoforged.neoforge.registries.DeferredRegister;
+
+public class ModEntities {
+
+    public static final DeferredRegister<EntityType<?>> ENTITY_TYPES =
+            DeferredRegister.create(BuiltInRegistries.ENTITY_TYPE, GrapplingHook.MODID);
+
+    public static final DeferredHolder<EntityType<?>, EntityType<GrapplingHookEntity>> GRAPPLING_HOOK =
+            ENTITY_TYPES.register("grappling_hook", () ->
+                    EntityType.Builder.<GrapplingHookEntity>of(GrapplingHookEntity::new, MobCategory.MISC)
+                            .sized(0.2F, 0.2F)
+                            .noSave()
+                            .noSummon()
+                            .clientTrackingRange(4)
+                            .updateInterval(2)
+                            .build("grappling_hook")
+            );
+}

src/main/java/fr/jessydavid/grappling_hook/item/GrapplingHookItem.java

@@ -0,0 +1,58 @@
+package fr.jessydavid.grappling_hook.item;
+
+import fr.jessydavid.grappling_hook.entity.GrapplingHookEntity;
+import net.minecraft.sounds.SoundEvents;
+import net.minecraft.sounds.SoundSource;
+import net.minecraft.world.InteractionHand;
+import net.minecraft.world.InteractionResultHolder;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.Item;
+import net.minecraft.world.item.ItemStack;
+import net.minecraft.world.level.Level;
+
+import java.util.List;
+
+public class GrapplingHookItem extends Item {
+
+    private static final float LAUNCH_POWER = 1.5F;
+
+    public GrapplingHookItem(Properties properties) {
+        super(properties);
+    }
+
+    @Override
+    public InteractionResultHolder<ItemStack> use(Level level, Player player, InteractionHand hand) {
+        ItemStack stack = player.getItemInHand(hand);
+
+        List<GrapplingHookEntity> existingHooks = level.getEntitiesOfClass(
+                GrapplingHookEntity.class,
+                player.getBoundingBox().inflate(64),
+                e -> e.getOwner() == player
+        );
+
+        if (!existingHooks.isEmpty()) {
+            if (!level.isClientSide()) {
+                existingHooks.forEach(hook -> {
+                    if (hook.isStuck()) {
+                        hook.pull();
+                    } else {
+                        hook.discard();
+                    }
+                });
+            }
+            return InteractionResultHolder.success(stack);
+        }
+
+        if (!level.isClientSide()) {
+            GrapplingHookEntity hook = new GrapplingHookEntity(player, stack, level);
+            hook.shootFromRotation(player, player.getXRot(), player.getYRot(), 0.0F, LAUNCH_POWER, 1.0F);
+            level.addFreshEntity(hook);
+
+            level.playSound(null, player.getX(), player.getY(), player.getZ(),
+                    SoundEvents.FISHING_BOBBER_THROW, SoundSource.PLAYERS,
+                    0.5F, 0.4F / (level.getRandom().nextFloat() * 0.4F + 0.8F));
+        }
+
+        return InteractionResultHolder.sidedSuccess(stack, level.isClientSide());
+    }
+}

src/main/java/fr/jessydavid/grappling_hook/item/ModItems.java

@@ -0,0 +1,18 @@
+package fr.jessydavid.grappling_hook.item;
+
+import fr.jessydavid.grappling_hook.GrapplingHook;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.world.item.Item;
+import net.neoforged.neoforge.registries.DeferredHolder;
+import net.neoforged.neoforge.registries.DeferredRegister;
+
+public class ModItems {
+
+    public static final DeferredRegister<Item> ITEMS =
+            DeferredRegister.create(BuiltInRegistries.ITEM, GrapplingHook.MODID);
+
+    public static final DeferredHolder<Item, GrapplingHookItem> GRAPPLING_HOOK =
+            ITEMS.register("grappling_hook", () ->
+                    new GrapplingHookItem(new Item.Properties().stacksTo(1))
+            );
+}

src/main/resources/assets/grappling_hook/lang/ar_sa.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "خطاف التسلق"
+}

src/main/resources/assets/grappling_hook/lang/cs_cz.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Hák"
+}

src/main/resources/assets/grappling_hook/lang/da_dk.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Enterhage"
+}

src/main/resources/assets/grappling_hook/lang/de_de.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Enterhaken"
+}

src/main/resources/assets/grappling_hook/lang/en_us.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Grappling Hook"
+}

src/main/resources/assets/grappling_hook/lang/es_es.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Gancho de Agarre"
+}

src/main/resources/assets/grappling_hook/lang/fi_fi.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Tarttumakoukku"
+}

src/main/resources/assets/grappling_hook/lang/fr_fr.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Grappin"
+}

src/main/resources/assets/grappling_hook/lang/hu_hu.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Csáklyahorog"
+}

src/main/resources/assets/grappling_hook/lang/it_it.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Rampino"
+}

src/main/resources/assets/grappling_hook/lang/ja_jp.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "グラップリングフック"
+}

src/main/resources/assets/grappling_hook/lang/ko_kr.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "그래플링 훅"
+}

src/main/resources/assets/grappling_hook/lang/nb_no.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Enterkrok"
+}

src/main/resources/assets/grappling_hook/lang/nl_nl.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Grijphaak"
+}

src/main/resources/assets/grappling_hook/lang/pl_pl.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Hak Wspinaczkowy"
+}

src/main/resources/assets/grappling_hook/lang/pt_br.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Gancho de Escalada"
+}

src/main/resources/assets/grappling_hook/lang/ro_ro.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Cârlig de Cățărare"
+}

src/main/resources/assets/grappling_hook/lang/ru_ru.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Крюк-Кошка"
+}

src/main/resources/assets/grappling_hook/lang/sk_sk.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Hák"
+}

src/main/resources/assets/grappling_hook/lang/sv_se.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Enterkrok"
+}

src/main/resources/assets/grappling_hook/lang/tr_tr.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Kanca"
+}

src/main/resources/assets/grappling_hook/lang/uk_ua.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "Гак-Кішка"
+}

src/main/resources/assets/grappling_hook/lang/zh_cn.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "抓钩"
+}

src/main/resources/assets/grappling_hook/lang/zh_tw.json

@@ -0,0 +1,3 @@
+{
+  "item.grappling_hook.grappling_hook": "抓鉤"
+}

src/main/resources/assets/grappling_hook/models/item/grappling_hook.json

@@ -0,0 +1,6 @@
+{
+  "parent": "item/generated",
+  "textures": {
+    "layer0": "grappling_hook:item/grappling_hook"
+  }
+}

src/main/resources/data/grappling_hook/recipe/grappling_hook.json

@@ -0,0 +1,20 @@
+{
+  "type": "minecraft:crafting_shaped",
+  "pattern": [
+    " F ",
+    "FC ",
+    " F "
+  ],
+  "key": {
+    "F": {
+      "item": "minecraft:iron_ingot"
+    },
+    "C": {
+      "item": "minecraft:string"
+    }
+  },
+  "result": {
+    "id": "grappling_hook:grappling_hook",
+    "count": 1
+  }
+}

src/main/templates/META-INF/neoforge.mods.toml

@@ -0,0 +1,79 @@
+# This is an example mods.toml file. It contains the data relating to the loading mods.
+# There are several mandatory fields (#mandatory), and many more that are optional (#optional).
+# The overall format is standard TOML format, v0.5.0.
+# Note that there are a couple of TOML lists in this file.
+# Find more information on toml format here:  https://github.com/toml-lang/toml
+# The name of the mod loader type to load - for regular FML @Mod mods it should be javafml
+modLoader="javafml" #mandatory
+# A version range to match for said mod loader - for regular FML @Mod it will be the the FML version. This is currently 47.
+loaderVersion="${loader_version_range}" #mandatory
+# The license for you mod. This is mandatory metadata and allows for easier comprehension of your redistributive properties.
+# Review your options at https://choosealicense.com/. All rights reserved is the default copyright stance, and is thus the default here.
+license="${mod_license}"
+# A URL to refer people to when problems occur with this mod
+#issueTrackerURL="https://change.me.to.your.issue.tracker.example.invalid/" #optional
+# A list of mods - how many allowed here is determined by the individual mod loader
+[[mods]] #mandatory
+# The modid of the mod
+modId="${mod_id}" #mandatory
+# The version number of the mod
+version="${mod_version}" #mandatory
+# A display name for the mod
+displayName="${mod_name}" #mandatory
+# A URL to query for updates for this mod. See the JSON update specification https://docs.neoforge.net/docs/misc/updatechecker/
+#updateJSONURL="https://change.me.example.invalid/updates.json" #optional
+# A URL for the "homepage" for this mod, displayed in the mod UI
+#displayURL="https://change.me.to.your.mods.homepage.example.invalid/" #optional
+# A file name (in the root of the mod JAR) containing a logo for display
+#logoFile="grappling_hook.png" #optional
+# A text field displayed in the mod UI
+#credits="" #optional
+# A text field displayed in the mod UI
+authors="${mod_authors}" #optional
+
+# The description text for the mod (multi line!) (#mandatory)
+description='''${mod_description}'''
+
+# The [[mixins]] block allows you to declare your mixin config to FML so that it gets loaded.
+#[[mixins]]
+#config="${mod_id}.mixins.json"
+
+# The [[accessTransformers]] block allows you to declare where your AT file is.
+# If this block is omitted, a fallback attempt will be made to load an AT from META-INF/accesstransformer.cfg
+#[[accessTransformers]]
+#file="META-INF/accesstransformer.cfg"
+
+# The coremods config file path is not configurable and is always loaded from META-INF/coremods.json
+
+# A dependency - use the . to indicate dependency for a specific modid. Dependencies are optional.
+[[dependencies."${mod_id}"]] #optional
+# the modid of the dependency
+modId="neoforge" #mandatory
+# The type of the dependency. Can be one of "required", "optional", "incompatible" or "discouraged" (case insensitive).
+# 'required' requires the mod to exist, 'optional' does not
+# 'incompatible' will prevent the game from loading when the mod exists, and 'discouraged' will show a warning
+type="required" #mandatory
+# Optional field describing why the dependency is required or why it is incompatible
+# reason="..."
+# The version range of the dependency
+versionRange="${neo_version_range}" #mandatory
+# An ordering relationship for the dependency.
+# BEFORE - This mod is loaded BEFORE the dependency
+# AFTER - This mod is loaded AFTER the dependency
+ordering="NONE"
+# Side this dependency is applied on - BOTH, CLIENT, or SERVER
+side="BOTH"
+# Here's another dependency
+[[dependencies."${mod_id}"]]
+modId="minecraft"
+type="required"
+# This version range declares a minimum of the current minecraft version up to but not including the next major version
+versionRange="${minecraft_version_range}"
+ordering="NONE"
+side="BOTH"
+
+# Features are specific properties of the game environment, that you may want to declare you require. This example declares
+# that your mod requires GL version 3.2 or higher. Other features will be added. They are side aware so declaring this won't
+# stop your mod loading on the server for example.
+#[features."${mod_id}"]
+#openGLVersion="[3.2,)"