Maintenance Status
Phosphor is not currently maintained due to a lack of available time and resources. As of Minecraft 1.20, there have been significant improvements to the game's lighting engine, and most of Phosphor's patches are no longer applicable or useful. (see more)
You may also be interested in our other mods, Sodium and Lithium.
(This page continues as it was historically written.)
Phosphor is a Minecraft mod which works to optimize one of game's most inefficient areas-- the lighting engine. It works on both the client and server, and can be installed on servers without requiring clients to also have the mod.
With Phosphor, the amount of time the game takes to generate new chunks can be greatly reduced, and you can expect to see some of the nastier frame stutters caused by loading chunks on the client simply vanish.
It's a no-compromises solution for improving performance either in single-player or large multi-player servers, and changes no features or behaviors of the vanilla game. In fact, our continued insistence towards not changing vanilla behaviours has even led to the mod being officially allowed in Minecraft speedrunning.
Installation
Make sure you have the latest version of Fabric Loader present and then simply drop the mod into your mods folder. No other mods or additional setup (not even Fabric API!) is required. You do not need to create new worlds in order to take advantage of the mod.
All Versions
+ Add VersionAdditionally, a small optimization is added to reduce the workload for the lightmap complexity initialization upon chunk loading added by Phosphor.
### Installation on servers:
Fabric needs to be installed using
fabric-installer >= 0.10.0 on servers in order to properly work with Mixins for Java 17. If the game crashes with error message The requested compatibility level JAVA_17 could not be set. Level is not supported by the active JRE or ASM version (Java 17.0, ASM 9.0 (ASM10_EXPERIMENTAL)), please reinstall Fabric.The approach for initial lighting is changed, which should lead to a small speedup. Together with some other changes, this furthermore establishes compatibility with the 1.17 world height changes.
The approach for initial lighting is changed, which should lead to a small speedup. Together with some other changes, this furthermore establishes compatibility with the 1.17 world height changes.
### Bug Fix
- Fixed a concurrency issue that could lead to lightmaps being discarded upon reloading chunks ([#49](https://github.com/CaffeineMC/phosphor-fabric/issues/49)). The fix will only prevent new glitches but will not repair already existing ones. If upgrading an already corrupted world to 0.7.2, you need to erase the light cache once, see the note on [MC-142134](https://bugs.mojang.com/browse/MC-142134) for complete instructions.
### Change
- Mark
Starlightas incompatible. Having bothPhosphorandStarlightinstalled will now lead to a crash instead of loading the game normally and causing unexpected logic errors later on.PhosphorandStarlightwere always incompatible and will always be, as they reimplement the lighting engine to a certain extent, hence modifying the same code in conflicting ways. With this change the game simply shuts down gracefully instead of causing undefined behavior.
### Bug Fixes
- Fixed a game hangup that occured in some situations where chunks were resent due to large numbers of block updates or specific servers ([#36](https://github.com/CaffeineMC/phosphor-fabric/issues/36), [#39](https://github.com/CaffeineMC/phosphor-fabric/issues/39))
- Fixed that some chunks were missing skylight after worldgen, due to wrong order of operations caused by a missing update notification.
