Eterea Obsidian
Simplified modpack management, automatic synchronization, and premium design.
Project Overview
Eterea Obsidian is a standalone desktop application that allows users to install, update, and launch Minecraft modpacks with a single click.
It eliminates the complexity of manual mod management, configuration files, and Forge versions, ensuring all players are always synchronized with the server's latest version.
Key Features
Automatic Synchronization
The launcher connects to a remote server downloading only necessary files. It verifies integrity via hashing to save bandwidth and intelligently manages "server-side only" mods.
Microsoft Authentication
Full integration with official Microsoft authentication to ensure secure and legitimate access.
Native Forge Support
Automatically installs and configures the correct Minecraft Forge version, handling library and official installer downloads without manual intervention.
Premium Obsidian Interface
Dark and modern design, inspired by obsidian and "Eterea" aesthetics, with glassmorphism effects. Intuitive dashboard for server selection and resource management.
EtereaSync
An essential utility mod designed for server administrators. Turns your Minecraft Forge server into an intelligent update hub.
Dynamic Manifest
Scans the mods folder in real-time and generates a JSON manifest with SHA-1 hashes for integrity verification.
Version Detection
Dynamically identifies Forge and Minecraft versions, ensuring clients always use the correct version.
Embedded HTTP Server
Starts a lightweight web server (port 3000) allowing launchers to download mods directly from the game server.
How to Use
Installation
Install the .jar file into your server's "mods" folder.
Startup
Start the server. The mod will automatically open the configured port and expose the /manifest endpoint.
// This console message indicates everything is ready
Synchronization
Enter the server IP address (e.g. http://your-ip:3000) into the Eterea Obsidian launcher to enable synchronization.
Important Note for Exaroton and Aternos Servers
If you host your game server on free or "on-demand" platforms like Exaroton or Aternos, read carefully:
These services block external connections for file downloads (HTTP/Web ports). You cannot use the server IP address (e.g., yourserver.exaroton.me) as the "Update URL" in the launcher, because the launcher will fail to download the mods.
Solution:
You must host the modpack files (mods + manifest.json) on an always-online external service. We highly recommend using GitHub (free) or any static web space.
- 1
Use the "Modpack Creator" in the Launcher settings to generate the files.
- 2
Upload everything to a public GitHub repository.
View example repository - 3
Use the GitHub "Raw" link as the URL in the launcher.
WARNING: Exaroton/Aternos users must NOT use the server IP for updates. Use GitHub or web hosting to host modpack files, otherwise the download will fail.