Repository navigation
Fixes
- Prevent cached/local resource packs from entering a stale JOIN shield after
SUCCESSFULLY_LOADEDor another terminal status was already delivered. - Avoid the resulting unnecessary timeout/overlay cleanup path associated with the reported 26.2 disconnect sequence.
Configuration migration
- Upgrade
config.ymlto schema 3 with every supported option documented inline. - Insert missing settings in canonical order, repair invalid known values, and remove unknown entries only after preserving the original.
- Use atomic replacement, content-addressed backup deduplication, a 1 MiB parse bound, and a maximum of 10 automatic backups.
- Refuse to rewrite configs from a newer schema version.
Compatibility and verification
- Paper 1.21.1 API lower-bound build: 12 tests passed.
- Paper 26.2 build 92 upper-bound build: 12 tests passed.
- Paper 26.2 build 92 and Folia 26.2 build 1 lifecycle/schema-migration smoke tests passed on Java 25.
- CI: https://github.com/siberanka/LoadScreenShield/actions/runs/30908329895
- JAR SHA-256:
F5ACBD64B16190A670B74DDEBEE12779333C7C5B01C887D78482D2DC143CE0A3
Before upgrading, stop the server and retain the plugin folder backup. The plugin also creates config.yml.backup-...yml automatically before its first schema rewrite.