PurpurClient

PurpurClient

Fixes client-side vanilla bugs

by
109.6K Downloads
fabricoptimizationutility
Configure a Compatible Minecraft Server

Screenshots

Purpur Background
PurpurClient Ender Dragon
PurpurClient Mobs
PurpurClient Options
PurpurClient Splash

About this Mod

PurpurClient

PurpurClient is a Fabric client mod that aims to fix various client-side bugs in the game. A lot of these bugfixes end up in the vanilla game eventually, but for those who can't wait, this mod is for you.

PurpurClient is designed to work together with Purpur servers (hence the name), but most features can still be used with any server type, as these are fixes to vanilla bugs that are not caused by Purpur itself.

If you have any questions, please join us in our Discord at https://purpurmc.org/discord.

Discord Shield Label

Current Features in 1.20.2:

  • Customizable mob passenger offsets
  • Adds bee counts inside beehives to debug screen¹
  • Fancy Purpur-themed Loading Screen (can be disabled in the config)
  • Fancy Window Title that changes based on what kind of server you're in (translations can be PR'd)
  • Displays Custom Enchantments instead of stripping them from the client
  • Removes the client-side limit of 255 levels

¹ only works when connected to Purpur servers

Past Features (to get an idea of what this mod has done and will do in the future):

  • Asynchronous chat processing (removed since Mojang's new chat system is confusing)
  • Fix rain particles appearing under water MC-131770
  • Fix sky darkening when riding minecart not on tracks MC-51150
  • Fix chat stutter MC-218167
  • Fix warnings in logs about invalid flying attributes Purpur-744
  • Fix debug markers ignoring the blue and red values that are set MC-234030 (Shows as Unresolved even though it's been fixed)
  • Fix client preemptively removing item entities from the world (MC-???)

Note: PurpurClient adds a fancy animated splash screen on game startup alongside a better window title message. Both of these can be disabled in the config if preferred.

Donate

We accept donations via GitHub Sponsors and the OpenCollective.

GitHub Sponsors
OpenCollective

Available Versions

1.21.5 build 43release
MC 1.21.5fabric
April 13, 2025
1.21.5 build 42release
MC 1.21.5fabric
March 28, 2025
1.21.4 build 41release
MC 1.21.4fabric
March 22, 2025
1.21.4 build 40release
MC 1.21.4fabric
March 22, 2025
1.21.3 build 39release
MC 1.21.3fabric
November 28, 2024

How to Install PurpurClient on Your Client

1

Install the Mod Loader Locally

Install fabric for your local Minecraft version.

2

Download the Matching File

Choose the PurpurClient file for fabric and Minecraft 1.21.5.

3

Install Mod

Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.5, 1.21.4, 1.21.3 (+11 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Does PurpurClient need to be installed on the Minecraft server?

No. Modrinth marks PurpurClient as unsupported on the server side. Install it only in your local Minecraft mods folder. Your server can remain unchanged unless the mod page lists an additional dependency.

Which version and loader does PurpurClient require?

Use a file for fabric and your exact Minecraft version. Supported versions include 1.21.5, 1.21.4, 1.21.3. Files for different loaders are not interchangeable.

PurpurClient is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.

Minecraft Server for Your Group

PurpurClient stays on your client. Host a compatible world for your group.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
Client Compatibility Guide
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Unsupported

Supported Versions

1.21.51.21.41.21.31.211.20.61.20.41.20.21.20.2-rc21.20.11.19.3+4 more