<div align="center"> <a href="https://github.com/skywardmc/adrenaline"> <img src="https://skywardmc.org/branding/adrenaline/text-logo.png" alt="Adrenaline" height="90"> </a> <br /> <br /> <p align="center"> A lightweight, open-source performance modpack for Fabric <br /> <a href="https://skywardmc.org/adrenaline">Explore the wiki</a> · <a href="https://github.com/skywardmc/adrenaline/issues">Report Bugs</a> · <a href="https://github.com/skywardmc/adrenaline/issues">Request Features</a> </p> </div>

Adrenaline is a client-side or server-side modpack, developed for Fabric, comprised of the best combination of mods (e.g. Sodium and Lithium, along with many more) that significantly improves rendering performance, logic performance, memory usage, and more - all without compromising on the game's vanilla looks and features!

It is designed to be simple and not include any quality-of-life mods, along with not including redundant performance mods. Because of this simplicity, the modpack is compatible with a very wide range of devices and can be updated to the latest versions very quickly. Want more features? No problem! Adrenaline serves as a great foundation for performance - simply add your favorite mods on top.

For the list of mods that are included, see this wiki page. Adrenaline can be installed on both clients and servers, so this list tells you what is installed depending on the environment.

📥 Installation Guide

Please be sure to read Sodium's Driver Compatibility section on the wiki before installing Adrenaline. It contains some important instructions on preventing crashes and other performance issues.

If you would like to install the modpack, go to this page on the SkywardMC website. You can install the modpack with a third party launcher or our standalone installer. After you install, you can figure out how to tweak things to give greater optimizations in the post-install section of the wiki. This includes procedures such as increasing your allocated memory and tweaking your game settings for your device.

After installing the modpack, you can easily add your favorite mods so long as they are compatible with the Minecraft version you are playing on. The wiki also has some recommendations on possibly improving performance further with other mods that are not suitable to be included in Adrenaline by default.

<details> <summary>Installing Adrenaline on a server</summary>

Adrenaline also optionally functions server-side! We now use Modrinth's mrpack environment feature to install the proper mods for the correct environment. Client-side mods that are part of Adrenaline will not be installed through these methods. The server portion of this modpack was previously known as Adrenaserver.

<details> <summary> 🏷️ Install using Aternos </summary>

You can get a low-power, free server at Aternos. However, it is often a bit slow on vanilla Minecraft without any performance patches. Aternos supports installing Adrenaline by going to Software -> Change -> Modpacks -> Modrinth -> Adrenaline, which will speed up your server by quite a lot without affecting vanilla behavior.

</details> <details> <summary> 📦 Install using mrpack-install </summary>

Download mrpack-install through GitHub releases (or your distro's package if it has one) and take a look at the commands on the README. In Adrenaline's case, to install in your server you would run:

mrpack-install adrenaline [optional version number]

</details> <details> <summary> 🐋 Install using Docker Compose </summary>

It's a good idea to have some knowledge on using Docker before doing this.

1. Make sure you have Docker Engine installed properly according to the Docker docs
2. Create a new directory
3. Place the contents below in a file called docker-compose.yml. This Compose file also contains some other server tweaks meant for performance, such as disabling sync-chunk-writes, reducing render and simulation distance, and more
4. Run docker compose up -d in that directory

For any other information, you can read through the Docker Minecraft Server documentation.

services:
  mc:
    image: itzg/minecraft-server
    tty: true
    stdin_open: true
    ports:
      - "25565:25565"
    environment:
      EULA: "TRUE"
      # Adrenaline and other mods
      MOD_PLATFORM: MODRINTH
      MODRINTH_DOWNLOAD_DEPENDENCIES: required
      MODRINTH_MODPACK: adrenaline # this installs the latest version of Adrenaline, you can also use a specific MR link to a version
      MODRINTH_PROJECTS: spark, chunky # comma separated list of extra mods
      # Server properties
      VIEW_DISTANCE: 8
      SIMULATION_DISTANCE: 5
      SYNC_CHUNK_WRITES: false # having this set to false will significantly improve performance but may cause desync issues and (extremely rare) data corruption. set to true if you don't have a backup system
    volumes:
      # Attach the relative directory 'data' to the container's /data path
      - ./data:/data

</details> <details> <summary> ✨ Install using mcman </summary>

mcman is a tool for managing the mods/plugins/configurations of a Minecraft server. First, install mcman from releases. To import Adrenaline while initializing a server, use this command:

mcman init --mrpack mr:adrenaline

After initializing and importing the mrpack, run mcman build to build the server into the server/ directory, from which you can call cd server && sh start.sh or cd server && call start.bat. For more information, check out mcman's docs.

</details> <details> <summary> 💿 Install using mrpack4server </summary>

See the mrpack4server Git repository for installation info. modpack-info.json:

{
	"project_id": "adrenaline",
	"version_id": "version id or name"
}

</details> <details> <summary> 🧙 Install using packwiz-installer </summary>

Before doing any of this, be sure to have a backup of the server in case anything goes wrong.

packwiz-installer is a useful tool that lets you automatically install and update a modpack through the pack.toml file of that pack.

Some server hosts may let you set a command that runs before the server actually starts. It's called a pre-launch command. I can't exactly help if you are using an external server provider as many don't support pre-launch commands or require you to supply your own jar file that will run the command.

First, you need to install packwiz-installer-bootstrap from here. After that, move it to the same folder as your server's Fabric loader jar. This will usually be the root of the server.

You may change the MC version of the modpack (available versions only).

java -jar packwiz-installer-bootstrap.jar -g -s server https://raw.githack.com/intergrav/Adrenaline/main/versions/fabric/1.21.1/pack.toml

If you are running this server through a batch file or shell script, you can add this command before your server's launch command and it should work just fine.

Having trouble? Check out the packwiz wiki and, if that doesn't help, ask in the packwiz Discord server.

</details> </details>

⭐ Features

🚀 Major performance improvement

Adrenaline aims to significantly improve rendering and game logic performance, along with memory and hardware usage, without compromising on the game's looks or features in any way. This is done with various optimization mods that are actively tested for stability and improvement. Some mods are also pre-configured. Adrenaline wouldn't exist without projects like Sodium, so I advise you to donate to mod authors and contributors if you can.

For the list of performance mods that are included, see this wiki page. Adrenaline can be installed on both clients and servers, so this list tells you what is installed depending on the environment.

🪶 Lightweight

I only pick the combination of mods that work best with eachother, and don't include performance mods that aren't necessary or often break compatibility with other mods or device hardware. I also don't include any quality of life mods in the pack for the sole purpose of keeping it simple and flexible. This simplicity allows you to very easily build your own modpacks based on Adrenaline, or simply install Adrenaline and play wi