Genesis: Core Lib

⚙️ Genesis: Core

The High-Performance Engine & Unified Settings Hub for the Genesis Suite

---

⚠️ Library Notice

Genesis: Core is the foundational engine and library for the Genesis mod ecosystem. It runs quietly in the background to power atmospheric and terrain modules like Genesis: Horizon and Genesis: Atlas. Install it alongside any Genesis module to unlock its features.

---

The central thermodynamic backbone and performance engine of Genesis.

Genesis: Core provides the foundational climate, calendar, and performance architecture for the entire Genesis family. Built with an uncompromising 20 TPS guarantee, it replaces Minecraft's dated, static environmental rules with a living, thermodynamic world—all while ensuring your game runs as smooth as silk.

---

🌟 At a Glance: Core Features

System	What It Does	Player & Server Benefit
🎛️ Unified Settings Hub	Central configuration screen for all Genesis mods	Press G anywhere to tweak all settings in one clean place
🌡️ Thermodynamic Engine	Real °C temperatures based on sun, altitude & season	Water freezes strictly at 0 °C; realistic climate physics
🪵 Radiant Heat & Drafts	Campfires heat rooms; open windows create drafts	Bases feel warm and cozy; smart shelters block wind and rain
⏱️ Cinematic Benchmark	30-second camera fly-through stress test	One-click hardware rating, frametime graphs & 1080p PNG scorecard
⭐ Recommended Profile	Hardware auto-tuning intelligence	Analyzes your PC and selects the optimal graphic preset
⚡ Zero-Stutter Pipeline	Decoupled render loop & freeze prevention	Butter-smooth 144+ FPS and rock-solid 20 TPS server stability

---

🎛️ One Unified Settings Hub (Press G)

No more hopping through multiple confusing configuration screens or manually editing text files. Every Genesis mod links directly into a unified in-game menu:

• Everything in One Spot: Manage graphics, performance profiles, weather intensity, and calendar settings from a single, clean interface.
• Modern Controls: Tactile toggle switches, intuitive sliders with real units (%, blocks, minutes), and instant default reset buttons.
• Live Application: Changes take effect immediately the second you apply them—no game restarts required.
• Instant Access: Open the hub at any time by pressing the G key, clicking the G icon on your title/pause screen, or typing /genesis config.

---

🌡️ Living °C Temperature & Thermodynamic Physics

Minecraft biomes normally rely on static, artificial temperature tags. Genesis replaces this with a continuous, living thermodynamic simulation:

• True Celsius Physics: Temperature shifts dynamically based on your altitude, the time of day, active seasons, and approaching storm fronts.
• Physical Freezing Point: Water freezes strictly at 0 °C—even a desert oasis can skim over with ice during a clear, freezing desert night.
• Realistic Snowmelt: Snow layers and icicles melt naturally according to ambient warmth, rather than arbitrary biome boundaries.

---

🪵 Campfire Warmth, Drafts & Smart Shelters

Transform your base into a genuine sanctuary against the harsh elements:

• Radiant Heat Sources: Campfires, furnaces, lava, and torches cast real physical warmth into enclosed rooms.
• Realistic Room Drafts: Enclosed rooms stay insulated from external cold. Leaving a door or window open during a gale allows cold air drafts to sweep inside.
• Intelligent Shelter Detection: The engine distinguishes between vertical rain and sideways-driven blizzards. Roofs keep out rain, while solid walls shield you from howling winds.

---

⏱️ Cinematic Benchmark & Hardware Auto-Tuning

Wondering how well your PC handles modern visuals? Genesis includes a professional, built-in benchmarking suite:

• 30-Second Fly-Through Spline: Experience an automated cinematic camera flight gliding through dense forests, swooping through deep caverns, and climbing into stormy skies.
• Interactive Frametime Graph: Pinpoint any micro-stutters or frame pacing issues with a clean visual timeline.
• ⭐ Recommended Profile: The benchmark analyzes your hardware capabilities and automatically recommends the best graphic preset (Cinematic, Balanced, or Performance) for your PC.
• Shareable Scorecard: Automatically exports a stylish 1080p scorecard PNG image to share your hardware rating with friends.

---

⌨️ Quick Controls & Commands

Shortcut / Command	Action	Description
G Key	Open Genesis Hub	In-game configuration menu for all installed Genesis mods
/genesis config	Open Settings	Chat command to open the universal settings screen
/genesis perf	Performance Telemetry	Real-time diagnostic readouts for tick and render overhead
Main Menu → Benchmark	Launch Stress Test	Runs the 30-second automated cinematic fly-through benchmark

---

🗺️ Feature Status & Roadmap

Status	Feature	Details
🟢 Delivered	Genesis Config Hub	Centralized in-game settings menu with live preset switching
🟢 Delivered	Fly-Through Benchmark	30s multi-stage camera stress test with 1080p scorecard PNG
🟢 Delivered	Recommended Profile Engine	Dynamic hardware profiling and preset auto-recommendation
🟢 Delivered	Dynamic °C Temperature	Altitude, diurnal, seasonal, and storm temperature physics
🟢 Delivered	Radiant Heat & Drafts	Campfires warm enclosed rooms; open windows create drafts
🟢 Delivered	ANR-Free World Loading	Prevents Windows "Not Responding" crashes during world loads
⏳ Planned	Survival & Biology Hooks	API hooks for upcoming body temperature and wildlife modules

---

🧩 Genesis Family Architecture

┌──────────────────────────────────────────────────────────────┐
│                      GENESIS: CORE                           │
│       Thermodynamic Physics Engine · Unified Settings Hub    │
│           Cinematic Benchmark · 20 TPS Performance           │
└───────────────┬──────────────────────────────┬───────────────┘
                │                              │
                ▼                              ▼
┌──────────────────────────────┐┌──────────────────────────────┐
│       GENESIS: ATLAS         ││      GENESIS: HORIZON        │
│   Continents · True Rivers   ││   Seasons · 3D Rain · Auroras│
│   Karst Caves · Plateaus     ││   4K Milky Way · Lens Drops  │
└──────────────────────────────┘└──────────────────────────────┘

---

💡 Modpack Developers & API Access

Genesis: Core includes an open Java API allowing modders and modpack creators to query local temperatures, wind vectors, and shelter status with sub-microsecond speeds. Feel free to include Genesis: Core in any modpack on CurseForge or Modrinth!