@zaisma/game-server 1.4.0 → 1.5.0

package/README.md

@@ -2,6 +2,8 @@
 
 Write a game server once; run it in Zaisma's rooms or on your own Node server. Rooms, players, state sync, chat, the game's database and its requests behave the same in both.
 
+To play your multiplayer game on your own computer before you upload it, run `npx @zaisma/game-server@1 play-locally` in the game's folder (or `npx @zaisma/cli play-locally`, which runs it). It serves the game, runs its game server, and opens a test bench: each player on Zaisma's own game page, guests until they sign in with a name, and a dev bar whose Add a player opens another tab as a new player, with passes signed by a key of its own, so two tabs play together with no account, key or internet. Flags: `[folder]`, `--port 4800`, `--game <slug>`, `--on-network`, `--no-open`, `--json`; Zaisma's README has the whole of it under "Play it on your own computer".
+
 ```ts
 // server.ts
 import { defineGameServer } from "@zaisma/game-server";

package/bench/brand/.assetsignore

@@ -0,0 +1,4 @@
+README.md
+*.afdesign
+fonts/OFL.txt
+flags/LICENSE

package/bench/brand/README.md

@@ -0,0 +1,51 @@
+# Zaisma brand
+
+The Z is the brand. Designed by Julius in Affinity Designer 2, based on Futura.
+
+## Which file to use
+
+| Use | File |
+|---|---|
+| Main logo, on dark backgrounds | `zaisma-wordmark-metal.svg` / `zaisma-mark-metal.svg` |
+| One color, on light backgrounds | `zaisma-wordmark-black.svg` / `zaisma-mark-black.svg` |
+| One color, on dark backgrounds | `zaisma-wordmark-white.svg` / `zaisma-mark-white.svg` |
+| Icons 32 px and smaller | `zaisma-mark-small-black.svg` / `zaisma-mark-small-white.svg` |
+| Launches, game jams, merch | `zaisma-mark-tricolor.svg` |
+| App icon | `zaisma-app-icon.svg`, `app-icon-*.png`, `apple-touch-icon.png` |
+| Browser tab | `favicon.svg`, `favicon.ico`, `favicon-32.png` |
+| Loading | `loader/` (see below) |
+
+PNG copies of the main files are included at 2048 px (mark) and 2400 px (wordmark).
+
+## Loader
+
+`loader/` holds the loading indicator: the Z building itself, one loop per second.
+
+- `zaisma-loader.svg` draws in `currentColor`; the site uses it as a CSS mask so it takes the text color. `-black` and `-white` are fixed-color copies.
+- `png/`, `webp/` and `gif/` are 128 px and 512 px exports, black and white, for places that can't run an animated SVG.
+- Use it only while something is actually loading, never as decoration.
+
+## Typeface
+
+Headings use **Jost** (`fonts/jost.7726a5cd.woff2`, variable weight), a free geometric typeface close to Futura. It's under the SIL Open Font License (`fonts/OFL.txt`). Body text uses the system font. The file is named for its contents (the first 8 hex digits of its SHA-256), so browsers keep it for good (`_headers`): a changed font gets a new name, and `test/node/brand-files.test.ts` checks that every page asks for one that's there.
+
+## Flags
+
+`flags/` holds a 60×45 PNG of each country's flag, shown beside rooms on game pages (where the room runs). They're rendered from [flag-icons](https://github.com/lipis/flag-icons) 7.5.0, under the MIT License (`flags/LICENSE`). They aren't part of the brand; they live here because this folder is what zaisma.com serves as files.
+
+## Rules
+
+- Metal only on dark backgrounds. Its white edges disappear on white.
+- Don't rotate, stretch, recolor, outline or add effects to the marks.
+- The wordmark is a lowercase z plus custom shard letters "aisma". Don't retype it in a font.
+- Bevel edges are 125 units in the Z's 4500-unit drawing (30 px in the Affinity file). The letters use the same thickness.
+- Leave clear space around the logo of at least the height of the z's top bar.
+- App icon tile color: `#1C1C1C`.
+
+## License
+
+The code in this repo is MIT. The Zaisma name and logo are the project's identity: use them to refer to Zaisma, not to brand other products.
+
+## Cover guide pictures
+
+`cover-guide/` holds the pictures zaisma.com/developers/covers shows (`apps/site/src/cover-guide.ts`, `docs/COVERS.md`): good covers made from real captures of the demo games Arena and Four in a Row, and stand-ins for made-up games. They are examples for developers, not Zaisma's brand.

package/bench/brand/_headers

@@ -0,0 +1,13 @@
+# How long browsers keep the files zaisma.com serves from this folder (wrangler.jsonc, "assets"). Workers Static Assets reads
+# this file and never serves it. Pages, /css/ and /js/ are the Worker's own answers, which it leaves alone.
+
+# Logos, icons, flags and pictures: used from the browser's cache for a day with no request, then refreshed in the
+# background for a week, so a repeat visit never waits on them.
+/*
+  Cache-Control: public, max-age=86400, stale-while-revalidate=604800
+
+# The font is named for its contents (README.md, Typeface), so it's kept for good. The rule above matches it too: its
+# Cache-Control is taken off first, or the two would be joined into one header.
+/fonts/*
+  ! Cache-Control
+  Cache-Control: public, max-age=31536000, immutable

package/bench/brand/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" role="img" aria-label="Zaisma"><rect width="1024" height="1024" rx="230" fill="#1C1C1C"/><g transform="translate(112 92) scale(0.18661)"><g fill="#FFFFFF"><path d="M1887.28,2962.39l2198.79,0c66.882,272.078 133.765,544.155 200.647,816.233c-1428.9,-0 -2857.81,-0 -4286.71,-0c667.483,-278.522 1295.53,-550.506 1887.28,-816.233Z"/><path d="M471.953,3302.71c783.648,-687.125 1431.04,-1310.93 1977.27,-1875.69c359.003,-140.007 706.42,-278.207 1043.12,-414.664c-427.425,518.594 -931.316,1086.1 -1541.37,1707.29c-489.281,198.206 -983.052,392.621 -1479.02,583.066Z"/><path d="M2486.31,1242.1l-1484.53,-0c30.202,-173.574 60.405,-347.147 90.607,-520.721l2582.62,0c-379.41,170.187 -774.918,343.675 -1188.69,520.721Z"/></g></g></svg>

package/bench/brand/flags/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Panayiotis Lipiridis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.