Skip to content

README for what MSMS actually is now, with screenshots (v0.2.0) - #150

Merged
CaYatur merged 1 commit into
mainfrom
docs/readme-v0.2.0
Jul 29, 2026
Merged

README for what MSMS actually is now, with screenshots (v0.2.0)#150
CaYatur merged 1 commit into
mainfrom
docs/readme-v0.2.0

Conversation

@CaYatur

@CaYatur CaYatur commented Jul 29, 2026

Copy link
Copy Markdown
Owner

The README still called the web panel and the store "beta", described the Bridge plugin as "pending", and did not mention the public website, the map page, chunk areas, the REST API or the client-jar textures at all — most of a release's worth of work, undocumented.

Rewritten where it was wrong

Web Panel, Store & Economy, Public Website and The Map Page are now four sections that say what each surface is and what it refuses to do. The feature matrix drops its two "beta" rows for nine real ones. The Turkish summary says the same things in Turkish rather than a shorter, older list.

The screenshots are taken by the app of itself

MSMS_SHOTS=<dir> opens the real UI against throwaway demo servers, clicks through each view and writes a PNG per screen. Reproducible on any machine, which is the point — they can be retaken after a redesign instead of quietly going stale.

Two things that had to be right about that, and were not at first:

  • The first attempt grabbed the screen with GDI and captured whatever was in front of the app — a game that happened to be running. Deleted, and replaced with capturePage(), which renders the window's own content and cannot photograph anything else on the machine.
  • capturePage() on a hidden window returns the last frame it happened to paint. That is not a blank image; it is a working screenshot of the wrong screen, and every tab shot came out as the console while the page underneath had genuinely switched. The window is now shown at opacity 0 with showInactive, which composites without taking focus.

It runs against a throwaway base directory with invented servers, so a README cannot end up publishing whoever ran it — their real server names, ports and players.

A bug the screenshots found

The Store and Web Panel both render common.add as a raw translation key on an "Add" button. The key was never defined in either locale. Fixed.

Verification

12/12 gates. Version bumped to 0.2.0.

The README still called the web panel and the store "beta", described the
Bridge plugin as "pending", and did not mention the public website, the
map page, chunk areas, the REST API or the client-jar textures at all —
most of a release's worth of work, undocumented.

Rewritten where it was wrong rather than patched: Web Panel, Store &
Economy, Public Website and The Map Page are now four sections that say
what each surface is and what it refuses to do. The feature matrix drops
its two "beta" rows for nine real ones. The Turkish summary says the same
things in Turkish rather than a shorter, older list.

The screenshots are taken BY THE APP OF ITSELF. `MSMS_SHOTS=<dir>` opens
the real UI against throwaway demo servers, clicks through each view and
writes a PNG per screen, so they can be retaken after a redesign instead
of quietly going stale.

Two things that had to be right about that, and were not at first:

  The first attempt grabbed the screen with GDI and captured whatever was
  in front of the app — a game that happened to be running. Deleted, and
  replaced with `capturePage()`, which renders the window's own content
  and cannot photograph anything else on the machine.

  `capturePage()` on a HIDDEN window returns the last frame it happened
  to paint. That is not a blank image; it is a working screenshot of the
  wrong screen, and every tab shot came out as the console while the page
  underneath had genuinely switched. The window is now shown at opacity 0
  with `showInactive`, which composites without taking focus.

It also runs against a throwaway base directory with invented servers, so
a README cannot end up publishing whoever ran it — their real server
names, ports and players.

Taking the screenshots found a bug: the Store and Web Panel both render
`common.add` as a raw translation key on an "Add" button, because the key
was never defined in either locale.

Verified: 12/12 gates. Version bumped to 0.2.0.
Copilot AI review requested due to automatic review settings July 29, 2026 17:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@CaYatur
CaYatur merged commit e556cd0 into main Jul 29, 2026
1 check passed
@CaYatur
CaYatur deleted the docs/readme-v0.2.0 branch July 29, 2026 17:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants