marco/IsoMmo
Watch
1
0
Fork
You've already forked IsoMmo
 0
Code Issues 42 Pull requests 6 Projects 1 Releases 6 Packages 2 Wiki Activity Actions

Migrate client from Godot to MonoGame #1

New issue
Closed
opened 2026-07-16 22:24:48 +02:00 by marco · 1 comment
marco commented 2026-07-16 22:24:48 +02:00
Owner
Copy link

Move the client rendering off Godot onto MonoGame. Server and protocol (IsoMmo.Shared) stay unchanged.

Why

Godot friction (editor dependency, .tscn/.uid files, ~1GB export templates, scene-tree quirks like the chat focus bug) outweighs its value for a game this simple, where we already build every scene in code. MonoGame gives us the platform layer (window, GPU, sprite batch, input, texture loading, cross-platform packaging) while we own all the engine logic. Avoid raw OpenGL — weeks of plumbing for no game.

Hard requirement: multi-platform

  • Server (IsoMmo.Auth, IsoMmo.GameServer): Windows + macOS + Linux. Already pure .NET 10 / ASP.NET Core + SQLite/Postgres, so this holds today — keep it that way.
  • Client (game): Windows + macOS required. Linux is a bonus.

Scope of the port

  • MonoGame project replacing client/IsoMmo.Client, still referencing IsoMmo.Shared
  • Window + input + camera + isometric sprite batch (reuse IsoProjection verbatim)
  • Human sprite rendering from extracted UO frames (reuse HumanArt facing/mirror table)
  • Infinite green grid around the camera
  • Mouse-driven movement (hold right button, walk toward cursor)
  • Text rendering (SpriteFont) for names + overhead chat — biggest new piece
  • Text input widget for chat (Enter opens, Enter sends, Esc cancels) — hand-rolled
  • Cross-platform build/run scripts (replace scripts/godot.sh)
  • Client logging parity (ClientLog)
  • Remove Godot artifacts at parity (.tscn, .uid, export_presets.cfg, project.godot, godot.sh)

Out of scope

Server, protocol, auth, DB, migrations — untouched.

Open questions

  • Port now, or finish/commit chat on Godot first?
  • macOS build needs a Mac for signing/packaging — CI later, or manual for now?

Definition of Done

Acceptance criteria specific to this issue (base DoD — tests green, whole solution builds, zero warnings, multi-platform preserved — applies on top):

  • The game launches and is fully playable from the MonoGame build on both Windows and macOS, with no Godot installed or referenced.
  • End-to-end parity verified in-game with two clients connected at once: login → silent account creation → character-name prompt → walk in 8 directions via mouse (hold right button) → each client sees the other move in real time.
  • Chat parity: Enter opens input on the first keypress, Enter sends, Esc cancels; the sender's message renders above their own head and above the correct character on every other client; character names render above sprites.
  • Human sprites render with correct facing/mirroring in all 8 directions (visual check against the current Godot behaviour).
  • git diff shows no changes to IsoMmo.Auth, IsoMmo.GameServer, or the wire contracts in IsoMmo.Shared (server/protocol untouched).
  • All Godot artifacts removed from the repo: .tscn, .uid, export_presets.cfg, project.godot, scripts/godot.sh, and the now-unused .godot//.tools/ ignore rules.
  • dotnet build of the whole solution succeeds with zero warnings; the client builds and runs without any editor step.
  • Cross-platform run script(s) replace scripts/godot.sh and are documented in the README.
  • README and CLAUDE.md updated to describe the MonoGame client (no stale Godot instructions).
Move the client rendering off Godot onto MonoGame. Server and protocol (`IsoMmo.Shared`) stay unchanged. ## Why Godot friction (editor dependency, `.tscn`/`.uid` files, ~1GB export templates, scene-tree quirks like the chat focus bug) outweighs its value for a game this simple, where we already build every scene in code. MonoGame gives us the platform layer (window, GPU, sprite batch, input, texture loading, cross-platform packaging) while we own all the engine logic. Avoid raw OpenGL — weeks of plumbing for no game. ## Hard requirement: multi-platform - **Server** (`IsoMmo.Auth`, `IsoMmo.GameServer`): Windows + macOS + Linux. Already pure .NET 10 / ASP.NET Core + SQLite/Postgres, so this holds today — keep it that way. - **Client** (game): Windows + macOS required. Linux is a bonus. ## Scope of the port - [ ] MonoGame project replacing `client/IsoMmo.Client`, still referencing `IsoMmo.Shared` - [ ] Window + input + camera + isometric sprite batch (reuse `IsoProjection` verbatim) - [ ] Human sprite rendering from extracted UO frames (reuse `HumanArt` facing/mirror table) - [ ] Infinite green grid around the camera - [ ] Mouse-driven movement (hold right button, walk toward cursor) - [ ] Text rendering (SpriteFont) for names + overhead chat — biggest new piece - [ ] Text input widget for chat (Enter opens, Enter sends, Esc cancels) — hand-rolled - [ ] Cross-platform build/run scripts (replace scripts/godot.sh) - [ ] Client logging parity (ClientLog) - [ ] Remove Godot artifacts at parity (.tscn, .uid, export_presets.cfg, project.godot, godot.sh) ## Out of scope Server, protocol, auth, DB, migrations — untouched. ## Open questions - Port now, or finish/commit chat on Godot first? - macOS build needs a Mac for signing/packaging — CI later, or manual for now? ## Definition of Done Acceptance criteria specific to this issue (base DoD — tests green, whole solution builds, zero warnings, multi-platform preserved — applies on top): - [ ] The game launches and is fully playable from the MonoGame build on **both Windows and macOS**, with **no Godot** installed or referenced. - [ ] End-to-end parity verified in-game with two clients connected at once: login → silent account creation → character-name prompt → walk in 8 directions via mouse (hold right button) → each client sees the other move in real time. - [ ] Chat parity: Enter opens input on the first keypress, Enter sends, Esc cancels; the sender's message renders above their own head and above the correct character on every other client; character names render above sprites. - [ ] Human sprites render with correct facing/mirroring in all 8 directions (visual check against the current Godot behaviour). - [ ] `git diff` shows **no changes** to `IsoMmo.Auth`, `IsoMmo.GameServer`, or the wire contracts in `IsoMmo.Shared` (server/protocol untouched). - [ ] All Godot artifacts removed from the repo: `.tscn`, `.uid`, `export_presets.cfg`, `project.godot`, `scripts/godot.sh`, and the now-unused `.godot/`/`.tools/` ignore rules. - [ ] `dotnet build` of the whole solution succeeds with zero warnings; the client builds and runs without any editor step. - [ ] Cross-platform run script(s) replace `scripts/godot.sh` and are documented in the README. - [ ] README and CLAUDE.md updated to describe the MonoGame client (no stale Godot instructions).
marco commented 2026-07-17 01:28:41 +02:00
Author
Owner
Copy link

