BranchesTags

Repository files navigation

Mod-template (multi-loader)

Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4

Project Description

This repository now demonstrates a multi-loader layout:

mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.

Prerequisites

  • Java Development Kit (JDK) 21 or higher
  • Git

Gradle is provided via the wrapper script included in this repository.

Build & Run

Clone the repository and invoke the build for a specific loader/version:

# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT

Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement), while the build logic itself targets the appropriate bytecode level per Minecraft version.

mcmeta integration

This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:

./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin

When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.

NeoForge specifics

  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.

Updating build.main.gradle

The file build.main.gradle is vendored from the upstream uebliche/mod-template repository. To update it to the latest version, run:

curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle

Commit the refreshed file to keep the template in sync with upstream.

Customisation

Adjust shared metadata in gradle.properties. Loader-specific files live under their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.

License

This project is licensed under the Non‑Commercial MIT license. See LICENSE.md for the full license text.

Contributing

Issues and pull requests are welcome. Please discuss major changes in an issue first to ensure they align with the project's goals.

Examples

Replace this section with screenshots or usage examples if available.

About

modrinth.com/mod/mod-template

Resources

Readme
License
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
Mod-template (multi-loader)
Test 1.21.11Test 1.21.10Test 1.21.1Test 1.20.4Test 1.19.4
Project Description
This repository now demonstrates a multi-loader layout:
mod-template/
├── common/ # shared Java-only logic (no loader APIs)
├── loader-fabric/ # Fabric/Loom project, applies build.main.gradle
├── loader-neoforge/ # NeoForge project powered by ModDevGradle
├── loader-paper/ # Paper plugin (Paperweight userdev)
└── loader-velocity/ # Velocity proxy plugin

Use common for gameplay/state code, and keep loader shims thin.
Prerequisites
  • Java Development Kit (JDK) 21 or higher
  • Git
Gradle is provided via the wrapper script included in this repository.
Build & Run
Clone the repository and invoke the build for a specific loader/version:
# Fabric 1.21.1
./gradlew :loader-fabric:build -PmcVersion=1.21.1
# NeoForge 1.21.10
./gradlew :loader-neoforge:runClient -PmcVersion=1.21.10
# Paper 1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1
# Velocity (API 3.3.0-SNAPSHOT)
./gradlew :loader-velocity:build -PmcVersion=3.3.0-SNAPSHOT
Use build_all.sh (or build_all.ps1 on Windows) to iterate over every loader and Minecraft
version derived from mcmeta. The list starts at buildFromVersion in gradle.properties and
includes all newer stable releases. The scripts run Gradle on Java 21 (loom + NeoForge requirement),
while the build logic itself targets the appropriate bytecode level per Minecraft version.
mcmeta integration
This template expects the mcmeta Gradle plugin to be available so it can resolve Minecraft + loader versions (including Loom). Point mcmetaPluginPath (Gradle property) or MCMETA_PLUGIN_PATH (env var) to the mcmeta Gradle plugin directory. Example:
./gradlew :loader-fabric:build -PmcmetaPluginPath=../../tools/mcmeta-gradle/gradle-plugin
When minecraft_version is not set, mcmeta uses the latest stable release. The build expects mcmeta data to be available, so keep the plugin path configured.
NeoForge specifics
  • NeoForge builds resolve loader + API versions from mcmeta and Maven metadata based on -PmcVersion.
  • The build list is driven by buildFromVersion in gradle.properties (all newer stable releases).
  • Local dev uses ModDevGradle run tasks: ./gradlew :loader-neoforge:runClient -PmcVersion=<version> boots with the shared common code already on the classpath.
Updating build.main.gradle
The file build.main.gradle is vendored from the upstream uebliche/mod-template repository.
To update it to the latest version, run:
curl -L https://raw.githubusercontent.com/uebliche/mod-template/main/build.main.gradle -o build.main.gradle
Commit the refreshed file to keep the template in sync with upstream.
Customisation
Adjust shared metadata in gradle.properties. Loader-specific files live under
their respective subprojects (e.g. loader-fabric/src/main/resources/fabric.mod.json). Use paper_main_class / velocity_main_class in gradle.properties if you want custom plugin entry classes for the server/proxy loaders.
License
This project is licensed under the Non‑Commercial MIT license.
See LICENSE.md for the full license text.
Contributing
Issues and pull requests are welcome.
Please discuss major changes in an issue first to ensure they align with the project's goals.
Examples
Replace this section with screenshots or usage examples if available.
About
modrinth.com/mod/mod-template
Resources
Readme
License
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Used by
Contributors
Languages