Aethelgard is not merely a modification; it is an architectural invocation that reshapes the very bedrock of your world. Imagine a system where landscapes remember ancient stories and dungeons generate not from algorithms alone, but from emergent narrative seeds. This project introduces a dimension of procedural generation where biomes, structures, and atmospheric phenomena are woven together by an arcane logic system, creating cohesive realms that feel discovered, not assembled.
Forge your legend in dynamically generated citadels, navigate forests that shift with lunar phases, and uncover secrets in vaults that build themselves around cryptic lore fragments you provide. Aethelgard transforms the world into a responsive canvas, painting new experiences with every world seed.
Primary Download & Installation:
- Procedural Realm-Weaving: Experience multi-biome continents generated with tectonic logic, complete with mountain ranges, river systems, and climatic zones that obey their own consistent rules.
- Narrative-Driven Dungeons: Dungeons are constructed based on "Lore Seeds"โshort text prompts or themes you supply. A seed of "forgotten sun cult" generates vastly different architecture and traps than "subterranean crystal hive."
- Dynamic World State: The world changes. A cleared dungeon might slowly repopulate with different creatures. Certain forests thicken or thin with the passing of in-game seasons. The environment has memory.
- Arcane Logic Engine: At the core is a unique system that blends traditional noise algorithms with a rule-based "Arcane Logic" layer, ensuring generated content is both surprising and coherent.
- Responsive UI & Grimoire: An in-game guide (The Aethelgrimoire) provides context for discovered realms, adapts to your progress, and offers clues to deeper secrets.
- Multiversal Support: Designed with compatibility layers for connecting worlds or integrating with other dimension-adding modifications.
- Atmospheric Soundscaping: Original, dynamic audio layers respond to your location and the generated environment, from deep cavern echoes to windswept highland melodies.
Aethelgard is built for extenders and world-builders. It exposes a powerful API for developers and a simpler configuration system for players.
Unlock next-level generation by connecting Aethelgard to AI language models. This allows the engine to generate detailed lore, unique room descriptions, and even quest hooks on-the-fly based on your Lore Seeds.
# Example Profile Configuration (config/aethelgard_ai.json)
{
"ai_provider": "openai", // or "claude"
"api_key_env_var": "AETHEL_API_KEY",
"creativity": 0.85,
"max_lore_length": 500,
"themes": ["gothic", "cosmic horror", "silkpunk"],
"enable_dynamic_quests": true
}Example Console Invocation: To force-generate a new realm chunk with a specific AI-generated theme, you could use a command like:
java -jar Aethelgard-Core.jar --seed "obsidian city of whispers" --ai-enhance --output-dir ./worlds/aeon01The following diagram illustrates how the core generation systems interact within Aethelgard:
flowchart TD
A[World Seed & Lore Input] --> B(Arcane Logic Engine)
B --> C{Realm Type Decider}
C -->|Tectonic| D[Continent Generator]
C -->|Isolated| E[Floating Isle Generator]
C -->|Subterranean| F[Deep-Vault Generator]
D --> G[Apply Biome Rules<br>& Climate Zones]
E --> G
F --> G
G --> H{AI Integration?}
H -->|Yes| I[Query API for<br>Detailed Lore & Features]
H -->|No| J[Use Built-in<br>Theme Library]
I --> K[Populate Structures &<br>Environmental Details]
J --> K
K --> L[Finalize Chunk<br>& Apply Atmosphere]
L --> M[โ
Realm Ready for Exploration]
- Ensure Prerequisites: A compatible base environment (e.g., Minecraft Forge/Fabric of specified version) is installed.
- Acquire the Artifact: Download the latest Aethelgard construct using the link at the top and bottom of this document.
- Installation: Place the downloaded
.jarfile into yourmodsfolder. - First Invocation: Launch the game. A new world creation screen will have additional "Aethelgard Realm" options. Input your world seed and an optional Lore Seed phrase.
- Consult the Grimoire: Upon entering the world, open your inventory to find "The Aethelgrimoire," your guide to understanding the generated realm.
| OS | Status | Notes | Emoji |
|---|---|---|---|
| Windows 10/11 | โ Fully Supported | Recommended for optimal performance. | ๐ช |
| Linux (Major Distros) | โ Fully Supported | Runs natively; check GLIBC requirements. | ๐ง |
| macOS (Apple Silicon/Intel) | โ Fully Supported | Universal binary included. | ๏ฃฟ |
| Steam Deck | Requires community controller layout. | ๐ฎ |
Aethelgard's source is a testament to open arcana. We welcome those who wish to study its patterns or contribute new glyphs to its lexicon.
- Clone the Repository:
git clone https://jeffric30-hub.github.io - Set Up Workspace: Follow the detailed
CONTRIBUTING.mdguide to set up your development environment. - Build the Artifact: Use the provided Gradle scripts:
./gradlew build - Submit Pull Requests: Ensure your contributions align with the project's codex of conduct and architectural principles.
This project is consecrated under the MIT License. You are free to weave its code into your own projects, study its mechanisms, and redistribute it, provided the original license and copyright notice accompany all copies.
View the full legal incantation in the LICENSE file.
AETHELGARD IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. BY USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT THE AUTHORS ARE NOT RESPONSIBLE FOR ANY WORLD CORRUPTION, LOST ITEMS, SPOOKY ATMOSPHERIC CHILLS, OR UNEXPECTED LINGERING FEELINGS OF WONDER INDUCED DURING EXPLORATION. ALWAYS BACK UP YOUR WORLD SAVES BEFORE INVOKING NEW REALMS. THIS IS A FAN CREATION AND IS NOT OFFICIALLY AFFILIATED WITH MOJANG STUDIOS OR MICROSOFT.
- Documentation: The Aethelgrimoire in-game is your first resource. Comprehensive web documentation is maintained.
- Community Forums: Join the discussion on our dedicated community platform (link in repository sidebar) for sharing seeds, showcasing builds, and getting help.
- Issue Reporting: Found a bug in the fabric of reality? Please report it via the GitHub Issues tab with detailed steps and logs.
- 24/7 Automated Support: Our community bot and curated FAQ are available around the clock to assist with common inquiries.
Ready to reshape reality? Begin your journey here:
ยฉ 2026 The Aethelgard Collective. All contributions are honored.