NilLoader

NilLoader is a lightweight modloader using the Java agent system/APIs to offer offer other possibilities for mods. It works on Mojang launcher, PrismMC/PolyMC, etc.

Infobox WIP

NilLoader

[[File:

|160px|class=pixel-image|alt=

: Infobox image for NilLoader the mod in Minecraft]]

Author	unascribed
Latest Release	{{{latest_release}}}
Initial Release	{{{initial_release}}}
Mod Loaders	{{{modloader}}}
Minecraft Versions	{{{minecraft_version}}}
Modrinth	https://git.sleeping.town/Nil/NilLoader

{
    "title": "NilLoader",
    "rows": [
        {
            "field": "unascribed",
            "label": "Author"
        },
        {
            "field": "{{{latest_release}}}",
            "label": "Latest Release"
        },
        {
            "field": "{{{initial_release}}}",
            "label": "Initial Release"
        },
        {
            "field": "{{{modloader}}}",
            "label": "Mod Loaders"
        },
        {
            "field": "{{{minecraft_version}}}",
            "label": "Minecraft Versions"
        },
        {
            "field": "https://git.sleeping.town/Nil/NilLoader",
            "label": "Modrinth"
        }
    ],
    "invimages": [],
    "images": [
        "[[File:NilLoader Logo Capture.png|250x250px|center]]"
    ]
}

Common version to target is 1.4.7

NilLoader (ØL or 0L) is a minimal, easy-to-install, application-independent system for applying runtime patches to programs written in Java, compatible with any launcher that allows you to modify JVM arguments.

It's based on the native Java agent system, but provides a comprehensive and convenient API for defining class patches and entrypoints on top of it. It additionally provides a system for working with obfuscated environments, without forcing you to write code using obfuscated names. (Note that NilLoader does not provide a "high-level" bytecode patching system like Mixin; you have to write raw bytecode patches using Mini or ASM directly.)

SVG to PNG conversion

Recommended Mods To Test Or Add To The Mods Folder

-NilMenu for 1.4.7

Description: A basic mod menu for NilLoader.

-Sha1Redemption for 1.4.2 to 1.6.4

Description: A hack workaround for signature errors in legacy Minecraft versions.

For Specifics: 1.4.2, 1.4.4-1.4.7, 1.5.x, 1.6.1-1.6.2, 1.6.4 Java Agent/NilLoader

-NilCord for 1.4.7

Description: Yet another Discord bridge for Minecraft.

-Legacy Freecam for 1.0 (tagged as such) Removed

-Half Life Menu for 1.21.1

Description: Changes the title screen to the pre-25th Half Life title screen.

Also for: 1.21, 1.21.11, 26.1-snapshot-1, 26.1, 26.1.1, 26w14a (April Fools), 26.1.2 Fabric, NeoForge, Quilt

Breakdown of versions per modloader:

1.21, 1.21.11, 26.1-snapshot-1, 26.1, 26.1.1, 26w14a (April Fools), 26.1.2, 26.2 Fabric,

1.21.11, 26.1-snapshot-1, 26.1, 26.1.1, 26w14a (April Fools), 26.1.2, 26.2 Quilt,

26.1-snapshot-1, 26.1, 26.1.1, 26w14a (April Fools), 26.1.2, 26.2 NeoForge,

1.21.1 Java Agent/NilLoader

-Let Your Friend Eating for 1.4.7 Particular Build Recommend

Description: Players can feed others directly by right-clicking.

Also for:Beta 1.7.3, 1.4.7, 1.10.2, 1.11.2, 1.12.2, 1.13.x, 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x, 26.1.x, 26.2

Breakdown of version support per Modloader:

Beta 1.7.3 Babric,

1.4.7 NilLoader,

1.16.4-1.16.5, 1.17.x, 1.18.x, 1.19.x, 1.20-1.20.6, 1.21-1.21.5, 25w15a-25w21a, 1.21.x, 26.1.x, 26.2 Fabric,

1.19.x, 1.20-1.20.4, 1.21-1.21.1 Quilt,

1.10.2, 1.11.2, 1.12.2, 1.13.x, 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21-1.21.1, Forge,

1.20.6, 1.21.x, 26.1.x, 26.2 NeoForge

