Celestial Survey

## v0.2.3: First Public Release (2026-05-20)

This is the first build of Celestial Survey pushed to CurseForge. Earlier versions (v0.0 through v0.2.2) existed only in private development, so this changelog doubles as a summary of where the mod currently stands plus a callout of the changes that landed in the Field Science slice.

### Requirements
- Minecraft 1.21.1
- NeoForge 21.1.228 or later
- Java 21 (required by Minecraft 1.21.x, not optional)
- KubeJS 2101.7.2 build 285 or later (the proof system uses the KubeJS bridge)

### What's in v0.2.3 overall

- Mod scaffold, namespace, registries, creative tab.
- Persistent **Proof Ledger** (player-scoped) with full `/aoacs` command suite: grant, revoke, reissue, list, dump.
- Datapack JSON loader with `schema_version` enforcement on every proof definition.
- KubeJS bridge exposing proof state and lifecycle events to pack scripts.
- v0.1 Lunar Survey loop: Observatory, Moon Dust Sample, survey notes pipeline.
- v0.2 Field Science slice (everything below).

### Recent additions: the Field Science slice

**New blocks**
- **Light Reader.** Analysis station with a line-matching minigame. Certifies Verified Lunar Survey from Lunar Survey Notes, and Verified Starlight Reading from Starlight Analysis.
- **Starlight Prism.** Collects Starlight Samples. Only works at night, with clear weather, sky access, and a charge timer that runs server-side.
- **Twin Sighting Marker.** Parallax puzzle. Requires two markers placed in the same dimension at a default minimum distance of 64 blocks.
- **Mission Console.** Assembles three certified proofs into a First Orbital Manifest. Verifies both the physical proof items and the matching ledger entries, but doesn't consume the inserted items.

**New items**
- Tier 1: Starlight Sample
- Tier 2: Lunar Survey Notes, Starlight Analysis
- Tier 3 proofs: Verified Starlight Reading, Twin Sighting Log, First Orbital Manifest

**Refactored**
- Observatory now produces Lunar Survey Notes (Tier 2) instead of going straight to Tier 3. To certify a Verified Lunar Survey, the notes have to run through the Light Reader.
- Backend ID for Verified Lunar Survey is unchanged. Existing ledger entries still resolve and can still be reissued through `/aoacs reissue`.

**Under the hood**
- KubeJS bridge contract split: the existing `machineBlocks()` surface stays stable, with new `fieldScienceBlocks()` and `fieldScienceProofs()` exposures for the v0.2 slice.
- Textures, blockstates, models, item models, recipes, loot tables, and proof JSON added and wired for all four new blocks and six new items.
- All 22 new Field Science textures verified by SHA256 against the packaged jar.
- Dev server smoke launch passes clean. Five proof definitions load, the KubeJS bridge smoke script runs, RCON shutdown completes cleanly.

### Known limitations in v0.2.3

- No v0.3 content yet (Anomaly Board, anomaly entities, detection systems).
- No v0.4 content yet (black holes, certification chain, Pocket and Rift dimensions).
- No JEI or EMI integration. Recipes function in-world but won't show up in those mods' guides.
- Modonomicon entries are stubs only.
- en_us only, no other localizations.
- FTB Teams compat (team-scoped ledger) deferred to v0.0.1. v0.2.3 is player-scoped only.

### Heads up

This version ships under the early-development disclaimer at the top of the project page. It is not intended for general installation. Please don't file bug reports or feature requests at this stage. See the project description for the full context.