release: prep v0.0.2-beta.0.26, server downloads, tracker badges, repo cleanup

Author: lovenityjade

.gitignore

@@ -61,7 +61,18 @@ output/
 Output Logs/
 /factorio/
 /WebHostLib/static/generated
-/WebHostLib/
+/WebHostLib/**/*.bak
+/WebHostLib/**/*.bak-*
+/WebHostLib/**/*.bak_*
+/WebHostLib/**/*.bak.*
+/WebHostLib/generated/
+/WebHostLib/static/client-sync/runtime/
+/WebHostLib/static/styles/**/*.css.map
+/sekailink-docs/
+/sekailink-client-plan/*.local.md
+/sekailink-client-plan/.XX-*
+/sekailink-client-plan/*.swp
+/sekailink-client-plan/XX-temp-tokens.md
 /deploy/
 /freeze_requirements.txt
 /Archipelago.zip
@@ -235,6 +246,8 @@ data/gzdoom/gzdoom.log
 
 # Workspace artifacts
 sekailink-laptop-pack.zip
+sekailink-*.zip
+sekailink-client-plan.zip
 zi5XmaYK/
 release/
 docs/
@@ -244,6 +257,12 @@ client/app/node_modules/
 .claude/
 .run/
 .local/
+user_yamls/
+.pyxbld/
+
+# Keep repository lean (no bundled binary payloads)
+third_party/**
+!third_party/README.md
 
 # Bundled mono runtime is a large binary dependency; keep README in git, but not the payload.
 third_party/mono/sekailink-mono-linux-*/**

README.md

@@ -1,29 +1,42 @@
 # SekaiLink
 
-SekaiLink is a desktop-first platform for Archipelago-style multiworld play with a low-friction UX:
-- create/join lobbies
-- manage YAML/player options
-- patch and launch automatically
-- connect emulator + tracker + client runtime
-- coordinate rooms, moderation, hints, and social features in one UI
+<p align="center">
+  <img src="assets/img/sekailink-logo-image.png" alt="SekaiLink Logo" width="160" />
+</p>
+<p align="center">
+  <img src="assets/img/sekailink-logo-text.png" alt="SekaiLink" width="320" />
+</p>
 
-## Current Scope
-- Client: Electron + React + TypeScript (`client/app`)
-- Runtime orchestration: Python wrappers + AP clients + emulator/tracker bridges
-- Server: WebHostLib + room/lobby/social APIs + generation pipeline
-- Admin: `client/admin-app`
+<p align="center">
+  <a href="https://discord.gg/jTaefxAEDW"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white"></a>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-22c55e?style=for-the-badge"></a>
+  <a href="https://sekailink.com/downloads"><img alt="Downloads" src="https://img.shields.io/badge/Downloads-Live-06b6d4?style=for-the-badge"></a>
+</p>
 
-## Key Features (current)
-- Unified Game Manager (My Games / Add a Game / YAML Editor)
-- Lobby system with generation flow, moderation actions, room info, timer, spoiler log access
-- Solo mode workflow
-- Global and lobby chat with persistent toast notifications
-- Friend system (requests, accept/decline, presence, DMs)
-- Self-update pipeline (incremental sync + staged updates)
-- SteamGridDB boxart integration (client + server endpoints)
-- Multi-language UI foundation (EN, FR, ES, JA, ZH-CN, ZH-TW)
+SekaiLink is a desktop client + server stack for streamlined Archipelago multiplayer sessions:
+- lobby creation/join flow
+- YAML and player options workflow
+- one-click patch/launch pipeline
+- emulator + tracker orchestration
+- moderation/social features in one UI
 
-## Supported Game Set (currently integrated)
+## Downloads
+- Linux AppImage: `https://sekailink.com/static/downloads/sekailink-beta-install.appimage`
+- Windows Installer: `https://sekailink.com/static/downloads/sekailink-beta-install.exe`
+- Downloads page: `https://sekailink.com/downloads`
+
+## Current Features
+- Neon-themed production UI (home, lobby, game manager, settings, profile modal)
+- Auto-update flow with startup check and patch pipeline
+- Global chat + lobby chat + toast notifications
+- Friends system (presence, requests, context actions)
+- Solo mode flow
+- Room moderation actions and room management
+- Runtime orchestration for BizHawk / PopTracker / SNI bridge
+- SteamGridDB boxart integration (client + server)
+- Multi-language foundation (EN, FR, ES, JA, ZH-CN, ZH-TW)
+
+## Supported Games (Current Integration)
 - A Link to the Past
 - A Link Between Worlds
 - Donkey Kong Country 1/2/3