-Agenta various as version independent Particular Build Recommend

Description: A authserver and skin fix for legacy versions of Minecraft.

Also for: c0.0.11a to Beta 1.8.1, 1.0, 1.1, 1.2.x, 1.3.x, 1.4.2, 1.4.4-1.4.7, 1.5.x, 1.6.1-1.6.2, 1.7.x

Modloaders: Babric Beta 1.7.3, Bukkit, Legacy Fabric (likely 1.3.2 to 1.7.10), Forge, Java Agent, Risugami's Modloader, Ornithe (it can support c0.0.11a and many others, Pre-Classic to 1.14.4 so whichever it applies to as could all versions listed), Quilt

Breakdown of versions per modloader: (without lots of testing unclear)

Builds 1.8.4 to 1.8.6 say c0.0.13a-c0.30_01c, All Alpha and Beat versions yet tags Risugami's Modloader, Forge, Fabric and Bukkit so may apply to Bukkit or Java Agent 1.9.0/1.9.1 supports Ornithe so instead of thinking it's a jar mod going with Bukkit based on what is tagged.

Unsure which Bukkit supports, it mentions Beta 1.2_01 tested with it but it groups testing Alpha 1.0.4 to 1.7.10 with Forge, Bukkit and Risugami's Modloader (from Beta to 1.6.2 as far as known, Forge as a fork of Risugami's Modloader being well Beta to current), Bukkit being however far of support.

By 1.8.5 instead of 1.8.4 tagging says c0.0.13a_03 to Beta 1.8.1 so Bukkit may cover those and however much Risugami's Modloader or Forge can.

Assuming Risugami's Modloader was only covering older versions and not up to 1.6.2 best to go with Forge or Legacy Fabric for the 1.3.x to 1.7.x versions, Ornithe if targets it as it can support Pre-Classic to 1.14.4 but also says Java Agent.

So in short not sure which versions support what without a lot of testing.

-NilLoader SDK API for 1.3.2, 1.4.7, 1.5.2, 1.6.2, 1.6.4

Description: Utilities and helper SDK for NilLoader mod development. The purpose is to make developing older versions of Minecraft easier.

-Version Numbering Converter various]

Description: Do you hate the new Apple-like version numbering system? Same! Do you like it? Don't care! Do you care about the version numbering and how to convert old versions to its new version or viceversa? This project is for you!

Also for: Support for (All Legacy Versions so all Pre-Classic and so on to ALpha/Beta) rd-132211 to Beta 1.7.3, 1.0 to 26.1.2, 26.2-snapshot-8

For specifics: rd, Alpha, Beta, 1.0, 1.1, 1.2.x, 1.3.x, 1.4.2, 1.4.4-1.4.7, 1.5.x, 1.6.1-1.6.2, 1.6.4, 1.7.x, 1.8.x, 1.9.x, 1.10.x, 1.11.x, 1.12.x, 1.13.x, 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x, 26.1.x, 26.2-snapshot-8

Modloader/Server Plugins: Better Than Adventure Beta 1.7.3, Bukkit, BungeeCord, Fabric, Folia, Forge, LiteLoader, NeoForge, NilLoader, Ornithe (assuming in the rd-132211 range to 1.14.4), Paper, Purpur, Quilt, Spigot, Sponge, Velocity, Waterfall

-Beds Always Explode for 1.4.7 Particular Build Recommend

Description: Mod that makes beds explode in every dimension.

Also for: Beta 1.7.3, 1.4.7, 1.7.10, 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x, 26.1.x, 26.2-pre-2

Modloader/Server Plugins: Babric Beta 1.7.3, Better Than Adventure Beta 1.7.3, Forge 1.7.10, Fabric/Quilt 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x, 26.1.x, 26.2-snapshot-4, 26.2-pre-2, NeoForge 26.1.x, Sponge 26.1.x

-Redirectionor Retro for NilLoader various versions NilLoader or Flint Loader filtering

Description: Avoid Enum values allocation in codes and improve game performance.

