Skip to content

Commit aee6808

Browse files
authored
Initial commit
0 parents  commit aee6808

File tree

16 files changed

+998
-0
lines changed

16 files changed

+998
-0
lines changed

Diff for: .gitattributes

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Disable autocrlf on generated files, they always generate with LF
2+
# Add any extra files or paths here to make git stop saying they
3+
# are changed when only line endings change.
4+
src/generated/**/.cache/cache text eol=lf
5+
src/generated/**/*.json text eol=lf

Diff for: .github/workflows/build.yml

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
name: Build
2+
3+
on: [push, pull_request]
4+
5+
jobs:
6+
build:
7+
runs-on: ubuntu-latest
8+
steps:
9+
- name: Checkout repository
10+
uses: actions/checkout@v4
11+
with:
12+
fetch-depth: 0
13+
fetch-tags: true
14+
15+
- name: Setup JDK 17
16+
uses: actions/setup-java@v4
17+
with:
18+
java-version: '17'
19+
distribution: 'temurin'
20+
21+
- name: Build with Gradle
22+
uses: gradle/actions/setup-gradle@v3
23+
with:
24+
arguments: build

Diff for: .gitignore

+26
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# eclipse
2+
bin
3+
*.launch
4+
.settings
5+
.metadata
6+
.classpath
7+
.project
8+
9+
# idea
10+
out
11+
*.ipr
12+
*.iws
13+
*.iml
14+
.idea
15+
16+
# gradle
17+
build
18+
.gradle
19+
20+
# other
21+
eclipse
22+
run
23+
runs
24+
run-data
25+
26+
repo

Diff for: README.md

+25
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
2+
Installation information
3+
=======
4+
5+
This template repository can be directly cloned to get you started with a new
6+
mod. Simply create a new repository cloned from this one, by following the
7+
instructions provided by [GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template).
8+
9+
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.
10+
11+
If at any point you are missing libraries in your IDE, or you've run into problems you can
12+
run `gradlew --refresh-dependencies` to refresh the local cache. `gradlew clean` to reset everything
13+
{this does not affect your code} and then start the process again.
14+
15+
Mapping Names:
16+
============
17+
By default, the MDK is configured to use the official mapping names from Mojang for methods and fields
18+
in the Minecraft codebase. These names are covered by a specific license. All modders should be aware of this
19+
license. For the latest license text, refer to the mapping file itself, or the reference copy here:
20+
https://github.com/NeoForged/NeoForm/blob/main/Mojang.md
21+
22+
Additional Resources:
23+
==========
24+
Community Documentation: https://docs.neoforged.net/
25+
NeoForged Discord: https://discord.neoforged.net/

Diff for: TEMPLATE_LICENSE.txt

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
MIT License
2+
3+
Copyright (c) 2023 NeoForged project
4+
5+
This license applies to the template files as supplied by github.com/NeoForged/MDK
6+
7+
8+
Permission is hereby granted, free of charge, to any person obtaining a copy
9+
of this software and associated documentation files (the "Software"), to deal
10+
in the Software without restriction, including without limitation the rights
11+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12+
copies of the Software, and to permit persons to whom the Software is
13+
furnished to do so, subject to the following conditions:
14+
15+
The above copyright notice and this permission notice shall be included in all
16+
copies or substantial portions of the Software.
17+
18+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24+
SOFTWARE.

Diff for: build.gradle