@@ -34,9 +47,8 @@ SekaiLink is a desktop-first platform for Archipelago-style multiworld play with
 - Lufia II Ancient Cave
 - Mega Man 2/3
 - Metroid Fusion / Metroid Zero Mission
-- Ocarina of Time
+- Ocarina of Time / Ship of Harkinian
 - Pokemon Crystal / Emerald / FireRed-LeafGreen / Red-Blue
-- Ship of Harkinian
 - SMZ3
 - Super Mario 64 / Super Mario Land 2 / Super Mario World
 - Super Metroid
@@ -45,47 +57,30 @@ SekaiLink is a desktop-first platform for Archipelago-style multiworld play with
 - Yoshi's Island
 
 ## Repository Layout
-- `client/app/` — desktop client UI + Electron shell
-- `client/admin-app/` — admin control panel
-- `WebHostLib/` — server web/API layer
-- `worlds/` — AP world integrations
-- `third_party/` — emulators, patched tools, external runtimes
-- `sekailink-client-plan/` — execution logs / implementation notes / roadmap docs
-- `sekailink-docs/` — developer and architecture docs
-
-## Production VPS (non-secret operational summary)
-- Domain: `sekailink.com`
-- Admin domain: `admin.sekailink.com`
-- Main path: `/opt/multiworldgg`
-- Web stack: Apache2 reverse proxy + Gunicorn WebHost
-- Active services:
-  - `multiworldgg-webhost.service`
-  - `multiworldgg-workers.service`
-  - `sekailink-social-bots.service`
-  - `sekailink-llama.service`
-  - `webmin.service`
+- `client/app/` : desktop app (Electron + React + TypeScript)
+- `client/admin-app/` : admin desktop panel
+- `WebHostLib/` : web UI + APIs + lobby/room endpoints
+- `worlds/` : world integrations
+- `services/` : auxiliary services (social bots, etc.)
+- `sekailink-client-plan/` : project docs, runbooks, implementation notes
 
-Do **not** commit credentials/tokens. Use local private files (`*.local`) or a proper secret manager.
-
-## Build (Client)
+## Build (Desktop Client)
 ```bash
 cd client/app
 npm install
 npm run build
-npm run electron:pack:ui-prototype
+npm run electron:pack
+npm run electron:pack:win
 ```
 
-AppImage output:
-- `client/app/release/sekailink-UI-prototype-<version>.AppImage`
-
 ## Documentation
-- Sprint logs and integration progress: `sekailink-client-plan/`
-- Dev setup and release process: `sekailink-docs/DEV_SETUP.md`, `sekailink-docs/RELEASE_PROCESS.md`
-- Runtime integration notes: `sekailink-docs/CLIENT_AUTOLAUNCH_PLAN.md`, `sekailink-docs/POPTRACKER.md`, `sekailink-docs/BIZHAWK-CONNECTORS.md`
+- Main docs index: `sekailink-client-plan/README.md`
+- Architecture and workflows: `sekailink-client-plan/03-target-architecture.md`, `sekailink-client-plan/28-integration-workflow.md`
+- Release and updater notes: `sekailink-client-plan/34-updater-sprint-2026-02-11.md`
 
 ## Credits