Also for (tagging, maybe not be accurate): 1.4.7, 1.5.0-1.5.3, 1.6.1-1.6.2, 1.6.4, 1.7.2, 1.7.4-1.7.10, 1.8 Snapshot-1.8.9, 1.9-1.9.4, 1.10 Snapshot-1.10.2, 1.11 Snapshot-1.11.2, 1.12 Snapshot-1.12.2, 1.13 Snapshot-1.13.2, 1.14 Snapshot-1.14.4, 1.15 Snapshot-1.15.2, 1.16 Snapshot-1.16.5, 1.17 Snapshot-1.17.1, 1.18 Snapshot-1.18.2, 1.19 Snapshot-1.19.4, 1.20 Snapshot-1.20.6, 1.21 Snapshot-1.21.9 Snapshot

Modloaders: Forge, Fabric, Rift, Quilt, NeoForge, Flint Loader (NilLoader)

Breakdown of versions per modloader:

1.7.10, 1.8.8-1.8.9, 1.9.x, 1.10.x, 1.11.x, 1.12.x, Forge

1.4.7, 1.5.x, 1.6.2, 1.6.4, 1.7.8, 1.7.10, 1.8-1.8.2, 1.8.5-1.8.6, 1.8.9, 1.9, 1.10.1, 1.11.1-1.11.2, 1.12.2, 1.13.2, 1.14, 1.14.2, 1.15.1-1.15.2,, 1.16.2, 1.16.4, 1.18, 1.19., 1.19.1, 1.19.3 Snapshot, 1.20, 1.21.1

