ferium
Fast and multi-source CLI program for managing Minecraft mods and modpacks from Modrinth, CurseForge, and GitHub Releases
- 1.4k
- Rust
- MPL-2.0
- 6 mo ago
A dual publishing Gradle Plugin to publish mods to Modrinth, Curseforge and GitHub in one go
Repo firstdarkdev/modpublisher, read from GitHub 21 h ago. firstdarkdev has not joined Take My Repo.
firstdarkdev/modpublisher is a public repo on GitHub by firstdarkdev. A dual publishing Gradle Plugin to publish mods to Modrinth, Curseforge and GitHub in one go. It declares the MIT license on GitHub. It is written mainly in Java, has 32 stars and last changed on 2026-10-15. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-21.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
ModPublisher is a Gradle Plugin that allows modders to publish their mods to multiple platforms, including CurseForge, Modrinth and GitHub in one go.
No need for separate plugins, just one!
To use this plugin inside your project, first you have to add our maven.
To do this, open up settings.gradle and add the following:
pluginManagement {
repositories {
gradlePluginPortal()
maven {
url "https://maven.firstdark.dev/releases"
}
/*
For unreleased versions
maven {
url "https://maven.firstdark.dev/snapshots"
}
*/
}
}Next, in your build.gradle add:
plugins {
id "com.hypherionmc.modutils.modpublisher" version "VERSION"
}Replace VERSION with the version above.
Finally, add the following to build.gradle file:
publisher {
// Setup the required API keys. You only need to define the keys for
// the platforms you plan on uploading to
apiKeys {
// Modrinth Token
modrinth System.getenv("MODRINTH_TOKEN")
// Curseforge Token
curseforge System.getenv("CURSE_TOKEN")
// GitHub Token
github System.getenv("GITHUB_TOKEN")
// Modtale Token
modtale System.getenv("MODTALE_TOKEN")
}
// Set the Game Type you are uploading for. This is Optional, but needed for Hytale Mods
// Current valid values are `hytale` and `minecraft`. minecraft is the default
setGameType("minecraft")
// Enable Debug mode. When enabled, no files will actually be uploaded
setDebug(true)
// Curseforge Project ID
setCurseID("1234")
// Modrinth Project ID
setModrinthID("dsgfhs79789")
// Modtale Project ID
setModtaleID("jfghg")
// Type of release. beta, alpha or release
// You can also use VersionType.BETA, VersionType.ALPHA or VersionType.RELEASE
setVersionType("beta")
// Changelog. This can be a file, string, OR, gist/github url
// For example: markdown.md, or "This is my changelog"
// Or: https://raw.githubusercontent.com/hypherionmc/changelogs/changelog.md
// Or https://gist.githubusercontent.com/hypherionmc/92f825d3c9337964cc77c9c8c9bf65e6/raw/ceeaaee5b98c688a23398864fe480b84796a1651/test_gist.md
setChangelog("changelog.md")
// Required for Modrinth/GitHub/Modtale
setProjectVersion("1.20.2-${project.version}")
// Fancy display name for the upload.
// Will default to the project version if not set
setDisplayName("[1.20.x] Simple Discord Link - ${project.version}")
// The supported game versions
setGameVersions("1.20", "1.20.1", "1.20.2")
// The modloaders your upload supports.
// This can also be an Enum from ModLoader,
// like setLoaders(ModLoader.FABRIC, ModLoader.FORGE)
// NOT NEEDED FOR HYTALE PLUGINS
setLoaders("forge", "fabric")
// The new Curseforge Environment tag. Optional
// Valid values are "server", "client" or "both"
// You can also use CurseEnvironment.BOTH, or CurseEnvironment.SERVER or CurseEnvironment.CLIENT
// NOT NEEDED FOR HYTALE PLUGINS
setCurseEnvironment("both")
// Upload the release, but keep it "private" until you are ready
// Working CurseForge, not working on Modrinth
setIsManualRelease(true)
// The file to be uploaded. This can be a file, task, or string.
// setArtifact("build/libs/mymod.jar")
// setArtifact(jar.getArchiveFile().get())
// If this is a task, the task specified will be executed before publishing
setArtifact(jar)
// Override the artifact uploaded to modrinth
// setPlatformArtifact(Platform.Modrinth, "build/libs/mymod.jar")
// setPlatformArtifact(Platform.Modrinth, jar.getArchiveFile().get())
// If this is a task, the task specified will be executed before publishing
// Valid platforms are modrinth, curseforge and github
setPlatformArtifact("modrinth", modrinthJar)
// Add supported java versions. Currently only used by CurseForge
// Supports anything that can be parsed using JavaVersion.toVersion()
// NOT NEEDED FOR HYTALE PLUGINS
setJavaVersions(JavaVersion.VERSION_1_8, 11)
// Safety check to check if the artifact contains a valid mod metadata entry,
// which could possibly mean that the jar is empty
// NOT NEEDED FOR HYTALE PLUGINS
setDisableEmptyJarCheck(true)
// Additional files to upload. Same as artifact, this can be a task, file or string
addAdditionalFile(jar, secondJar)
// Additional files to upload with a custom display name and changelog.
// Currently only supported on Curseforge
addAdditionalFile {
// File, Task or String
artifact jar
displayName "Some Name"
changelog "Hello Changelog"
fileType "sources-jar" // Only supported by modrinth right now
}
}Additional values that can be added to the above:
// GitHub options github { // GitHub repo to publish to. Overrides githubRepo repo = "OWNER/REPO" // Tag to use for GitHub release. Defaults to version tag = "v${project.version}" // Whether to create a tag for the GitHub release, if one doesn't exist yet. Defaults to true createTag = true // Whether to create the GitHub release if it doesn't exist yet. Defaults to true createRelease = true // Whether to update the GitHub release if it already exists. Defaults to true updateRelease = true // Whether the release should be left as an unpublished draft. // // If enabled, newly created releases and existing drafts will not be published. // Instead, a draft release is used. // // If disabled, the release will be published. // This option does not allow converting a published release to a draft. // // Defaults to false draft = false // The commitish ref the tag should target (ignored when tag already exists) target = "main" } // Modrinth Dependencies. // Accepts a slug or id modrinthDepends { // Multiple required dependencies required "fabric-api", "craterlib" // Single dependency required "fabric-api" // Optional dependency optional 'optional-dep' // Your mod is not compatible with this mod incompatible 'breaks-with' // Your mod embeds this dependency embedded 'fabric-api' } // Curse Dependencies curseDepends { // Multiple required dependencies required "fabric-api", "craterlib" // Single dependency required "fabric-api" // Optional dependency optional 'optional-dep' // Your mod is not compatible with this mod incompatible 'breaks-with' // Your mod embeds this dependency embedded 'fabric-api' }
To use this plugin inside your project, first you have to add our maven.
To do this, open up settings.gradle.kts and add the following:
pluginManagement {
repositories {
gradlePluginPortal()
maven {
url = uri("https://maven.firstdark.dev/releases")
}
/*
For Unreleased Versions
maven {
url = uri("https://maven.firstdark.dev/snapshots")
}*/
}
}Next, in your build.gradle.kts add:
plugins {
id("com.hypherionmc.modutils.modpublisher") version "VERSION"
}Replace VERSION with the version above.
Finally, add the following to build.gradle.kts file:
publisher {
// Setup the required API keys. You only need to define the keys for
// the platforms you plan on uploading to
apiKeys {
// Modrinth Token
modrinth(System.getenv("MODRINTH_TOKEN"))
// Curseforge Token
curseforge(System.getenv("CURSE_TOKEN"))
// GitHub Token
github(System.getenv("GITHUB_TOKEN"))
// Modtale Token
modtale(System.getenv("MODTALE_TOKEN"))
}
// Set the Game Type you are uploading for. This is Optional, but needed for Hytale Mods
// Current valid values are `hytale` and `minecraft`. minecraft is the default
gameType.set("minecraft")
// Enable Debug mode. When enabled, no files will actually be uploaded
debug.set(true)
// Curseforge Project ID
curseID.set("12345")
// Modrinth Project ID
modrinthID.set("sdjkg8867")
// Modtale Project ID
modtaleID.set("gjgndg")
// GitHub repo to publish to. Only required for GitHub
githubRepo.set("OWNER/REPO")
// Type of release. beta, alpha or release
// You can also use VersionType.BETA, VersionType.ALPHA or VersionType.RELEASE
versionType.set("release")
// Changelog. This can be a file, string, OR, gist/github url
// For example: markdown.md, or "This is my changelog"
// Or: https://raw.githubusercontent.com/hypherionmc/changelogs/changelog.md
// Or https://gist.githubusercontent.com/hypherionmc/92f825d3c9337964cc77c9c8c9bf65e6/raw/ceeaaee5b98c688a23398864fe480b84796a1651/test_gist.md
changelog.set("Coming Soon")
// Required for Modrinth/GitHub
projectVersion.set("1.3.0")
// Fancy display name for the upload.
// Will default to the project version if not set
displayName.set("MyAwesomeMod - Version")
// The supported game versions
// setGameVersions("1.20", "1.20.1", "1.20.2")
gameVersions.set(listOf("1.19.3", "1.19.4"))
// The modloaders your upload supports.
// This can also be an Enum from ModLoader,
// like setLoaders(ModLoader.FORGE, ModLoader.FABRIC)
loaders.set(listOf("forge", "fabric"))
// The new Curseforge Environment tag. Optional
// Valid values are "server", "client" or "both"
// You can also use CurseEnvironment.BOTH, or CurseEnvironment.SERVER or CurseEnvironment.CLIENT
// setCurseEnvironment(CurseEnvironment.CLIENT)
curseEnvironment.set("both")
// Upload the release, but keep it "private" until you are ready
// Unreleased feature on CurseForge, working on Modrinth
isManualRelease.set(true)
// The file to be uploaded. This can be a file, task, or string.
// setArtifact("build/libs/mymod.jar")
// setArtifact(jar.getArchiveFile().get())
// If this is a task, the task specified will be executed before publishing
artifact.set(tasks.jar)
// Override the artifact uploaded to modrinth
// setPlatformArtifact(Platform.Modrinth, "build/libs/mymod.jar")
// setPlatformArtifact(Platform.Modrinth, jar.getArchiveFile().get())
// If this is a task, the task specified will be executed before publishing
// Valid platforms are modrinth, curseforge and github
setPlatformArtifact("modrinth", modrinthJar)
// Safety check to check if the artifact contains a valid mod metadata entry,
// which could possibly mean that the jar is empty
disableEmptyJarCheck.set(true)
// Add supported java versions. Currently only used by CurseForge
// Supports anything that can be parsed using JavaVersion.toVersion()
setJavaVersions(JavaVersion.VERSION_1_8, 11)
// Additional files to upload. Same as artifact, this can be a task, file or string
additionalFiles.set(listOf(tasks.jar))
// Additional files to upload with a custom display name and changelog.
// Currently, supports CurseForge only
addAdditionalFile {
// File, Task or String
artifact(tasks.jar)
displayName("Test Name")
changelog("Some Changelog")
fileType("sources-jar") // Only supported by Modrinth right now
}
}Additional values that can be added to the above:
// GitHub options github { // GitHub repo to publish to. Overrides githubRepo repo = "OWNER/REPO" // Tag to use for GitHub release. Defaults to version tag = "v${project.version}" // Whether to create a tag for the GitHub release, if one doesn't exist yet. Defaults to true createTag = true // Whether to create the GitHub release if it doesn't exist yet. Defaults to true createRelease = true // Whether to update the GitHub release if it already exists. Defaults to true updateRelease = true // Whether the release should be left as an unpublished draft. // // If enabled, newly created releases and existing drafts will not be published. // Instead, a draft release is used. // // If disabled, the release will be published. // This option does not allow converting a published release to a draft. // // Defaults to false draft = false // The commitish ref the tag should target (ignored when tag already exists) target = "main" } // Modrinth Dependencies. // Accepts a slug or id modrinthDepends { // Multiple required dependencies required("fabric-api", "craterlib") // Single dependency required("fabric-api") // Optional dependency optional("optional-mod") // Your mod is not compatible with this mod incompatible("breaks-with") // Your mod embeds this dependency embedded("rift") } // Curse Dependencies curseDepends { // Multiple required dependencies required("fabric-api", "craterlib") // Single dependency required("fabric-api") // Optional dependency optional("optional-mod", "another-mod") // Your mod is not compatible with this mod incompatible("breaks-with") // Your mod embeds this dependency embedded("rift") }
This project and code is licensed under the MIT license. You are free to use, adapt or modify the code for your own use.
Please just don't reuse the name ModPublisher to avoid confusion.
If you need any additional help, open a Ticket or visit our Discord
firstdarkdev/modpublisher is a public repo on GitHub by firstdarkdev. A dual publishing Gradle Plugin to publish mods to Modrinth, Curseforge and GitHub in one go.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-10-15. GitHub counts 10 open issues and pull requests. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.

Fast and multi-source CLI program for managing Minecraft mods and modpacks from Modrinth, CurseForge, and GitHub Releases

:octocat: 分享 GitHub 上有趣、入门级的开源项目。Share interesting, entry-level open source projects on GitHub.

The best authentication plugin for the Bukkit/Spigot API!

The 30 Days of Python programming challenge is a step-by-step guide to learn the Python programming language in 30 days. This challenge may take more than 100 days. Follow your own pace. These videos may help too: https://www.youtube.com/channel/UC7PNRuno1rzYPb1xLa4yktw
A template for creating Fabric/Quilt/NeoForge mods using a shared code base
A Gradle plugin to merge multiple mod-loaders mods into one jar!
A mod to customize your Minecraft Splash Screen (NeoForge)
Take My Repo has not tested this on your machine. Requirements come from the project's own documentation.