From c82e3c95be3415e9af1faf22791bd1658d04d4ba Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 1 Nov 2025 00:57:56 +0000
Subject: [PATCH 1/5] Initial plan
From b0e3b73a4b2cd8b3fea1a83979c3f7b1740870b5 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 1 Nov 2025 01:04:01 +0000
Subject: [PATCH 2/5] Transform README into professional presentation with
enhanced structure
Co-authored-by: unrays <207573825+unrays@users.noreply.github.com>
---
README.md | 448 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 443 insertions(+), 5 deletions(-)
diff --git a/README.md b/README.md
index 73bd603..48db44e 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,446 @@
-# Quark
-Event-driven C# engine for managing game entities, positions, health, and interactions.
-The project development commenced on Sunday, October 26, 2025.
+
-Welcome to my new attempt at "I'm creating problems for myself because I already have too much work to do". So, here you see the result of 2 days (when I first committed to the repo) of research and personal realignment on the fundamental notions of design and software architecture because I happened to drift a little from my best practices lately. As a result, I re-taught myself about ten hours of personal training on the different architectures and solid principles and I think I trained properly in order to be able to continue on a good basis. The project that I present to you today is simply a kind of game engine that I built around a new type of architecture that I discovered called service driven architecture and which, as its name suggests, consists of orchestrating its systems into different services. I've actually completely fallen in love with this concept and I think it's going to replace my ECS obsession for a few weeks while the traumatic ECS C++ flashbacks fade from my mind. As for this game engine, since this is the 4th time I've tried to talk about it, I'll try to be straight forward. So basically, I started this project this morning on a whim where I had the idea of applying the different notions learned this weekend and I liked the concept of game engine so it was natural that I go there. In fact, it was a few times that I tried to do something similar but each time, I always arrived at the same point where my architecture seemed too rigid and complex for me to scale up and make a real engine of my code. Finally, this new approach pushed me to create something much more SOLID and modular, which allowed me for the first time in my career to experiment with Event and trigger systems, which allowed me to create something much bigger and which makes me much more proud, a Collision System. Okay, I know it might not be the most impressive thing, but you can see that this is my first working collision system ever. In fact, I've never managed to get to this stage, and now that I've done it, I'm looking at new goals to push my skills even further. The architecture you see here is pretty much all done by me only, with the help of documentation of course but it's still 100% out of my head and my brain, and I'm quite proud of it. I made it in 4 hours non-stop almost of programming and I finished this evening, thus pushing my project on github for personal documentation purposes and to showcase my new seasonal and probably very fleeting obsessions. If you've read my message so far, I'd like to ask you first of all what you're actually doing reading 800-word messages from a random guy on GitHub and also, I sincerely thank you for your attention, I hope you enjoyed this little bit of my daily life, I invite you to stay tuned in case I re-re-release another ECS in the coming weeks. On that note, sincerely have a very nice end of the day.
+# ⚛️ Quark
-Some of the information above is slightly incorrect because I ultimately reworked the project, so no, I didn't do all of that in just 4 hours :)
+### *A Modern, Event-Driven C# Game Engine*
+
+[](https://docs.microsoft.com/en-us/dotnet/csharp/)
+[](https://dotnet.microsoft.com/)
+[](https://www.libsdl.org/)
+[](LICENSE)
+[](https://github.com/unrays/Quark)
+
+*Built with service-driven architecture principles • Started October 26, 2025*
+
+[Features](#-features) • [Getting Started](#-getting-started) • [Architecture](#-architecture) • [Showcase](#-showcase) • [Documentation](#-documentation)
+
+
+
+---
+
+## 📖 About
+
+Welcome to **Quark** – a game engine born from a weekend of architectural enlightenment and SOLID principles. This is my latest attempt at "creating problems for myself when I already have too much work", but here we are!
+
+After about ten hours of deep-diving into design patterns and software architecture (because I'd drifted from my best practices), I discovered **service-driven architecture**. I fell in love with this concept, and honestly, it's replacing my ECS obsession – at least until those traumatic ECS C++ flashbacks fade away.
+
+**Why is this special?** This is the fourth iteration of this idea, but the first time I've created something that actually *scales*. Previous attempts always hit a wall where the architecture felt too rigid. This time, the modular approach finally clicked, allowing me to:
+- Build my first working **collision system** (a personal milestone! 🎉)
+- Implement proper **event-driven interactions**
+- Create a truly **extensible framework**
+
+The architecture here is 100% from my head (with documentation help, of course), and I'm genuinely proud of it. While the initial commit claimed "4 hours of work", let's be honest – I ultimately reworked everything, so... maybe a bit more than 4 hours. 😅
+
+> **Real talk:** If you're reading this far, I appreciate you taking time to explore a random developer's passion project. This is a showcase of current skills and learning journey. Expect active development, experiments, and maybe another ECS attempt in a few weeks.
+
+---
+
+## ✨ Features
+
+### 🎮 Core Engine Systems
+
+- **🎯 Service-Driven Architecture** – Modular, loosely-coupled services for maximum flexibility
+- **⚡ Event System** – Reactive programming with comprehensive event handling
+- **💥 Collision Detection** – Working collision system with event-driven resolution
+- **🎨 Entity-Component System** – Clean entity management with component services
+- **🎮 Multi-Input Support** – Keyboard, Xbox, PlayStation, and Nintendo Switch controller mapping
+- **🏥 Health Management** – Damage and healing system with event notifications
+- **📍 Position & Movement** – Position tracking with teleport and move capabilities
+- **🎭 Visual Management** – Sprite and texture rendering with SDL2
+- **🎨 Color System** – Comprehensive color utilities with interpolation and conversion
+
+### 🛠️ Technical Highlights
+
+- **Clean Architecture** – SOLID principles throughout
+- **Immutable Data Structures** – Functional programming patterns where applicable
+- **Type Safety** – Strong typing with C# 11 features
+- **Event-Driven** – Observer pattern for system communication
+- **Extensible** – Easy to add new systems and services
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- [.NET 8.0 SDK](https://dotnet.microsoft.com/download) or higher
+- SDL2 libraries (for rendering)
+- A C# IDE ([Visual Studio](https://visualstudio.microsoft.com/), [Rider](https://www.jetbrains.com/rider/), or [VS Code](https://code.visualstudio.com/))
+
+### Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/unrays/Quark.git
+cd Quark
+
+# Restore dependencies
+dotnet restore
+
+# Build the project
+dotnet build
+
+# Run the engine
+dotnet run
+```
+
+### 🎯 Basic Usage Example
+
+```csharp
+// Create entities
+Entity player = Player.Create("Hero");
+
+// Set up services
+var healthService = new HealthService();
+var positionService = new PositionService();
+
+// Register components
+healthService.Register(player, Health.Create(100, 100));
+positionService.Register(player, Vector2.Create(0, 0));
+
+// Subscribe to events
+healthService.OnDamaged += (entity, damage, current, max) => {
+ Console.WriteLine($"{entity.Name} took {damage} damage! HP: {current}/{max}");
+};
+
+// Perform actions
+healthService.Damage(player, 25);
+positionService.Move(player, 10, 5);
+```
+
+---
+
+## 🏗️ Architecture
+
+Quark uses a **service-driven architecture** where functionality is organized into specialized services that communicate through events. This approach provides:
+
+- **Separation of Concerns** – Each service handles one responsibility
+- **Loose Coupling** – Services interact via events, not direct dependencies
+- **Easy Testing** – Services can be tested in isolation
+- **Scalability** – New features are added as new services
+
+### 📦 Core Services
+
+
+Entity Management
+
+```csharp
+// EntityStore - Central registry for all entities
+public class EntityStore {
+ public IReadOnlyList Store { get; }
+ public void Register(Entity entity);
+}
+```
+
+
+
+Health System
+
+```csharp
+// HealthService - Manages entity health and damage
+public class HealthService {
+ public event Action OnDamaged;
+ public event Action OnHealed;
+
+ public void Register(Entity entity, IHealth health);
+ public void Damage(Entity entity, Int32 damage);
+ public void Heal(Entity entity, Int32 heal);
+}
+```
+
+
+
+Position System
+
+```csharp
+// PositionService - Handles entity positioning and movement
+public class PositionService {
+ public event Action OnMoved;
+ public event Action OnTeleported;
+
+ public void Register(Entity entity, IVector2 position);
+ public void Move(Entity entity, Double dX, Double dY);
+ public void Teleport(Entity entity, Double X, Double Y);
+}
+```
+
+
+
+Collision System
+
+```csharp
+// CollisionManager - Detects and resolves entity collisions
+public class CollisionManager {
+ public event Action OnCollision;
+
+ public void CheckCollisions(Entity entity, double x, double y);
+ public void ResolveCollisions(Entity collider, Entity collided);
+}
+```
+
+
+
+Input System
+
+```csharp
+// InputService - Multi-platform input handling
+public class InputService {
+ public event Action EntityInputRequested;
+
+ public void BindInputDevice(InputDevice inputDevice, Entity entity);
+ public void ProcessInput(InputDevice inputDevice, InputKey inputKey);
+}
+
+// ActionDispatcher - Maps inputs to game actions
+public class ActionDispatcher {
+ public event Action EntityActionRequested;
+
+ public void MapInput(Entity entity, InputKey input);
+ public void ToggleInputMapping();
+}
+```
+
+
+
+Visual System
+
+```csharp
+// EntityVisualManager - Manages sprites, textures, and rendering
+public class EntityVisualManager {
+ public event Action OnVisualRegistered;
+
+ public void Register(Entity entity, ITexture texture, IHitbox hitbox);
+ public Sprite GetSprite(Entity entity);
+}
+
+// RenderSystem - SDL2-based rendering
+public class RenderSystem {
+ public void RenderPresent();
+ public void DrawRectangle(Int32 x, Int32 y, Int32 w, Int32 h, Color color);
+ public void RenderCopy(IntPtr texture, SDL_Rect dstRect);
+}
+```
+
+
+### 🔄 Event Flow Example
+
+```
+User Input → InputDevice → InputService → ActionDispatcher → InputManager
+ ↓
+ PositionService
+ ↓
+ CollisionManager → Event Handlers
+```
+
+---
+
+## 🎨 Showcase
+
+### Latest Progress
+
+
+
+
+
+*Rendering a sprite with hitbox visualization – showcasing the modular visual system*
+
+
+
+### Console Output Examples
+
+
+Entity System Overview
+
+```console
+┌─────────┬─────────┬────────────┐
+│ Entity │ Health │ Position │
+├─────────┼─────────┼────────────┤
+│ Alpha │ 40/100 │ (10, 10) │
+├─────────┼─────────┼────────────┤
+│ Bravo │ 60/100 │ (0, 0) │
+├─────────┼─────────┼────────────┤
+│ Charlie │ 40/100 │ (0, 0) │
+├─────────┼─────────┼────────────┤
+│ Delta │ Invalid │ (NaN, NaN) │
+├─────────┼─────────┼────────────┤
+│ Echo │ Invalid │ (NaN, NaN) │
+└─────────┴─────────┴────────────┘
+```
+
+
+
+Event Logging
+
+```console
+[Dialogue] Alpha → Bravo: "d"
+[Health] Alpha took 75 damage | HP: 25/100
+[Health] Alpha healed by 25 | HP: 50/100
+[Health] Alpha took 10 damage | HP: 40/100
+[Movement] Alpha moved to (10, 0)
+[Collision] Bravo collided with Charlie
+[Movement] Bravo moved to (0, 0)
+[Movement] Alpha teleported to (10, 10)
+```
+
+
+
+Input & Collision Handling
+
+```console
+[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
+[Input] Bravo pressed Key_A
+[Input] Bravo executed MoveLeft
+[Movement] Bravo moved to (30, 10)
+
+[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
+[Input] Bravo pressed Key_A
+[Input] Bravo executed MoveLeft
+[Collision] Bravo collided with Alpha
+[Movement] Bravo moved to (10, 10)
+```
+
+
+---
+
+## 🎮 Input System
+
+One of Quark's strengths is its comprehensive input mapping system supporting multiple platforms:
+
+| Platform | Supported | Bindings |
+|----------|-----------|----------|
+| ⌨️ **Keyboard** | ✅ Yes | Full key mapping (A-Z, 0-9, F1-F12, arrows, modifiers) |
+| 🎮 **Xbox Controller** | ✅ Yes | A/B/X/Y, bumpers, triggers, D-pad, analog sticks |
+| 🎮 **PlayStation** | ✅ Yes | Cross/Circle/Square/Triangle, L/R buttons, D-pad, sticks |
+| 🎮 **Nintendo Switch** | ✅ Yes | A/B/X/Y, L/R/ZL/ZR, D-pad, analog sticks |
+
+### Action Mapping
+
+```csharp
+public enum Action {
+ MoveUp, MoveDown, MoveLeft, MoveRight,
+ Jump, Attack, Interact, Reload,
+ Crouch, Sprint, Dash, Use,
+ OpenMenu, Pause, Confirm, Cancel
+}
+```
+
+---
+
+## 📚 Documentation
+
+### 🎨 Color System
+
+Quark includes a rich color system with 25+ predefined colors and utilities:
+
+```csharp
+// Convert to RGBA, Hex, or SDL_Color
+var rgba = Color.Red.ToRGBA(); // (255, 0, 0, 255)
+var hex = Color.Blue.ToHex(); // "#0000FF"
+var sdl = Color.Green.ToSDLColor(); // SDL_Color struct
+
+// Color interpolation
+var midColor = Color.Red.Lerp(Color.Blue, 0.5f);
+
+// Invert colors
+var inverted = Color.White.Invert(); // Returns Black
+```
+
+### 🔧 Extending the Engine
+
+Adding a new service is straightforward:
+
+1. **Create your service class** with event declarations
+2. **Subscribe to events** from other services as needed
+3. **Register entities** with your service
+4. **Emit events** when state changes
+
+```csharp
+public class YourCustomService {
+ public event Action OnSomethingHappened;
+
+ public void Register(Entity entity, YourData data) {
+ // Your logic here
+ OnSomethingHappened?.Invoke(entity, data);
+ }
+}
+```
+
+---
+
+## 🗺️ Roadmap
+
+### ✅ Completed
+- [x] Core service architecture
+- [x] Event system implementation
+- [x] Collision detection
+- [x] Multi-platform input handling
+- [x] Basic rendering with SDL2
+- [x] Entity component system
+- [x] Health and position management
+
+### 🚧 In Progress
+- [ ] Menu system and UI framework
+- [ ] Improved collision resolution
+- [ ] Animation system
+- [ ] Scene management
+
+### 🔮 Planned Features
+- [ ] Physics engine integration
+- [ ] Audio service
+- [ ] Particle systems
+- [ ] Networking capabilities
+- [ ] Level editor
+- [ ] Scripting support
+
+---
+
+## 🤝 Contributing
+
+This is primarily a personal learning project and skills showcase, but I'm open to suggestions and feedback! Feel free to:
+
+- 🐛 Report bugs via [Issues](https://github.com/unrays/Quark/issues)
+- 💡 Suggest features or improvements
+- 📖 Improve documentation
+- ⭐ Star the repo if you find it interesting!
+
+---
+
+## 📄 License
+
+This project is licensed under a custom license. See the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+Built with:
+- [SDL2](https://www.libsdl.org/) – Cross-platform multimedia library
+- [ImGui.NET](https://github.com/mellinoe/ImGui.NET) – Immediate mode GUI
+- [ConsoleTableExt](https://github.com/minhhungit/ConsoleTableExt) – Beautiful console tables
+
+Inspired by countless hours studying software architecture, ECS patterns, and modern game engine design.
+
+---
+
+
+
+### 💬 Get In Touch
+
+Have questions? Want to discuss architecture patterns? Found this interesting?
+
+[Open an Issue](https://github.com/unrays/Quark/issues) • [View Source](https://github.com/unrays/Quark)
+
+---
+
+*Built with ❤️ and too much coffee*
+*© 2025 Félix-Olivier Dumas*
+
+
+
+---
+
+
+📜 Full Source Code Example
```csharp
// Copyright (c) October 2025 Félix-Olivier Dumas. All rights reserved.
@@ -1334,3 +1770,5 @@ Bravo is not allowed to perform 'None'
Bravo is not allowed to perform 'Interact'
[Input] Bravo pressed Key_E
```
+
+
From a26ca730d1f91322155267862654fc3c7bf5a70c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 1 Nov 2025 01:06:10 +0000
Subject: [PATCH 3/5] Clean up README: remove duplicate sections and add proper
closing
Co-authored-by: unrays <207573825+unrays@users.noreply.github.com>
---
README.md | 74 +++----------------------------------------------------
1 file changed, 3 insertions(+), 71 deletions(-)
diff --git a/README.md b/README.md
index 48db44e..905e519 100644
--- a/README.md
+++ b/README.md
@@ -1698,77 +1698,9 @@ class Program {
}
```
-## Latest Progress
-
-Rendering a sprite offset from its hitbox by 10 units. Modularity++
-## Output
-```console
-[Input] Device 'Undefined Controller' triggered 'Start'
-[Input] Alpha pressed Start
-[Input] Device 'Undefined Controller' triggered 'Start'
-[Input] Alpha pressed Start
-[Input] Device 'Undefined Keyboard' triggered 'Alt'
-[Input] Bravo pressed Alt
-[Input] Device 'Undefined Keyboard' triggered 'Alt'
-[Input] Bravo pressed Alt
-[Dialogue] Alpha ␦ Bravo: "d"
-[Health] Alpha took 75 damage | HP: 25/100
-[Health] Alpha healed by 25 | HP: 50/100
-[Health] Alpha took 10 damage | HP: 40/100
-[Health] Bravo took 50 damage | HP: 50/100
-[Health] Bravo healed by 10 | HP: 60/100
-[Health] Charlie took 60 damage | HP: 40/100
-[Movement] Alpha moved to (10, 0)
-[Collision] Bravo collided with Charlie
-[Movement] Bravo moved to (0, 0)
-[Movement] Alpha teleported to (10, 10)
-┌─────────┬─────────┬────────────┐
-│ Entity │ Health │ Position │
-├─────────┼─────────┼────────────┤
-│ Alpha │ 40/100 │ (10, 10) │
-├─────────┼─────────┼────────────┤
-│ Bravo │ 60/100 │ (0, 0) │
-├─────────┼─────────┼────────────┤
-│ Charlie │ 40/100 │ (0, 0) │
-├─────────┼─────────┼────────────┤
-│ Delta │ Invalid │ (NaN, NaN) │
-├─────────┼─────────┼────────────┤
-│ Echo │ Invalid │ (NaN, NaN) │
-└─────────┴─────────┴────────────┘
-```
+
-## Entity Input Handling with Collision Support
-```console
-[Input] Bravo pressed Key_A
-[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
-[Movement] Bravo moved to (30, 10)
-[Input] Bravo executed MoveLeft
-[Input] Bravo pressed Key_A
-[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
-[Movement] Bravo moved to (20, 10)
-[Input] Bravo executed MoveLeft
-[Input] Bravo pressed Key_A
-[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
-[Collision] Bravo collided with Alpha
-[Movement] Bravo moved to (10, 10)
-[Input] Bravo executed MoveLeft
-[Input] Bravo pressed Key_A
-[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
-[Movement] Bravo moved to (0, 10)
-[Input] Bravo executed MoveLeft
-[Input] Bravo pressed Key_A
-[Input] Device 'unknown_keyboard_0' triggered 'Key_D'
-[Collision] Bravo collided with Alpha
-[Movement] Bravo moved to (10, 10)
-[Input] Bravo executed MoveRight
-[Input] Bravo pressed Key_D
-[Input] Device 'unknown_keyboard_0' triggered 'Key_T'
-Bravo is not allowed to perform 'None'
-[Input] Bravo pressed Key_T
-[Input] Device 'unknown_keyboard_0' triggered 'Key_E'
-Bravo is not allowed to perform 'Interact'
-[Input] Bravo pressed Key_E
-```
+---
-
+*This complete source code is available in [Program.cs](Program.cs)*
From 269887cb94df11009745f740c0d2791902c94876 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 1 Nov 2025 01:17:16 +0000
Subject: [PATCH 4/5] Tone down README: remove AI emojis and make it less
corporate
Co-authored-by: unrays <207573825+unrays@users.noreply.github.com>
---
README.md | 231 +++++++++++++++++++++++-------------------------------
1 file changed, 98 insertions(+), 133 deletions(-)
diff --git a/README.md b/README.md
index 905e519..98cbd43 100644
--- a/README.md
+++ b/README.md
@@ -1,90 +1,76 @@
-
+# Quark
-# ⚛️ Quark
-
-### *A Modern, Event-Driven C# Game Engine*
+**Event-Driven C# Game Engine**
[](https://docs.microsoft.com/en-us/dotnet/csharp/)
[](https://dotnet.microsoft.com/)
[](https://www.libsdl.org/)
-[](LICENSE)
-[](https://github.com/unrays/Quark)
-
-*Built with service-driven architecture principles • Started October 26, 2025*
-
-[Features](#-features) • [Getting Started](#-getting-started) • [Architecture](#-architecture) • [Showcase](#-showcase) • [Documentation](#-documentation)
-
+*Service-driven architecture • Started October 26, 2025*
---
-## 📖 About
+## About
-Welcome to **Quark** – a game engine born from a weekend of architectural enlightenment and SOLID principles. This is my latest attempt at "creating problems for myself when I already have too much work", but here we are!
+Welcome to **Quark** – yet another attempt at "creating problems for myself when I already have too much work to do". But here we are.
-After about ten hours of deep-diving into design patterns and software architecture (because I'd drifted from my best practices), I discovered **service-driven architecture**. I fell in love with this concept, and honestly, it's replacing my ECS obsession – at least until those traumatic ECS C++ flashbacks fade away.
+After spending about ten hours re-learning design patterns and software architecture this weekend (because I'd drifted from my best practices), I stumbled upon **service-driven architecture**. Fell completely in love with this concept. It's basically replacing my ECS obsession for now, at least until those traumatic ECS C++ flashbacks fade from my mind.
-**Why is this special?** This is the fourth iteration of this idea, but the first time I've created something that actually *scales*. Previous attempts always hit a wall where the architecture felt too rigid. This time, the modular approach finally clicked, allowing me to:
-- Build my first working **collision system** (a personal milestone! 🎉)
-- Implement proper **event-driven interactions**
-- Create a truly **extensible framework**
+**Why this matters:** This is the 4th time I've tried building something like this, but the first time it actually *works* and *scales*. Previous attempts always hit a wall where everything felt too rigid and coupled. This time though, the modular approach finally clicked:
-The architecture here is 100% from my head (with documentation help, of course), and I'm genuinely proud of it. While the initial commit claimed "4 hours of work", let's be honest – I ultimately reworked everything, so... maybe a bit more than 4 hours. 😅
+- Built my first working **collision system** (huge personal win!)
+- Got proper **event-driven interactions** working
+- Created something that's actually **extensible**
-> **Real talk:** If you're reading this far, I appreciate you taking time to explore a random developer's passion project. This is a showcase of current skills and learning journey. Expect active development, experiments, and maybe another ECS attempt in a few weeks.
+The architecture is 100% from my brain (with docs help obviously), and I'm genuinely proud of it. The initial commit said "4 hours of work" but let's be real – I reworked pretty much everything after, so... definitely more than 4 hours. 😅
+
+> If you're reading this far, thanks for checking out some random dev's passion project. This is basically a showcase of what I'm learning and building. Expect active development, weird experiments, and probably another ECS attempt in a few weeks.
---
-## ✨ Features
+## Features
-### 🎮 Core Engine Systems
+**Core Systems:**
-- **🎯 Service-Driven Architecture** – Modular, loosely-coupled services for maximum flexibility
-- **⚡ Event System** – Reactive programming with comprehensive event handling
-- **💥 Collision Detection** – Working collision system with event-driven resolution
-- **🎨 Entity-Component System** – Clean entity management with component services
-- **🎮 Multi-Input Support** – Keyboard, Xbox, PlayStation, and Nintendo Switch controller mapping
-- **🏥 Health Management** – Damage and healing system with event notifications
-- **📍 Position & Movement** – Position tracking with teleport and move capabilities
-- **🎭 Visual Management** – Sprite and texture rendering with SDL2
-- **🎨 Color System** – Comprehensive color utilities with interpolation and conversion
+- **Service-Driven Architecture** – Modular services that communicate via events
+- **Event System** – Reactive programming for all game interactions
+- **Collision Detection** – First working collision system (big deal for me!)
+- **Entity Management** – Clean component-based entity system
+- **Multi-Input Support** – Keyboard + Xbox/PlayStation/Switch controllers
+- **Health System** – Damage and healing with event notifications
+- **Position & Movement** – Teleport and move with collision checks
+- **Rendering** – SDL2-based sprite and texture rendering
+- **Color Utilities** – 25+ colors with interpolation and conversion
-### 🛠️ Technical Highlights
+**Technical Stuff:**
-- **Clean Architecture** – SOLID principles throughout
-- **Immutable Data Structures** – Functional programming patterns where applicable
-- **Type Safety** – Strong typing with C# 11 features
-- **Event-Driven** – Observer pattern for system communication
-- **Extensible** – Easy to add new systems and services
+- SOLID principles (actually applied, not just buzzwords)
+- Immutable data structures where it makes sense
+- Strong typing with C# 11
+- Observer pattern for system communication
+- Easy to extend with new services
---
-## 🚀 Getting Started
+## Getting Started
-### Prerequisites
+**What you need:**
- [.NET 8.0 SDK](https://dotnet.microsoft.com/download) or higher
-- SDL2 libraries (for rendering)
-- A C# IDE ([Visual Studio](https://visualstudio.microsoft.com/), [Rider](https://www.jetbrains.com/rider/), or [VS Code](https://code.visualstudio.com/))
+- SDL2 libraries
+- Any C# IDE (Visual Studio, Rider, VS Code)
-### Quick Start
+**Quick Start:**
```bash
-# Clone the repository
git clone https://github.com/unrays/Quark.git
cd Quark
-
-# Restore dependencies
dotnet restore
-
-# Build the project
dotnet build
-
-# Run the engine
dotnet run
```
-### 🎯 Basic Usage Example
+**Basic Usage:**
```csharp
// Create entities
@@ -103,23 +89,23 @@ healthService.OnDamaged += (entity, damage, current, max) => {
Console.WriteLine($"{entity.Name} took {damage} damage! HP: {current}/{max}");
};
-// Perform actions
+// Do stuff
healthService.Damage(player, 25);
positionService.Move(player, 10, 5);
```
---
-## 🏗️ Architecture
+## Architecture
-Quark uses a **service-driven architecture** where functionality is organized into specialized services that communicate through events. This approach provides:
+Quark uses **service-driven architecture** – basically, functionality is split into specialized services that talk to each other through events. This gives you:
-- **Separation of Concerns** – Each service handles one responsibility
-- **Loose Coupling** – Services interact via events, not direct dependencies
-- **Easy Testing** – Services can be tested in isolation
-- **Scalability** – New features are added as new services
+- Clean separation (each service does one thing)
+- Loose coupling (services don't directly depend on each other)
+- Easy testing (test services independently)
+- Scalability (add new services without breaking existing ones)
-### 📦 Core Services
+**Core Services:**
Entity Management
@@ -222,7 +208,7 @@ public class RenderSystem {
```
-### 🔄 Event Flow Example
+**Event Flow:**
```
User Input → InputDevice → InputService → ActionDispatcher → InputManager
@@ -234,22 +220,18 @@ User Input → InputDevice → InputService → ActionDispatcher → InputManage
---
-## 🎨 Showcase
+## Showcase
-### Latest Progress
-
-
+**Latest Progress:**
-*Rendering a sprite with hitbox visualization – showcasing the modular visual system*
-
-
+*Sprite rendering with hitbox visualization – showing the modular visual system in action*
-### Console Output Examples
+**Console Output:**
-Entity System Overview
+Entity System
```console
┌─────────┬─────────┬────────────┐
@@ -284,7 +266,7 @@ User Input → InputDevice → InputService → ActionDispatcher → InputManage
-Input & Collision Handling
+Input & Collision
```console
[Input] Device 'unknown_keyboard_0' triggered 'Key_A'
@@ -302,18 +284,18 @@ User Input → InputDevice → InputService → ActionDispatcher → InputManage
---
-## 🎮 Input System
+## Input System
-One of Quark's strengths is its comprehensive input mapping system supporting multiple platforms:
+Multi-platform input support:
-| Platform | Supported | Bindings |
-|----------|-----------|----------|
-| ⌨️ **Keyboard** | ✅ Yes | Full key mapping (A-Z, 0-9, F1-F12, arrows, modifiers) |
-| 🎮 **Xbox Controller** | ✅ Yes | A/B/X/Y, bumpers, triggers, D-pad, analog sticks |
-| 🎮 **PlayStation** | ✅ Yes | Cross/Circle/Square/Triangle, L/R buttons, D-pad, sticks |
-| 🎮 **Nintendo Switch** | ✅ Yes | A/B/X/Y, L/R/ZL/ZR, D-pad, analog sticks |
+| Platform | Status | Bindings |
+|----------|--------|----------|
+| Keyboard | ✓ | Full mapping (A-Z, 0-9, F1-F12, arrows, modifiers) |
+| Xbox | ✓ | A/B/X/Y, bumpers, triggers, D-pad, sticks |
+| PlayStation | ✓ | Cross/Circle/Square/Triangle, L/R buttons, sticks |
+| Switch | ✓ | A/B/X/Y, L/R/ZL/ZR, D-pad, sticks |
-### Action Mapping
+**Actions:**
```csharp
public enum Action {
@@ -326,40 +308,36 @@ public enum Action {
---
-## 📚 Documentation
+## Documentation
-### 🎨 Color System
-
-Quark includes a rich color system with 25+ predefined colors and utilities:
+**Color System:**
```csharp
-// Convert to RGBA, Hex, or SDL_Color
+// Convert colors
var rgba = Color.Red.ToRGBA(); // (255, 0, 0, 255)
var hex = Color.Blue.ToHex(); // "#0000FF"
var sdl = Color.Green.ToSDLColor(); // SDL_Color struct
-// Color interpolation
+// Interpolate
var midColor = Color.Red.Lerp(Color.Blue, 0.5f);
-// Invert colors
+// Invert
var inverted = Color.White.Invert(); // Returns Black
```
-### 🔧 Extending the Engine
-
-Adding a new service is straightforward:
+**Adding New Services:**
-1. **Create your service class** with event declarations
-2. **Subscribe to events** from other services as needed
-3. **Register entities** with your service
-4. **Emit events** when state changes
+1. Create your service class with events
+2. Subscribe to events from other services
+3. Register entities with your service
+4. Emit events when state changes
```csharp
public class YourCustomService {
public event Action OnSomethingHappened;
public void Register(Entity entity, YourData data) {
- // Your logic here
+ // Your logic
OnSomethingHappened?.Invoke(entity, data);
}
}
@@ -367,76 +345,63 @@ public class YourCustomService {
---
-## 🗺️ Roadmap
+## Roadmap
-### ✅ Completed
+**Done:**
- [x] Core service architecture
-- [x] Event system implementation
+- [x] Event system
- [x] Collision detection
-- [x] Multi-platform input handling
-- [x] Basic rendering with SDL2
-- [x] Entity component system
-- [x] Health and position management
-
-### 🚧 In Progress
-- [ ] Menu system and UI framework
-- [ ] Improved collision resolution
+- [x] Multi-platform input
+- [x] SDL2 rendering
+- [x] Entity components
+- [x] Health/position management
+
+**Working on:**
+- [ ] Menu system
+- [ ] Better collision resolution
- [ ] Animation system
- [ ] Scene management
-### 🔮 Planned Features
-- [ ] Physics engine integration
+**Maybe later:**
+- [ ] Physics engine
- [ ] Audio service
- [ ] Particle systems
-- [ ] Networking capabilities
+- [ ] Networking
- [ ] Level editor
- [ ] Scripting support
---
-## 🤝 Contributing
+## Contributing
-This is primarily a personal learning project and skills showcase, but I'm open to suggestions and feedback! Feel free to:
+This is mainly a personal learning project, but feel free to:
-- 🐛 Report bugs via [Issues](https://github.com/unrays/Quark/issues)
-- 💡 Suggest features or improvements
-- 📖 Improve documentation
-- ⭐ Star the repo if you find it interesting!
+- Report bugs via [Issues](https://github.com/unrays/Quark/issues)
+- Suggest features
+- Improve docs
+- Star if you find it interesting
---
-## 📄 License
+## License
-This project is licensed under a custom license. See the [LICENSE](LICENSE) file for details.
+Custom license. See [LICENSE](LICENSE) for details.
---
-## 🙏 Acknowledgments
+## Credits
Built with:
-- [SDL2](https://www.libsdl.org/) – Cross-platform multimedia library
-- [ImGui.NET](https://github.com/mellinoe/ImGui.NET) – Immediate mode GUI
-- [ConsoleTableExt](https://github.com/minhhungit/ConsoleTableExt) – Beautiful console tables
+- [SDL2](https://www.libsdl.org/) – Graphics
+- [ImGui.NET](https://github.com/mellinoe/ImGui.NET) – UI
+- [ConsoleTableExt](https://github.com/minhhungit/ConsoleTableExt) – Pretty tables
-Inspired by countless hours studying software architecture, ECS patterns, and modern game engine design.
+Lots of coffee and architecture docs.
---
-
-
-### 💬 Get In Touch
-
-Have questions? Want to discuss architecture patterns? Found this interesting?
-
-[Open an Issue](https://github.com/unrays/Quark/issues) • [View Source](https://github.com/unrays/Quark)
-
----
-
-*Built with ❤️ and too much coffee*
*© 2025 Félix-Olivier Dumas*
-
-
---
From 6e82300479a1138e45e4422cfacaecc9806af54f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix-Olivier=20Dumas?=
Date: Sat, 1 Nov 2025 11:29:53 -0400
Subject: [PATCH 5/5] Update README.md
---
README.md | 29 ++++++++++++++++++++---------
1 file changed, 20 insertions(+), 9 deletions(-)
diff --git a/README.md b/README.md
index 98cbd43..17f0555 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,23 @@
-# Quark
-
-**Event-Driven C# Game Engine**
-
-[](https://docs.microsoft.com/en-us/dotnet/csharp/)
-[](https://dotnet.microsoft.com/)
-[](https://www.libsdl.org/)
-
-*Service-driven architecture • Started October 26, 2025*
+
+
+
Quark
+
Event-Driven C# Game Engine
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
+
+ Service-driven architecture • Started October 26, 2025
+
---