Minecraft

How to Install and Use the Supplementaries Mod for Minecraft

Minecraft·May 20, 2026·28 min read

What Supplementaries Adds

Supplementaries is a Minecraft mod for players who like vanilla gameplay but keep noticing small gaps in building, storage, decoration, redstone, and exploration. It adds useful blocks, interactive decorations, odd tools, and a few clever machines without turning the game into a completely different experience.

The mod is available for Forge and Fabric, although the Forge version usually has the fuller feature set. On Fabric, you should also install Fabric API. On both loaders, Moonlight Lib is required. Missing that dependency is the classic way to make Minecraft refuse to cooperate.

This guide covers downloading Supplementaries, installing it on your client and server, trying the main features, changing its configuration, and fixing the most common problems.

Downloading the Mod Files

Start by downloading the mod files that match your Minecraft version and mod loader.

  1. Open the Supplementaries page on CurseForge and select Files near the top.
  1. Find the file for the Minecraft version you plan to use.
  2. Open the file menu, then choose Download File.
  1. Save the file somewhere easy to find.
  2. Repeat the process for Moonlight Lib, which Supplementaries needs to run.

If you are using Fabric, download Fabric API as well. The same versions should be used on the server and every player client. Mixing Forge and Fabric files, or using a mod built for a different Minecraft version, usually ends with a crash before anyone gets to admire the fancy furniture.

Installing Supplementaries on Your Client

Every player who joins the server must install the same mod loader and matching mod files locally. Set up Forge or Fabric in the Minecraft Launcher first, then add the files.

  1. Open the Minecraft Launcher and go to Installations.
  1. Find your Forge or Fabric profile and click the folder icon.
  1. Open the `mods` folder. If it does not exist yet, create a folder named `mods`.
  2. Move the Supplementaries, Moonlight Lib, and Fabric API files into that folder as needed.
  1. Return to the launcher, choose the modded profile, and press Play.

Once Minecraft reaches the main menu, the client side is ready. If the game crashes here, check that every `.jar` file matches the same Minecraft version and loader.

Installing Supplementaries on a Minecraft Server

The server also needs Forge or Fabric enabled before the mod files are uploaded. In the HolyHosting control panel, select the matching server type, restart once to generate the required folders, then upload the mods.

  1. Open your server panel and go to the file access area.
  1. Log in with your panel password if prompted.
  1. Open the `mods` directory.
  2. Upload the Supplementaries file and its required dependencies.
  1. Wait until each upload reaches 100 percent, then restart the server.

The client and server should use the same mod files. If one player has a different version, Minecraft may reject the connection or show a mismatched mod list error.

First Steps In Game

After joining the server, you can begin crafting and placing the new blocks from Supplementaries. Installing JEI or a similar recipe viewer is strongly recommended because the mod adds enough recipes that guessing them by hand becomes more archaeology than gameplay.

Start by gathering familiar materials such as wood, wool, cobblestone, bricks, blackstone, and lapis. Some recipes also use newer or less common materials, including ash from loot chests in generated structures. Once you have basic supplies, the mod opens up a large set of building, decoration, storage, redstone, and utility options.

New Building Blocks

Supplementaries adds several block variants that fit naturally beside vanilla materials. Examples include Blackstone Tiles, Lapis Bricks, Ash Bricks, Checker Blocks, and Stone Tiles. These are useful for bases that need more detail without switching into a completely different visual style.

Some recipes are simple conversions from existing blocks, while others need specific materials. Ash, for example, can appear in lootable chests inside mineshafts and other generated structures. The result is a block set that rewards exploration but still feels grounded in normal survival progression.

Decorations and Storage

Decorations are one of the main reasons to install Supplementaries. Many are not just static props. A Pedestal can display held items, Sacks and Vaults provide storage alternatives, and other blocks add small interactive details to rooms, shops, libraries, and workshops.

There are also stranger options, including Goblets that can hold potions, Globes that can be spun, and Blackboards that support drawings. These pieces are especially useful for multiplayer towns, roleplay builds, or any base that needs more personality than another wall of barrels.

