Back to mods
Somnium API project artwork

CurseForge · Minecraft mod

Somnium API

A highly customizable Power and Ability API, for those who can dream it possible.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Somnium API release should I use?

Updated 5 months ago
Latest stable file Somnium API 1.0.4
Game version 1.20.1
Loader Forge

Somnium API 1.0.4 targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Somnium API required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Somnium API 1.0.4 need?

Somnium API 1.0.4. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

Curios API Optional for Somnium API 1.0.4
optional
Matching file found Matched file: curios-forge-5.14.1+1.20.1.jar
GeckoLib Optional for Somnium API 1.0.4
optional
Matching file found Matched file: geckolib-forge-1.20.1-4.8.4.jar
Pehkui Optional for Somnium API 1.0.4
optional
Matching file found Matched file: [1.20.1] [Forge] Pehkui 3.8.2

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Somnium API without breaking your instance.

Built for Somnium API 1.0.4. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Somnium API 1.0.4. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Somnium API 1.0.4. It opens that exact file at the source.

About this project

What does Somnium API add?

A highly customizable Power and Ability API, for those who can dream it possible.

What Somnium Provides

Powers & Abilities — A complete ability system with five activation types (Instant, Toggle, Hold, Charged, Passive), groupable into Powers with configurable unlock conditions. Includes a drag-and-drop ability inventory, a 6-slot HUD bar with paging, and customizable categories.

Stamina & Overuse — A universal stamina resource that drains when abilities are used and regenerates over time. Pushing too far triggers the Overuse system — a three-stage penalty that discourages ability spam while creating meaningful risk-reward decisions.

Composition — A permanent growth stat unique to each player. Composition increases through gameplay (ability usage, stamina recovery, overuse survival) and directly expands the player's stamina capacity. Diminishing returns ensure no hard cap while maintaining balance.

Power Leveling — Optional per-power XP and leveling. Abilities can require minimum power levels to unlock, and XP is earned through ability usage within that power.

Custom Meters — A flexible value system for addon developers to create their own resources (mana, rage, focus, etc.) with independent drain, regen, and scaling.

Transformations — A dedicated ability type for shapeshifting, with phase transitions, visual data hooks, and automatic inventory management.

Tag System — A lightweight labeling system for gating abilities behind conditions. Tags can be granted by items, events, curios, or any custom logic.

Optional Compatibility — First-class integration with GeckoLib 4, Curios API, and Pehkui. All optional — Somnium works without any of them.

Project description from CurseForge.

Pick your setup

Somnium API by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Somnium API versions and loaders

5 of 5 releases match

Looking for an older file? The official CurseForge project page is in Resources.