+189
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,189 @@
1+
plugins {
2+
id 'java-library'
3+
id 'maven-publish'
4+
id 'net.neoforged.moddev' version '1.0.21'
5+
}
6+
7+
tasks.named('wrapper', Wrapper).configure {
8+
// Define wrapper values here so as to not have to always do so when updating gradlew.properties.
9+
// Switching this to Wrapper.DistributionType.ALL will download the full gradle sources that comes with
10+
// documentation attached on cursor hover of gradle classes and methods. However, this comes with increased
11+
// file size for Gradle. If you do switch this to ALL, run the Gradle wrapper task twice afterwards.
12+
// (Verify by checking gradle/wrapper/gradle-wrapper.properties to see if distributionUrl now points to `-all`)
13+
distributionType = Wrapper.DistributionType.BIN
14+
}
15+
16+
version = mod_version
17+
group = mod_group_id
18+
19+
repositories {
20+
mavenLocal()
21+
}
22+
23+
base {
24+
archivesName = mod_id
25+
}
26+
27+
// Mojang ships Java 21 to end users starting in 1.20.5, so mods should target Java 21.
28+
java.toolchain.languageVersion = JavaLanguageVersion.of(21)
29+
30+
neoForge {
31+
// Specify the version of NeoForge to use.
32+
version = project.neo_version
33+
34+
parchment {
35+
mappingsVersion = project.parchment_mappings_version
36+
minecraftVersion = project.parchment_minecraft_version
37+
}
38+
39+
// This line is optional. Access Transformers are automatically detected
40+
// accessTransformers = project.files('src/main/resources/META-INF/accesstransformer.cfg')
41+
42+
// Default run configurations.
43+
// These can be tweaked, removed, or duplicated as needed.
44+
runs {
45+
client {
46+
client()
47+
48+
// Comma-separated list of namespaces to load gametests from. Empty = all namespaces.
49+
systemProperty 'neoforge.enabledGameTestNamespaces', project.mod_id
50+
}
51+
52+
server {
53+
server()
54+
programArgument '--nogui'
55+
systemProperty 'neoforge.enabledGameTestNamespaces', project.mod_id
56+
}
57+
58+
// This run config launches GameTestServer and runs all registered gametests, then exits.
59+
// By default, the server will crash when no gametests are provided.
60+
// The gametest system is also enabled by default for other run configs under the /test command.
61+
gameTestServer {
62+
type = "gameTestServer"
63+
systemProperty 'neoforge.enabledGameTestNamespaces', project.mod_id
64+
}
65+
66+
data {
67+
data()
68+
69+
// example of overriding the workingDirectory set in configureEach above, uncomment if you want to use it
70+
// gameDirectory = project.file('run-data')
71+
72+
// Specify the modid for data generation, where to output the resulting resource, and where to look for existing resources.
73+
programArguments.addAll '--mod', project.mod_id, '--all', '--output', file('src/generated/resources/').getAbsolutePath(), '--existing', file('src/main/resources/').getAbsolutePath()
74+
}
75+
76+
// applies to all the run configs above
77+
configureEach {
78+
// Recommended logging data for a userdev environment
79+
// The markers can be added/remove as needed separated by commas.
80+
// "SCAN": For mods scan.
81+
// "REGISTRIES": For firing of registry events.
82+
// "REGISTRYDUMP": For getting the contents of all registries.
83+
systemProperty 'forge.logging.markers', 'REGISTRIES'
84+
85+
// Recommended logging level for the console
86+
// You can set various levels here.
87+
// Please read: https://stackoverflow.com/questions/2031163/when-to-use-the-different-log-levels
88+
logLevel = org.slf4j.event.Level.DEBUG
89+
}
90+
}
91+
92+
mods {
93+
// define mod <-> source bindings
94+
// these are used to tell the game which sources are for which mod
95+
// mostly optional in a single mod project
96+
// but multi mod projects should define one per mod
97+
"${mod_id}" {
98+
sourceSet(sourceSets.main)
99+
}
100+
}
101+
}
102+
103+
// Include resources generated by data generators.
104+
sourceSets.main.resources { srcDir 'src/generated/resources' }
105+
106+
// Sets up a dependency configuration called 'localRuntime'.
107+
// This configuration should be used instead of 'runtimeOnly' to declare
108+
// a dependency that will be present for runtime testing but that is
109+
// "optional", meaning it will not be pulled by dependents of this mod.
110+
configurations {
111+
runtimeClasspath.extendsFrom localRuntime
112+
}
113+
114+
dependencies {
115+
// Example optional mod dependency with JEI
116+
// The JEI API is declared for compile time use, while the full JEI artifact is used at runtime
117+
// compileOnly "mezz.jei:jei-${mc_version}-common-api:${jei_version}"
118+
// compileOnly "mezz.jei:jei-${mc_version}-neoforge-api:${jei_version}"
119+
// We add the full version to localRuntime, not runtimeOnly, so that we do not publish a dependency on it
120+
// localRuntime "mezz.jei:jei-${mc_version}-neoforge:${jei_version}"
121+
122+
// Example mod dependency using a mod jar from ./libs with a flat dir repository
123+
// This maps to ./libs/coolmod-${mc_version}-${coolmod_version}.jar
124+
// The group id is ignored when searching -- in this case, it is "blank"
125+
// implementation "blank:coolmod-${mc_version}:${coolmod_version}"
126+
127+
// Example mod dependency using a file as dependency
128+
// implementation files("libs/coolmod-${mc_version}-${coolmod_version}.jar")
129+
130+
// Example project dependency using a sister or child project:
131+
// implementation project(":myproject")
132+
133+
// For more info:
134+
// http://www.gradle.org/docs/current/userguide/artifact_dependencies_tutorial.html
135+
// http://www.gradle.org/docs/current/userguide/dependency_management.html
136+
}
137+
138+
// This block of code expands all declared replace properties in the specified resource targets.
139+
// A missing property will result in an error. Properties are expanded using ${} Groovy notation.
140+
var generateModMetadata = tasks.register("generateModMetadata", ProcessResources) {
141+
var replaceProperties = [
142+
minecraft_version : minecraft_version,
143+
minecraft_version_range: minecraft_version_range,
144+
neo_version : neo_version,
145+
neo_version_range : neo_version_range,
146+
loader_version_range : loader_version_range,
147+
mod_id : mod_id,
148+
mod_name : mod_name,
149+
mod_license : mod_license,
150+
mod_version : mod_version,
151+
mod_authors : mod_authors,
152+
mod_description : mod_description
153+
]
154+
inputs.properties replaceProperties
155+
expand replaceProperties
156+
from "src/main/templates"
157+
into "build/generated/sources/modMetadata"
158+
}
159+
// Include the output of "generateModMetadata" as an input directory for the build
160+
// this works with both building through Gradle and the IDE.
161+
sourceSets.main.resources.srcDir generateModMetadata
162+
// To avoid having to run "generateModMetadata" manually, make it run on every project reload
163+
neoForge.ideSyncTask generateModMetadata
164+
165+
// Example configuration to allow publishing using the maven-publish plugin
166+
publishing {
167+
publications {
168+
register('mavenJava', MavenPublication) {
169+
from components.java
170+
}
171+
}
172+
repositories {
173+
maven {
174+
url "file://${project.projectDir}/repo"
175+
}
176+
}
177+
}
178+
179+
tasks.withType(JavaCompile).configureEach {
180+
options.encoding = 'UTF-8' // Use the UTF-8 charset for Java compilation
181+
}
182+
183+
// IDEA no longer automatically downloads sources/javadoc jars for dependencies, so we need to explicitly enable the behavior.
184+
idea {
185+
module {
186+
downloadSources = true
187+
downloadJavadoc = true
188+
}
189+
}

