CurseForge · Minecraft mod
Somnium API
A highly customizable Power and Ability API, for those who can dream it possible.
Quick answer
Which Somnium API release should I use?
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.
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.
This file does not list any required mods. Do not add a library just because a different file uses it.
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.
- 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.
- 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.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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.20.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Somnium API versions and loaders
Somnium API 1.0.4
somnium-1.0.4.jar
2 Jun 2026
Somnium API 1.0.3
somnium-1.0.3.jar
2 Jun 2026
Somnium API 1.0.2
somnium-1.0.2.jar
17 May 2026
1.0.1
somnium-1.0.1.jar
15 May 2026
somnium-1.0.0.jar
12 May 2026
Looking for an older file? The official CurseForge project page is in Resources.