NukeCoreCraft

## v0.2.0 — The Singularity Update

**Minecraft 1.20.1 | Forge 47+**

### New Features

#### Black Hole Overhaul

- **5-Phase Lifecycle** — Black holes now progress through distinct phases: Fuse → Forming → Pulling → Critical → Detonate, each with unique visuals and behavior.

- **Launch Ascent** — The Singularity Core rises into the air during the fuse phase using smoothstep easing before activation.

- **Floating Chunk Entities** — Terrain is now ripped out in irregular multi-block chunks (up to ~60 blocks each) that spiral toward the event horizon with orbital mechanics and tumbling rotation.

- **Mass Accumulation System** — Absorbed blocks contribute to a mass counter; once the configurable threshold (default 50,000) is reached, the black hole enters its critical phase.

- **Escalating Audio** — Added escalating beep sounds and ambient drones across all black hole phases.

#### Cinematic Black Hole Renderer

- **Event Horizon Sphere** — Dark, light-absorbing core rendered as 3D geometry.

- **Photon Ring** — Luminous halo around the event horizon that scales with phase.

- **Accretion Disk** — Tilted, expanding disk of absorbed material that grows with mass.

- **Corona Glow** — Camera-facing billboard glow effect.

- **Polar Energy Jets** — Directional beams extending from the black hole's poles.

- Smooth phase-based scale transitions with per-phase visual intensity.

#### Black Hole Proximity Screen Effects

- **Gravitational Lensing** — FOV distortion that intensifies as you approach a black hole.

- **Void Desaturation** — Screen color drains toward dark purple the closer you get.

- **Proximity Fog** — Creeping void darkness encroaches on the player's view.

- **Gravitational Tremor** — Camera shake effect from nearby singularities.

- **Heartbeat Pulse** — FOV pulses during the critical countdown phase.

- **Deep Void Vignette** — Darkened screen edges with pulsing overlay that "breathes" with the black hole.

#### Remote Detonator — Singularity Core Support

- The Remote Detonator can now link to and remotely activate **both** the Atomic Core and the Singularity Core.

- Updated feedback messages (e.g. "Remote linked to singularity core.") for clarity.

- Generic "device" language replaces "nuke" in status messages when applicable.

#### Revised Crafting Recipes

- **Atomic Core** — Redesigned recipe: Netherite Ingots + TNT + Nether Star center (previously used Shulker Boxes and Blaze Rods).

- **Singularity Core** — Redesigned recipe: End Crystals + Dragon Breath + Netherite Blocks + Atomic Core center (tier-2 recipe requiring an Atomic Core as an ingredient).

### Performance Improvements

- **FloatingBlockEntity** — Reusable collection pools for flood-fill block ripping, eliminating per-call allocations.

- **BlackHoleEntity** — Inlined shuffled neighbor iteration during terrain ripping avoids ArrayList and BlockPos allocations per node; uses MutableBlockPos for neighbor checks.

- **NukeCloudEntity** — Per-tick cached particle options for stem and cap smoke; pre-cached frequently used ScaledParticleOptions eliminates hundreds of per-particle allocations.

- **BlockEditQueue** — Improved block-edit batching efficiency.

- **NukeOverlayHandler** — Consolidated black hole proximity scanning into a single entity pass; uses lerp-based smoothing for all screen effect transitions.

### Bug Fixes

- Fixed overlay handler not properly tracking seen mushroom clouds between ticks.

- Fixed potential division-by-zero in mass ratio calculations for black hole visuals.

- Corrected NukeExplosion radius propagation to dependent systems (cloud entity, overlay handler, block edit queue).