Skip to content

feat(config): read the v2 library generation, and move old library URLs to it - #338

Merged
samsoir merged 1 commit into
develop/0.5.0from
feat/library-url-v2
Oct 23, 2026
Merged

samsoir merged 1 commit into
develop/0.5.0from
feat/library-url-v2

Conversation

@samsoir

@samsoir samsoir commented Oct 23, 2026

Copy link
Copy Markdown
Owner

From beta.1 the client reads library generation v2. Changing the default alone would move nobody: 0.4.8 wrote library_url into every config file it created.

  • DEFAULT_LIBRARY_URL is https://xearthlayer.app/packages/v2/xearthlayer_package_library.txt.
  • The pre-0.5 root URL and the alpha staging URL are retired values for packages.library_url: the parser reads them as the v2 URL, and the startup notice and config upgrade rewrite the file.
  • The first-start layout migration writes the v2 URL into the new config and says so. The legacy copy kept for a 0.4.x rollback was re-saved from the parsed config, which would have pointed 0.4.x at v2; it now keeps the URL it had.
  • A library URL of one's own is left alone.

Do not merge before #335: v2/ is not on xearthlayer.app until the promotion, so a build from develop could not fetch the library until then.

Verification

  • Tests: both retired URLs load as v2 and a custom URL does not; config upgrade rewrites them; the migration writes v2 to the new config, keeps the old URL in the legacy copy, and names the change.
  • Scratch HOME: a 0.4.8-style ~/.xearthlayer/config.ini with the old URL migrates with "packages.library_url now reads the rebuilt scenery library"; a migrated config naming the alpha staging URL reads v2, and config upgrade backs it up and rewrites it.

Closes #334

…Ls to it (#334)

From beta.1 the client reads library generation v2, the rebuilt world.
Changing the default alone would move nobody: 0.4.8 wrote library_url
into every config file it created.

- DEFAULT_LIBRARY_URL is
  https://xearthlayer.app/packages/v2/xearthlayer_package_library.txt.
- The pre-0.5 root URL (LEGACY_LIBRARY_URL) and the alpha staging URL
  (ALPHA_STAGING_LIBRARY_URL) are retired values for
  packages.library_url, read by the parser as the v2 URL, as
  prefetch.mode = auto is read as opportunistic. Every reader gets v2
  at once; the startup notice and config upgrade rewrite the file.
- The first-start layout migration saves the v2 URL into the new
  config and says so. The legacy copy of the config, kept for a
  rollback to 0.4.x, was re-saved from the parsed config and so would
  have pointed 0.4.x at the v2 world; it now keeps the URL it had.

A library URL of one's own is left alone.

Verified in a scratch HOME: a 0.4.8-style ~/.xearthlayer/config.ini
naming the old URL migrates with "packages.library_url now reads the
rebuilt scenery library", the new config holds the v2 URL and the
legacy copy the old one; a migrated config naming the alpha staging
URL reads v2, and config upgrade backs it up and rewrites it.

Closes #334
@samsoir
samsoir merged commit dfdfd6e into develop/0.5.0 Oct 23, 2026
2 checks passed
@samsoir
samsoir deleted the feat/library-url-v2 branch October 23, 2026 23:35
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.

1 participant