Chrono Dawn

Time-manipulation themed dimension mod for Minecraft

A multi-loader Minecraft mod that adds a mysterious time-themed dimension called "Chrono Dawn" with custom portals, unique biomes, powerful bosses, and time-manipulating artifacts.

More screenshots available on CurseForge and Modrinth

⚠️ Save compatibility (v0.2.0 → v0.3.0+ breaking change)

Worlds created in v0.2.0 or earlier are NOT compatible with v0.3.0+ (including the current release).

Breaking changes were introduced in v0.3.0:

Portal System Rewrite: Pre-v0.3.0 portals will not function. You must break and rebuild them using Time Hourglass.
Save Data Changes: Boss defeat progress tracked by the legacy Eye of Chronos format may be reset.

Recommendation: Back up your world before updating, or start a new world. No further breaking changes have been introduced since v0.3.0.

See CHANGELOG.md for detailed information.

Features

Core Mechanics

Custom Dimension: Explore Chrono Dawn, a dimension frozen in perpetual twilight
Portal System: One-way portal travel using Time Hourglass, upgradeable to bidirectional with Portal Stabilizer
Time Distortion: Hostile mobs move slower in Chrono Dawn dimension
11 Unique Biomes: Forest, Plains, Desert, Mountain, Ocean, Snowy, Swamp, Dark Forest, Ancient Forest, Prairies, and Faded Plains

Content

Custom Wood Types: Time Wood, Dark Time Wood, and Ancient Time Wood — each with a full block set (logs, planks, stairs, slabs, doors, trapdoors, fences, buttons, pressure plates, saplings). Tall tree variants now generate as 2×2 mega trunks.
Major Structures:
- Ancient Ruins (Overworld spawn)
- Forgotten Library (Chrono Dawn)
- Desert Clock Tower (Time Guardian mini-boss; source of Enhanced Clockstone)
- Guardian Vault (Chronos Warden boss)
- Clockwork Depths (Clockwork Colossus boss)
- Phantom Catacombs (Temporal Phantom boss)
- Entropy Crypt (Entropy Keeper boss)
- Master Clock (final dungeon with Time Tyrant boss)
Small Ambient Structures (scattered across Chrono Dawn biomes): Watchmaker's Camp (chest loot), Hourglass Monolith, Old Sundial, Petrified Adventurer (with snowy variant), Time Cairn, Time Well, and Upside-Down Tree
Friendly Mobs in Chrono Dawn: Chrono Bovine (cow-equivalent; drops Chrono Bovine Meat), Chrono Ursid (polar-bear-equivalent), Temporal Caprid (goat-equivalent)
Cave Decoration: Temporal Stalactites and Temporal Stalagmites with tip + frustum variants, enhanced fall damage on tips, and cascading column breaks
Aquatic Plants (Chrono Dawn ocean/swamp): Temporal Kelp, Temporal Seagrass + Tall variant, Lumen Polyp (underwater light source), and Dawn / Dusk / Twilight / Eternal Chrono Coral
Lighting Blocks: Time Torches (Orange / Pink / Purple) crafted from Time Blossoms, and Temporal / Dawn / Dusk Lanterns
Faded Plains Biome Content: Faded Temporal Grass, Parched Temporal Dirt, and Temporal Dead Bush surface flora for the new dry biome
Boss Enemies:
- Time Guardian (mini-boss, drops Master Clock Key)
- Chronos Warden (mid-boss, drops Guardian Stone)
- Clockwork Colossus (mid-boss, drops Colossus Gear)
- Temporal Phantom (mid-boss, drops Phantom Essence)
- Entropy Keeper (mid-boss, drops Entropy Core)
- Time Tyrant (final boss, drops Fragments of Stasis Core)
Ultimate Artifacts:
- Chronoblade (sword) — chance to skip the next enemy attack
- Time Tyrant's Mail (chestplate) — chance to rewind time on fatal damage
- Echoing Time Boots — spawn a decoy afterimage when sprinting
- Unstable Pocket Watch — swap speed effects with enemies
- Chrono Aegis — right-click activated buff artifact (10-minute anti-Time-Tyrant buff for the wielder and nearby allies)
ChronoDawn Custom Shields: Three tiered shields (Clockstone → Enhanced Clockstone → Entropy Crystal) with cumulative time-themed effects (passive debuff shortening, faster raise on 1.21.5+, Speed on block at T2+, Time Echo auto-block at T3)
Chronicle of Chrono Dawn: In-game guidebook auto-given when entering the dimension, covering biomes, structures, bosses, items, and progression
Configurable: Tune select gameplay values via config/chronodawn.toml — currently Ancient Ruins generation (spacing, separation, salt) and per-ore generation tuning for Time Crystal, Entropy Crystal, Temporal Amber, and Clockstone (enabled, count, y_min, y_max). See docs/configuration.md. Modpack creators see docs/modpack-integration.md.

