Skip to content

Latest commit

 

History

History
180 lines (122 loc) · 12.1 KB

README.md

File metadata and controls

180 lines (122 loc) · 12.1 KB
Logo

Leading, lightweight, and unbiased performance modpack with no QoL features
Explore the wiki · Report Bugs · Request Features

Available on Modrinth Chat on Discord Ready for Gitpod

Adrenaline is a client-side or server-side modpack 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.

Installing Adrenaline on a server

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.

📦 Install using mrpack-install

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]
🐋 Install using Docker Compose

It may be 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
    volumes:
      # Attach the relative directory 'data' to the container's /data path
      - ./data:/data
✨ Install using mcman

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.

🧙 Install using packwiz-installer

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.

🎯 Goals

🚀 Improve performance

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.

🪶 Stay 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 with your favorite mods.

⚙️ Source-available

All mods in Adrenaline are either open-source or source-available, which means you can view the code of mods and see exactly what they are doing. Adrenaline is also available as packwiz projects on GitHub so that you can easily view what's being changed, contribute if you would like to, or fork the modpack to create your own project. If you would like to view the mods shipped with Adrenaline, simply look at the dependencies in the Modrinth page or look in the Git repository.

✅ Hardware Compatibility

Adrenaline supports the use of graphics cards with drivers that are compatible with OpenGL 4.6. Most graphics cards released in 2010 or later are compatible. This includes the following hardware:

  • Intel HD Graphics 500 Series (Skylake) or newer
  • Nvidia GeForce 400 Series (Fermi) or newer
  • AMD Radeon HD 7000 Series (GCN 1) or newer

In some cases, older graphics cards may also work (as long as they have drivers which support OpenGL 3.3) but they are not officially supported and may not be compatible in the future.

Android devices that use OpenGL translation layers (such as GL4ES, ANGLE, etc) are not supported and will likely not work with Adrenaline's set of mods. These translation layers do not implement required functionality and suffer from underlying driver bugs which cannot be worked around.

If you are running into problems, you should make sure that your graphics drivers are up-to-date. I also recommend taking a look at this page on the Sodium wiki.

The majority of this was taken from Sodium's hardware compatibility section. I'll update this accordingly if anything is changed.

🐛 How to Report Issues

Experiencing bugs, crashes, or other issues? Feel free to open an issue on the issue tracker. Be sure to include necessary information like your hardware/software (e.g. GPU and CPU, modpack version and OS) so that it's easier for us to find issues and resolve them.

❓ Frequently Asked Questions

For a few frequently asked questions, along with tons of other information, consider visiting the wiki. It has a few other helpful resources that I suggest you read, such as troubleshooting info and more. This wiki is often updated with new information.

🍉 Sponsor

Need a fast, reliable Minecraft server? Feel free to use my code devin for 25% off your first month of any server from Bisect Hosting, supporting me in the process. Click this banner for more information. You can also setup my server-side performance pack called Adrenaserver to improve your server's optimization while still allowing vanilla clients to join.

Bisect Hosting Image

Adrenaline's description is heavily inspired by Sodium's description and also includes some information from them. Description last updated: March 25, 2024