<div align="center">
<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/banners/modpage_banner.png?raw=true" alt="Legacy4J Themed Banner" width="700" >
<p></p>

[<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/curseforge_button.png?raw=true" alt="curseforge" width="100">](https://www.curseforge.com/minecraft/mc-mods/legacy-minecraft)
[<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/modrinth_button.png?raw=true" alt="modrinth" width="100">](https://modrinth.com/mod/legacy4j)
[<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/forge_button.png?raw=true" alt="forge" width="100">](https://files.minecraftforge.net/)
[<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/fabric_button.png?raw=true" alt="fabric" width="100">](https://fabricmc.net/)
[<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/neoforge_button.png?raw=true" alt="neoforge" width="100">](https://neoforged.net/)
[<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/quilt_button.png?raw=true" alt="quilt" width="100">](https://quiltmc.org/)


<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/modpage_about.png?raw=true" width="700" >
</div>

**Legacy4J** is a mod about the nostalgia of the old 4J Studios Minecraft Legacy Edition. The main objective of this mod is to remake every aspect of [Legacy Console Edition](https://minecraft.wiki/w/Legacy_Console_Edition) in a near 1:1 way for our current Java Edition versions, adding its exclusive features, and bringing it to modern versions.

This includes accurate controller support, control tooltips, crafting menu, creative flight, gamma shader, hud scaling, the GUI, and more!

<div align="center">
<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/modpage_comparison.png?raw=true" width="700" >
</div>

Not only that, but several QOL features have been added in addition to those already present in the Legacy Edition, such as Resource Albums, Global Packs, World Templates, an integrated Mods screen, options related to terrain fog and more.
You can see more about this on the [project wiki](https://docs.nostalgica.net/mods/legacy4j)!

*Feel free to [report issues](https://github.com/Wilyicaro/Legacy-Minecraft/issues) or contribute [here](https://github.com/Wilyicaro/Legacy-Minecraft), or to use this mod in modpacks!*  

## Nostalgica Reverie
Consider joining the [Nostalgica Reverie Discord](https://discord.gg/6pRkrYxbGW) for sneak peeks and updates on development! By joining, you can:
- Get installation help and technical support for alot of nostalgic projects
- Get the latest updates about development
- Talk with and collaborate with our team
- And just hang out with the rest of our community!

<div align="center">
<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/modpage_official_projects.png?raw=true" width="700" >
</div>

- [AlphaJam](https://modrinth.com/mod/alphajam) | A Quality of Life mod for a1.2.6 with a bit of Legacy Console Edition flavor.
 
- [Re-Console](https://modrinth.com/modpack/legacy-minecraft) | A continued Legacy Console Edition experience, expanded upon with modern Java Edition content and QoL!

- [Re-Console SMP](https://modrinth.com/server/re-console-smp) | The official Re-Console Survival Multiplayer server! smp.nostalgica.net
 
- [Rekindled Legacy](https://modrinth.com/modpack/rekindled-legacy) | A faithful re-creation of older Legacy Console Edition versions! 
 
- [Simply Legacy](https://modrinth.com/modpack/simply-legacy) | A faithful, fully-featured continuation of the vanilla Legacy Console Edition experience for PCs, Steam Decks and more!

- [2000s Edition](https://modrinth.com/modpack/simply-legacy) | Legacy Console Edition if it was made for 2000s-era PC's and the 6th Generation of Video Game Consoles!

<div align="center">
<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/modpage_special_thanks.png?raw=true" width="700" >
</div>

- AgentMindStorm for providing the built-in resource packs: Console Aspects & Programmer Console Aspects (NeoForge and Forge)
- Moutardx for providing the How To Play text from TU69
- RedRain0o0 for doing almost all the How To Play UI Definitions, and the screenshot toasts
- cloud54 and Cjnator38 for providing Steam Control Icons and sounds for the keyboard screen
- AzaleaCatgirl99 and ItzJustAPlayer for helping with the PlayStation® 5 Control Icons
- NicSonic-_- for providing the Stadia Control Icons
- Cjnator38 for providing the LE default font converted to JE, and the 1.21.x credits background, and helping with the 1.21.6 port
- Cjnator38 and NicSonic for making HD Control Icons for Xbox 360, Playstation 5, Switch and Stadia
- Androser for contributing to the controller bindings
- pizzart for contributing with some QOL and accuracy changes
- Nabouna32 for contributing with option tooltips and controller LED RGB options
- Creepereater201 for adding legacy mobcaps, decay potions, accurate elytra momentum and other tweaks
- BrandonItaly for adding downloadable content offers

<div align="center">
<img src="https://github.com/Kyubion-Studios/Legacy4J-Branding/blob/main/media/modpage_related_projects.png?raw=true" width="700" >
</div>

- [VDX: Legacy Console UI](https://www.curseforge.com/minecraft-bedrock/texture-packs/vdx-legacy-console-ui) | An experimental resource pack by CrisXolt that converts Legacy Edition UI designs to Bedrock Edition with high accuracy
- [Legacy Skins](https://modrinth.com/modpack/legacy-skins) | Combines CPM, Figura, and L4J to allow skin switching like the old days!
- [Mash-up ports](https://modrinth.com/collection/pmzubVQQ) | A collection of every ported mash-up pack and texture pack!
- [Skin pack ports](https://modrinth.com/collection/snUBKbay) | A collection of every ported skin pack (and some custom ones!)
- [Minimega](https://modrinth.com/modpack/minimega) | Legacy Console Edition Minigames ported to Java Edition! (Glide & Battle as of 2026)
- [Project4J](https://modrinth.com/modpack/project-4j) | Experience a timeline where Legacy Console Edition had mods!

# 📝 Planned and Implemented Features
| Feature                                                                    | Implemented | Planned |
|:---------------------------------------------------------------------------|:-----------:|:-------:|
| All Interfaces                                                             |      ✅      | ✅       |
| Animated Character (Paper doll in Bedrock Edition)                         |      ✅      | ✅       |
| Auto-Save Icon                                                             |      ✅      | ✅       |
| Backports to earlier versions (Currently 1.20.1)                           |      ✅      | ✅       |
| Create or load the world with open LAN (Online Game if using World Host)   |      ✅      | ✅       |
| Integration with [World Host](https://github.com/Gaming32/world-host)      |      ✅      | ✅       |
| HUD distance from the bottom (Configurable)                                |      ✅      | ✅       |
| HUD opacity setting                                                        |      ✅      | ✅       |
| LE-style tooltips                                                          |      ✅      | ✅       |
| LE GUI blocks Lighting                                                     |      ✅      | ✅       |
| LE Creative Flight                                                         |      ✅      | ✅       |
| Superflat in-GUI customizer                                                |      ✅      | ✅       |
| Tutorial World                                                             |      ✅      | ✅       |
| How To Play Interface                                                      |      ✅      | ✅       |
| Patch/Update Notes Interface                                               |      ✅      | ✅       |
| Advanced Hints/Tutorial                                                    |      ❌      | ✅       |
| Improved Change Skin Interface                                             |      ✅      | ✅       |
| [Legacy Edition Minigames](https://www.legacyminigames.net/) Compatibility |      ❌      | ✅       |
| Backports that would need a full remake (<=1.16.5)                         |      ❌      | ❌       |


# Build Instructions
## Linux & MacOS
```
sudo chmod +x gradlew
./gradlew build
```
## Windows
```
.\gradlew.bat build
```


## 🚫 **LEGACY4J** CAN BE CONSIDERED A HACK IN SERVERS EQUIPPED WITH ANTI-CHEATS
WE ARE NOT RESPONSIBLE FOR PUNISHMENTS RECEIVED IN ANY SERVER