Technical Features

Multi-Loader Architecture: Supports both Fabric and NeoForge loaders
Architectury Framework: Shared common code (80%) with loader-specific implementations (20%)
Custom Portal System: Advanced portal mechanics with independent implementation
Performance Optimized: Efficient entity tick handling and caching systems

Requirements

For Players

Minecraft: Java Edition 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, or 1.21.11
Mod Loader (version depends on Minecraft version):
- For 1.21.1: Fabric Loader 0.17.3+ with Fabric API 0.116.7+, OR NeoForge 21.1.209+
- For 1.21.2/1.21.3: Fabric Loader 0.17.3+ with Fabric API, OR NeoForge 21.2.0-beta+/21.3.0-beta+
- For 1.21.4: Fabric Loader 0.17.3+ with Fabric API 0.110.5+, OR NeoForge 21.4.0-beta+
- For 1.21.5: Fabric Loader 0.17.3+ with Fabric API 0.121.0+, OR NeoForge 21.5.96+
- For 1.21.6: Fabric Loader 0.17.3+ with Fabric API 0.128.2+, OR NeoForge 21.6.20-beta+
- For 1.21.7: Fabric Loader 0.17.3+ with Fabric API 0.129.0+, OR NeoForge 21.7.25-beta+
- For 1.21.8: Fabric Loader 0.17.3+ with Fabric API 0.129.0+, OR NeoForge 21.8.0-beta+
- For 1.21.9: Fabric Loader 0.17.3+ with Fabric API 0.134.1+, OR NeoForge 21.9.16-beta+
- For 1.21.10: Fabric Loader 0.17.3+ with Fabric API 0.138.4+, OR NeoForge 21.10.64+
- For 1.21.11: Fabric Loader 0.17.3+ with Fabric API 0.141.3+, OR NeoForge 21.11.38-beta+
Dependencies:
- Architectury API 13.0.8+ (for 1.21.1), 14.0.4+ (for 1.21.2/1.21.3), 15.0.1+ (for 1.21.4), 16.1.4+ (for 1.21.5), 17.0.6+ (for 1.21.6), 17.0.8+ (for 1.21.7/1.21.8), 18.0.3+ (for 1.21.9), 18.0.8+ (for 1.21.10), or 19.0.1+ (for 1.21.11)

For Developers

Java Development Kit (JDK): 21 or higher
IDE: IntelliJ IDEA (recommended) or Eclipse
Git: For version control

Building from Source

Clone Repository

git clone https://github.com/ksoichiro/ChronoDawn.git
cd ChronoDawn

Multi-Version Build Support

Chrono Dawn supports multiple Minecraft versions from the same codebase:

1.20.1: Fabric only (legacy support) - NeoForge requires Minecraft 1.20.5+
1.21.1: NeoForge/Fabric (stable)
1.21.2: NeoForge/Fabric (stable)
1.21.3: NeoForge/Fabric (uses 1.21.2 modules - hotfix release)
1.21.4: NeoForge/Fabric (stable)
1.21.5: NeoForge/Fabric (stable)
1.21.6: NeoForge/Fabric (stable)
1.21.7: NeoForge/Fabric (stable)
1.21.8: NeoForge/Fabric (stable)
1.21.9: NeoForge/Fabric (stable)
1.21.10: NeoForge/Fabric (stable)
1.21.11: NeoForge/Fabric (current version, default)

Build for Specific Minecraft Version

Build for Minecraft 1.21.11 (Default)

# Shortcut command (recommended)
./gradlew build1_21_11

# Or explicit version
./gradlew build -Ptarget_mc_version=1.21.11

Build for Minecraft 1.21.8

./gradlew build1_21_8

Build for Minecraft 1.21.7

./gradlew build1_21_7

Build for Minecraft 1.21.6

./gradlew build1_21_6

Build for Minecraft 1.21.2

