<div align="center">

<img src="https://download.fo/icon.png" alt="FO logo" width="10%" height="10%">

# Fabulously Optimized

[![Official Website][img-website]][url-website]
[![Support and Contribute][img-contribute]][url-contribute]
[![Read the Wiki][img-wiki]][url-wiki]

[![Mod list][img-mods]][file-mods]
[![Changed Options][img-options]][url-options]
[![Resource Packs][img-rp]][url-rp]
[![Help us Translate][img-translate]][url-translate]

[![Discord][img-discord]][url-discord]
[![GitHub][img-github]][url-github]
[![Mastodon][img-mastodon]][url-mastodon]

A simple Minecraft modpack focusing on performance and graphics enhancements.

</div>

## Download

[![Installation Guide][img-install]][url-install]
[![CurseForge][img-cf]][url-cf]
[![Modrinth][img-modrinth]][url-modrinth]

> By downloading Fabulously Optimized, you have acknowledged the [disclaimers][url-terms].

We recommend and support five launchers, all of which can be used offline on 🪟 Windows, 🐧 Linux and 🍏 macOS.

See this table for a comparison between the launchers:

| Launcher                                      |               Tutorial               |    Install    |     Upgrade     |   Add mods    | Support us and mods |
| --------------------------------------------- | :----------------------------------: | :-----------: | :-------------: | :-----------: | :-----------------: |
| [CurseForge App][url-app-cf]                  |    [🔗&nbsp;Open][url-tutorial-cf]    |  ✅&nbsp;Easy  |   ✅&nbsp;Easy   |  ✅&nbsp;Easy  |     ✅&nbsp;Yes      |
| [Modrinth App][url-app-modrinth]              | [🔗&nbsp;Open][url-tutorial-modrinth] |  ✅&nbsp;Easy  |   ✅&nbsp;Easy   |  ✅&nbsp;Easy  |     ✅&nbsp;Yes      |
| [Prism Launcher][url-app-prism]               |  [🔗&nbsp;Open][url-tutorial-prism]   |  ✅&nbsp;Easy  |   ✅&nbsp;Easy   |  ✅&nbsp;Easy  |   ⏺️<sup>[2]</sup>   |
| [MultiMC][url-app-multimc]                    | [🔗&nbsp;Open][url-tutorial-multimc]  |  ✅&nbsp;Easy  |  ❌&nbsp;Manual  | ❌&nbsp;Manual |   ⏺️<sup>[2]</sup>   |
| [MultiMC (auto-update)][url-app-mmcu]           |   [🔗&nbsp;Open][url-tutorial-mmcu]   |  ✅&nbsp;Easy  | ⏺️<sup>[1]</sup> | ❌&nbsp;Manual |   ⏺️<sup>[2]</sup>   |
| [Minecraft Launcher][url-app-vanilla] (installer) | [🔗&nbsp;Open][url-tutorial-vanilla] |  ✅&nbsp;Easy  | ✅&nbsp;Easy | ❌&nbsp;Manual |   ⏺️<sup>[2]</sup>   |
| [Minecraft Launcher][url-app-vanilla] (manual setup) | [🔗&nbsp;Open][url-tutorial-vanilla]  | ❌&nbsp;Manual |  ❌&nbsp;Manual  | ❌&nbsp;Manual |   ⏺️<sup>[2]</sup>   |

> [!NOTE]
>
> **[1]**: Updates to the modpack within the same Minecraft version are automatic. The modpack cannot be updated automatically across Minecraft versions.
>
> **[2]**: These launchers support the modpack and its mods by increasing their download count, but not with monetary benefits.

<details><summary>Download Resource Packs separately</summary>

FO includes some resource packs [for a better experience][url-rp], but they can also be downloaded separately.

| Resource Pack             | CurseForge                  | Modrinth                        | Planet Minecraft                   |
| ------------------------- | --------------------------- | ------------------------------- | ---------------------------------- |
| **Chat Reporting Helper** | [CurseForge][url-rp-crh-cf] | [Modrinth][url-rp-crh-modrinth] | [Planet Minecraft][url-rp-crh-pmc] |
| **Fast Better Grass**     | [CurseForge][url-rp-fbg-cf] | [Modrinth][url-rp-fbg-modrinth] | [Planet Minecraft][url-rp-fbg-pmc] |

