Skip to content

About

Player HUD packages for PlxNative: the registry

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

PlxNative Player HUD registry

Declarative player layouts for PlxNative. A source directory becomes one deterministic .plxhud bundle through the native SDK. Start with AUTHORING.md, the manifest schema, the HUD schema and an example.

The Cinema HUD seeds the registry; examples/ holds the sources to start from. Validation uses the app's exact compiler, all shipped languages and the oldest compatible hash-pinned Ubuntu 24.04 x86_64 simulator. CI renders native state previews, checks exact native-built archive hashes and prepares a Pages catalog with revocation and compatibility data.

The source-pinned bundle SDK, native-emitted schemas and measured calibration profile are imported. The complete registry-native lint, authoring and preview acceptance run remains pending.

The published index is signed. index.signed holds the exact bytes of index.json (which carries a serial, the publish run's UTC epoch seconds) under an Ed25519 signature from one of the two public keys in keys.json; the app accepts only that file. Only a deploying run of the main workflow holds the signing key. IMPLEMENTATION.md gives the format, the key rotation plan and the stock openssl command that verifies a download.

The registry is public. IMPLEMENTATION.md records acceptance evidence. Main deploys the verified catalog to GitHub Pages with the repository variable PUBLISH_PAGES=true. Pushes also retain the catalog as a CI artifact. Disabling that variable keeps artifact staging available; a manual workflow dispatch with publish=true deploys explicitly.

The app workflow can send an app-release-probe after the dispatch secret is configured. This runs the same registry discovery/re-lint backstop without accepting a synthetic app-release pin. GitHub's combined Actions create/approve-PR setting must allow PR creation for the compatibility projection to open its review PR; the workflow never approves or merges it.

About

Player HUD packages for PlxNative: the registry

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages