Merge remote-tracking branch 'origin/main' into sw1132
This commit is contained in:
+19
-11
@@ -134,12 +134,12 @@ Geist (400, 500, 600) and Geist Mono (400), bundled under the SIL Open Font Lice
|
||||
|
||||
## Surfaces
|
||||
|
||||
- **Launcher** (`launcher/`): top bar; Play is a page header (version as the title, its notes'
|
||||
first line under it), the client/server segmented control, the version picker and Play, then
|
||||
an index list of Resources, Minecraft folder (and the server rows). Versions and Patch notes
|
||||
are index lists with the release name as the title; Settings is an index list of switches and
|
||||
values. The opening is the faint wordmark drawn letter by letter, then the interface arrives.
|
||||
The sunset photograph is gone: the window is the page colour, light or dark with the system.
|
||||
- **Launcher** (`launcher/`): drawn in the Blocks look below. A top bar (wordmark, the pages as
|
||||
tabs, the account chip, Settings), a sidebar (the instances, the hosted servers, the launcher's
|
||||
own version and channel at its foot), and the page over a stone texture. Home opens on a pixel
|
||||
landscape banner with the hero, the version picker and Play; Mods holds the resource pack,
|
||||
shader pack and modpack tabs; Versions and Patch notes are lists of panels; Settings is
|
||||
grouped panels of rows. Dark by default, Light or System in Settings (Appearance).
|
||||
- **Website** (`website/`): the Blocks look below. The same page structure as before (what it
|
||||
is, screenshots, parity, launcher, patch notes, community), headings in Pixelify Sans, lists as
|
||||
stacks of panels, the stone texture behind the page and Horizon's pixel landscape (a dawn or a
|
||||
@@ -162,11 +162,19 @@ of the main action. The game's menus keep `LIGHT` and `DARK`.
|
||||
- **Blocks, not rounded cards.** Every surface is square: a 2 px dark outline, a 2 px light bevel
|
||||
along the top and a darker lip along the bottom. The main action is the violet face with its own
|
||||
bevel and a 4 px lip; it sinks a pixel when pressed. Code and fields are sunk wells.
|
||||
- **Pixel art drawn in code.** The stone behind the pages is 64 texels of the page colour in five
|
||||
close shades (`TILE_SHADES`), never Minecraft's stone; the landscape is a banded sky, a sun cut in
|
||||
slices like the mark, hills and square trees. `website/scripts/art.mjs` draws both.
|
||||
- **Icons** (the launcher): Pixelarticons (MIT), 24 unit pixel SVGs in
|
||||
`crates/horizon-theme/icons/pixel/`.
|
||||
- **Inventory tabs** switch the kinds in Mods: the open tab joins the panel under it.
|
||||
- **Slots** hold pictures: a mod's or pack's own icon and gallery images from its source,
|
||||
downloaded when first shown and kept on disk (`launcher/src/browser/images.rs`); the launcher
|
||||
ships no third-party pictures. The Horizon instance shows a grass block drawn from the player's
|
||||
own prepared Minecraft textures. Sources are named in text ("from Modrinth"): Modrinth's logo is
|
||||
all rights reserved, so it is not shown.
|
||||
- **Pixel art drawn in code.** The stone behind the pages is close shades of the page colour
|
||||
(`TILE_SHADES`), never Minecraft's stone; the landscape is a banded sky, a sun cut in slices like
|
||||
the mark, hills and square trees (a sunset in dark, a dawn in light). The launcher bakes them in
|
||||
`launcher/src/art.rs` at the window's scale so each texel covers whole device pixels; the website
|
||||
draws them in `website/scripts/art.mjs`.
|
||||
- **Icons**: Pixelarticons (MIT), 24 unit pixel SVGs in `crates/horizon-theme/icons/pixel/`, tinted
|
||||
with the text colour.
|
||||
- **Contrast**: every text colour meets WCAG AA (4.5:1) on the panels, the page and the lightest
|
||||
stone shade in both palettes (`blocks_text_meets_wcag_aa_in_both_appearances`).
|
||||
|
||||
|
||||
+56
-3
@@ -51,6 +51,19 @@ or GeckoLib) is listed as not ported. A mod that shares its id or a namespace wi
|
||||
game reads mod content when it starts: start it again after installing. **Remove** deletes the folder and turns it
|
||||
off.
|
||||
|
||||
### End-to-end check
|
||||
|
||||
`tools/mod_browser_harness.py [--mod SLUG] [--query TEXT] [--keep]` runs the whole path a player takes, in a scratch
|
||||
game folder: the launcher's `mods search --kind mod`, `mods check` and `mods install` (Modrinth), then the game
|
||||
opens a survival world with the mod offscreen (horizon-ctl), places one of its blocks, and crafts one of its recipes
|
||||
from vanilla ingredients on a crafting table and takes the result. It times the world's load with and without the
|
||||
mod and prints a JSON summary; it exits 1 when a step fails. It needs the launcher, the game and horizon-ctl built
|
||||
and the prepared 26.3 resources in `.local`.
|
||||
|
||||
On the Mac mini (M4 Pro, offscreen) with Macaw's Fences and Walls (the default): check 4.0 s, install 3.1 s, world
|
||||
load 5.4 s without mods and 7.3 s with it (resources 1.1 s and 2.6 s: the mod content folder is built on the first
|
||||
start); the hedge places and its recipe crafts 4.
|
||||
|
||||
## Checks on every download
|
||||
|
||||
- The file must come from Modrinth's or CurseForge's file servers (`cdn.modrinth.com`, `edge.forgecdn.net`,
|
||||
@@ -71,6 +84,41 @@ report, **Port** and **Play** ([modpacks.md](modpacks.md)). Installed packs are
|
||||
file and the checksum they were checked against, with **Update to …** when a newer version runs and **Remove**
|
||||
(asked twice).
|
||||
|
||||
### Project pages, filters and icons
|
||||
|
||||
A result's title opens its page inside the launcher, not in a web browser: its icon, authors, downloads, followers,
|
||||
last update, licence and source, how well it runs (for a Java mod, what ports and what doesn't, from its check) with
|
||||
**Install** or **Import**, the project's links (its page on the source, source code, issues, wiki, Discord,
|
||||
donations; `https://` only, opened in the system browser), then three tabs: **Description** (the project's Markdown,
|
||||
drawn by the launcher's renderer), **Gallery** and **Versions** (each version's date, loaders, game versions, file
|
||||
and size, and the verdict of any version already checked). The data is `browser::details` (`Source::details`; on
|
||||
Modrinth `GET /project/{id}` and `/project/{id}/members`, then `/project/{id}/version`).
|
||||
|
||||
**Filters** sit above the results: the order (best match, relevance, downloads, follows, newest, updated) and, under
|
||||
**Filters**, the loader, game version, environment (client, server) and categories, with the values the source lists
|
||||
for the kind (Modrinth's `/tag/category`, `/tag/loader`, `/tag/game_version`, asked once per run). A loader or version
|
||||
picked replaces the default (Java mod loaders and 26.3 for mods); a version other than 26.3 checks and installs the
|
||||
newest file for 1.21 or later, as **Show everything** does. Changing tabs clears the filters. CurseForge support
|
||||
is coming soon; its source already maps the order and the game version.
|
||||
|
||||
**Icons and gallery images** are the projects' own, fetched at run time from the source's image server
|
||||
(`browser::images`): HTTPS from `cdn.modrinth.com` (or CurseForge's `media.forgecdn.net` / `edge.forgecdn.net`) only,
|
||||
at most 8 MB each, decoded (PNG, JPEG, WebP, GIF, at most 8192 pixels a side), scaled (icons 128 px, gallery 960 px)
|
||||
and kept as PNGs in `mod-browser/images/` under the game folder, which is kept under 128 MB by dropping the oldest
|
||||
files. A plate with the project's initial stands in until the icon arrives. Nothing of a project's art is in the
|
||||
launcher or the repository.
|
||||
|
||||
**Vanilla Minecraft** is marked with a grass block drawn at run time from the player's own prepared game files
|
||||
(`assets/minecraft/textures/block/grass_block_*.png`, tinted with the plains grass colour): the game-version filter
|
||||
shows it. No Mojang file or logo is in the launcher or the repository.
|
||||
|
||||
**Source logos.** Modrinth's logo is not shown: Modrinth's own repository says its branding is all rights reserved and
|
||||
"the use of Modrinth branding elements, including but not limited to the wrench-in-labyrinth logo, ... is strictly
|
||||
prohibited without explicit written permission from Rinth, Inc." (`packages/assets/COPYING.md` in
|
||||
[modrinth/code](https://github.com/modrinth/code/blob/main/packages/assets/COPYING.md)), and its
|
||||
[terms](https://modrinth.com/legal/terms) ask for prior written permission to use its marks. Results name their source
|
||||
in text ("from Modrinth") until Rinth, Inc. agrees. CurseForge support, and so its logo, is coming soon.
|
||||
|
||||
## Installing, updating, removing
|
||||
|
||||
`mod-browser.json` beside `options.txt` lists every file the browser installed: its source, project, version, file
|
||||
@@ -83,15 +131,20 @@ same name the player put there is never overwritten.
|
||||
Packs, as in vanilla and Iris.
|
||||
- **Update** installs the newer version and removes the old file.
|
||||
- **Remove** deletes the file and its entry. Packs installed as dependencies stay.
|
||||
- **A modpack** is downloaded (checked the same way) into `ports/downloads/` and imported; the Modpacks tab says
|
||||
what of it Horizon runs and ports it.
|
||||
- **A modpack** is downloaded (checked the same way) into `ports/downloads/`, imported, and ported straight away
|
||||
for the selected version when it is prepared (`modpacks::import_and_port`): the jars of the mods Horizon can carry
|
||||
over come from the pack's links or Modrinth, and the message says how many of its files play. **Play** on the
|
||||
Modpacks tab starts it with every ported mod on together. A ported mod that owns a namespace an earlier one owns
|
||||
(the game would refuse it) is left off before the game starts and listed under the pack ("Left off: ..."); the
|
||||
coverage list says why each mod that didn't port didn't. A port that fails leaves the pack imported, with **Port**
|
||||
to try again. Measured on three packs in [modpacks.md](modpacks.md#three-packs-through-the-mod-browser-measured).
|
||||
|
||||
From a terminal (or an agent):
|
||||
|
||||
```sh
|
||||
horizon-launcher mods search faithful # --kind mod|modpack|resource|shader, --everything, --source
|
||||
horizon-launcher mods check macaws-fences-and-walls # a Java mod's verdict, what ports and what doesn't (--json)
|
||||
horizon-launcher mods install faithful-32x # id or slug; a Java mod is ported, a modpack imported
|
||||
horizon-launcher mods install faithful-32x # id or slug; a Java mod is ported, a modpack imported and ported
|
||||
horizon-launcher mods list # --json
|
||||
horizon-launcher mods update [faithful-32x] [--check]
|
||||
horizon-launcher mods remove faithful-32x
|
||||
|
||||
+33
-4
@@ -240,6 +240,10 @@ How the game loads them, without touching vanilla's path:
|
||||
when its Java original ships them so (`namespaces = ["kaisyn", "towns_and_towers"]` for Towns
|
||||
and Towers, mod id `t_and_t`; docs/mods.md). No namespace has two owners: a mod whose id or
|
||||
listed namespace another mod that is on already owns is left out, with both named in the log.
|
||||
`horizon-port-pack` avoids that inside a pack: a namespace two carried mods both claim (YUNG's
|
||||
structure mods all ship files under `yungsapi`, the namespace of YUNG's API, whose own jar isn't
|
||||
carried) is left to none of them, and its files stay outside. The launcher applies the game's
|
||||
rule before it starts a pack (`pipeline::loadable`) and lists what it left off.
|
||||
- The overlay is built on the first start with a set of mods and kept for later starts. A stamp
|
||||
(`horizon-mod-content.stamp`) hashes the game executable, the base tables and every mod file's
|
||||
size and mtime. Adding, removing or editing a mod, or a new build of Horizon, rebuilds it. For
|
||||
@@ -322,8 +326,8 @@ Fabric API doesn't run (its id has a dash, which content mods can't use). A chec
|
||||
by SHA-1, or through a CurseForge app instance's `minecraftinstance.json`), else downloaded from
|
||||
the link the pack itself gives (a `.mrpack`'s, on the format's hosts only) or, for a CurseForge
|
||||
pack, the same file on Modrinth's public CDN, found by its SHA-1. A jar is kept only when its
|
||||
hash matches. A file only CurseForge has is listed as needing a CurseForge API key (Ludovic's
|
||||
decision; open question below), with the player's installed instance as the way round it.
|
||||
hash matches. A file only CurseForge has is listed as "CurseForge downloads coming soon" (its API
|
||||
needs a paid key; Ludovic, 2026-10-22), with the player's installed instance as the way round it.
|
||||
`<work>/fetch.json` says what happened to each file. On All the Mods 10 8.3's CurseForge zip
|
||||
(2026-10-17): of the 54 data-tier content mods, 42 come from Modrinth's CDN (84 MB) and 12 need
|
||||
the key or the instance; `port` then carries the 42 over (0 ported, 42 partial: the harness is a
|
||||
@@ -1047,10 +1051,35 @@ What is missing, ranked by how much a player notices:
|
||||
6. **Smaller gaps:** Mo' Structures' mixin that keeps lakes out of its structures and its two
|
||||
block-ageing processors, and the 5 missing block models.
|
||||
|
||||
### Three packs through the mod browser, measured
|
||||
|
||||
2026-10-22, Mac mini M4 Pro (offscreen, a debug launcher, release-profile `horizon-port-pack` and game), while
|
||||
other sessions kept the CPU at 85 to 93 %, so times are upper bounds. The two Modrinth packs were imported with
|
||||
`horizon-launcher mods install <slug>` (the browser's Import), ATM10 from its CurseForge zip with `modpack import`
|
||||
(CurseForge support is coming soon), then each ported with `--resources` for 26.3 and opened as a survival
|
||||
world with every ported mod on (horizon-ctl `launch --dev-mod ...`, from a scratch script).
|
||||
|
||||
| Pack | Files | Import | Port | Ported mods | Coverage | Declared | World load (resources) | Crashes |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| Vanilla Perfected 26.3 (Fabric, small) | 108 | 30.4 s | 1.0 s | 2 | 2 partial, 79 not yet, 27 not needed | 0 blocks (a trail effect, a torch-flower texture) | 5.2 s (2.1 s) | none |
|
||||
| Slimes Adventure 1.13.4 (Fabric 1.21.1, medium) | 105 | 18.8 s | 22.8 s | 20 | 20 partial, 46 not yet, 39 not needed | 8,208 blocks, 41 items, 1,376 recipes | 23.0 s (15.0 s) | none |
|
||||
| All the Mods 10 8.3 (NeoForge 1.21.1, CurseForge zip) | 496 | 3.1 s | 29.4 s | 42 | 42 partial, 333 not yet, 121 not needed | 10,000 blocks, 1,273 items, 4,178 recipes | 38.3 s (28.7 s) | none |
|
||||
|
||||
The same world with no mods loads in 5.4 s (resources 1.1 s). Import is the pack download and Modrinth's answers by
|
||||
file hash; Vanilla Perfected's 30 s is mostly its 108 lookups and its download. Port is the jars (downloaded for the
|
||||
two Modrinth packs; ATM10's 42 copied from a folder, 12 more are on CurseForge only: CurseForge downloads coming soon) and the carry,
|
||||
which writes tens of thousands of small files. World load grows with the blocks the pack declares: ATM10 adds
|
||||
about 155,000 block states, and loading their models and textures is most of its 28.7 s.
|
||||
|
||||
Every world loaded and stayed up, with no panic and no error in the log. Before the namespace fix above, Slimes
|
||||
Adventure lost three of YUNG's mods at start ("both use the namespace yungsapi"); after it all 20 load. As a share of
|
||||
the mods that need porting (not counting performance mods and libraries), 2 of 81 ported partly, 20 of 66 and 42 of
|
||||
375. Every ported mod is Partial: their Java code (block entities, entities, Mixins) doesn't come along.
|
||||
|
||||
## Open questions for Ludovic
|
||||
|
||||
- Contacting authors of permissively licensed mods to publish ports (none contacted).
|
||||
- Whether players should run code-port agents themselves (their own Claude Code or Codex
|
||||
login, as Zenith does) or only download published ports.
|
||||
- A CurseForge API key for the launcher (CurseForge grants them to launchers on request). Until
|
||||
then, CurseForge packs import from an installed instance.
|
||||
- CurseForge: dropped for now (its API needs a paid key; Ludovic, 2026-10-22), shown as coming
|
||||
soon. CurseForge packs import from their zip or an installed instance.
|
||||
|
||||
Reference in New Issue
Block a user