From abed8dc3031e216a986028382f4be24a3d44ce46 Mon Sep 17 00:00:00 2001
From: Stone_Red <56473591+Stone-Red-Code@users.noreply.github.com>
Date: Sat, 3 Feb 2024 13:20:09 +0100
Subject: [PATCH] Add basic level generation

---
 src/TextLore.sln                              |   2 +-
 src/TextLore/Components/Pages/Home.razor      |   5 +-
 src/TextLore/Components/Shared/Console.razor  |  29 ++++-
 src/TextLore/Components/_Imports.razor        |   4 +-
 src/TextLore/{Models => Console}/Command.cs   |   2 +-
 src/TextLore/Console/CommandResult.cs         |  39 +++++++
 .../{ => Console}/Commands/ClearCommand.cs    |   8 +-
 .../{ => Console}/Commands/HelpCommand.cs     |  10 +-
 .../{ => Console}/Commands/TestCommand.cs     |   6 +-
 .../{Models => Console}/ConsoleInput.cs       |   2 +-
 .../{Models => Console}/ConsoleMessageType.cs |   2 +-
 .../{Models => Console}/ConsoleOutput.cs      |   2 +-
 .../ConsoleOutputEventArgs.cs                 |   2 +-
 .../{Models => Console}/ConsoleWriter.cs      |  23 +++-
 src/TextLore/Database/GamesDatabaseContext.cs |   8 ++
 .../Commands/GenerateLevelCommand.cs          |  96 +++++++++++++++++
 .../Games/Roguelike/Logic/LevelGenerator.cs   | 100 ++++++++++++++++++
 src/TextLore/Games/Roguelike/Models/Level.cs  |  59 +++++++++++
 src/TextLore/Games/Roguelike/Models/Room.cs   |  10 ++
 .../Games/Roguelike/Models/RoomDefinition.cs  |  14 +++
 .../Games/Roguelike/RoguelikePage.razor       |   6 ++
 .../Games/Roguelike/RoguelikePage.razor.cs    |  43 ++++++++
 src/TextLore/Games/_Imports.razor             |  14 +++
 src/TextLore/Models/CommandResult.cs          |  22 ----
 src/TextLore/Program.cs                       |  40 +++++--
 src/TextLore/TextLore.csproj                  |   5 +
 .../Utilities/Logic/DeterministicRandom.cs    |  95 +++++++++++++++++
 src/TextLore/Utilities/Models/Direction.cs    |  15 +++
 .../Utilities/Models/PercentageProgress.cs    |   9 ++
 src/TextLore/Utilities/Models/Position.cs     |  27 +++++
 src/TextLore/Utilities/Models/Size.cs         |   7 ++
 src/TextLore/appsettings.Development.json     |  15 +--
 src/TextLore/games.sqlite                     | Bin 0 -> 12288 bytes
 src/TextLore/games.sqlite-shm                 | Bin 0 -> 32768 bytes
 src/TextLore/games.sqlite-wal                 |   0
 src/TextLore/wwwroot/app.css                  |  12 +--
 src/TextLore/wwwroot/console.css              |  10 ++
 37 files changed, 668 insertions(+), 75 deletions(-)
 rename src/TextLore/{Models => Console}/Command.cs (92%)
 create mode 100644 src/TextLore/Console/CommandResult.cs
 rename src/TextLore/{ => Console}/Commands/ClearCommand.cs (68%)
 rename src/TextLore/{ => Console}/Commands/HelpCommand.cs (86%)
 rename src/TextLore/{ => Console}/Commands/TestCommand.cs (74%)
 rename src/TextLore/{Models => Console}/ConsoleInput.cs (81%)
 rename src/TextLore/{Models => Console}/ConsoleMessageType.cs (72%)
 rename src/TextLore/{Models => Console}/ConsoleOutput.cs (86%)
 rename src/TextLore/{Models => Console}/ConsoleOutputEventArgs.cs (87%)
 rename src/TextLore/{Models => Console}/ConsoleWriter.cs (69%)
 create mode 100644 src/TextLore/Database/GamesDatabaseContext.cs
 create mode 100644 src/TextLore/Games/Roguelike/Commands/GenerateLevelCommand.cs
 create mode 100644 src/TextLore/Games/Roguelike/Logic/LevelGenerator.cs
 create mode 100644 src/TextLore/Games/Roguelike/Models/Level.cs
 create mode 100644 src/TextLore/Games/Roguelike/Models/Room.cs
 create mode 100644 src/TextLore/Games/Roguelike/Models/RoomDefinition.cs
 create mode 100644 src/TextLore/Games/Roguelike/RoguelikePage.razor
 create mode 100644 src/TextLore/Games/Roguelike/RoguelikePage.razor.cs
 create mode 100644 src/TextLore/Games/_Imports.razor
 delete mode 100644 src/TextLore/Models/CommandResult.cs
 create mode 100644 src/TextLore/Utilities/Logic/DeterministicRandom.cs
 create mode 100644 src/TextLore/Utilities/Models/Direction.cs
 create mode 100644 src/TextLore/Utilities/Models/PercentageProgress.cs
 create mode 100644 src/TextLore/Utilities/Models/Position.cs
 create mode 100644 src/TextLore/Utilities/Models/Size.cs
 create mode 100644 src/TextLore/games.sqlite
 create mode 100644 src/TextLore/games.sqlite-shm
 create mode 100644 src/TextLore/games.sqlite-wal

diff --git a/src/TextLore.sln b/src/TextLore.sln
index 8175d64..f54db4e 100644
--- a/src/TextLore.sln
+++ b/src/TextLore.sln
@@ -3,7 +3,7 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
 VisualStudioVersion = 17.8.34511.84
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TextLore", "TextLore\TextLore.csproj", "{1F935415-BA18-42C8-B210-D6195F93A719}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TextLore", "TextLore\TextLore.csproj", "{1F935415-BA18-42C8-B210-D6195F93A719}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
diff --git a/src/TextLore/Components/Pages/Home.razor b/src/TextLore/Components/Pages/Home.razor
index fb74bde..1802ce1 100644
--- a/src/TextLore/Components/Pages/Home.razor
+++ b/src/TextLore/Components/Pages/Home.razor
@@ -1,9 +1,8 @@
 @page "/"
 