</details>

## Credits

- [TheYTG123][url-credits-TheYTG123] on CurseForge who helped with Jumploader to release the 1.16.3 version a little faster
- [triphora][url-credits-triphora] who suggested and helped with the Modrinth format, and formerly moderated the FO Discord server
- [RozeFound][url-credits-RozeFound] for helping with Python scripts and providing lots of constructive feedback for the pack
- [TheMadHau5][url-credits-TheMadHau5], [redbrain][url-credits-redbrain], [Kichura][url-credits-Kichura] for the [fancy mod table][file-mods]
- [RaptaG][url-credits-RaptaG] and [Ultrasonic1209][url-credits-Ultrasonic1209] for the [Packwiz mod ignoring tutorials][url-tutorial-mmcu-ignoremods]
- [IMB11][url-credits-IMB11] for the fancy website
- [vgskye][url-credits-vgskye] for the fancy installer (and [osfanbuff63][url-credits-osfanbuff63] for the installer that didn't get released)
- [Miroma][url-credits-Miroma] for the current version of this readme
- All our [fabulous translators][url-credits-translators]
- Other people creating pull requests for [the main project][url-github-main-graph], [wiki][url-github-wiki-graph] and [other organization projects][url-github-org]
- People who have created videos about the modpack
- Everyone who has suggested ideas and reported bugs!

Special thanks to:

- [jellysquid3][url-credits-jellysquid3] for creating [Sodium][url-credits-jellysquid3-sodium], [Lithium][url-credits-jellysquid3-lithium], [Phosphor][url-credits-jellysquid3-phosphor] which were the initial inspiration for creating the modpack
- [LambdAurora][url-credits-LambdAurora] for creating [the list of OptiFine alternatives][url-credits-LambdAurora-alternatives] which the pack does get some mod ideas from, and [LambDynamicLights][url-credits-LambdAurora-LambDynamicLights]
- [comp500][url-credits-comp500] for creating [Jumploader][url-credits-comp500-Jumploader] - a mod that made the modpack possible in Minecraft 1.16.x, [Indium][url-credits-comp500-Indium] - mod that provided the rendering API for Sodium for increased mod compatibility and [packwiz][url-credits-comp500-packwiz] - a tool that makes the MultiMC auto-update happen
- Mod devs who have joined the Discord and are discussing the modpack's development there
- All developers who made the mods that are, have been and will be in the modpack
- Everyone who uses, tests and shares the modpack!

<!-- Files -->
[file-mods]: <INCLUDED-MODS.md>

<!-- Images -->
[img-cf]: <https://img.shields.io/curseforge/dt/396246?style=for-the-badge&label=CurseForge&color=orange&logoColor=orange&labelColor=black&logo=curseforge>
[img-discord]: <https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscordapp.com%2Fapi%2Finvites%2Ffabulously-optimized-859124104644788234%3Fwith_counts%3Dtrue&query=approximate_member_count&style=for-the-badge&label=Discord&color=5865F2&logoColor=white&labelColor=black&logo=discord>
[img-github]: <https://img.shields.io/github/stars/Fabulously-Optimized/fabulously-optimized?style=for-the-badge&label=Stars&color=white&logoColor=white&labelColor=black&logo=github>
[img-install]: <https://img.shields.io/badge/Installation%20Guide-black?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgLTk2MCA5NjAgOTYwIiB3aWR0aD0iMjQiPjxwYXRoIGQ9Ik00ODAtMzIwIDI4MC01MjBsNTYtNTggMTA0IDEwNHYtMzI2aDgwdjMyNmwxMDQtMTA0IDU2IDU4LTIwMCAyMDBaTTI0MC0xNjBxLTMzIDAtNTYuNS0yMy41VDE2MC0yNDB2LTEyMGg4MHYxMjBoNDgwdi0xMjBoODB2MTIwcTAgMzMtMjMuNSA1Ni41VDcyMC0xNjBIMjQwWiIgZmlsbD0iI2ZmZmZmZiIvPjwvc3ZnPg%3D%3D>
[img-mastodon]: <https://img.shields.io/mastodon/follow/109406313733713199?style=for-the-badge&domain=https%3A%2F%2Ffloss.social%2F&label=Mastodon&color=6364FF&logoColor=white&labelColor=black&logo=mastodon>
[img-modrinth]: <https://img.shields.io/modrinth/dt/1KVo5zza?style=for-the-badge&label=Modrinth&color=darkgreen&labelColor=black&logo=modrinth>
[img-mods]: <https://img.shields.io/badge/Mod_list-darkgreen?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64% %3D>
[img-options]: <https://img.shields.io/badge/Changed_Options-blue?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgLTk2MCA5NjAgOTYwIiB3aWR0aD0iMjQiPjxwYXRoIGQ9Ik00NDAtMTIwdi0yNDBoODB2ODBoMzIwdjgwSDUyMHY4MGgtODBabS0zMjAtODB2LTgwaDI0MHY4MEgxMjBabTE2MC0xNjB2LTgwSDEyMHYtODBoMTYwdi04MGg4MHYyNDBoLTgwWm0xNjAtODB2LTgwaDQwMHY4MEg0NDBabTE2MC0xNjB2LTI0MGg4MHY4MGgxNjB2ODBINjgwdjgwaC04MFptLTQ4MC04MHYtODBoNDAwdjgwSDEyMFoiIGZpbGw9IiNmZmZmZmYiLz48L3N2Zz4%3D>
[img-rp]: <https://img.shields.io/badge/Resource_Packs-purple?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64% %3D>
[img-contribute]: <https://img.shields.io/badge/Support_and_Contribute-red?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgLTk2MCA5NjAgOTYwIiB3aWR0aD0iMjQiPjxwYXRoIGQ9Im00ODAtMTIwLTU4LTUycS0xMDEtOTEtMTY3LTE1N1QxNTAtNDQ3LjVRMTExLTUwMCA5NS41LTU0NFQ4MC02MzRxMC05NCA2My0xNTd0MTU3LTYzcTUyIDAgOTkgMjJ0ODEgNjJxMzQtNDAgODEtNjJ0OTktMjJxOTQgMCAxNTcgNjN0NjMgMTU3cTAgNDYtMTUuNSA5MFQ4MTAtNDQ3LjVRNzcxLTM5NSA3MDUtMzI5VDUzOC0xNzJsLTU4IDUyWiIgZmlsbD0iI2ZmZmZmZiIvPjwvc3ZnPg==>
[img-translate]: <https://img.shields.io/badge/Help_us_Translate-orange?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgLTk2MCA5NjAgOTYwIiB3aWR0aD0iMjQiPjxwYXRoIGQ9Im00NzYtODAgMTgyLTQ4MGg4NEw5MjQtODBoLTg0bC00My0xMjJINjAzTDU2MC04MGgtODRaTTE2MC0yMDBsLTU2LTU2IDIwMi0yMDJxLTM1LTM1LTYzLjUtODBUMTkwLTY0MGg4NHEyMCAzOSA0MCA2OHQ0OCA1OHEzMy0zMyA2OC41LTkyLjVUNDg0LTcyMEg0MHYtODBoMjgwdi04MGg4MHY4MGgyODB2ODBINTY0cS0yMSA3Mi02MyAxNDh0LTgzIDExNmw5NiA5OC0zMCA4Mi0xMjItMTI1LTIwMiAyMDFabTQ2OC03MmgxNDRsLTcyLTIwNC03MiAyMDRaIiBmaWxsPSIjZmZmZmZmIi8%2BPC9zdmc%2B>
[img-website]: <https://img.shields.io/badge/Official_Website-DBD0B5?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64% %3D>
[img-wiki]: <https://img.shields.io/badge/Read_the_Wiki-423E35?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64% %3D%3D>

<!-- URLs -->
[url-app-cf]: <https://curseforge.com/download/app>
[url-app-mmcu]: <https://wiki.download.fo/readme/multimc-auto-update>
[url-app-modrinth]: <https://modrinth.com/app>
[url-app-multimc]: <https://multimc.org>
[url-app-prism]: <https://prismlauncher.org>
[url-app-vanilla]: <https://minecraft.net/en-us/download>
[url-cf]: <https://download.fo/curseforge>
[url-credits-comp500]: <https://github.com/comp500>
[url-credits-comp500-Jumploader]: <https://curseforge.com/minecraft/mc-mods/jumploader>
[url-credits-comp500-Indium]: <https://modrinth.com/mod/indium>
[url-credits-comp500-packwiz]: <https://github.com/comp500/packwiz>
[url-credits-jellysquid3]: <https://github.com/jellysquid3>
[url-credits-jellysquid3-lithium]: <https://curseforge.com/minecraft/mc-mods/lithium>
[url-credits-jellysquid3-phosphor]: <https://curseforge.com/minecraft/mc-mods/phosphor>
[url-credits-jellysquid3-sodium]: <https://curseforge.com/minecraft/mc-mods/sodium>
[url-credits-Kichura]: <https://github.com/Kichura>
[url-credits-LambdAurora]: <https://github.com/LambdAurora>
[url-credits-LambdAurora-alternatives]: <https://lambdaurora.dev/optifine_alternatives>
[url-credits-LambdAurora-LambDynamicLights]: <https://curseforge.com/minecraft/mc-mods/lambdynamiclights>
[url-credits-RaptaG]: <https://github.com/RaptaG>
[url-credits-IMB11]: <https://github.com/IMB11>
[url-credits-vgskye]: <https://github.com/vgskye>
[url-credits-osfanbuff63]: <https://github.com/osfanbuff63>
[url-credits-Miroma]: <https://github.com/its-miroma>
[url-credits-translators]: <https://crowdin.com/project/fabulously-optimized/>
[url-credits-redbrain]: <https://github.com/redbrain>
[url-credits-RozeFound]: <https://github.com/RozeFound>
[url-credits-TheMadHau5]: <https://github.com/themadhau5>
[url-credits-TheYTG123]: <https://curseforge.com/members/theytg123/projects>
[url-credits-triphora]: <https://github.com/triphora>
[url-credits-Ultrasonic1209]: <https://github.com/Ultrasonic1209>
[url-discord]: <https://download.fo/discord>
[url-github]: <https://download.fo/github>
[url-github-main-graph]: <https://github.com/Fabulously-Optimized/fabulously-optimized/graphs/contributors>
[url-github-wiki-graph]: <https://github.com/Fabulously-Optimized/wiki/graphs/contributors>
[url-github-org]: <https://github.com/Fabulously-Optimized>
[url-install]: <https://download.fo/install>
[url-mastodon]: <https://download.fo/mastodon>
[url-modrinth]: <https://download.fo/modrinth>
[url-options]: <https://wiki.download.fo/readme/changed-options>
[url-rate]: <https://download.fo/rate>
[url-rp]: <https://wiki.download.fo/readme/changed-options#resource-packs>
[url-rp-crh-cf]: <https://curseforge.com/minecraft/texture-packs/chat-reporting-helper>
[url-rp-crh-modrinth]: <https://modrinth.com/resourcepack/chat-reporting-helper>
[url-rp-crh-pmc]: <https://planetminecraft.com/texture-pack/chat-reporting-helper>
[url-rp-fbg-cf]: <https://curseforge.com/minecraft/texture-packs/fast-better-grass>
[url-rp-fbg-modrinth]: <https://modrinth.com/resourcepack/fast-better-grass>
[url-rp-fbg-pmc]: <https://planetminecraft.com/texture-pack/fast-better-grass>
[url-terms]: <https://download.fo/terms>
[url-contribute]: <https://download.fo/contribute>
[url-translate]: <https://download.fo/translate>
[url-tutorial-cf]: <https://wiki.download.fo/install-instructions#curseforge-app>
[url-tutorial-mmcu]: <https://wiki.download.fo/install-instructions#multimc-auto-update>
[url-tutorial-mmcu-ignoremods]: <https://wiki.download.fo/multimc-auto-update#can-i-ignore-some-of-the-mods>
[url-tutorial-modrinth]: <https://wiki.download.fo/install-instructions#modrinth-app>
[url-tutorial-multimc]: <https://wiki.download.fo/install-instructions#multimc>
[url-tutorial-prism]: <https://wiki.download.fo/install-instructions#prism-launcher>
[url-tutorial-vanilla]: <https://wiki.download.fo/install-instructions#minecraft-launcher-vanilla>
[url-website]: <https://download.fo>
[url-wiki]: <https://download.fo/wiki>