Flint Loader mention 1.5.3 (doesn't exist), 1.6.1, 1.7.2-1.7.9, 1.8.3-1.8.4, 1.8.7-1.8.8, 1.9.1-1.9.4, 1.10.2, 1.11, 1.12-1.12.1, 1.13-1.13.1, 1.14.1, 1.14.3-1.14.4, 1.15, 1.16-1.16.1, 1.17.3, 1.16.5, 1.17-1.17.1, 1.18.1-1.18.2, 1.19.2-1.19.4, 1.19.4 Snapshot, 1.20.2-1.20.6, 1.20.3 Snapshot, 1.20.5 Snapshot, 1.20.2 Snapshot (yes tagged and presented in that order), 1.21.1-1.21.8, 1.21.9 Snapshot, 1.21.4 Snapshot, 1.21.5 Snapshot, 1.21.1 Snapshot, 1.21.6 Snapshot, 1.21.2 Snapshot, 1.12 Snapshot, 1.14 Snapshot, 1.13 Snapshot, 1.11 Snapshot, 1.18 Snapshot, 1.9 Snapshot, 1.17 Snapshot, 1.20 Snapshot, 1.21 Snapshot, 1.8 Snapshot, 1.19 Snapshot, 1.10 Snapshot, 1.15 Snapshot, 1.16 Snapshot

1.21.4, 1.21.5, 1.21.8 NilLoader in terms of latest build 1.9 that has latest release version in the list.

Would recommend just testing what works as the tagging may be inaccurate.

Ragecord NilCord but expanded upon.

Description: Ragecord is a fork of Nilcord that expands Discord ↔ Minecraft communication with moderation tools, message filtering, and deeper integration with server-side systems.

Also for: 1.7.10

Modloaders: Marked as Forge (as no NilLoader listed on Curseforge, more likely Forge as it's a fork of NilCord with additional) or NilLoader

-FeatureCreep Mention of NilLoader and Rift (may not support NilLoader or Rift as both are listed but Rift was not supported so best to go for other modloaders supported instead, tagging only means so much after all and isn't always accurate), but more so supports for Forge, Fabric, NeoForge, Quilt.

Also for: 1.6.4, 1.7.10, 1.8.9, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.4, 1.16.5, 1.17, 1.17 Snapshot, 1.17.1, 1.18 Snapshot, 1.18, 1.18.1, 1.18.2, 1.19 Snapshot, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20 Snapshot, 1.20, 1.20.1, 1.20.2, 1.20.3 Snapshot, 1.20.3, 1.20.4, 1.20.5 Snapshot, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10

Breakdown of versions per modloader: (be careful of tagging)

1.6.4, 1.7.10, 1.8.9, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.1, 1.18.2, 1.19.2, 1.19.3, 1.19.4, 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.10 Forge,

1.13.2 Rift (be careful with tagging here as while not all but latest was tested and doesn't work, is intended for Forge more so),

1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.1, 1.18.2, 1.19 Snapshot, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20 Snapshot, 1.20.1, 1.20.2, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1 Fabric,

1.12.2 LiteLoader,

1.18.2, 1.19.2, 1.19.3, 1.19.4, 1.20.1, Quilt

1.20.1 (assuming 1.20.2 as NeoForge starts at that), 1.20.6 NeoForge

NilFix for NilLoader 1.2.5

Description: Nilmod aiming to fix some bugs in Minecraft 1.2.5 mods

Origins

NilLoader was primarily designed for Minecraft, like a lot of Java bytecode patching frameworks. In a Minecraft environment, it is compatible with all current and past loaders, and can patch any version of the game from Cave Game Test to the latest snapshot. However, since NilLoader is so generic, it does not come with many conveniences that other loaders do, such as intermediate mappings, cross-version compatibility, or any API of any kind. NilLoader lets you do two things: patch classes, and get told when the JVM starts before anything else has run.

However, given these two possibilities, you can do just about anything else you want. Note that NilLoader is not a replacement for Fabric or Forge, it is an additional option for supporting weird versions or doing things the other loaders won't let you do. Someone could very well build an entire API on top of NilLoader, but that someone will not be me, and it's not something I intend to have happen.

NilLoader has its origins in the cross-version patching framework created for Ears, used for its ports to Beta 1.7, early versions of Forge, NFC, etc. That is, more or less, its intended purpose.

How to install

Quote from the NilLoader page:

More comprehensive docs coming soon, but for now, check out NilExample to write mods, and use this Prism Launcher component JSON to install it. (Click "Add Empty" under versions, enter "NilLoader" and "com.unascribed.nilloader", then click Edit on the right, and replace the contents of the file it opens with that JSON.)

For other launchers, download the latest NilLoader from releases, put it in your .minecraft, rename it to NilLoader.jar, and add -javaagent:NilLoader.jar to your JVM arguments.

Broken down steps here:

Step 1: Setup PrismMC or PolyMC launchers (or others for their approripate methods).

Step 2: Go to the NilLoader installer website/source.

Step 3: Read the following quote below.

For Mojang launchers/other users

3.1: For other launchers use the NilLoader from the releases section and go to the .minecraft folder via %Appdata% for Windows, equivalents for Mac/Linux, etc. and set the JVM arguments under Installations tab for the Mojang launcher for example. This can be tricky but can work if applied correctly.

For PrismMC/PolyMC users

3.2: For the PrismMC/PolyMC launchers create a new instance, recommend creating a 1.4.7 vanilla/unmodded instance as many mods commonly support it. From there go to 'add empty' under the edit instance button/settings.

With 'add empty' 2 textboxes will be visible. In the top one put 'NilLoader' in the bottom one put 'com.unascribed.nilloader', then load the game. You will notice the title screen won't change, but the json file will generate, this is important. Go to the 'patches' folder in the .minecraft for your PolyMC/PrismMC launcher instance you have created and edit it (as in open the file in any text document program/app). From there you will see the default information for the json file, you want to remove it and replace it with the NilLoader related code recommended. This will be the following below to compare the default the json generates, and the one to put into the json to replace it with.

Default JSON output for a Vanilla instance

Spaced in edit to look good in formatting, so if comes off weird just remove pargraph spacing, if it looks right just copy and paste or go to the official source for it and copy the RAW DATA of it

{

"formatVersion": 1,

"name": "NilLoader",

"uid": "com.unascribed.nilloader",

"version": "1"

}

To replace it with the NilLoader related code:

Spaced in edit to look good in formatting, so if comes off weird just remove pargraph spacing, if it looks right just copy and paste or go to the official source for it and copy the RAW DATA of it

{

"formatVersion": 1,

"name": "NilLoader",

"uid": "com.unascribed.nilloader",

"version": "1.3.5",

"+agents": [

{

"name": "com.unascribed:nilloader:1.3.5",

"url": "https://repo.sleeping.town"

}

]

}

Add empty to apply NilLoader to PolyMC Launcher	Add empty to apply NilLoader to PrisnMC Launcher	Title screen with the NilMenu button, a separate mod like Fabric/Ornithe/Quilt Mod Menu mods	Inside NilMenu screen	NilLoader Capture of logo