LiteLoader is a lightweight mod bootstrap designed to provide very basic loader functionality for mods which don't need to modify game mechanics. It is designed to run alongside Minecraft Forge and Forge Mod Loader (FML) and LiteLoader mods will virtually never conflict with Forge mods.
You must run the game with the target version at least once before you start.
Close the Minecraft launcher and the game if it is running
Run the installer, if your minecraft installation is not automatically detected then select your .minecraft folder by clicking "..."
If you wish to extract the loader jar, choose extract, this can be used for the manual installation below
Select any additional Tweaks you wish to apply to the profile (hint: to change these at a later date simply run the installer again) such as cascading to Minecraft Forge.
Click OK to create the profile
A message should indicate that the installation was successful
Start the minecraft launcher and choose the "LiteLoader" profile.
Besides installating manually, you have 3 options for installing LiteLoader alongside another tweaker:
Use the liteloader installer to "chain" the tweaks:
You must run the game with the target version at least once before you start.
Download the other tweaks you wish to chain to and install them, they will create their own profiles in the launcher (eg. Forge, Optifine)
Run the liteloader installer, the installer will detect supported tweaks and allow you "chain" the liteloader profile to them, check the boxes for the tweaks you wish to include in the profile.
Run the launcher and choose the LiteLoader profile, this profile will also now load your chained tweakers
Use liteloader to load the other tweaks:
You must run the game with the target version at least once before you start.
Run the liteloader installer and install liteloader with no chained tweakers
]
Download the other tweaks you wish to chain to and extract them, copy the extracted jars to ./minecraft/mods/ (eg. .minecraft/mods/1.7.2), create the folder if it does not exist
Run the launcher and choose the LiteLoader profile, you can check that the other tweakers were loaded by checking in the liteloader mods list
Use FML to load liteloader:
You must run the game with the target version at least once before you start.
Download Minecraft Forge or FML and install it, FML will create its own profiles in the launcher
Run the liteloader installer and choose extract, extract the liteloader jar to ./minecraft/mods/ (eg. .minecraft/mods/1.7.2), create the folder if it does not exist
Run the launcher and choose the FML profile, FML will load liteloader
This method is not recommended and you should only use this method if you are au fait with editing "version" files by hand. If it looks too complicated I recommend using the installer instead, since it makes these changes for you!
Manual installation for LiteLoader 1.7.2:
You do not need to download anything
Create copy of the "version" you wish to use (eg. 1.7.2) or navigate to the version you want to add LiteLoader to. If you don't know how to do this, do not proceed any further and instead use the installer.
Open the version json and make the following modifications:
[alphalist=a]
In the minecraftArguments field, add an additional argument:
Run the game and the launcher will download LiteLoader automatically.
Manual installation for LiteLoader 1.6.4:
You do not need to download anything
Create copy of the "version" you wish to use (eg. 1.6.4) or navigate to the version you want to add LiteLoader to. If you don't know how to do this, do not proceed any further and instead use the installer.
If LiteLoader is to be the start of the tweak chain, do the following:
[alphalist=a]
In the minecraftArguments field, add an additional argument:
Run the game and the launcher will download LiteLoader automatically.
Important note: if you wish to chain to Forge or FML with 1.6.4 then you will require Forge build 898 or later or FML build 767 or later, previous versions have an error which will cause your game to crash stating that it got multiple values for "version" but was expecting only one. If you experience this problem then upgrading to the requisite version of Forge or FML is the solution.
LiteLoader is aimed squarely at mods which only change the client in some way; some good examples might be a mini-map, a mod which overhauls the in-game chat or a client-side macro system. This type of mod doesn't generally need the awesome power of something like Minecraft Forge to function, so asking players to install an API that's several times larger than the mod itself doesn't make sense. It must however coexist peacefully alongside Forge (so that players can use both platforms if they want to!) and LiteLoader does this.
LiteLoader was primarily developed for use by The VoxelModPack Team but is source available to allow mod developers to make their own mods using the platform.
As a modder, if you're looking for a loader to help you add a new block, item, mob or mechanic into the game, then LiteLoader isn't for you and you should check out Minecraft Forge. If you want to make a mod that displays something on the screen like a heads-up FPS counter, provides an in-game IRC window, or anything else that doesn't alter game mechanics then LiteLoader is probably perfect for you!
What is this for and why do I need it?
Like other loaders and API's,
LiteLoader
doesn't do much on its own. If you want to run a
LiteLoader
mod then you need
LiteLoader
, if you don't then you don't need it! In general, the mods which use
LiteLoader
will link to this thread as a place to download the loader and provide support.
Can I load Forge or ModLoader mods with this?
No,
LiteLoader
is a standalone API used by some client-only mods, however you can run it
at the same time
as Forge or FML and it won't conflict, so if you want to use Forge mods and Lite mods, then that's fine!
The game won't load when I specify multiple tweaks, what gives?
Try changing the order of the tweaks, sometimes the load order is important since the first tweak is the "primary" one. Try putting liteloader's tweaker first for example.
I have a mac, and after installing the 1.5.2 version of LiteLoader I have no sounds at all!
This isn't
LiteLoader
's fault, there is a problem with the mac archiver that causes it to
overwrite
the "com" folder inside you minecraft jar with the LiteLoader one instead of
merging
it. Unfortunately the "com" folder contains the sound codecs for the game!
To work around this, either manually
merge
the new "com" folder into the existing one in the minecraft jar, or use the
I installed a mod into my "mods" folder but it's not detected by LiteLoader.
First, check that the mod is for the correct version of
Minecraft
.
LiteLoader
includes a version-checking system designed to prevent out-of-date mods from loading and crashing your client. If the versions mismatch then
LiteLoader
will not load the mod. For example if you have a mod for Minecraft 1.5.1 do not expect it to work on Minecraft 1.5.2!
Secondly, ensure that the file extension is
.litemod
. Some browsers detect that the files are .zip files and rename them to
.zip
when you download.
LiteLoader
requires the files to have the
.litemod
extension in order to recognise them as mods.
Can I redistribute LiteLoader in my mod pack?
Yes, see the
Permissions
section below.
Can I make a custom version of LiteLoader and redistribute it?
In general, no. The reason for this is that LiteLoader is an API (albeit a small one), and having multiple incompatible versions of an API in the wild is confusing for users and makes tracking bugs and issues very difficult. We do however work with mod developers who would like custom extensions to LiteLoader or would like to integrate the loader itself into their mod. Please note that LiteLoader's source code is protected by copyright and you may not redistribute the source without permission.
Where can I find information about making LiteLoader mods?
, if you're waiting for an update just be patient. One of LiteLoader's goals is to keep its footprint small to make updating easy, so in general the update speeds are very fast.
Can I run LiteLoader and Forge at the same time?
Yes, they are designed to coexist, you can install both without any problems.
Won't running two loaders cause some kind of performance impact?
To cut a long story short, no. The loader is a
tiny
portion of the general footprint of the game and any mods you might install that
use
those loaders. Any impact on performance as a result of using multiple loaders is entirely lost in the general overhead of running the game itself.
Where can I report bugs?
If you have a question or a problem that you are not sure if it's a bug, then ask right here in this thread. Alternatively if you find a bug in LiteLoader itself you can
's core remit is to stay as light-weight as possible. This means I will generally only add functionality to the loader if it makes sense for it to be there.
LiteLoader
will never support adding blocks and items to the game so don't ask.
I accidentally my entire Minecraft. Is this bad?
Probably. If in doubt add more cowbell.
2014-02-15 - LiteLoader 1.7.2_04 - Lots of changes:
Full support for all features of the Mojang Tweak System in litemods - this means litemods can provide their own tweaker, and one or more class transformers
Support for loading jars containing tweakclasses in their metadata - this means that this version of liteloader and future versions can load Optifine, and also Forge
Support for being loaded as a tweakclass jar, eg. loaded by FML by just extracting the jar and dropping it in "mods"
Support for enabling and disabling mods in-game (still requires restart to apply but I made a nice pretty interface for viewing loaded mods and toggling their enabled state)
Better handling of external tweakers, loaded tweaks now show up in the mods list
Mod transformers will always be added last, this ensures that if FML is in use that the mod transformers end up downstream of the FML deobfuscation transformer
Skip adding transformers for disabled mods, prevents crashes when a disabled mod would get its tranformer added anyway
Internal refactoring to support more flexibility and extensibility in the future
LiteLoader version and loaded mods count is now shown in the main menu tab tooltip
Fixed support for being loaded by FML by extracting the jar into the "mods" folder
Loader events now injected using ASM instead of hooking on the profiler stack, this is much more efficient
Added update checker to the liteloader "about" panel
Added ingame log viewer for diagnosing mod startup errors, press F3 in the "about" panel
Added new transformer base classes for mod makers to use
Added new interfaces for the "server" (single player IntegratedServer) so mods can hook more easily into single player and LAN play
Refactored and improved mod discovery and disablement, disabling a mod now really disables it
Allow multiple descriptions in a single litemod.json file (for litemods containing more than one mod)
Switch all logging to log4j
Added a scroll bar for the mod "description" panel to allow longer descriptions in small resolutions
Fixed faulty logic in packet transformer check which would incorrectly sieve valid transformers
Added dependency check to mod metadata to allow specifying intra-mod dependencies
Allow Exposables to specify their own file name and gson deserialiser by implementing AdvancedExposable
Migrated macros JInputLib into LiteLoader, allow mods to access JInput controllers easily
Installer can now chain to Optifine as well, and also supports selecting amongst valid forge/fml/optifine versions
2013-09-27 - LiteLoader 1.6.4_00 - Updated for 1.6.4 and LaunchWrapper 1.8
2013-07-31 - LiteLoader 1.6.2_04 - Fixed issue with mod key bindings not saving properly
2013-07-31 - LiteLoader 1.6.2_03 - Updated installer to support chaining to FML
2013-07-25 - LiteLoader 1.6.2_02 - Fix for SoundSystem issue
2013-07-17 - LiteLoader 1.6.2_01 - Re-added crash log hook, installer now auto-detects forge version
2013-07-16 - LiteLoader 1.6.2_00 - Initial release for 1.6.2
You are free to redistribute unmodified LiteLoader binaries in any mod pack or compilation, including on third-party distribution platforms such as Feed The Beast provided that the distribution remains free, eg. no ad.fly links or similar.
You are free to use the source code to make your own LiteLoader mods but you may not redistribute modified versions of the loader. You may not redistribute the source code in any form without written permission.
Developing mods for LiteLoader is based around usage of the Minecraft Coder Pack so you should be familiar with MCP before you start.
Some (very brief and incomplete) documentation is available on (if you can tolerate my voice for that long!) which covers everything from start to finish.
If you get stuck feel free to ask questions here in the thread, I always try to help when I can. Or you can find me on IRC espernet #minecraft and #voxelmodpack.
Feel free to ask any questions or any other comments you have here in the thread, we will do our best to answer them!
In the meantime, happy Minecrafting
Manual installation for LiteLoader 1.7.2:
[/alphalist]
- Run the game and the launcher will download LiteLoader automatically.
[/alphalist]
- Alternatively, if you are adding LiteLoader to an existing "tweak"-based version, such as Forge:
[alphalist=a]
- In the minecraftArguments field, add an additional argument:
(in previous versions this was --cascadedTweaks, but now you just add multiple --tweakClass options)
[/alphalist]
- Run the game and the launcher will download LiteLoader automatically.
LiteLoader was primarily developed for use by The VoxelModPack Team but is source available to allow mod developers to make their own mods using the platform.
As a modder, if you're looking for a loader to help you add a new block, item, mob or mechanic into the game, then LiteLoader isn't for you and you should check out Minecraft Forge. If you want to make a mod that displays something on the screen like a heads-up FPS counter, provides an in-game IRC window, or anything else that doesn't alter game mechanics then LiteLoader is probably perfect for you!
doesn't do much on its own. If you want to run a
mod then you need
, if you don't then you don't need it! In general, the mods which use
will link to this thread as a place to download the loader and provide support.
is a standalone API used by some client-only mods, however you can run it
as Forge or FML and it won't conflict, so if you want to use Forge mods and Lite mods, then that's fine!
's fault, there is a problem with the mac archiver that causes it to
the "com" folder inside you minecraft jar with the LiteLoader one instead of
it. Unfortunately the "com" folder contains the sound codecs for the game!
To work around this, either manually
the new "com" folder into the existing one in the minecraft jar, or use the
made by
, which automates the installation.
.
includes a version-checking system designed to prevent out-of-date mods from loading and crashing your client. If the versions mismatch then
will not load the mod. For example if you have a mod for Minecraft 1.5.1 do not expect it to work on Minecraft 1.5.2!
Secondly, ensure that the file extension is
. Some browsers detect that the files are .zip files and rename them to
when you download.
requires the files to have the
extension in order to recognise them as mods.
section below.
below.
conveniently redirects to the
.
, if you're waiting for an update just be patient. One of LiteLoader's goals is to keep its footprint small to make updating easy, so in general the update speeds are very fast.
portion of the general footprint of the game and any mods you might install that
those loaders. Any impact on performance as a result of using multiple loaders is entirely lost in the general overhead of running the game itself.
on the LiteLoader assembla.
's core remit is to stay as light-weight as possible. This means I will generally only add functionality to the loader if it makes sense for it to be there.
will never support adding blocks and items to the game so don't ask.
You are free to use the source code to make your own LiteLoader mods but you may not redistribute modified versions of the loader. You may not redistribute the source code in any form without written permission.
Some (very brief and incomplete) documentation is available on (if you can tolerate my voice for that long!) which covers everything from start to finish.
If you get stuck feel free to ask questions here in the thread, I always try to help when I can. Or you can find me on IRC espernet #minecraft and #voxelmodpack.
In the meantime, happy Minecrafting