# Shortcut command (recommended)
./gradlew build1_21_2

# Or explicit version
./gradlew build -Ptarget_mc_version=1.21.2

Build for Minecraft 1.21.1

# Shortcut command (recommended)
./gradlew build1_21_1

# Or explicit version
./gradlew build -Ptarget_mc_version=1.21.1

Build for Minecraft 1.20.1

# Shortcut command (recommended)
./gradlew build1_20_1

# Or explicit version
./gradlew build -Ptarget_mc_version=1.20.1

Build for Minecraft 1.21.3

# Shortcut command (recommended)
./gradlew build1_21_3

# Or explicit version
./gradlew build -Ptarget_mc_version=1.21.3

Note: 1.21.3 is a hotfix release that uses the same modules as 1.21.2.

Build for Minecraft 1.21.4

# Shortcut command (recommended)
./gradlew build1_21_4

# Or explicit version
./gradlew build -Ptarget_mc_version=1.21.4

Build for Minecraft 1.21.5

# Shortcut command (recommended)
./gradlew build1_21_5

# Or explicit version
./gradlew build -Ptarget_mc_version=1.21.5

Build for All Versions (Release)

# Build all release versions (1.20.1, 1.21.1, 1.21.2, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11)
# Note: 1.21.3 is excluded - the 1.21.2 JAR is compatible with 1.21.3
./gradlew buildAll

# Full release pipeline (cleanAll → buildAll → collectJars)
# JARs are collected into build/release/
./gradlew release

Output Files (example for 1.21.2):

fabric/1.21.2/build/libs/chronodawn-0.8.0+1.21.2-fabric.jar - Fabric loader JAR
neoforge/1.21.2/build/libs/chronodawn-0.8.0+1.21.2-neoforge.jar - NeoForge loader JAR

Build Specific Loader

Fabric Only

./gradlew :fabric:build -Ptarget_mc_version=1.21.2

NeoForge Only

./gradlew :neoforge:build -Ptarget_mc_version=1.21.2

Development Setup

Step 1: Import Project to IDE

IntelliJ IDEA (Recommended)

Open IntelliJ IDEA
File → Open → Select build.gradle in project root
Choose "Open as Project"
Wait for Gradle sync to complete

Eclipse

Open Eclipse
File → Import → Existing Gradle Project
Select project root directory
Click Finish

Step 2: Run in Development Environment

Fabric Development Client

# Windows
gradlew.bat :fabric:runClient

# macOS/Linux
./gradlew :fabric:runClient

NeoForge Development Client

# Windows
gradlew.bat :neoforge:runClient

# macOS/Linux
./gradlew :neoforge:runClient

Development Server

# Fabric
./gradlew :fabric:runServer

# NeoForge
./gradlew :neoforge:runServer

Step 3: Verify Setup

Launch the development client and verify:

Minecraft starts successfully
"Chrono Dawn" appears in mod list
Creative inventory includes Chrono Dawn items
World generation includes Ancient Ruins structures

Testing

Run All Tests

# Windows
gradlew.bat test

# macOS/Linux
./gradlew test

Run Loader-Specific Tests

# Fabric tests
./gradlew :fabric:test

# NeoForge tests
./gradlew :neoforge:test

Manual Testing Checklist

Portal System:
- Find Ancient Ruins in Overworld
- Craft Time Hourglass
- Activate portal and travel to Chrono Dawn
- Verify portal is one-way (stops working after entry)
Dimension Features:
- Explore different biomes (Forest, Desert, Mountain, etc.)
- Verify hostile mobs have Slowness IV effect
- Find Forgotten Library structure
Portal Stabilizer:
- Craft Portal Stabilizer in Chrono Dawn
- Stabilize portal for bidirectional travel
- Test round-trip travel Overworld ↔ Chrono Dawn
Boss Battles:
- Defeat Time Guardian mini-boss
- Explore Phantom Catacombs and defeat Temporal Phantom
- Locate Master Clock structure
- Defeat Time Tyrant final boss

Installing Pre-built JAR

For Fabric (Minecraft 1.21.2)

Install Minecraft 1.21.2
Install Fabric Loader 0.17.3+
Download and install Fabric API
Download and install Architectury API 14.0.4+
Copy chronodawn-0.8.0+1.21.2-fabric.jar to .minecraft/mods/ folder
Launch Minecraft with Fabric profile