1.0.0

2025-02-12 19:47:48 +08:00 · 2025-02-12 19:47:48 +08:00 · bc634bb8b1
commit bc634bb8b1
28 changed files with 1693 additions and 0 deletions
--- a/.gitattributes
+++ b/.gitattributes
@ -0,0 +1,5 @@
+# Disable autocrlf on generated files, they always generate with LF
+# Add any extra files or paths here to make git stop saying they
+# are changed when only line endings change.
+src/generated/**/.cache/cache text eol=lf
+src/generated/**/*.json text eol=lf
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@ -0,0 +1,25 @@
+name: Build
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Setup JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Build with Gradle
+        run: ./gradlew build
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,26 @@
+# eclipse
+bin
+*.launch
+.settings
+.metadata
+.classpath
+.project
+
+# idea
+out
+*.ipr
+*.iws
+*.iml
+.idea
+
+# gradle
+build
+.gradle
+
+# other
+eclipse
+run
+runs
+run-data
+
+repo
--- a/LICENSE.md
+++ b/LICENSE.md
@ -0,0 +1,68 @@
+# Camellia License  
+
+**Version: 1.0**  
+
+---
+
+## Article 1: Definitions  
+1. This license applies to all individuals or organizations using, modifying, or distributing this project and its derivative works.  
+2. **"Original Author"** refers to the developer who initially created this project.  
+3. **"User"** refers to any individual or organization using, modifying, or distributing this project under this license.  
+4. **"Notify the Original Author"** means the user must send a notice to the publicly available contact provided by the original author:  
+   - The notice must clearly specify the user's planned actions and related details.  
+   - If no objection is received within 7 days after the notice is sent, the user may proceed with their plan.  
+
+---
+
+## Article 2: Scope of Authorization  
+1. Users may freely copy, modify, and distribute this project in non-commercial environments.  
+2. Commercial use is prohibited without prior authorization, including but not limited to:  
+   - Directly selling this project or its derivative works;  
+   - Authorizing third parties to sell this project or its derivative works;  
+   - Bundling this project or its derivative works as part of paid software or services.  
+3. To engage in commercial use, the user must contact the original author or an explicitly authorized representative to obtain permission:  
+   - If multiple forks exist, the user should contact the nearest authorized fork developer unless otherwise stated by the original author.  
+
+---
+
+## Article 3: Platform Incentives  
+1. Users may upload this project to platforms (e.g., CurseForge) to earn platform incentives but must **"notify the original author"**.  
+2. Platform incentives belong entirely to the uploader, and no profit sharing with the original author is required.  
+
+---
+
+## Article 4: Code Open-Sourcing and Attribution Requirements  
+1. Users who modify and distribute this project must meet the following requirements:  
+   - Retain a visible link to the original project in the project code;  
+   - Use the same or a newer version of this license (Camellia License);  
+   - Open-source the modified code on the same code hosting platform as the original author:  
+     - If the user wishes to use additional code hosting platforms, they must **"notify the original author"**.  
+2. When distributing, users must retain visible attribution to the original author in the project code.  
+
+---
+
+## Article 5: Disclaimer  
+1. This project is provided "as is" without any express or implied warranties, including but not limited to merchantability, fitness for a particular purpose, or non-infringement.  
+2. The original author is not responsible for any direct or indirect losses resulting from the use or modification of this project.  
+
+---
+
+## Article 6: Violation Handling  
+1. Users who violate this license must immediately cease the violation and take necessary remedial actions.  
+2. If a user engages in commercial use in violation of this license, the original author has the right to claim all profits gained from the violation.  
+3. Any disputes are governed by the laws of the jurisdiction where the original author resides.  
+
+---
+
+## Article 7: License Revisions  
+1. Each version of this license is fixed and cannot be altered.  
+2. Revised versions of this license will be released as new versions, and users may choose to comply with either the current version or any newer version.  
+
+---
+
+## Article 8: Other Provisions  
+1. This license does not restrict users from engaging in other lawful activities permitted by this license.  
+
+---
+
+**Copyright © 2024 [Author]**
--- a/README.md
+++ b/README.md
@ -0,0 +1,25 @@
+
+Installation information
+=======
+
+This template repository can be directly cloned to get you started with a new
+mod. Simply create a new repository cloned from this one, by following the
+instructions provided by [GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template).
+
+Once you have your clone, simply open the repository in the IDE of your choice. The usual recommendation for an IDE is either IntelliJ IDEA or Eclipse.
+
+If at any point you are missing libraries in your IDE, or you've run into problems you can
+run `gradlew --refresh-dependencies` to refresh the local cache. `gradlew clean` to reset everything 
+{this does not affect your code} and then start the process again.
+
+Mapping Names:
+============
+By default, the MDK is configured to use the official mapping names from Mojang for methods and fields 
+in the Minecraft codebase. These names are covered by a specific license. All modders should be aware of this
+license. For the latest license text, refer to the mapping file itself, or the reference copy here:
+https://github.com/NeoForged/NeoForm/blob/main/Mojang.md
+
+Additional Resources: 
+==========
+Community Documentation: https://docs.neoforged.net/  
+NeoForged Discord: https://discord.neoforged.net/
--- a/TEMPLATE_LICENSE.txt
+++ b/TEMPLATE_LICENSE.txt
@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2023 NeoForged project
+
+This license applies to the template files as supplied by github.com/NeoForged/MDK
+
+
+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.
--- a/build.gradle
+++ b/build.gradle
@ -0,0 +1,189 @@
+plugins {
+    id 'java-library'
+    id 'maven-publish'
+    id 'net.neoforged.moddev' version '2.0.78'
+    id 'idea'
+}
+
+tasks.named('wrapper', Wrapper).configure {
+    // Define wrapper values here so as to not have to always do so when updating gradlew.properties.
+    // Switching this to Wrapper.DistributionType.ALL will download the full gradle sources that comes with
+    // documentation attached on cursor hover of gradle classes and methods. However, this comes with increased
+    // file size for Gradle. If you do switch this to ALL, run the Gradle wrapper task twice afterwards.
+    // (Verify by checking gradle/wrapper/gradle-wrapper.properties to see if distributionUrl now points to `-all`)
+    distributionType = Wrapper.DistributionType.BIN
+}
+
+version = mod_version
+group = mod_group_id
+
+repositories {
+    mavenLocal()
+}
+
+base {
+    archivesName = "$mod_id-neoforge-$mod_version"
+}
+
+// Mojang ships Java 21 to end users starting in 1.20.5, so mods should target Java 21.
+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 = project.files('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
+        // 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' }
+
+// Sets up a dependency configuration called 'localRuntime'.
+// This configuration should be used instead of 'runtimeOnly' to declare
+// a dependency that will be present for runtime testing but that is
+// "optional", meaning it will not be pulled by dependents of this mod.
+configurations {
+    runtimeClasspath.extendsFrom localRuntime
+}
+
+dependencies {
+    // Example optional 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}-neoforge-api:${jei_version}"
+    // We add the full version to localRuntime, not runtimeOnly, so that we do not publish a dependency on it
+    // localRuntime "mezz.jei:jei-${mc_version}-neoforge:${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"
+        }
+    }
+}
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8' // Use the UTF-8 charset for Java compilation
+}
+
+// IDEA no longer automatically downloads sources/javadoc jars for dependencies, so we need to explicitly enable the behavior.
+idea {
+    module {
+        downloadSources = true
+        downloadJavadoc = true
+    }
+}
--- a/gradle.properties
+++ b/gradle.properties
@ -0,0 +1,24 @@
+org.gradle.jvmargs=-Xmx1G
+org.gradle.daemon=true
+org.gradle.parallel=true
+org.gradle.caching=true
+org.gradle.configuration-cache=true
+
+parchment_minecraft_version=1.21.1
+parchment_mappings_version=2024.11.17
+# Environment Properties
+minecraft_version=1.21.1
+minecraft_version_range=(1.21,1.21.1]
+neo_version=21.1.117
+neo_version_range=[21.0.0,)
+loader_version_range=[1,)
+
+## Mod Properties
+mod_id=red_envelope
+mod_name=Red Envelope
+mod_license=Camellia License
+mod_version=1.0.0
+
+mod_group_id=org.hiedacamellia
+mod_authors=HiedaCamellia, Houraisan Kaguya
+mod_description=A mod allows you to send red envelopes (also hongbao) to other players.
--- a/gradle/wrapper/gradle-wrapper.jar
+++ b/gradle/wrapper/gradle-wrapper.jar
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.12-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
--- a/252
+++ b/252
@ -0,0 +1,252 @@
+#!/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.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+#   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 -P "${APP_HOME:-./}" > /dev/null && printf '%s
+' "$PWD" ) || 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" "$@"
--- a/gradlew.bat
+++ b/gradlew.bat
@ -0,0 +1,94 @@
+@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
+@rem SPDX-License-Identifier: Apache-2.0
+@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
--- a/settings.gradle
+++ b/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.9.0'
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/RedEnvelope.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/RedEnvelope.java
@ -0,0 +1,29 @@
+package org.hiedacamellia.redenvelope;
+
+import com.mojang.logging.LogUtils;
+import net.minecraft.resources.ResourceLocation;
+import net.neoforged.bus.api.IEventBus;
+import net.neoforged.fml.ModContainer;
+import net.neoforged.fml.common.Mod;
+import net.neoforged.fml.config.ModConfig;
+import org.hiedacamellia.redenvelope.core.config.ServerConfig;
+import org.hiedacamellia.redenvelope.registries.REAttachment;
+import org.slf4j.Logger;
+
+@Mod(RedEnvelope.MODID)
+public class RedEnvelope
+{
+    public static final String MODID = "red_envelope";
+    public static final Logger LOGGER = LogUtils.getLogger();
+
+    public RedEnvelope(IEventBus modEventBus, ModContainer modContainer)
+    {
+        REAttachment.register(modEventBus);
+        modContainer.registerConfig(ModConfig.Type.COMMON, ServerConfig.SPEC);
+    }
+
+    public static ResourceLocation rl(String path)
+    {
+        return ResourceLocation.fromNamespaceAndPath(MODID, path);
+    }
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/command/CommandExecutes.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/command/CommandExecutes.java
@ -0,0 +1,135 @@
+package org.hiedacamellia.redenvelope.core.command;
+
+import com.mojang.brigadier.arguments.IntegerArgumentType;
+import com.mojang.brigadier.arguments.StringArgumentType;
+import com.mojang.brigadier.context.CommandContext;
+import net.minecraft.commands.CommandSourceStack;
+import net.minecraft.network.chat.Component;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.item.ItemStack;
+import net.neoforged.neoforge.network.PacketDistributor;
+import org.hiedacamellia.redenvelope.RedEnvelope;
+import org.hiedacamellia.redenvelope.core.network.OpenRedEnvelopePacket;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopePacket;
+import org.hiedacamellia.redenvelope.core.util.REUtil;
+import org.hiedacamellia.redenvelope.registries.REAttachment;
+
+import java.util.Map;
+import java.util.UUID;
+
+public class CommandExecutes {
+
+    public static int sendLuckWithItemCount(CommandContext<CommandSourceStack> context) {
+        int itemcount = IntegerArgumentType.getInteger(context, "itemcount");
+        return sendLuck(context,itemcount);
+    }
+    public static int sendLuckWithoutItemCount(CommandContext<CommandSourceStack> context) {
+        return sendLuck(context,-1);
+    }
+    public static int sendLuck(CommandContext<CommandSourceStack> context,int itemcount) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        ItemStack mainHandItem = player.getMainHandItem();
+        if(mainHandItem.isEmpty()) return 0;
+        int count = IntegerArgumentType.getInteger(context, "count");
+        if(mainHandItem.getCount()< itemcount && itemcount!=-1) return 0;
+        ItemStack copy = mainHandItem.copy();
+        if(itemcount != -1)
+            copy.setCount(itemcount);
+        else
+            itemcount = copy.getCount();
+
+        RedEnvelopePacket luck = REUtil.create(player, copy, "luck", count);
+        RedEnvelope.LOGGER.debug("send luck packet");
+        RedEnvelopePacket._handleServer(luck,player);
+        mainHandItem.shrink(itemcount);
+        return 1;
+    }
+
+    public static int sendSpellWithItemCount(CommandContext<CommandSourceStack> context) {
+        int itemcount = IntegerArgumentType.getInteger(context, "itemcount");
+        return sendSpell(context,itemcount);
+    }
+    public static int sendSpellWithoutItemCount(CommandContext<CommandSourceStack> context) {
+        return sendSpell(context,-1);
+    }
+    public static int sendSpell(CommandContext<CommandSourceStack> context,int itemcount) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        ItemStack mainHandItem = player.getMainHandItem();
+        if(mainHandItem.isEmpty()) return 0;
+        int count = IntegerArgumentType.getInteger(context, "count");
+        if(mainHandItem.getCount()< itemcount && itemcount!=-1) return 0;
+        ItemStack copy = mainHandItem.copy();
+        if(itemcount != -1)
+            copy.setCount(itemcount);
+
+        RedEnvelopePacket spell = REUtil.create(player, copy, "spell", count);
+        spell.extraData().putString("spell",StringArgumentType.getString(context, "words"));
+        RedEnvelope.LOGGER.debug("send spell packet");
+        RedEnvelopePacket._handleServer(spell,player);
+        mainHandItem.shrink(itemcount);
+        return 1;
+    }
+
+    public static int sendCommon(CommandContext<CommandSourceStack> context) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        ItemStack mainHandItem = player.getMainHandItem();
+        if(mainHandItem.isEmpty()) return 0;
+        int count = IntegerArgumentType.getInteger(context, "count");
+        int single = IntegerArgumentType.getInteger(context, "single");
+        if(mainHandItem.getCount()< single*count) {
+            player.sendSystemMessage(Component.translatable("chat.red_envelope.notenough"));
+            return 0;
+        }
+        ItemStack copy = mainHandItem.copy();
+        copy.setCount(single);
+        RedEnvelopePacket common = REUtil.create(player, copy, "common", count);
+        common.extraData().putInt("single",single);
+        RedEnvelope.LOGGER.debug("send common packet");
+        RedEnvelopePacket._handleServer(common,player);
+        mainHandItem.shrink(single*count);
+        return 1;
+    }
+
+    public static int open(CommandContext<CommandSourceStack> context) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        String uuid = StringArgumentType.getString(context, "uuid");
+        OpenRedEnvelopePacket._handleServer(new OpenRedEnvelopePacket(UUID.fromString(uuid)),player);
+        return 1;
+    }
+
+    public static int withdraw(CommandContext<CommandSourceStack> context) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        String uuid = StringArgumentType.getString(context, "uuid");
+        var copy = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        REUtil.withdraw(player.server,copy.get(UUID.fromString(uuid)),2);
+        return 1;
+    }
+
+    public static int queryWithUUID(CommandContext<CommandSourceStack> context) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        String uuid = StringArgumentType.getString(context, "uuid");
+        REUtil.query(player,UUID.fromString(uuid));
+        return 1;
+    }
+
+    public static int query(CommandContext<CommandSourceStack> context) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        REUtil.query(player);
+        return 1;
+    }
+
+    public static int queryList(CommandContext<CommandSourceStack> context) {
+        ServerPlayer player = context.getSource().getPlayer();
+        if(player == null) return 0;
+        REUtil.queryList(player);
+        return 1;
+    }
+
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/command/RECommand.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/command/RECommand.java
@ -0,0 +1,31 @@
+package org.hiedacamellia.redenvelope.core.command;
+
+import com.mojang.brigadier.arguments.IntegerArgumentType;
+import com.mojang.brigadier.arguments.StringArgumentType;
+import net.minecraft.commands.Commands;
+import net.neoforged.bus.api.SubscribeEvent;
+import net.neoforged.fml.common.EventBusSubscriber;
+import net.neoforged.neoforge.event.RegisterCommandsEvent;
+
+@EventBusSubscriber
+public class RECommand {
+
+    @SubscribeEvent
+    public static void registerCommands(RegisterCommandsEvent event) {
+        event.getDispatcher().register(
+                Commands.literal("hongbao")
+                 .then(Commands.literal("luck").then(Commands.argument("count",IntegerArgumentType.integer(1)).then(Commands.argument("itemcount",IntegerArgumentType.integer(1)).executes(CommandExecutes::sendLuckWithItemCount)).executes(CommandExecutes::sendLuckWithoutItemCount))
+                ).then(Commands.literal("common").then(Commands.argument("count",IntegerArgumentType.integer(1)).then(Commands.argument("single",IntegerArgumentType.integer(1)).executes(CommandExecutes::sendCommon)))
+                ).then(Commands.literal("spell").then(Commands.argument("count",IntegerArgumentType.integer(1))
+                                .then(Commands.argument("itemcount",IntegerArgumentType.integer(1))
+                                        .then(Commands.argument("words",StringArgumentType.greedyString())
+                                                .executes(CommandExecutes::sendSpellWithItemCount)))
+                                .then(Commands.argument("words",StringArgumentType.greedyString())
+                                        .executes(CommandExecutes::sendSpellWithoutItemCount)))
+                ).then(Commands.literal("open").then(Commands.argument("uuid", StringArgumentType.string()).executes(CommandExecutes::open))
+                ).then(Commands.literal("withdraw").then(Commands.argument("uuid", StringArgumentType.string()).executes(CommandExecutes::withdraw))
+                ).then(Commands.literal("query").then(Commands.argument("uuid", StringArgumentType.string()).executes(CommandExecutes::queryWithUUID)).then(Commands.argument("all", StringArgumentType.string()).executes(CommandExecutes::queryWithUUID)).executes(CommandExecutes::queryList)
+                )
+        );
+    }
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/config/ServerConfig.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/config/ServerConfig.java
@ -0,0 +1,16 @@
+package org.hiedacamellia.redenvelope.core.config;
+
+import net.neoforged.neoforge.common.ModConfigSpec;
+
+
+public class ServerConfig
+{
+    private static final ModConfigSpec.Builder BUILDER = new ModConfigSpec.Builder();
+
+    public static final ModConfigSpec.IntValue TTL = BUILDER.comment("The time to live of the red envelope")
+            .comment("\u7ea2\u5305\u7684\u5b58\u6d3b\u65f6\u95f4")
+            .defineInRange("ttl", 1200, 1, 24000);
+
+    public static final ModConfigSpec SPEC = BUILDER.build();
+
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/event/REPlayerEvent.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/event/REPlayerEvent.java
@ -0,0 +1,73 @@
+package org.hiedacamellia.redenvelope.core.event;
+
+
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.entity.player.Player;
+import net.neoforged.bus.api.SubscribeEvent;
+import net.neoforged.fml.common.EventBusSubscriber;
+import net.neoforged.neoforge.event.ServerChatEvent;
+import net.neoforged.neoforge.event.entity.player.PlayerEvent;
+import net.neoforged.neoforge.event.tick.PlayerTickEvent;
+import net.neoforged.neoforge.network.PacketDistributor;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopePacket;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopeStorage;
+import org.hiedacamellia.redenvelope.core.util.REUtil;
+import org.hiedacamellia.redenvelope.registries.REAttachment;
+
+import java.util.Map;
+import java.util.UUID;
+
+@EventBusSubscriber
+public class REPlayerEvent {
+
+    @SubscribeEvent
+    public static void onPlayerJoin(PlayerEvent.PlayerLoggedInEvent event){
+        Player player = event.getEntity();
+        if(player instanceof ServerPlayer serverPlayer)
+            PacketDistributor.sendToPlayer(serverPlayer,new RedEnvelopeStorage(serverPlayer.getData(REAttachment.HONGBAO_STORAGE).copy()));
+    }
+
+    @SubscribeEvent
+    public static void onPlayerExit(PlayerEvent.PlayerLoggedOutEvent event){
+        Player player = event.getEntity();
+        if(player instanceof ServerPlayer serverPlayer) {
+            serverPlayer.getData(REAttachment.HONGBAO_STORAGE).copy().values().forEach(
+                    redEnvelopePacket -> {
+                        if(redEnvelopePacket.extraData().getUUID("from")==serverPlayer.getUUID())
+                            REUtil.withdraw(serverPlayer.server,redEnvelopePacket,3);
+                    }
+            );
+        }
+    }
+
+    @SubscribeEvent
+    public static void onPlayerTick(PlayerTickEvent.Post event){
+        Player player = event.getEntity();
+        if(player instanceof ServerPlayer serverPlayer){
+            long gameTime = serverPlayer.level().getGameTime();
+            if(gameTime % 100 ==0){
+                var map = serverPlayer.getData(REAttachment.HONGBAO_STORAGE).copy();
+                map.values().forEach(hongBaoPacket -> {
+                    if(hongBaoPacket.extraData().getLong("time") + 10 < System.currentTimeMillis()/1000){
+                        REUtil.withdraw(serverPlayer.server,hongBaoPacket,1);
+                    }
+                });
+            }
+        }
+    }
+
+    @SubscribeEvent
+    public static void onPlayerChat(ServerChatEvent event){
+        ServerPlayer player = event.getPlayer();
+        String string = event.getMessage().getString();
+        player.getData(REAttachment.HONGBAO_STORAGE).copy().values().forEach(
+                redEnvelopePacket -> {
+                    if(!redEnvelopePacket.hbtype().equals("spell")) return;
+                    if(redEnvelopePacket.extraData().getString("spell").equals(string)){
+                        REUtil.open(player,redEnvelopePacket.uuid());
+                    }
+                }
+        );
+    }
+
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/network/OpenRedEnvelopePacket.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/network/OpenRedEnvelopePacket.java
@ -0,0 +1,46 @@
+package org.hiedacamellia.redenvelope.core.network;
+
+import com.mojang.serialization.Codec;
+import com.mojang.serialization.codecs.RecordCodecBuilder;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.server.level.ServerPlayer;
+import net.neoforged.neoforge.network.handling.IPayloadContext;
+import org.hiedacamellia.redenvelope.RedEnvelope;
+import org.hiedacamellia.redenvelope.core.util.REUtil;
+
+import java.util.UUID;
+
+public record OpenRedEnvelopePacket(UUID uuid) implements CustomPacketPayload {
+
+    public static final Codec<OpenRedEnvelopePacket> CODEC = RecordCodecBuilder.create(
+            instance -> instance.group(
+                    REUtil.UUID_CODEC.fieldOf("uuid").forGetter(OpenRedEnvelopePacket::uuid)
+            ).apply(instance, OpenRedEnvelopePacket::new)
+    );
+
+    public static final StreamCodec<RegistryFriendlyByteBuf, OpenRedEnvelopePacket> STREAM_CODEC = StreamCodec.composite(
+            ByteBufCodecs.fromCodec(REUtil.UUID_CODEC), OpenRedEnvelopePacket::uuid,
+            OpenRedEnvelopePacket::new
+    );
+
+    public static final Type<OpenRedEnvelopePacket> TYPE = new CustomPacketPayload.Type<>(RedEnvelope.rl("open_hong_bao"));
+
+    public static void handleServer(OpenRedEnvelopePacket message, IPayloadContext context) {
+        context.enqueueWork(
+                () -> {
+                    if(context.player() instanceof ServerPlayer serverPlayer) _handleServer(message, serverPlayer);
+                }
+        );
+    }
+    public static void _handleServer(OpenRedEnvelopePacket message, ServerPlayer serverPlayer) {
+        REUtil.open(serverPlayer,message.uuid());
+    }
+
+    @Override
+    public Type<? extends CustomPacketPayload> type() {
+        return TYPE;
+    }
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/network/RedEnvelopePacket.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/network/RedEnvelopePacket.java
@ -0,0 +1,81 @@
+package org.hiedacamellia.redenvelope.core.network;
+
+import com.mojang.serialization.Codec;
+import com.mojang.serialization.MapCodec;
+import com.mojang.serialization.codecs.RecordCodecBuilder;
+import net.minecraft.nbt.CompoundTag;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.server.players.PlayerList;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.ItemStack;
+import net.neoforged.neoforge.network.PacketDistributor;
+import net.neoforged.neoforge.network.handling.IPayloadContext;
+import org.hiedacamellia.redenvelope.RedEnvelope;
+import org.hiedacamellia.redenvelope.core.util.REUtil;
+
+import java.util.List;
+import java.util.UUID;
+
+public record RedEnvelopePacket(ItemStack itemStack, String hbtype, int count, UUID uuid , CompoundTag extraData) implements CustomPacketPayload {
+
+    public RedEnvelopePacket copy(){
+        return new RedEnvelopePacket(itemStack.copy(),hbtype,count,uuid,extraData.copy());
+    }
+
+    public static final Codec<RedEnvelopePacket> CODEC = RecordCodecBuilder.create(
+            instance -> instance.group(
+                    ItemStack.CODEC.fieldOf("itemStack").forGetter(RedEnvelopePacket::itemStack),
+                    Codec.STRING.fieldOf("type").forGetter(RedEnvelopePacket::hbtype),
+                    Codec.INT.fieldOf("count").forGetter(RedEnvelopePacket::count),
+                    REUtil.UUID_CODEC.fieldOf("uuid").forGetter(RedEnvelopePacket::uuid),
+                    CompoundTag.CODEC.fieldOf("extraData").forGetter(RedEnvelopePacket::extraData)
+            ).apply(instance, RedEnvelopePacket::new)
+    );
+    public static final MapCodec<RedEnvelopePacket> MAP_CODEC = MapCodec.assumeMapUnsafe(CODEC);
+
+    public static final StreamCodec<RegistryFriendlyByteBuf, RedEnvelopePacket> STREAM_CODEC = StreamCodec.composite(
+            ItemStack.STREAM_CODEC, RedEnvelopePacket::itemStack,
+            ByteBufCodecs.STRING_UTF8, RedEnvelopePacket::hbtype,
+            ByteBufCodecs.INT, RedEnvelopePacket::count,
+            ByteBufCodecs.fromCodec(REUtil.UUID_CODEC), RedEnvelopePacket::uuid,
+            ByteBufCodecs.fromCodec(CompoundTag.CODEC), RedEnvelopePacket::extraData,
+            RedEnvelopePacket::new
+    );
+
+    public static final Type<RedEnvelopePacket> TYPE = new CustomPacketPayload.Type<>(RedEnvelope.rl("hong_bao"));
+
+    @Override
+    public Type<? extends CustomPacketPayload> type() {
+        return TYPE;
+    }
+
+    public static void handleServer(RedEnvelopePacket message, IPayloadContext context) {
+        context.enqueueWork(
+                () -> {
+                    if(context.player() instanceof ServerPlayer serverPlayer)_handleServer(message, serverPlayer);
+                }
+        );
+    }
+    public static void _handleServer(RedEnvelopePacket message, ServerPlayer player) {
+        MinecraftServer server = player.level().getServer();
+        PlayerList playerList = server.getPlayerList();
+        List<ServerPlayer> players = playerList.getPlayers();
+        players.forEach(serverPlayer -> RedEnvelopeStorage.add(serverPlayer,message.copy()));
+        players.forEach(serverPlayer -> REUtil.receiveMessage(serverPlayer,message.copy()));
+        if(server.isDedicatedServer())
+            PacketDistributor.sendToAllPlayers(message);
+    }
+    public static void handleClient(RedEnvelopePacket message, IPayloadContext context) {
+        context.enqueueWork(
+                () -> {
+                    Player player = context.player();
+                    RedEnvelopeStorage.add(player,message.copy());
+                }
+        );
+    }
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/network/RedEnvelopeStorage.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/network/RedEnvelopeStorage.java
@ -0,0 +1,94 @@
+package org.hiedacamellia.redenvelope.core.network;
+
+import com.google.common.collect.Maps;
+import com.mojang.datafixers.util.Pair;
+import com.mojang.serialization.Codec;
+import com.mojang.serialization.MapCodec;
+import com.mojang.serialization.codecs.RecordCodecBuilder;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.codec.ByteBufCodecs;
+import net.minecraft.network.codec.StreamCodec;
+import net.minecraft.network.protocol.common.custom.CustomPacketPayload;
+import net.minecraft.world.entity.player.Player;
+import net.neoforged.neoforge.network.handling.IPayloadContext;
+import org.hiedacamellia.redenvelope.RedEnvelope;
+import org.hiedacamellia.redenvelope.core.util.REUtil;
+import org.hiedacamellia.redenvelope.registries.REAttachment;
+
+import java.util.*;
+
+public record RedEnvelopeStorage(Pair<List<UUID>, List<RedEnvelopePacket>> map) implements CustomPacketPayload {
+
+    public RedEnvelopeStorage copy() {
+        return new RedEnvelopeStorage(new Pair<>(new ArrayList<>(map.getFirst()),new ArrayList<>(map.getSecond())));
+    }
+
+    public RedEnvelopeStorage(RedEnvelopeStorage storage){
+        this(storage.copy().map());
+    }
+
+    public static final Codec<RedEnvelopeStorage> CODEC = RecordCodecBuilder.create(
+            instance -> instance.group(
+                    Codec.pair(Codec.list(REUtil.UUID_CODEC),Codec.list(RedEnvelopePacket.CODEC)).fieldOf("map").forGetter(RedEnvelopeStorage::map)
+            ).apply(instance, RedEnvelopeStorage::new)
+    );
+
+    public static final StreamCodec<RegistryFriendlyByteBuf, RedEnvelopeStorage> STREAM_CODEC = StreamCodec.composite(
+            ByteBufCodecs.fromCodec(Codec.pair(Codec.list(REUtil.UUID_CODEC),Codec.list(RedEnvelopePacket.CODEC)))
+            , RedEnvelopeStorage::map, RedEnvelopeStorage::new
+    );
+
+    public static final Type<RedEnvelopeStorage> TYPE = new CustomPacketPayload.Type<>(RedEnvelope.rl("hong_bao_storage"));
+
+    public static void handleClient(RedEnvelopeStorage message, IPayloadContext context) {
+        context.enqueueWork(
+                () -> {
+                    Player player = context.player();
+                    player.setData(REAttachment.HONGBAO_STORAGE, new RedEnvelopeStorage(message.map()));
+                }
+        );
+    }
+
+    @Override
+    public Type<? extends CustomPacketPayload> type() {
+        return TYPE;
+    }
+
+    public static void add(Player player, RedEnvelopePacket packet){
+        var data = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        data.put(packet.uuid(),packet);
+        player.setData(REAttachment.HONGBAO_STORAGE,new RedEnvelopeStorage(data));
+    }
+
+    public void put(UUID uuid, RedEnvelopePacket packet){
+        map.getFirst().add(uuid);
+        map.getSecond().add(packet);
+    }
+
+    public void remove(UUID uuid){
+        int index = map.getFirst().indexOf(uuid);
+        if(index==-1) return;
+        map.getFirst().remove(index);
+        map.getSecond().remove(index);
+    }
+
+    public RedEnvelopePacket get(UUID uuid){
+        int index = map.getFirst().indexOf(uuid);
+        if(index==-1) return null;
+        return map.getSecond().get(index);
+    }
+
+    public void replace(UUID uuid, RedEnvelopePacket packet){
+        int index = map.getFirst().indexOf(uuid);
+        if(index==-1) return;
+        map.getSecond().set(index,packet);
+    }
+
+    public List<RedEnvelopePacket> values(){
+        return map.getSecond();
+    }
+
+    public List<UUID> keys(){
+        return map.getFirst();
+    }
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/core/util/REUtil.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/core/util/REUtil.java
@ -0,0 +1,231 @@
+package org.hiedacamellia.redenvelope.core.util;
+
+import com.mojang.serialization.Codec;
+import com.mojang.serialization.MapCodec;
+import com.mojang.serialization.codecs.RecordCodecBuilder;
+import net.minecraft.ChatFormatting;
+import net.minecraft.nbt.CompoundTag;
+import net.minecraft.network.chat.ClickEvent;
+import net.minecraft.network.chat.Component;
+import net.minecraft.network.chat.MutableComponent;
+import net.minecraft.network.chat.Style;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.util.RandomSource;
+import net.minecraft.world.entity.player.Player;
+import net.minecraft.world.item.ItemStack;
+import org.hiedacamellia.redenvelope.RedEnvelope;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopePacket;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopeStorage;
+import org.hiedacamellia.redenvelope.registries.REAttachment;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+import java.util.Objects;
+import java.util.UUID;
+
+public class REUtil {
+
+    public static final Codec<UUID> UUID_CODEC = RecordCodecBuilder.create(
+            instance -> instance.group(
+                    Codec.LONG.fieldOf("most").forGetter(UUID::getMostSignificantBits),
+                    Codec.LONG.fieldOf("least").forGetter(UUID::getLeastSignificantBits)
+            ).apply(instance, UUID::new)
+    );
+    public static final MapCodec<UUID> UUID_MAP_CODEC = MapCodec.assumeMapUnsafe(UUID_CODEC);
+
+    public static RedEnvelopePacket create(ServerPlayer player, ItemStack itemStack, String hbtype, int count) {
+        CompoundTag compoundTag = new CompoundTag();
+        compoundTag.putUUID("from", player.getUUID());
+        compoundTag.putBoolean("opened", false);
+        compoundTag.putLong("time", (System.currentTimeMillis() / 1000));
+        return new RedEnvelopePacket(itemStack, hbtype, count, UUID.randomUUID(), compoundTag);
+    }
+
+
+    public static void receiveMessage(Player player, RedEnvelopePacket packet) {
+        CompoundTag compoundTag = packet.extraData();
+        UUID from = compoundTag.getUUID("from");
+        Component fromDisplayName = player.level().getServer().getPlayerList().getPlayer(from).getDisplayName();
+        MutableComponent component = Component.translatable("chat.red_envelope.receive." + packet.hbtype(), fromDisplayName);
+        if(!packet.hbtype().equals("spell"))
+            component.append(Component.translatable("chat.red_envelope.open")
+                    .withStyle(Style.EMPTY.withClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/hongbao open " + packet.uuid())).withUnderlined(true))
+                    .withStyle(ChatFormatting.GREEN));
+        else
+            component.append(Component.literal("[").append(packet.extraData().getString("spell")).append("]").withStyle(ChatFormatting.LIGHT_PURPLE))
+                    .append(Component.translatable("chat.red_envelope.send")
+                    .withStyle(Style.EMPTY.withClickEvent(new ClickEvent(ClickEvent.Action.SUGGEST_COMMAND, packet.extraData().getString("spell"))).withUnderlined(true))
+                    .withStyle(ChatFormatting.GREEN));
+
+        player.sendSystemMessage(component);
+        RedEnvelope.LOGGER.debug("receive red envelope");
+    }
+
+    public static void open(ServerPlayer player, UUID uuid) {
+        var data = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        RedEnvelopePacket redEnvelopePacket = data.get(uuid);
+        if (redEnvelopePacket == null) {
+            return;
+        }
+        if (redEnvelopePacket.extraData().getBoolean("opened")) {
+            player.sendSystemMessage(Component.translatable("chat.red_envelope.opened.done"));
+            return;
+        }
+        CompoundTag compoundTag = redEnvelopePacket.extraData();
+        UUID from = compoundTag.getUUID("from");
+        ServerPlayer serverPlayer = player.level().getServer().getPlayerList().getPlayer(from);
+        var map = serverPlayer.getData(REAttachment.HONGBAO_STORAGE).copy();
+        RedEnvelopePacket real = map.get(uuid);
+        RedEnvelopePacket left = open(player, real);
+        if (left != null) {
+            if (left.count() >= 1) {
+                map.replace(uuid, left);
+            } else {
+                map.remove(uuid);
+            }
+        } else {
+            destroy(player.server, uuid);
+        }
+        if (left != null)
+            if (serverPlayer.getUUID() != player.getUUID()) {
+                player.setData(REAttachment.HONGBAO_STORAGE, new RedEnvelopeStorage(data));
+                left.extraData().putBoolean("opened", true);
+                data.replace(uuid, left);
+            } else {
+                left.extraData().putBoolean("opened", true);
+                map.replace(uuid, left);
+            }
+        serverPlayer.setData(REAttachment.HONGBAO_STORAGE, new RedEnvelopeStorage(map));
+    }
+
+    public static void query(ServerPlayer player) {
+        var copy = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        copy.keys().forEach(uuid -> query(player, uuid));
+    }
+
+    public static void queryList(ServerPlayer player) {
+        var copy = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        copy.keys().forEach(uuid -> {
+            player.sendSystemMessage(Component.literal(uuid.toString()).append(
+                    Component.translatable("chat.red_envelope.action.query")
+                            .withStyle(Style.EMPTY.withClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/hongbao query " + uuid)).withUnderlined(true))
+            ));
+        });
+    }
+
+
+    public static void query(ServerPlayer player, UUID uuid) {
+
+        RedEnvelope.LOGGER.debug("query red_envelope " + uuid);
+
+        var data = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        RedEnvelopePacket redEnvelopePacket = data.get(uuid);
+        if (redEnvelopePacket == null) {
+            RedEnvelope.LOGGER.debug("red_envelope not found");
+            return;
+        }
+        CompoundTag compoundTag = redEnvelopePacket.extraData();
+        UUID from = compoundTag.getUUID("from");
+        boolean opened = compoundTag.getBoolean("opened");
+        ServerPlayer serverPlayer = player.level().getServer().getPlayerList().getPlayer(from);
+        var map = serverPlayer.getData(REAttachment.HONGBAO_STORAGE).copy();
+        RedEnvelopePacket real = map.get(uuid);
+        MutableComponent component = Component.translatable("chat.red_envelope.query." + real.hbtype());
+
+        MutableComponent returned = Component.empty();
+        ItemStack itemStack = real.itemStack();
+        returned.append(String.valueOf(itemStack.getCount())).append("x ").append(itemStack.getDisplayName());
+
+        component.append(Component.translatable("chat.red_envelope.query.from", serverPlayer.getDisplayName(), real.count(), returned).append(" "));
+        if (opened)
+            component.append(Component.translatable("chat.red_envelope.query.opened")
+                    .withStyle(ChatFormatting.AQUA));
+        else
+            component.append(Component.translatable("chat.red_envelope.query.unopened")
+                    .withStyle(Style.EMPTY.withClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/hongbao open " + real.uuid())).withUnderlined(true))
+                    .withStyle(ChatFormatting.GREEN));
+
+        if (player.getUUID() == serverPlayer.getUUID())
+            component.append(Component.translatable("chat.red_envelope.action.withdraw")
+                    .withStyle(Style.EMPTY.withClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/hongbao withdraw " + uuid)).withUnderlined(true)
+                    ));
+
+
+        player.sendSystemMessage(component);
+    }
+
+    public static void destroy(ServerPlayer player, UUID uuid) {
+        var data = player.getData(REAttachment.HONGBAO_STORAGE).copy();
+        data.remove(uuid);
+        player.setData(REAttachment.HONGBAO_STORAGE, new RedEnvelopeStorage(data));
+    }
+
+    public static void destroy(MinecraftServer server, UUID uuid) {
+        server.getPlayerList().getPlayers().forEach(player -> destroy(player, uuid));
+    }
+
+    public static void withdraw(MinecraftServer server, RedEnvelopePacket packet, int type) {
+        CompoundTag compoundTag = packet.extraData();
+        UUID from = compoundTag.getUUID("from");
+        ServerPlayer serverPlayer = server.getPlayerList().getPlayer(from);
+        var map = serverPlayer.getData(REAttachment.HONGBAO_STORAGE).copy();
+        RedEnvelopePacket real = map.get(packet.uuid());
+        MutableComponent returned = Component.empty();
+        ItemStack itemStack = real.itemStack();
+        if(Objects.equals(real.hbtype(), "common")){
+            itemStack.setCount(real.count()*real.extraData().getInt("single"));
+        }
+        serverPlayer.addItem(itemStack.copy());
+        returned.append(String.valueOf(itemStack.getCount())).append("x ").append(itemStack.getDisplayName());
+        switch (type) {
+            case 1:
+                serverPlayer.sendSystemMessage(Component.translatable("chat.red_envelope.returned", returned));
+                break;
+            case 2:
+                serverPlayer.sendSystemMessage(Component.translatable("chat.red_envelope.withdraw", returned));
+                break;
+            case 3:
+                break;
+        }
+        destroy(server, real.uuid());
+    }
+
+    @Nullable
+    private static RedEnvelopePacket open(ServerPlayer player, RedEnvelopePacket packet) {
+        String hbtype = packet.hbtype();
+        RedEnvelopePacket left = packet;
+        MutableComponent got = Component.empty();
+        if (hbtype.equals("luck")||hbtype.equals("spell")) {
+            int count = packet.count();
+            if (count == 1) {
+                ItemStack itemStack = packet.itemStack();
+                player.addItem(itemStack.copy());
+                left = null;
+                got.append(String.valueOf(itemStack.getCount())).append("x ").append(itemStack.getDisplayName());
+            } else {
+                ItemStack itemStack = packet.itemStack();
+                int itemStackCount = itemStack.getCount();
+                RandomSource random = player.level().getRandom();
+                int i = random.nextIntBetweenInclusive(1, itemStackCount - count);
+                ItemStack copy = itemStack.copy();
+                copy.setCount(i);
+                itemStack.shrink(i);
+                player.addItem(copy);
+                left = new RedEnvelopePacket(itemStack, hbtype, count - 1, packet.uuid(), packet.extraData());
+                got.append(String.valueOf(i)).append("x ").append(itemStack.getDisplayName());
+            }
+        }
+        if (hbtype.equals("common")) {
+            int count = packet.count();
+            int single = packet.extraData().getInt("single");
+            ItemStack itemStack = packet.itemStack();
+            ItemStack copy = itemStack.copy();
+            player.addItem(copy);
+            left = new RedEnvelopePacket(itemStack, hbtype, count - 1, packet.uuid(), packet.extraData());
+            got.append(String.valueOf(single)).append("x ").append(itemStack.getDisplayName());
+        }
+        player.sendSystemMessage(Component.translatable("chat.red_envelope.opened." + packet.hbtype(), got));
+        return left;
+    }
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/registries/REAttachment.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/registries/REAttachment.java
@ -0,0 +1,29 @@
+package org.hiedacamellia.redenvelope.registries;
+
+import com.mojang.datafixers.util.Pair;
+import net.neoforged.bus.api.IEventBus;
+import net.neoforged.neoforge.attachment.AttachmentType;
+import net.neoforged.neoforge.registries.DeferredRegister;
+import net.neoforged.neoforge.registries.NeoForgeRegistries;
+import org.hiedacamellia.redenvelope.RedEnvelope;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopeStorage;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.function.Supplier;
+
+public class REAttachment {
+
+
+    protected static final DeferredRegister<AttachmentType<?>> ATTACHMENTS = DeferredRegister.create(NeoForgeRegistries.ATTACHMENT_TYPES, RedEnvelope.MODID);
+
+    public static final Supplier<AttachmentType<RedEnvelopeStorage>> HONGBAO_STORAGE = ATTACHMENTS.register(
+            "currency_storage", () -> AttachmentType.builder(()->new RedEnvelopeStorage(new Pair<>(new ArrayList<>(),new ArrayList<>()))).serialize(RedEnvelopeStorage.CODEC).copyOnDeath().build()
+    );
+
+    public static void register(IEventBus modEventBus) {
+        ATTACHMENTS.register(modEventBus);
+    }
+
+}
--- a/src/main/java/org/hiedacamellia/redenvelope/registries/REPayload.java
+++ b/src/main/java/org/hiedacamellia/redenvelope/registries/REPayload.java
@ -0,0 +1,36 @@
+package org.hiedacamellia.redenvelope.registries;
+
+import net.neoforged.bus.api.SubscribeEvent;
+import net.neoforged.fml.common.EventBusSubscriber;
+import net.neoforged.neoforge.network.event.RegisterPayloadHandlersEvent;
+import net.neoforged.neoforge.network.handling.DirectionalPayloadHandler;
+import net.neoforged.neoforge.network.registration.PayloadRegistrar;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopePacket;
+import org.hiedacamellia.redenvelope.core.network.RedEnvelopeStorage;
+import org.hiedacamellia.redenvelope.core.network.OpenRedEnvelopePacket;
+
+@EventBusSubscriber(bus = EventBusSubscriber.Bus.MOD)
+public class REPayload {
+    @SubscribeEvent
+    public static void register(final RegisterPayloadHandlersEvent event) {
+        final PayloadRegistrar registrar = event.registrar("1.0.0");
+        registrar.playBidirectional(
+                RedEnvelopePacket.TYPE,
+                RedEnvelopePacket.STREAM_CODEC,
+                new DirectionalPayloadHandler<>(
+                        RedEnvelopePacket::handleServer,
+                        RedEnvelopePacket::handleClient
+                )
+        );
+        registrar.playToClient(
+                RedEnvelopeStorage.TYPE,
+                RedEnvelopeStorage.STREAM_CODEC,
+                RedEnvelopeStorage::handleClient
+        );
+        registrar.playToServer(
+                OpenRedEnvelopePacket.TYPE,
+                OpenRedEnvelopePacket.STREAM_CODEC,
+                OpenRedEnvelopePacket::handleServer
+        );
+    }
+}
--- a/src/main/resources/assets/hongbao/lang/en_us.json
+++ b/src/main/resources/assets/hongbao/lang/en_us.json
@ -0,0 +1,25 @@
+{
+  "chat.red_envelope.action.query" : "Query",
+  "chat.red_envelope.action.withdraw" : "Withdraw",
+  "chat.red_envelope.receive" : "Received a red envelope from %s",
+  "chat.red_envelope.receive.luck" : "Received a luck red envelope from %s",
+  "chat.red_envelope.receive.common" : "Received a common red envelope from %s",
+  "chat.red_envelope.receive.spell" : "Received a spell red envelope from %s",
+  "chat.red_envelope.returned" : "The red envelope has been returned with %s",
+  "chat.red_envelope.withdraw" : "The red envelope has been withdrawn with %s",
+  "chat.red_envelope.open" : "Click to open",
+  "chat.red_envelope.opened" : "Opened a red envelope and got %s",
+  "chat.red_envelope.opened.done" : "Already opened this red envelope",
+  "chat.red_envelope.opened.luck" : "Opened a luck red envelope and got %s",
+  "chat.red_envelope.opened.common" : "Opened a common red envelope and got %s",
+  "chat.red_envelope.opened.spell" : "Opened a spell red envelope and got %s",
+  "chat.red_envelope.query" : "The red envelope you queried: ",
+  "chat.red_envelope.query.luck" : "The luck red envelope you queried: ",
+  "chat.red_envelope.query.common" : "The common red envelope you queried: ",
+  "chat.red_envelope.query.spell" : "The spell red envelope you queried: ",
+  "chat.red_envelope.query.from" : "From %s , envelope left: %d , content left: %s",
+  "chat.red_envelope.query.opened" : "Already opened",
+  "chat.red_envelope.query.unopened" : "Click to open",
+  "chat.red_envelope.notenough": "Not enough item in hand",
+  "chat.red_envelope.send": "Send"
+}
--- a/src/main/resources/assets/hongbao/lang/zh_cn.json
+++ b/src/main/resources/assets/hongbao/lang/zh_cn.json
@ -0,0 +1,25 @@
+{
+  "chat.red_envelope.action.query" : "查询",
+  "chat.red_envelope.action.withdraw" : "撤回",
+  "chat.red_envelope.receive" : "收到了一个来自 %s 的红包",
+  "chat.red_envelope.receive.luck" : "收到了一个来自 %s 的拼手气红包",
+  "chat.red_envelope.receive.common" : "收到了一个来自 %s 的普通红包",
+  "chat.red_envelope.receive.spell" : "收到了一个来自 %s 的口令红包",
+  "chat.red_envelope.returned" : "红包超时并返还了 %s",
+  "chat.red_envelope.withdraw" : "撤回了红包并返还了 %s",
+  "chat.red_envelope.open" : "点击领取",
+  "chat.red_envelope.opened" : "打开了红包并获得了 %s",
+  "chat.red_envelope.opened.done" : "已领取该红包",
+  "chat.red_envelope.opened.luck" : "打开了拼手气红包并获得了 %s",
+  "chat.red_envelope.opened.common": "打开了普通红包并获得了 %s",
+  "chat.red_envelope.opened.spell": "打开了口令红包并获得了 %s",
+  "chat.red_envelope.query" : "查询的红包：",
+  "chat.red_envelope.query.luck" : "查询的拼手气红包：",
+  "chat.red_envelope.query.common": "查询的普通红包：",
+  "chat.red_envelope.query.spell": "查询的口令红包：",
+  "chat.red_envelope.query.from" : "来自 %s ，剩余数量 %d ，剩余物品 %s",
+  "chat.red_envelope.query.opened" : "已领取",
+  "chat.red_envelope.query.unopened" : "点击领取",
+  "chat.red_envelope.notenough": "手中物品不足",
+  "chat.red_envelope.send": "发送"
+}
--- a/src/main/resources/icon.png
+++ b/src/main/resources/icon.png
--- a/src/main/templates/META-INF/neoforge.mods.toml
+++ b/src/main/templates/META-INF/neoforge.mods.toml
@ -0,0 +1,92 @@
+# This is an example neoforge.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 FML version. This is currently 2.
+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.neoforged.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="icon.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,)"