Minecraft: Java Edition mod

Relics Mod, mapped out for you

Relics adds wearable items with their own abilities, leveling and star-chart research. This codex explains what the mod does, which setup it needs and how to get your first relic working.

  • Forge & NeoForge
  • Needs Curios API + OctoLib
  • Free to download
Illustration of a faceted relic amulet floating above a light star chart and rolling terrain
Unique abilities Ability research Per-relic leveling

Codex entry: the mod

What is Relics Mod?

Relics is a Minecraft mod by Octo Studios that turns accessories into long-term companions. Each relic is built around unique abilities, grows through its own leveling system, and comes with randomized stats, so no two copies feel quite the same.

The authors describe it as a drag-and-drop mod with complex, carefully designed mechanics, where each relic can shine alone or in combination with other relics and even other mods. Recent builds add an ability research screen presented as constellations, which you complete before an ability works.

Relics is a Java Edition mod. It runs on Forge and NeoForge, depends on the Curios API for its equipment slots, and has required the OctoLib library since its 1.19.2 builds.

Along the route

Relics Mod features

Six things you will run into on a typical Relics playthrough, roughly in the order you meet them.

Relics with their own mechanics

Relics are designed around abilities rather than a single bonus number. Learning how each one behaves is a large part of the fun.

Leveling and randomized stats

Each relic levels up on its own, and its stats are rolled when it is created, so the same relic can be stronger or weaker in different hands.

Constellation research

An ability research screen shows abilities as star constellations. On recent builds, abilities need to be researched before they work.

Curios accessory slots

Relics are worn in the extra equipment slots provided by the Curios API, leaving your armor slots free.

Synergies with relics and mods

Relics are meant to combine. Pairing the right items, or adding compatibility addons for other mods, changes how strong a setup can be.

Active ability menu

Recent 1.21.1 builds include an active ability menu with semi-automatic control while holding the right mouse button.

The journey

How Relics Mod works, start to finish

Four checkpoints take you from an empty instance to a relic whose abilities actually fire.

  1. 1

    Check your version and loader

    Choose a Minecraft version with a Relics build and install the matching loader: NeoForge for 1.21.1, Forge or NeoForge for 1.20.1, Forge for older versions.

  2. 2

    Collect the dependencies

    Download Curios API and OctoLib builds that match your Minecraft version and loader.

  3. 3

    Add Relics to the mods folder

    Place the compiled Relics jar and its dependencies in the instance's mods folder, then launch the game.

  4. 4

    Explore, equip and research

    Find relics through exploration, equip them in Curios slots and research their abilities so they start working.

Who Relics Mod suits

Relics fits best where players want items that grow with them over a long run.

Long survival worlds

Per-relic leveling gives you a reason to keep and improve gear for hundreds of hours instead of replacing it.

Adventure modpacks

Relics found through exploration reward travelling to new structures, and addons extend that to other mods' bosses.

Multiplayer servers

Randomized stats and build choices mean players develop different relic setups, which makes trading and comparing more interesting.

Players who like systems

Research, upgrades and synergies give theory-crafters plenty to test, especially in a creative test world.

Before you pack

Relics Mod compatibility

Relics is a Java Edition mod for Forge and NeoForge. Match the Minecraft version, loader and dependency versions exactly.

Looking for Fabric? Read our Fabric explainer.

Relics Mod builds by Minecraft version and loader
Minecraft Loader Notes
1.21.1 NeoForge Where new content lands. Recent 0.12 files include beta releases.
1.20.1 ForgeNeoForge Older content set; no new features are back-ported.
1.19.2 Forge First version line that requires OctoLib.
1.18.2, 1.16.5 Forge Legacy builds.
Fabric / Quilt Not listed No Fabric or Quilt build in published listings.
Bedrock / Pocket Edition Not applicable Relics is a Java Edition mod.

Compiled from public mod platform listings. Always confirm against the file you download.

Installing Relics Mod

  1. Create an instance

    Install Forge or NeoForge for your chosen Minecraft version, or make a matching instance in your launcher, and launch it once.

  2. Add Curios API and OctoLib

    Use versions built for the same Minecraft version and loader as your Relics file.

  3. Add the compiled Relics jar

    Place the .jar in the mods folder. A source ZIP will not load; build it first or use a compiled release.

  4. Launch and check

    Curios slots should appear in your inventory. On servers, install the same versions on the server and every client.

Need the detail? Follow the full installation guide.

Satchel holding a relic gem with a download arrow

Download Relics Mod

This download is the Relics source code archive from the 1.21.0 branch of the Octo-Studios/relics repository on GitHub. It is intended for players and developers who want to read or build the mod themselves.

Source archive (.zip) Branch 1.21.0 Hosted on GitHub Java Edition
Download Relics Mod

The archive contains source code, not a ready-to-play jar. To play, build it as described in the installation guide or use a compiled release from the mod's platform page. You will also need Curios API and OctoLib.

Release information

Relics changes a lot between Minecraft versions: the authors note that every port is a major update. Changelogs live on each file's page, so read them before updating a world.

This site's download
Source archive, branch 1.21.0
Recent 1.21.1 builds
0.12 series on NeoForge, some marked beta
New content policy
Latest supported Minecraft version only
License
All Rights Reserved

Relics Mod pros and cons

What works well

  • Relics have distinct abilities rather than simple stat bonuses.
  • Leveling and randomized stats give long-term progression.
  • Uses standard Curios slots, so it fits alongside other accessory mods.
  • Addons extend it with more relics and other-mod integration.
  • Builds exist for several Minecraft versions.

What to weigh up

  • No Fabric or Quilt build is listed.
  • Needs extra dependencies to run.
  • New content only reaches the latest supported version.
  • Some recent 1.21.1 files are beta releases.
  • An unstable API means addons can break after updates.

Troubleshooting Relics Mod

Most problems trace back to setup. Find your symptom on the left.

Game stops with a missing mod message

Install Curios API and OctoLib versions that match your Minecraft version and loader.

Relics never appears in game

Check that you used a compiled .jar for the right loader, not the source ZIP or a jar for another loader.

Relic equipped, ability does nothing

Research the ability on the research screen. Recent builds require this before abilities work.

Crash after updating an addon

Install the Relics version the addon supports and update both together.

Kicked when joining a server

Match Relics, Curios and OctoLib versions exactly on the server and your client.

More fixes, with log tips, in the crash and error guide.

A note on safe downloads

Only install Minecraft mods from sources you trust, and be cautious with reuploads on unfamiliar sites, especially anything claiming to be an unofficial port. Relics is licensed All Rights Reserved, so mirrors are not approved by its authors.

relicsmod.com is an independent guide site and is not affiliated with Octo Studios, Mojang or Microsoft. Back up your worlds before installing or updating any mod.

Index of questions

Relics Mod FAQ

Twenty answers in two chapters. Use the arrow keys to move between questions.

Setup & compatibility

Relics, research & gameplay