Redstone and Machines

Supplementaries also includes redstone-friendly blocks for players who like automation and movement. Cog Blocks, Relayers, Spring Launchers, Speakers, and Turn Tables can be used in contraptions that move blocks, trigger sounds, rotate entities, or extend vanilla redstone designs.

These systems can become complex quickly, so the official wiki is worth checking when a block has behavior that is not obvious from the recipe alone. Start with a small test setup before wiring it into your main base, especially on servers where one overexcited machine can make everyone ask why the world suddenly feels like syrup.

Useful Items to Try

Supplementaries is not limited to blocks. It also adds tools and playful items that can help with exploration, combat, and general server chaos. The following are good early examples.

Bubble Blower

The Bubble Blower creates bubbles for a simple visual effect, but it becomes more useful when combined with the Stasis enchantment. With that enchantment, it can create large bubbles that provide air underwater.

The item requires iron materials to craft and Soap to refill durability. It is not the most powerful tool in the mod, but it is memorable and occasionally practical.

Rope Arrow

Rope Arrows are excellent for caves, cliffs, and quick vertical escapes. Shoot one into a block and it drops rope downward, giving players a fast climbing path. It can also push objects out of its route, which leaves room for creative uses in maps or builds.

Crafting one requires Rope and a normal Arrow. Keep extra Rope available because the item has durability and needs to be replenished.

Bombs

Bombs come in normal and blue variants. The normal version creates a smaller explosion, while the blue version has a larger delayed effect. These items damage entities and fragile decorations, but they do not destroy normal terrain blocks.

That makes them useful for clearing hostile mobs or having controlled fun with friends without turning the base into a crater field. Still, test them somewhere unimportant first. Decorative blocks are not known for their bravery.

Building With Supplementaries

The best way to use Supplementaries is to combine its parts with vanilla building habits. Add shelves, pedestals, blackboards, and custom blocks to rooms that already have a purpose. Use the redstone parts for small machines before scaling up. Bring Rope Arrows into caves, and keep storage decorations in areas where players naturally gather resources.

The mod works well in survival bases, adventure maps, shops, taverns, libraries, farms, and multiplayer hubs. It gives builders more texture and interaction without requiring everyone on the server to learn an entirely new progression system.

Changing the Configuration

If a block or item behaves in a way that does not fit your server, you can adjust the configuration. Server owners can toggle features and edit values such as certain item behaviors or explosion settings.

The exact options can differ between Forge and Fabric, so read the config names carefully before changing values.

  1. Open the server file access area and log in.
  2. Enter the `config` directory.
  3. Find `supplementaries-common.json` and open it for editing.
  1. Change the settings you need, then save the file.
  1. Restart the server so the changes take effect.

Make small changes first and keep a backup of the file before major edits. A single incorrect value can prevent the server from starting, which is not the kind of mystery anyone wants at midnight.

Common Problems

If players cannot join the server, first confirm they are using the correct server address and port or the correct subdomain. Then check whether the server was restarted after the mod files were uploaded.

If the server or launcher fails to start, verify these points:

  • Supplementaries is installed on both the client and server.
  • Moonlight Lib is installed on both sides.
  • Fabric API is installed when using Fabric.
  • All files match the same Minecraft version.
  • The client and server are using the same loader type.

World generation can also matter. Since Supplementaries adds loot and some generated content, creating a fresh world may be useful when testing the mod from scratch.

Performance issues are usually tied to heavy modded servers, complicated redstone machines, or too many active contraptions in loaded chunks. Reduce oversized machines, add performance mods that match your loader, and review server resource usage if lag appears after large builds are added.

Helpful Resources

  • Supplementaries on CurseForge
  • Official Supplementaries wiki
  • Guide to adding mods to a Minecraft server
  • Guide to becoming a Minecraft server operator

Still have questions?

Come chat with us and we will get back to you as soon as possible!

Contact Support