-SekaiLink builds on upstream ecosystems and tooling:
-- **Archipelago** — protocol, clients, world architecture
-- **PopTracker** — tracker runtime and pack ecosystem
-- **BizHawk** — emulator core integration
-- plus other world/emulator/tool maintainers referenced in `THIRD_PARTY_NOTICES.md`
+SekaiLink builds on and integrates upstream projects:
+- [Archipelago](https://github.com/ArchipelagoMW/Archipelago)
+- [PopTracker](https://github.com/black-sliver/PopTracker)
+- [BizHawk](https://github.com/TASEmulators/BizHawk)
+

WebHostLib/README.md

@@ -0,0 +1,19 @@
+# WebHost
+
+## Contribution Guidelines
+**Thank you for your interest in contributing to the MultiworldGG website!**  
+Much of the content on the website is generated automatically, but there are some things
+that need a personal touch. For those things, we rely on contributions from both the core
+team and the community. The current primary maintainer of the website is TreZc0_.
+
+### Small Changes
+Little changes like adding a button or a couple new select elements are perfectly fine.
+Tweaks to style specific to a PR's content are also probably not a problem. For example, if
+you build a new page which needs two side by side tables, and you need to write a CSS file
+specific to your page, that is perfectly reasonable.
+
+### Content Additions
+Once you develop a new feature or add new content the website, make a pull request. It will
+be reviewed by the community and there will probably be some discussion around it. Depending
+on the size of the feature, and if new styles are required, there may be an additional step
+before the PR is accepted wherein Farrak works with the designer to implement styles.

WebHostLib/__init__.py

@@ -0,0 +1,131 @@
+import base64
+import os
+import socket
+import typing
+import uuid
+
+from flask import Flask
+from flask_socketio import SocketIO
+from flask_caching import Cache
+from flask_compress import Compress
+from pony.flask import Pony
+from werkzeug.routing import BaseConverter
+
+from Utils import title_sorted, get_file_safe_name,world_list_sorted
+
+UPLOAD_FOLDER = os.path.relpath('uploads')
+LOGS_FOLDER = os.path.relpath('logs')
+os.makedirs(LOGS_FOLDER, exist_ok=True)
+
+app = Flask(__name__)
+Pony(app)
+socketio = SocketIO(
+    app,
+    cors_allowed_origins="*",
+    async_mode="gevent",
+    message_queue=os.environ.get("REDIS_URL", "redis://127.0.0.1:6379/0"),
+    logger=False,
+    engineio_logger=False,
+)
+
+app.jinja_env.filters['any'] = any
+app.jinja_env.filters['all'] = all
+app.jinja_env.filters['get_file_safe_name'] = get_file_safe_name
+
+# overwrites of flask default config
+app.config["DEBUG"] = False
+app.config["PORT"] = 80
+app.config["UPLOAD_FOLDER"] = UPLOAD_FOLDER
+app.config["MAX_CONTENT_LENGTH"] = 64 * 1024 * 1024  # 64 megabyte limit
+# if you want to deploy, make sure you have a non-guessable secret key
+app.config["SECRET_KEY"] = bytes(socket.gethostname(), encoding="utf-8")
+app.config["SESSION_PERMANENT"] = True
+app.config["MAX_FORM_MEMORY_SIZE"] = 2 * 1024 * 1024  # 2 MB, needed for large option pages such as SC2
+
+# custom config
+app.config["SELFHOST"] = True  # application process is in charge of running the websites
+app.config["GENERATORS"] = 8  # maximum concurrent world gens
+app.config["HOSTERS"] = 8  # maximum concurrent room hosters
+app.config["SELFLAUNCH"] = True  # application process is in charge of launching Rooms.
+app.config["SELFLAUNCHCERT"] = None  # can point to a SSL Certificate to encrypt Room websocket connections
+app.config["SELFLAUNCHKEY"] = None  # can point to a SSL Certificate Key to encrypt Room websocket connections
+app.config["SELFGEN"] = True  # application process is in charge of scheduling Generations.
+# at what amount of worlds should scheduling be used, instead of rolling in the web-thread
+app.config["JOB_THRESHOLD"] = 1
+# after what time in seconds should generation be aborted, freeing the queue slot. Can be set to None to disable.
+app.config["JOB_TIME"] = 600
+# memory limit for generator processes in bytes
+app.config["GENERATOR_MEMORY_LIMIT"] = 4294967296
+app.config['SESSION_PERMANENT'] = True
+# set worlds requested to be removed by maintainer as hidden by default
+app.config['HIDDEN_WEBWORLDS'] = ["Super Mario World", "Sonic Adventure 2 Battle", "Celeste 64", "Donkey Kong Country 3", "Celeste (Open World)"]
+
+# waitress uses one thread for I/O, these are for processing of views that then get sent
+# sekailink.xyz uses gunicorn + nginx; ignoring this option
+app.config["WAITRESS_THREADS"] = 10
+# a default that just works. sekailink.xyz runs on postgresql
+app.config["PONY"] = {
+    'provider': 'sqlite',
+    'filename': os.path.abspath('ap.db3'),
+    'create_db': True
+}
+app.config["MAX_ROLL"] = 20
+app.config["CACHE_TYPE"] = "SimpleCache"
+app.config["CACHE_DEFAULT_TIMEOUT"] = 300  # 5 minutes default
+app.config["CACHE_KEY_PREFIX"] = "multiworld_"
+app.config["HOST_ADDRESS"] = ""
+app.config["ASSET_RIGHTS"] = False
+app.config["MONITORING_ADMIN_TOKEN"] = None  # Admin token for monitoring API endpoints
+app.config["TERMS_VERSION"] = "v1"
+app.config["LOBBY_TIMEOUT_SECONDS"] = 6 * 60 * 60
+app.config["LOBBY_EMPTY_TIMEOUT_SECONDS"] = 60 * 60
+app.config["DEV_LOGIN_ENABLED"] = True
+
+cache = Cache()
+Compress(app)
+
+
+def to_python(value: str) -> uuid.UUID:
+    return uuid.UUID(bytes=base64.urlsafe_b64decode(value + '=='))
+
+
+def to_url(value: uuid.UUID) -> str:
+    return base64.urlsafe_b64encode(value.bytes).rstrip(b'=').decode('ascii')
+
+
+class B64UUIDConverter(BaseConverter):
+
+    def to_python(self, value: str) -> uuid.UUID:
+        return to_python(value)
+
+    def to_url(self, value: typing.Any) -> str:
+        assert isinstance(value, uuid.UUID)
+        return to_url(value)
+
+
+# short UUID
+app.url_map.converters["suuid"] = B64UUIDConverter
+app.jinja_env.filters["suuid"] = to_url
+app.jinja_env.filters["title_sorted"] = title_sorted
+app.jinja_env.filters["world_list_sorted"] = world_list_sorted
+
+
+def register() -> None:
+    """Import submodules, triggering their registering on flask routing.
+    Note: initializes worlds subsystem."""
+    import importlib
+
+    from werkzeug.utils import find_modules
+    # has automatic patch integration
+    import worlds.Files
+    app.jinja_env.filters['is_applayercontainer'] = worlds.Files.is_ap_player_container
+
+    from WebHostLib.customserver import run_server_process
+    import WebHostLib.lobbies
+    import WebHostLib.realtime
+
+    for module in find_modules("WebHostLib", include_packages=True):
+        importlib.import_module(module)
+
+    from . import api
+    app.register_blueprint(api.api_endpoints)

WebHostLib/api/__init__.py

@@ -0,0 +1,15 @@
+"""API endpoints package."""
+from typing import List, Tuple
+
+from flask import Blueprint
+
+from ..models import Seed, Slot
+
+api_endpoints = Blueprint('api', __name__, url_prefix="/api")
+
+
+def get_players(seed: Seed) -> List[Tuple[str, str]]:
+    return [(slot.player_name, slot.game) for slot in seed.slots.order_by(Slot.player_id)]
+
+# trigger endpoint registration
+from . import datapackage, generate, monitoring, room, tracker, user, sphere_tracker

WebHostLib/api/datapackage.py

@@ -0,0 +1,32 @@
+from flask import abort
+
+from Utils import restricted_loads
+from WebHostLib import cache
+from WebHostLib.models import GameDataPackage
+from . import api_endpoints
+
+
+@api_endpoints.route('/datapackage')
+@cache.cached()
+def get_datapackage():
+    from worlds import network_data_package
+    return network_data_package
+
+
+@api_endpoints.route('/datapackage/<string:checksum>')
+@cache.memoize(timeout=3600)
+def get_datapackage_by_checksum(checksum: str):
+    package = GameDataPackage.get(checksum=checksum)
+    if package:
+        return restricted_loads(package.data)
+    return abort(404)
+
+
+@api_endpoints.route('/datapackage_checksum')
+@cache.cached()
+def get_datapackage_checksums():
+    from worlds import network_data_package
+    version_package = {
+        game: game_data["checksum"] for game, game_data in network_data_package["games"].items()
+    }
+    return version_package