Skip to content

Remote Mod Type: URL

ACGaming edited this page Aug 10, 2024 · 2 revisions

Downloading files from the internet

Direct links

First of all, your file needs to end with .url.json. Then, the format needs to be the following:

{
    "url": "https://mymod.com/download/mod.jar"
}

Sometimes you may want to override the file name, in that case you can use the fileName key:

{
    "url": "https://mymod.com/download/mod.jar",
    "fileName": "the-final-name.jar"
}

In general, it is recommended to specify the file name, if it can't be clearly obtained from the URL.

Practical example:

{
    "url": "https://github.com/MightyPirates/OpenComputers/releases/download/v1.7.5/OpenComputers-MC1.12.2-1.7.5.192.jar"
}

(Note: fileName has been omitted, because it is clear in this case)

Following URLs (does not work for ad links)

Sometimes you can't use a direct download link, but your link might be labeled with buttons. If so, you can use the follows key to follow links. It is highly recommended to specify fileName in such case!

{
    "url": "https://mymod.com/download/the-landing-page",
    "follows": ["Download now"],
    "fileName": "mymod.jar"
}

Practical example:

{
    "url": "https://www.mediafire.com/file/646bzvu0z4e92vf/Tekklands-Pre-Re-1.0.jar/file",
    "follows": ["Download (247.65KB)"],
    "fileName": "Tekklands-Pre-Re-1.0.jar"
}

This feature is supported in version 1.0+

Complicated mods

While we give our best to correctly inject mods into Forge or other mod loaders, some might require a few hacks to work. Those are disabled by default, and need to be enabled in the respective configuration file for the mod.

Launchwrapper Tweakers with low tweak order (e.g. OptiFine)

Some mods require to be injected before Forge itself. This is not possible without manipulating the LaunchClassLoader, and thus requires a special entry in the options key:

{
    "url": "https://my-core-mod.com/download/mod.jar",
    "options": {
        "launchwrapperTweakerForceNext": true
    }
}

Practical example (uses follows key, not required for "launchwrapperTweakerForceNext"):

{
    "url": "http://optifine.net/adloadx?f=OptiFine_1.12.2_HD_U_G5.jar",
    "follows": ["OptiFine 1.12.2 HD U G5"],
    "fileName": "Optifine_1.12.2_HD_U_G5.jar",
    "options": {
        "launchwrapperTweakerForceNext": true
    }
}

This feature is supported in version 1.0+