LaunchGuard

LaunchGuard v0.5.0

LaunchGuard v0.5.0 adds local JSON and HTML exports, plus configuration validation for LaunchGuard config files.

This release includes the export work developed after v0.3.0. There was no separate public v0.4.0 release.

Added

• /launchguard export json
• /launchguard export html
• /launchguard validate
• launchguard.export permission
• launchguard.validate permission
• JSON report files under plugins/LaunchGuard/exports/
• Self-contained HTML report files under plugins/LaunchGuard/exports/
• Export retention with settings.exportsToKeep
• Versioned JSON export schema with schemaVersion: 1
• Configuration validation for config.yml, checks.yml, and messages.yml

JSON Export

Use:

/launchguard export json

JSON exports are saved under:

plugins/LaunchGuard/exports/

JSON exports include report metadata, server information, summary counts, result status, and individual check results.

HTML Export

Use:

/launchguard export html

HTML exports are saved under:

plugins/LaunchGuard/exports/

HTML reports are self-contained local files. They do not load external CSS, JavaScript, fonts, images, or CDN resources.

Configuration Validation

Use:

/launchguard validate

Validation checks:

• config.yml
• checks.yml
• messages.yml

It can report YAML parse errors, invalid types, missing sections, unknown keys, duplicate entries, empty values, and common configuration mistakes.

Validation does not modify files and does not reload configuration automatically.

Safety

LaunchGuard remains read-only.

It does not:

• Execute plugin commands
• Execute configured commands
• Install plugins
• Download plugins
• Enable or disable plugins
• Reload plugins
• Teleport players
• Modify blocks
• Modify worlds
• Modify economy data
• Modify permission data
• Change whitelist state
• Send network requests
• Upload data
• Force-load chunks

Exports are written only under plugins/LaunchGuard/exports/.

Export retention deletes only .json and .html files inside the exports directory.

Validation reads LaunchGuard configuration files but does not modify them.

Compatibility

• Tested on Paper 1.20.4 with Java 17
• Tested on Paper 1.20.6 with Java 21
• Tested on Paper 1.21.1 with Java 21
• Tested on Paper 1.21.8 with Java 21
• Built with Java 17 target compatibility
• Use the Java version required by your Paper server version

Limitations

• Export is manual only.
• Validation does not perform cross-file validation.
• Validation does not check actual plugin runtime behavior.
• Validation does not replace /launchguard run.
• Message key validation uses a static expected-key list.