Done via #1 and merged to main (commit b8aeb51). The client is now MonoGame (DesktopGL, .NET 10); Godot is fully removed and the project consolidated into client/IsoMmo.Client.

Delivered and verified on macOS: login → silent account creation → character prompt → 8-direction mouse movement → two clients seeing each other move (with glide + names) → overhead chat. Engine-independent logic lives in IsoMmo.Client.Core (46 unit tests). dotnet build of the whole solution is zero-warning; git diff shows no changes to Auth/GameServer or the Shared wire contract. Cross-platform just tasks + README/CLAUDE.md updated.

Two DoD items remain machine-dependent and are tracked in #15: Windows playability and a visual check against real extracted UO art. Closing this as the migration itself is complete.

Done via #1 and merged to `main` (commit b8aeb51). The client is now MonoGame (DesktopGL, .NET 10); Godot is fully removed and the project consolidated into `client/IsoMmo.Client`. Delivered and verified on macOS: login → silent account creation → character prompt → 8-direction mouse movement → two clients seeing each other move (with glide + names) → overhead chat. Engine-independent logic lives in `IsoMmo.Client.Core` (46 unit tests). `dotnet build` of the whole solution is zero-warning; `git diff` shows no changes to Auth/GameServer or the Shared wire contract. Cross-platform `just` tasks + README/CLAUDE.md updated. Two DoD items remain machine-dependent and are tracked in #15: Windows playability and a visual check against real extracted UO art. Closing this as the migration itself is complete.
marco closed this issue 2026-07-17 01:28:41 +02:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
renovate/opentelemetry-dotnet-monorepo
renovate/sixlabors.imagesharp-4.x
renovate/sonaranalyzer.csharp-10.x
renovate/dotnet-monorepo
renovate/roslynator.analyzers-4.x
fix/blend-knows-a-bank
docs/rendering-open-problems
feat/shaped-cutaway
spike/confine-unwalkable-blend
fix/sprite-depth
design/3d-terrain
feat/p2a-solid-terrain
feat/relief-overlay-occlusion
feat/cliff-face-legibility
renovate/patch-dependencies
chore/sonaranalyzer-10.30
feat/server-compact-worldmap
feat/world-new-biomes
fix/biome-seams
feat/vitals-hud
fix/marsh-creature-parity
feat/biome-props
feat/world-terrain
0.2.1
0.2.0
0.1.5
0.1.4
0.1.2
v0.1.1
v0.1.0
0.1.3
Labels
Clear labels   
alpha:wave-0
Alpha — de-risk, do first

  
alpha:wave-1
Alpha — foundations

  
alpha:wave-2
Alpha — features

  
alpha:wave-3
Alpha — refine & stabilize

  
area:assets
Art, sound, the assets.isoa pack and its tools

  
area:combat
Combat system, weapons, balance

  
area:ecology
Natural nodes, harvesting, spawners

  
area:infra
CI, analyzers, dependencies, performance, ops

  
area:render
Client rendering: terrain mesh, shading, sprites, cutaway

  
area:scripting
Lua content scripting host and API

  
area:ui
Client UI, HUD, input, targeting

  
area:world
World model, map format, editor, topology

  
enhancement
New feature or improvement

  
epic
Milestone-level roadmap epic

  
migration
Platform or framework migration

  
post-alpha
Explicitly out of the alpha scope

  
roadmap
Roadmap tracker

  
tech-debt
Accepted debt to revisit

  
type:bug
Something is wrong and reproducible

  
type:chore
Housekeeping: no behaviour change

  
type:design
Design to agree before any implementation

No labels
alpha:wave-0
alpha:wave-1
alpha:wave-2
alpha:wave-3
area:assets
area:combat
area:ecology
area:infra
area:render
area:scripting
area:ui
area:world
enhancement
epic
migration
post-alpha
roadmap
tech-debt
type:bug
type:chore
type:design
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
marco/IsoMmo#1
No description provided.