Diff for: gradle.properties

+45
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Sets default memory used for gradle commands. Can be overridden by user or command line properties.
2+
org.gradle.jvmargs=-Xmx1G
3+
org.gradle.daemon=true
4+
org.gradle.parallel=true
5+
org.gradle.caching=true
6+
org.gradle.configuration-cache=true
7+
8+
#read more on this at https://github.com/neoforged/ModDevGradle?tab=readme-ov-file#better-minecraft-parameter-names--javadoc-parchment
9+
# you can also find the latest versions at: https://parchmentmc.org/docs/getting-started
10+
parchment_minecraft_version=1.21
11+
parchment_mappings_version=2024.11.10
12+
# Environment Properties
13+
# You can find the latest versions here: https://projects.neoforged.net/neoforged/neoforge
14+
# The Minecraft version must agree with the Neo version to get a valid artifact
15+
minecraft_version=1.21.1
16+
# The Minecraft version range can use any release version of Minecraft as bounds.
17+
# Snapshots, pre-releases, and release candidates are not guaranteed to sort properly
18+
# as they do not follow standard versioning conventions.
19+
minecraft_version_range=[1.21.1, 1.22)
20+
# The Neo version must agree with the Minecraft version to get a valid artifact
21+
neo_version=21.1.77
22+
# The Neo version range can use any version of Neo as bounds
23+
neo_version_range=[21.1.0,)
24+
# The loader version range can only use the major version of FML as bounds
25+
loader_version_range=[4,)
26+
27+
## Mod Properties
28+
29+
# The unique mod identifier for the mod. Must be lowercase in English locale. Must fit the regex [a-z][a-z0-9_]{1,63}
30+
# Must match the String constant located in the main mod class annotated with @Mod.
31+
mod_id=examplemod
32+
# The human-readable display name for the mod.
33+
mod_name=Example Mod
34+
# The license of the mod. Review your options at https://choosealicense.com/. All Rights Reserved is the default.
35+
mod_license=All Rights Reserved
36+
# The mod version. See https://semver.org/
37+
mod_version=1.0.0
38+
# The group ID for the mod. It is only important when publishing as an artifact to a Maven repository.
39+
# This should match the base package used for the mod sources.
40+
# See https://maven.apache.org/guides/mini/guide-naming-conventions.html
41+
mod_group_id=com.example.examplemod
42+
# The authors of the mod. This is a simple text string that is used for display purposes in the mod list.
43+
mod_authors=YourNameHere, OtherNameHere
44+
# The description of the mod. This is a simple multiline text string that is used for display purposes in the mod list.
45+
mod_description=Example mod description.\nNewline characters can be used and will be replaced properly.

Diff for: gradle/wrapper/gradle-wrapper.jar

42.5 KB
Binary file not shown.

Diff for: gradle/wrapper/gradle-wrapper.properties

+7
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
distributionBase=GRADLE_USER_HOME
2+
distributionPath=wrapper/dists
3+
distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip
4+
networkTimeout=10000
5+
validateDistributionUrl=true
6+
zipStoreBase=GRADLE_USER_HOME
7+
zipStorePath=wrapper/dists

0 commit comments

Comments
 (0)