Midgard Hub

Midgard Hub is Alfheim's project center and the first interface you see when launching the engine. It handles project creation, management, and global configuration.

Feature Overview

• Recent projects list: Quickly open previously used projects
• New project: Create new projects from templates
• Project template browsing
• Norn novel import (coming soon)
• Global settings: Language, paths, theme

Interface Layout

The Hub consists of a left navigation bar and a right content area.

Navigation Bar

The left navigation bar contains the following entries:

At the bottom there are also:

• Theme toggle (dark/light mode)
• Documentation link
• Version number display

Project Management

Recent Projects

When you open the Hub, the recent projects list is displayed by default, showing projects you have previously opened or created.

Each project entry displays:

• Project name
• Project path
• Last modified time

Opening a Project

• From list: Click any project in the recent projects list.
• Browse: Click the Add button and locate the project folder in the file picker.

Opening a project will open a separate editor window. You can open multiple projects simultaneously; each project is edited in its own window. If you try to open an already open project, the Hub will automatically focus the corresponding editor window.

Searching Projects

Use the search box to quickly find recent projects by name.

Pinning Projects

Important projects can be pinned to the top of the list so they are not pushed down by new projects. Click the pin button on a project. Click again to unpin.

Removing Projects

Removing a project from the list does not delete the project files; it simply no longer appears in recent projects.

Creating a New Project

1. Click the New Project button.
2. In the dialog that appears, fill in:
   • Project Name: Your game name.
   • Storage Directory: Click browse to select a directory; the project will create a folder with the same name in that directory.
   • Project Template: Select a starting template.
3. Click Create.

Available Templates

Template Library

Browse all available project templates in the Templates tab to learn each template's name and description.

Norn (Coming Soon)

Norn is a planned novel import feature that supports automatically extracting characters, worldview, and story structure from novel files in EPUB, TXT, and PDF formats, generating ready-to-play projects.

Expected workflow:

1. Import novel file
2. AI parsing and analysis
3. Review extracted characters
4. Review extracted worldview
5. Review extracted story structure
6. Generate project

This feature will be released in a future version.

Global Settings

Configure in the Settings tab:

Interface Language

Switch the engine's interface display language. After changing, the interface language for both the Hub and all editor windows will update in sync.

Default Project Path

Set the default storage directory when creating new projects.

Hub and Editor Relationship

• The Hub is the main window and stays open at all times.
• Each open project has its own editor window.
• Closing an editor window closes that project; the Hub remains running.
• Closing the Hub exits the entire Alfheim application.

Tips

• Develop the habit of pinning frequently used projects to save time finding them each time you open.
• Project name and settings can be modified in the editor at any time after creation; you don't need to finalize everything when creating.
• The Hub supports opening multiple projects simultaneously, making it convenient to reference and reuse content across different projects.