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

-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 (more likely 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.10s

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