-
 <PageTitle>TextLore</PageTitle>
 
-<Console Name="Main Menu" Commands="commands" HelpCommand="helpCommand" />
+<Console Name="Main Menu" Commands="commands" Description="@desctiption" HelpCommand="helpCommand" />
 
 @code 
 {
@@ -11,6 +10,8 @@
 
     HelpCommand? helpCommand;
 
+    string desctiption = "Select a game mode by using the 'play' command.";
+
     protected override void OnInitialized()
     {
         helpCommand  = new HelpCommand(commands);
diff --git a/src/TextLore/Components/Shared/Console.razor b/src/TextLore/Components/Shared/Console.razor
index 47143a2..64a0bc9 100644
--- a/src/TextLore/Components/Shared/Console.razor
+++ b/src/TextLore/Components/Shared/Console.razor
@@ -1,5 +1,4 @@
 @using Microsoft.AspNetCore.Components.Forms
-@using TextLore.Models
 
 <div id="console">
     <div id="header">
@@ -72,11 +71,16 @@
         }
     }
 
-    public async Task Execute(EditContext context)
+    private Task Execute(EditContext context)
     {
         string commandName = ConsoleInput.Text.Split(' ')[0];
         string commandArgs = new string(ConsoleInput.Text.Skip(commandName.Length).ToArray()).TrimStart(' ');
 
+        return Execute(commandName, commandArgs);
+    }
+
+    public async Task Execute(string commandName, string commandArgs = "")
+    {
         Command? command = Commands.FirstOrDefault(c => c.Name.Equals(commandName) || c.Aliases.Contains(commandName));
         command ??= HelpCommand?.Name.Equals(commandName) == true || HelpCommand?.Aliases.Contains(commandName) == true ? HelpCommand : null;
 
@@ -86,13 +90,20 @@
             return;
         }
 
+        await Execute(command, commandArgs);
+    }
+
+    public async Task Execute(Command command, string commandArgs = "")
+    {
         disabled = true;
 
         ConsoleWriter consoleWriter = new ConsoleWriter();
         ConsoleOutput consoleOutput = new ConsoleOutput();
 
         consoleWriter.OnOutput += (_, e) => WriteOutput(consoleOutput, e);
-        consoleWriter.OnClear += (_, _) => consoleOutputs.Clear();
+        consoleWriter.OnClearAll += (_, _) => consoleOutputs.Clear();
+        consoleWriter.OnClearLine += (_, _) => ClearLine(consoleOutput);
+        consoleWriter.OnClearCurrent += (_, _) => consoleOutput.Text = string.Empty;
         consoleOutput.Command = ConsoleInput.Text;
         currentOutput = consoleOutput;
 
@@ -119,6 +130,18 @@
         StateHasChanged();
     }
 
+    private void ClearLine(ConsoleOutput consoleOutput)
+    {
+        consoleOutput.Text = consoleOutput.Text.TrimEnd(Environment.NewLine.ToCharArray());
+
+        if (consoleOutput.Text.Contains(Environment.NewLine))
+        {
+            consoleOutput.Text = consoleOutput.Text.Substring(0, consoleOutput.Text.LastIndexOf(Environment.NewLine));
+        }
+
+        consoleOutput.Text += Environment.NewLine;
+    }
+
     private async Task CommandNotFound(string commandName)
     {
         currentOutput = new()
diff --git a/src/TextLore/Components/_Imports.razor b/src/TextLore/Components/_Imports.razor
index e63cccd..7f50a8c 100644
--- a/src/TextLore/Components/_Imports.razor
+++ b/src/TextLore/Components/_Imports.razor
@@ -9,5 +9,5 @@
 @using TextLore
 @using TextLore.Components
 @using TextLore.Components.Shared
-@using TextLore.Commands
-@using TextLore.Models
\ No newline at end of file
+@using TextLore.Console
+@using TextLore.Console.Commands
\ No newline at end of file
diff --git a/src/TextLore/Models/Command.cs b/src/TextLore/Console/Command.cs
similarity index 92%
rename from src/TextLore/Models/Command.cs
rename to src/TextLore/Console/Command.cs
index c3afe97..1fbc8e3 100644
--- a/src/TextLore/Models/Command.cs
+++ b/src/TextLore/Console/Command.cs
@@ -1,4 +1,4 @@
-namespace TextLore.Models;
+namespace TextLore.Console;
 
 public abstract class Command
 {
diff --git a/src/TextLore/Console/CommandResult.cs b/src/TextLore/Console/CommandResult.cs
new file mode 100644
index 0000000..72b921e
--- /dev/null
+++ b/src/TextLore/Console/CommandResult.cs
@@ -0,0 +1,39 @@
+namespace TextLore.Console;
+
+public class CommandResult(string message, bool success, Command? precedingCommand = null)
+{
+    public string Message { get; } = message;
+    public bool IsSuccess { get; } = success;
+
+    public Command? PrecedingCommand { get; } = precedingCommand;
+
+    public static CommandResult Success(string message = "")
+    {
+        return new(message, true);
+    }
+
+    public static CommandResult Success(Command precedingCommand, string message = "")
+    {
+        return new(message, true, precedingCommand);
+    }
+
+    public static CommandResult Failure(string message = "")
+    {
+        return new(message, false);
+    }
+
+    public static CommandResult Failure(Command precedingCommand, string message = "")
+    {
+        return new(message, false, precedingCommand);
+    }
+
+    public static implicit operator CommandResult(string message)
+    {
+        return Success(message);
+    }
+
+    public static implicit operator Task<CommandResult>(CommandResult result)
+    {
+        return Task.FromResult(result);
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Commands/ClearCommand.cs b/src/TextLore/Console/Commands/ClearCommand.cs
similarity index 68%
rename from src/TextLore/Commands/ClearCommand.cs
rename to src/TextLore/Console/Commands/ClearCommand.cs
index 171629e..4ed93ac 100644
--- a/src/TextLore/Commands/ClearCommand.cs
+++ b/src/TextLore/Console/Commands/ClearCommand.cs
@@ -1,6 +1,4 @@
-using TextLore.Models;
-
-namespace TextLore.Commands;
+namespace TextLore.Console.Commands;
 
 public class ClearCommand : Command
 {
@@ -13,7 +11,7 @@ public class ClearCommand : Command
 
     public override Task<CommandResult> Execute(ConsoleWriter consoleOutput, string args)
     {
-        consoleOutput.Clear();
-        return Task.FromResult(CommandResult.Success("Console cleared!"));
+        consoleOutput.ClearAll();
+        return CommandResult.Success("Console cleared!");
     }
 }
\ No newline at end of file
diff --git a/src/TextLore/Commands/HelpCommand.cs b/src/TextLore/Console/Commands/HelpCommand.cs
similarity index 86%
rename from src/TextLore/Commands/HelpCommand.cs
rename to src/TextLore/Console/Commands/HelpCommand.cs
index f16d17e..929ebc9 100644
--- a/src/TextLore/Commands/HelpCommand.cs
+++ b/src/TextLore/Console/Commands/HelpCommand.cs
@@ -1,6 +1,4 @@
-using TextLore.Models;
-
-namespace TextLore.Commands;
+namespace TextLore.Console.Commands;
 
 public class HelpCommand(IEnumerable<Command> commands) : Command
 {
@@ -18,7 +16,7 @@ public class HelpCommand(IEnumerable<Command> commands) : Command
             {
                 consoleOutput.WriteLine($"  {command.Name} - {command.Description}");
             }
-            return Task.FromResult(CommandResult.Success());
+            return CommandResult.Success();
         }
         else
         {
@@ -26,7 +24,7 @@ public class HelpCommand(IEnumerable<Command> commands) : Command
             if (command is null)
             {
                 consoleOutput.WriteLine($"Command \"{args[0]}\" not found.");
-                return Task.FromResult(CommandResult.Failure());
+                return CommandResult.Failure();
             }
             else
             {
@@ -44,7 +42,7 @@ public class HelpCommand(IEnumerable<Command> commands) : Command
                     consoleOutput.WriteLine($"Usage: {command.Usage}");
                 }
 
-                return Task.FromResult(CommandResult.Success());
+                return CommandResult.Success();
             }
         }
     }
diff --git a/src/TextLore/Commands/TestCommand.cs b/src/TextLore/Console/Commands/TestCommand.cs
similarity index 74%
rename from src/TextLore/Commands/TestCommand.cs
rename to src/TextLore/Console/Commands/TestCommand.cs
index fabbfef..6fbef94 100644
--- a/src/TextLore/Commands/TestCommand.cs
+++ b/src/TextLore/Console/Commands/TestCommand.cs
@@ -1,6 +1,4 @@
-using TextLore.Models;
-
-namespace TextLore.Commands;
+namespace TextLore.Console.Commands;
 
 public class TestCommand : Command
 {
@@ -12,6 +10,6 @@ public class TestCommand : Command
     public override Task<CommandResult> Execute(ConsoleWriter consoleOutput, string args)
     {
         consoleOutput.WriteLine("This is a test command.");
-        return Task.FromResult(CommandResult.Success("test"));
+        return CommandResult.Success("test");
     }
 }
\ No newline at end of file
diff --git a/src/TextLore/Models/ConsoleInput.cs b/src/TextLore/Console/ConsoleInput.cs
similarity index 81%
rename from src/TextLore/Models/ConsoleInput.cs
rename to src/TextLore/Console/ConsoleInput.cs
index 2dffa09..83c1808 100644
--- a/src/TextLore/Models/ConsoleInput.cs
+++ b/src/TextLore/Console/ConsoleInput.cs
@@ -1,4 +1,4 @@
-namespace TextLore.Models;
+namespace TextLore.Console;
 
 public class ConsoleInput
 {
diff --git a/src/TextLore/Models/ConsoleMessageType.cs b/src/TextLore/Console/ConsoleMessageType.cs
similarity index 72%
rename from src/TextLore/Models/ConsoleMessageType.cs
rename to src/TextLore/Console/ConsoleMessageType.cs
index dda32f0..efc6682 100644
--- a/src/TextLore/Models/ConsoleMessageType.cs
+++ b/src/TextLore/Console/ConsoleMessageType.cs
@@ -1,4 +1,4 @@
-namespace TextLore.Models;
+namespace TextLore.Console;
 
 public enum ConsoleMessageType
 {
diff --git a/src/TextLore/Models/ConsoleOutput.cs b/src/TextLore/Console/ConsoleOutput.cs
similarity index 86%
rename from src/TextLore/Models/ConsoleOutput.cs
rename to src/TextLore/Console/ConsoleOutput.cs
index f245bec..82e63f0 100644
--- a/src/TextLore/Models/ConsoleOutput.cs
+++ b/src/TextLore/Console/ConsoleOutput.cs
@@ -1,4 +1,4 @@
-namespace TextLore.Models;
+namespace TextLore.Console;
 
 public class ConsoleOutput
 {
diff --git a/src/TextLore/Models/ConsoleOutputEventArgs.cs b/src/TextLore/Console/ConsoleOutputEventArgs.cs
similarity index 87%
rename from src/TextLore/Models/ConsoleOutputEventArgs.cs
rename to src/TextLore/Console/ConsoleOutputEventArgs.cs
index 5d682b4..d3f9585 100644
--- a/src/TextLore/Models/ConsoleOutputEventArgs.cs
+++ b/src/TextLore/Console/ConsoleOutputEventArgs.cs
@@ -1,4 +1,4 @@
-namespace TextLore.Models;
+namespace TextLore.Console;
 
 public class ConsoleOutputEventArgs(string message, ConsoleMessageType messageType) : EventArgs
 {
diff --git a/src/TextLore/Models/ConsoleWriter.cs b/src/TextLore/Console/ConsoleWriter.cs
similarity index 69%
rename from src/TextLore/Models/ConsoleWriter.cs
rename to src/TextLore/Console/ConsoleWriter.cs
index 9914923..c406a75 100644
--- a/src/TextLore/Models/ConsoleWriter.cs
+++ b/src/TextLore/Console/ConsoleWriter.cs
@@ -1,10 +1,15 @@
-namespace TextLore.Models;
+namespace TextLore.Console;
 
 public class ConsoleWriter
 {
     public event EventHandler<ConsoleOutputEventArgs>? OnOutput;
 
-    public event EventHandler<EventArgs>? OnClear;
+    public event EventHandler<EventArgs>? OnClearAll;
+
+    public event EventHandler<EventArgs>? OnClearLine;
+
+    public event EventHandler<EventArgs>? OnClearCurrent;
+
     public void Write(string message, ConsoleMessageType consoleMessageType = ConsoleMessageType.Default)
     {
         OnOutput?.Invoke(this, new(message, consoleMessageType));
@@ -45,8 +50,18 @@ public class ConsoleWriter
         WriteInfo(message + Environment.NewLine);
     }
 
-    public void Clear()
+    public void ClearLine()
     {
-        OnClear?.Invoke(this, EventArgs.Empty);
+        OnClearLine?.Invoke(this, EventArgs.Empty);
+    }
+
+    public void ClearAll()
+    {
+        OnClearAll?.Invoke(this, EventArgs.Empty);
+    }
+
+    public void ClearCurrent()
+    {
+        OnClearCurrent?.Invoke(this, EventArgs.Empty);
     }
 }
\ No newline at end of file
diff --git a/src/TextLore/Database/GamesDatabaseContext.cs b/src/TextLore/Database/GamesDatabaseContext.cs
new file mode 100644
index 0000000..350e663
--- /dev/null
+++ b/src/TextLore/Database/GamesDatabaseContext.cs
@@ -0,0 +1,8 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace TextLore.Database;
+
+public class GamesDatabaseContext(DbContextOptions<GamesDatabaseContext> options) : DbContext(options)
+{
+    public DbSet<Games.Roguelike.Models.RoomDefinition> RoguelikeRooms { get; set; }
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/Commands/GenerateLevelCommand.cs b/src/TextLore/Games/Roguelike/Commands/GenerateLevelCommand.cs
new file mode 100644
index 0000000..8b63670
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/Commands/GenerateLevelCommand.cs
@@ -0,0 +1,96 @@
+using Microsoft.AspNetCore.Components;
+using Microsoft.EntityFrameworkCore;
+
+using TextLore.Console;
+using TextLore.Games.Roguelike.Logic;
+using TextLore.Games.Roguelike.Models;
+using TextLore.Utilities.Logic;
+using TextLore.Utilities.Models;
+
+namespace TextLore.Games.Roguelike.Commands;
+
+public class GenerateLevelCommand(IQueryable<RoomDefinition> roomDefinitions, NavigationManager navigationManager, Action<Level> levelGeneratedCallback) : Command
+{
+    private bool isGenerated = false;
+    public override string Name => "generatelevel";
+    public override string Description => "Generates a new level.";
+
+    public override string[] Aliases => ["genlevel"];
+
+    public override bool NoHistoryIfNoOutput => true;
+
+    public override async Task<CommandResult> Execute(ConsoleWriter consoleOutput, string args)
+    {
+        if (!DeterministicRandom.TryParse(args, out DeterministicRandom? seed))
+        {
+            consoleOutput.WriteLine("Invalid seed. Generating a new one...");
+            seed = await GenerateSeed();
+
+            navigationManager.NavigateTo($"/roguelike/{seed.ToBase64()}");
+        }
+
+        consoleOutput.WriteLine("Generating level...");
+
+        LevelGenerator levelGenerator = new LevelGenerator(seed, roomDefinitions);
+
+        IProgress<PercentageProgress> progress = new Progress<PercentageProgress>(p => ReportProgress(p, consoleOutput));
+
+        Level level;
+
+        try
+        {
+            level = await levelGenerator.GenerateLevel(progress);
+        }
+        catch (InvalidOperationException ex)
+        {
+            return CommandResult.Failure(ex.Message);
+        }
+        catch (ArgumentException ex)
+        {
+            return CommandResult.Failure(ex.Message);
+        }
+
+        isGenerated = true;
+
+        consoleOutput.WriteLine($"Level size: {level.Size.Width}x{level.Size.Height}");
+        consoleOutput.WriteLine($"Room count: {level.RoomCount}");
+        consoleOutput.WriteLine($"Filled space: {(double)level.RoomCount / (level.Size.Width * level.Size.Height):F0}%");
+        consoleOutput.WriteLine($"Seed: {seed.ToBase64()}");
+
+        consoleOutput.WriteLine("Level generation complete!");
+
+        levelGeneratedCallback?.Invoke(level);
+
+        return CommandResult.Success("Level generated!");
+    }
+
+    private void ReportProgress(PercentageProgress progress, ConsoleWriter consoleOutput)
+    {
+        if (isGenerated)
+        {
+            return;
+        }
+
+        char spinner = (DateTime.UtcNow.Second % 4) switch
+        {
+            0 => '|',
+            1 => '/',
+            2 => '-',
+            3 => '\\',
+            _ => '|'
+        };
+
+        consoleOutput.ClearLine();
+
+        consoleOutput.WriteLine($"{spinner} Generating level... {progress.Percentage}%");
+    }
+
+    private async Task<DeterministicRandom> GenerateSeed()
+    {
+        int baseSeed = Guid.NewGuid().GetHashCode();
+        int min = await roomDefinitions.MinAsync(r => r.Id);
+        int max = await roomDefinitions.MaxAsync(r => r.Id);
+
+        return new DeterministicRandom(baseSeed, min, max);
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/Logic/LevelGenerator.cs b/src/TextLore/Games/Roguelike/Logic/LevelGenerator.cs
new file mode 100644
index 0000000..b58910b
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/Logic/LevelGenerator.cs
@@ -0,0 +1,100 @@
+using Microsoft.EntityFrameworkCore;
+
+using TextLore.Games.Roguelike.Models;
+using TextLore.Utilities.Logic;
+using TextLore.Utilities.Models;
+
+namespace TextLore.Games.Roguelike.Logic;
+
+public class LevelGenerator(DeterministicRandom seed, IQueryable<RoomDefinition> rooms)
+{
+    public async Task<Level> GenerateLevel(IProgress<PercentageProgress> progress)
+    {
+        // Random size between 10x10 and 100x100.
+        Size size = new Size(seed.Next(10, 100), seed.Next(10, 100));
+
+        // Fill 20-60% of the level with rooms.
+        int roomCount = size.Width * size.Height / 100 * seed.Next(20, 60);
+
+        Level level = new Level(size, seed);
+        Queue<Room> generationQueue = new Queue<Room>();
+
+        RoomDefinition startRoomDefinition = await GetRandomRoomDefinition() ?? throw new InvalidOperationException("No rooms found in the database.");
+        Position startRoomPosition = new Position(seed.Next(0, size.Width), seed.Next(0, size.Height));
+
+        Room startRoom = new Room(startRoomPosition, startRoomDefinition);
+
+        level.AddRoom(startRoom);
+        generationQueue.Enqueue(startRoom);
+
+        while (generationQueue.Count > 0)
+        {
+            Room currentRoom = generationQueue.Dequeue();
+
+            foreach (Direction direction in currentRoom.DoorDirections.ToArray())
+            {
+                Position newPosition = currentRoom.Position + direction;
+
+                // Randomly skip a direction to create a maze-like structure.
+                if (seed.Next(0, 100) < 50)
+                {
+                    continue;
+                }
+
+                if (level.IsPositionInBounds(newPosition) && level.GetRoom(newPosition) is null)
+                {
+                    RoomDefinition? newRoomDefinition = await GetRandomRoomDefinition();
+
+                    Room newRoom = new Room(newPosition, newRoomDefinition ?? throw new InvalidOperationException("No rooms found in the database."));
+
+                    level.AddRoom(newRoom);
+                    generationQueue.Enqueue(newRoom);
+                }
+            }
+
+            await Task.Delay(1);
+            progress.Report(new(level.RoomCount, roomCount));
+
+            if (level.RoomCount >= roomCount)
+            {
+                break;
+            }
+
+            if (generationQueue.Count == 0)
+            {
+                Room? nextRoom = level.GetRooms().Values.ElementAt(seed.Next(0, level.RoomCount));
+
+                if (nextRoom is not null)
+                {
+                    generationQueue.Enqueue(nextRoom);
+                }
+            }
+        }
+
+        return level;
+    }
+
+    private async Task<RoomDefinition?> GetRandomRoomDefinition()
+    {
+        RoomDefinition? room = null;
+        int randomRoomIndex = seed.Next();
+
+        // This is a fallback in case the room doesn't exist in the database to keep the order of the future rooms the same.
+        DeterministicRandom fallbackRandom = new DeterministicRandom(randomRoomIndex, seed.Min, seed.Max);
+
+        // Try to find a room 100 times, if it doesn't exist, then return null.
+        for (int i = 0; i < 100; i++)
+        {
+            room = await rooms.FirstOrDefaultAsync(x => x.Id == randomRoomIndex);
+
+            if (room is not null)
+            {
+                break;
+            }
+
+            randomRoomIndex = fallbackRandom.Next();
+        }
+
+        return room;
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/Models/Level.cs b/src/TextLore/Games/Roguelike/Models/Level.cs
new file mode 100644
index 0000000..fe94250
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/Models/Level.cs
@@ -0,0 +1,59 @@
+using TextLore.Utilities.Logic;
+using TextLore.Utilities.Models;
+
+namespace TextLore.Games.Roguelike.Models;
+
+public class Level(Size size, DeterministicRandom seed)
+{
+    private readonly Dictionary<Position, Room> rooms = [];
+
+    public Size Size => size;
+    public int RoomCount => rooms.Count;
+
+    public DeterministicRandom Seed => seed;
+
+    public Room? GetRoom(Position point)
+    {
+        return rooms.GetValueOrDefault(point);
+    }
+
+    public IReadOnlyDictionary<Position, Room> GetRooms()
+    {
+        return rooms;
+    }
+
+    public void AddRoom(Room room)
+    {
+        if (!IsRoomInBounds(room))
+        {
+            throw new InvalidOperationException("Room is out of bounds.");
+        }
+
+        rooms[room.Position] = room;
+    }
+
+    public bool IsPositionInBounds(Position point)
+    {
+        return point.X >= 0 && point.X < size.Width && point.Y >= 0 && point.Y < size.Height;
+    }
+
+    public bool IsRoomInBounds(Room room)
+    {
+        return IsPositionInBounds(room.Position);
+    }
+
+    public bool RoomExists(Position point)
+    {
+        return rooms.ContainsKey(point);
+    }
+
+    public void ClearRoom(Position point)
+    {
+        _ = rooms.Remove(point);
+    }
+
+    public void ClearRooms()
+    {
+        rooms.Clear();
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/Models/Room.cs b/src/TextLore/Games/Roguelike/Models/Room.cs
new file mode 100644
index 0000000..344d87a
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/Models/Room.cs
@@ -0,0 +1,10 @@
+using TextLore.Utilities.Models;
+
+namespace TextLore.Games.Roguelike.Models;
+
+public class Room(Position position, RoomDefinition roomDefinition)
+{
+    public Position Position => position;
+    public List<Direction> DoorDirections { get; init; } = [Direction.Up, Direction.Down, Direction.Right, Direction.Left];
+    public RoomDefinition Definition => roomDefinition;
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/Models/RoomDefinition.cs b/src/TextLore/Games/Roguelike/Models/RoomDefinition.cs
new file mode 100644
index 0000000..20144ed
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/Models/RoomDefinition.cs
@@ -0,0 +1,14 @@
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace TextLore.Games.Roguelike.Models;
+
+public class RoomDefinition(string name)
+{
+    [Key]
+    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
+    public int Id { get; private set; }
+
+    [Required]
+    public string Name { get; set; } = name;
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/RoguelikePage.razor b/src/TextLore/Games/Roguelike/RoguelikePage.razor
new file mode 100644
index 0000000..e9c0b35
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/RoguelikePage.razor
@@ -0,0 +1,6 @@
+@page "/roguelike/{Seed?}"
+
+@inject GamesDatabaseContext DatabaseContext
+@inject NavigationManager NavigationManager
+
+<Console @ref="console" Name="Roguelike" Commands="commands" Description="@desctiption" HelpCommand="helpCommand" />
\ No newline at end of file
diff --git a/src/TextLore/Games/Roguelike/RoguelikePage.razor.cs b/src/TextLore/Games/Roguelike/RoguelikePage.razor.cs
new file mode 100644
index 0000000..b168fe2
--- /dev/null
+++ b/src/TextLore/Games/Roguelike/RoguelikePage.razor.cs
@@ -0,0 +1,43 @@
+using Microsoft.AspNetCore.Components;
+
+using TextLore.Console;
+using TextLore.Console.Commands;
+using TextLore.Games.Roguelike.Commands;
+using TextLore.Games.Roguelike.Models;
+
+namespace TextLore.Games.Roguelike;
+
+public partial class RoguelikePage
+{
+    private readonly List<Command> commands = [new TestCommand(), new ClearCommand()];
+
+    // Short description how to play the game
+    private readonly string desctiption = "This is a roguelike game. Use commands to play the game.";
+
+    private Components.Shared.Console console = null!;
+    private HelpCommand? helpCommand;
+
+    private Level? level;
+
+    [Parameter]
+    public string Seed { get; set; } = string.Empty;
+
+    public void OnLevelGenerated(Level level)
+    {
+        this.level = level;
+    }
+
+    protected override void OnInitialized()
+    {
+        helpCommand = new HelpCommand(commands);
+        commands.Add(helpCommand);
+    }
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (firstRender)
+        {
+            await console.Execute(new GenerateLevelCommand(DatabaseContext.RoguelikeRooms, NavigationManager, OnLevelGenerated), Seed);
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Games/_Imports.razor b/src/TextLore/Games/_Imports.razor
new file mode 100644
index 0000000..93177f0
--- /dev/null
+++ b/src/TextLore/Games/_Imports.razor
@@ -0,0 +1,14 @@
+@using System.Net.Http
+@using System.Net.Http.Json
+@using Microsoft.AspNetCore.Components.Forms
+@using Microsoft.AspNetCore.Components.Routing
+@using Microsoft.AspNetCore.Components.Web
+@using static Microsoft.AspNetCore.Components.Web.RenderMode
+@using Microsoft.AspNetCore.Components.Web.Virtualization
+@using Microsoft.JSInterop
+@using TextLore
+@using TextLore.Database
+@using TextLore.Components
+@using TextLore.Components.Shared
+@using TextLore.Console
+@using TextLore.Console.Commands
\ No newline at end of file
diff --git a/src/TextLore/Models/CommandResult.cs b/src/TextLore/Models/CommandResult.cs
deleted file mode 100644
index a314729..0000000
--- a/src/TextLore/Models/CommandResult.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-namespace TextLore.Models;
-
-public class CommandResult(string message, bool success)
-{
-    public string Message { get; } = message;
-    public bool IsSuccess { get; } = success;
-
-    public static CommandResult Success(string message = "")
-    {
-        return new(message, true);
-    }
-
-    public static CommandResult Failure(string message = "")
-    {
-        return new(message, false);
-    }
-
-    public static implicit operator CommandResult(string message)
-    {
-        return Success(message);
-    }
-}
\ No newline at end of file
diff --git a/src/TextLore/Program.cs b/src/TextLore/Program.cs
index 9ccf00c..2f04cea 100644
--- a/src/TextLore/Program.cs
+++ b/src/TextLore/Program.cs
@@ -1,19 +1,47 @@
-using TextLore.Components;
+using Microsoft.EntityFrameworkCore;
 
-var builder = WebApplication.CreateBuilder(args);
+using TextLore.Components;
+using TextLore.Database;
+
+WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
 
 // Add services to the container.
 builder.Services.AddRazorComponents()
     .AddInteractiveServerComponents();
 
-var app = builder.Build();
+builder.Services.AddDbContext<GamesDatabaseContext>(options =>
+    options.UseSqlite(builder.Configuration.GetConnectionString("GamesDatabase")));
+
+WebApplication app = builder.Build();
 
 // Configure the HTTP request pipeline.
 if (!app.Environment.IsDevelopment())
 {
-    app.UseExceptionHandler("/Error", createScopeForErrors: true);
+    _ = app.UseExceptionHandler("/Error", createScopeForErrors: true);
     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
-    app.UseHsts();
+    _ = app.UseHsts();
+}
+
+using AsyncServiceScope serviceScope = app.Services.CreateAsyncScope();
+
+GamesDatabaseContext databaseContext = serviceScope.ServiceProvider.GetRequiredService<GamesDatabaseContext>();
+
+if (await databaseContext.Database.EnsureCreatedAsync())
+{
+    databaseContext.RoguelikeRooms.AddRange(
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 1"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 2"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 3"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 4"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 5"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 6"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 7"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 8"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 9"),
+        new TextLore.Games.Roguelike.Models.RoomDefinition("Room 10")
+    );
+
+    _ = await databaseContext.SaveChangesAsync();
 }
 
 app.UseHttpsRedirection();
@@ -24,4 +52,4 @@ app.UseAntiforgery();
 app.MapRazorComponents<App>()
     .AddInteractiveServerRenderMode();
 
-app.Run();
+app.Run();
\ No newline at end of file
diff --git a/src/TextLore/TextLore.csproj b/src/TextLore/TextLore.csproj
index 1b28a01..46cf575 100644
--- a/src/TextLore/TextLore.csproj
+++ b/src/TextLore/TextLore.csproj
@@ -6,4 +6,9 @@
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.1" />
+    <PackageReference Include="Microsoft.IdentityModel.Tokens" Version="7.3.0" />
+  </ItemGroup>
+
 </Project>
diff --git a/src/TextLore/Utilities/Logic/DeterministicRandom.cs b/src/TextLore/Utilities/Logic/DeterministicRandom.cs
new file mode 100644
index 0000000..93f16f6
--- /dev/null
+++ b/src/TextLore/Utilities/Logic/DeterministicRandom.cs
@@ -0,0 +1,95 @@
+using Microsoft.IdentityModel.Tokens;
+
+using System.Diagnostics.CodeAnalysis;
+
+namespace TextLore.Utilities.Logic;
+
+public class DeterministicRandom(int seed, int min, int max) : IParsable<DeterministicRandom>
+{
+    private readonly Random random = new Random(seed);
+    public int Seed => seed;
+    public int Min => min;
+    public int Max => max;
+
+    public DeterministicRandom(int min, int max) : this(Guid.NewGuid().GetHashCode(), min, max)
+    {
+    }
+
+    public static DeterministicRandom Parse(string s, IFormatProvider? provider)
+    {
+        byte[] bytes = Base64UrlEncoder.DecodeBytes(s);
+
+        int lseed = BitConverter.ToInt32(bytes.Take(4).ToArray(), 0);
+        int lmin = BitConverter.ToInt32(bytes.Skip(4).Take(4).ToArray(), 0);
+        int lmax = BitConverter.ToInt32(bytes.Skip(8).Take(4).ToArray(), 0);
+
+        return new DeterministicRandom(lseed, lmin, lmax);
+    }
+
+    public static DeterministicRandom Parse(string s)
+    {
+        return Parse(s, null);
+    }
+
+    public static bool TryParse([NotNullWhen(true)] string? s, IFormatProvider? provider, [NotNullWhen(true)] out DeterministicRandom? result)
+    {
+        if (s is null)
+        {
+            result = null;
+            return false;
+        }
+
+        int lseed;
+        int lmin;
+        int lmax;
+
+        try
+        {
+            byte[] bytes = Base64UrlEncoder.DecodeBytes(s);
+
+            lseed = BitConverter.ToInt32(bytes.Take(4).ToArray(), 0);
+            lmin = BitConverter.ToInt32(bytes.Skip(4).Take(4).ToArray(), 0);
+            lmax = BitConverter.ToInt32(bytes.Skip(8).Take(4).ToArray(), 0);
+        }
+        catch (Exception)
+        {
+            result = null;
+            return false;
+        }
+
+        if (lmin > lmax)
+        {
+            result = null;
+            return false;
+        }
+
+        result = new DeterministicRandom(lseed, lmin, lmax);
+        return true;
+    }
+
+    public static bool TryParse([NotNullWhen(true)] string? s, [NotNullWhen(true)] out DeterministicRandom? result)
+    {
+        return TryParse(s, null, out result);
+    }
+
+    public int Next()
+    {
+        return random.Next(min, max);
+    }
+
+    public int Next(int min, int max)
+    {
+        return random.Next(min, max);
+    }
+
+    public string ToBase64()
+    {
+        byte[] bytes = new byte[12];
+
+        Array.Copy(BitConverter.GetBytes(seed), 0, bytes, 0, 4);
+        Array.Copy(BitConverter.GetBytes(min), 0, bytes, 4, 4);
+        Array.Copy(BitConverter.GetBytes(max), 0, bytes, 8, 4);
+
+        return Base64UrlEncoder.Encode(bytes);
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Utilities/Models/Direction.cs b/src/TextLore/Utilities/Models/Direction.cs
new file mode 100644
index 0000000..3b914e3
--- /dev/null
+++ b/src/TextLore/Utilities/Models/Direction.cs
@@ -0,0 +1,15 @@
+namespace TextLore.Utilities.Models;
+
+public readonly struct Direction(int x, int y)
+{
+    public static Direction Up => new Direction(0, -1);
+    public static Direction Down => new Direction(0, 1);
+    public static Direction Left => new Direction(-1, 0);
+    public static Direction Right => new Direction(1, 0);
+    public static Direction UpLeft => new Direction(-1, -1);
+    public static Direction UpRight => new Direction(1, -1);
+    public static Direction DownLeft => new Direction(-1, 1);
+    public static Direction DownRight => new Direction(1, 1);
+    public int X { get; } = x;
+    public int Y { get; } = y;
+}
\ No newline at end of file
diff --git a/src/TextLore/Utilities/Models/PercentageProgress.cs b/src/TextLore/Utilities/Models/PercentageProgress.cs
new file mode 100644
index 0000000..a1f9d49
--- /dev/null
+++ b/src/TextLore/Utilities/Models/PercentageProgress.cs
@@ -0,0 +1,9 @@
+namespace TextLore.Utilities.Models;
+
+public class PercentageProgress(int current, int total)
+{
+    public int Current { get; set; } = current;
+    public int Total { get; set; } = total;
+    public int Percentage => (int)((double)Current / Total * 100);
+    public bool IsComplete => Current >= Total;
+}
\ No newline at end of file
diff --git a/src/TextLore/Utilities/Models/Position.cs b/src/TextLore/Utilities/Models/Position.cs
new file mode 100644
index 0000000..03bb4cc
--- /dev/null
+++ b/src/TextLore/Utilities/Models/Position.cs
@@ -0,0 +1,27 @@
+namespace TextLore.Utilities.Models;
+
+public struct Position(int x, int y)
+{
+    public int X { get; set; } = x;
+    public int Y { get; set; } = y;
+
+    public static Position operator +(Position a, Position b)
+    {
+        return new Position(a.X + b.X, a.Y + b.Y);
+    }
+
+    public static Position operator -(Position a, Position b)
+    {
+        return new Position(a.X - b.X, a.Y - b.Y);
+    }
+
+    public static Position operator +(Position a, Direction b)
+    {
+        return new Position(a.X + b.X, a.Y + b.Y);
+    }
+
+    public static Position operator -(Position a, Direction b)
+    {
+        return new Position(a.X - b.X, a.Y - b.Y);
+    }
+}
\ No newline at end of file
diff --git a/src/TextLore/Utilities/Models/Size.cs b/src/TextLore/Utilities/Models/Size.cs
new file mode 100644
index 0000000..315d32b
--- /dev/null
+++ b/src/TextLore/Utilities/Models/Size.cs
@@ -0,0 +1,7 @@
+namespace TextLore.Utilities.Models;
+
+public readonly struct Size(int width, int height)
+{
+    public int Width { get; } = width;
+    public int Height { get; } = height;
+}
\ No newline at end of file
diff --git a/src/TextLore/appsettings.Development.json b/src/TextLore/appsettings.Development.json
index 0c208ae..cfe57e9 100644
--- a/src/TextLore/appsettings.Development.json
+++ b/src/TextLore/appsettings.Development.json
@@ -1,8 +1,11 @@
 {
-  "Logging": {
-    "LogLevel": {
-      "Default": "Information",
-      "Microsoft.AspNetCore": "Warning"
+    "Logging": {
+        "LogLevel": {
+            "Default": "Information",
+            "Microsoft.AspNetCore": "Warning"
+        }
+    },
+    "ConnectionStrings": {
+        "GamesDatabase": "Data Source=games.sqlite"
     }
-  }
-}
+}
\ No newline at end of file
diff --git a/src/TextLore/games.sqlite b/src/TextLore/games.sqlite
new file mode 100644
index 0000000000000000000000000000000000000000..531ee3ae5301db306075e22180e62f973aa3584c
GIT binary patch
literal 12288
zcmeI&Jxjwt7zgl6QmYrJCoUo`519;#THkdtmLS2H)_8)Qq-rW+YtYsYpx?j`;O_43
z?(Xg`E)MQqq&K9ClMeEK$jkro@+ADW3)$NZ&$<aU)2nu)OABm-nI_vHVvLz;wbZK1
zP@$j)YM+gNDwEAL-%9E#bNGXairSzc009U<00Izz00bZa0SG_<0)HV;GmB$WQ%1ep
zIBF%G%a)q`9(Iz;>*V6Ne`r-=-;+K`Z!`3%@7l?WMmw2Sce*$0#^9Li8n?6GJ>&HB
zI%%DqCvlp#JNc2B>*(Z9Iy70bNtF|vI21(E-|}OMs*<ApFr-Q~+LN)Tj+0Z{KJ34@
z76&_CT&HcnPTsz(29bK!jvvYCUeiduuS3#5Q2ly6OSYTM&24eV#HV-@ui`~Kizo3Y
z9>l#mh=KqFAOHafKmY;|fB*y_009U<;CBRU+hP;hrvoa_ac;5k@4Uu`bX?_wI<D}d
zj>~*N$0c6Sagkd(E^t%Fd2Z-f&gTDycxP%sK>z{}fB*y_009U<00Izz00bcL4+KUH
K%Qf=<4cK4m^MmaG

literal 0
HcmV?d00001

diff --git a/src/TextLore/games.sqlite-shm b/src/TextLore/games.sqlite-shm
new file mode 100644
index 0000000000000000000000000000000000000000..fe9ac2845eca6fe6da8a63cd096d9cf9e24ece10
GIT binary patch
literal 32768
zcmeIuAr62r3<XeTSayS60=Z=O-0|kP2&fu@!6Du^ziFC^7w55MN)9hQYV3Wk79a2P
z)%8g3H30$y2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk
z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs
w0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5cq?@4dk5`Qvd(}

literal 0
HcmV?d00001

diff --git a/src/TextLore/games.sqlite-wal b/src/TextLore/games.sqlite-wal
new file mode 100644
index 0000000..e69de29
diff --git a/src/TextLore/wwwroot/app.css b/src/TextLore/wwwroot/app.css
index 0e68619..ad6a210 100644
--- a/src/TextLore/wwwroot/app.css
+++ b/src/TextLore/wwwroot/app.css
@@ -29,14 +29,8 @@ app {
     overflow-y: hidden;
 }
 
-#console::before {
-    position: absolute;
-    content: "";
-    height: 10%;
-    width: 100%;
-    bottom: 3rem;
-    left: 0;
-    background: linear-gradient(transparent 0%, black 100%);
+h1:focus {
+    outline: none;
 }
 
 .sidebar {
@@ -139,5 +133,5 @@ app {
 }
 
 ::selection {
-    background: #FF5E99;
+    background: #0dcaf0;
 }
\ No newline at end of file
diff --git a/src/TextLore/wwwroot/console.css b/src/TextLore/wwwroot/console.css
index 2ab1609..611841e 100644
--- a/src/TextLore/wwwroot/console.css
+++ b/src/TextLore/wwwroot/console.css
@@ -111,6 +111,16 @@
         color: inherit;
     }
 
+    #console::before {
+        position: absolute;
+        content: "";
+        height: 10%;
+        width: 100%;
+        bottom: 3rem;
+        left: 0;
+        background: linear-gradient(transparent 0%, black 100%);
+    }
+
 .valid {
     outline-color: black !important;
 }
\ No newline at end of file