Critical Game Design Decisions

Purpose: Document critical game design decisions for Chrono Dawn mod to maintain consistency across features.

How it works: This skill is automatically activated when you mention tasks related to:

• Implementing respawn mechanics
• Designing dimension travel features
• Creating portal systems
• Balancing difficulty and progression
• Designing escape mechanisms for players

Simply describe what you want to do, and Claude will reference the appropriate guidance from this skill.

---

Respawn Mechanics

Decision Date: 2025-10-26

Core Decision

Chrono Dawn follows Minecraft's standard respawn behavior (like End dimension)

Key Principles:

1. Players respawn at bed/respawn anchor, or world spawn if none set
2. Portal Stabilizer does NOT affect respawn location
3. Portal Stabilizer only makes portal bidirectional (one-way → two-way)
4. Players can always escape by breaking bed and dying

---

Rationale

Maintains Tension

One-Way Portal: Creates sense of risk and commitment when entering Chrono Dawn

Player Experience: "Should I enter now, or prepare more?"

Avoids Excessive Difficulty

Escape Mechanism: Players can always escape by:

1. Breaking their bed
2. Dying (respawns at world spawn)
3. Returning to Overworld via world spawn

Prevents Softlocks: Players never get permanently trapped

Follows Minecraft Conventions

Consistency with End Dimension:

• End Dragon fight: One-way portal to End
• Escape: Defeat dragon or die
• Respawn: World spawn (if no bed)

Player Expectations: Experienced players understand this pattern

---

Implementation Guidelines

Portal Stabilizer

Functionality:

• Converts one-way portal to two-way portal
• Does NOT create respawn point
• Does NOT prevent death respawn to Overworld

Code Implementation:

// Portal Stabilizer should only affect portal directionality
// NOT player respawn location
if (hasPortalStabilizer) {
    portal.setBidirectional(true);
}
// Respawn logic remains unchanged

Bed/Respawn Anchor

Functionality:

• Standard Minecraft respawn mechanics apply
• Setting bed in Chrono Dawn: Respawn in Chrono Dawn
• No bed set: Respawn at world spawn (Overworld)

Code Implementation:

// Use Minecraft's default respawn logic
// No custom overrides needed for Chrono Dawn dimension

Dimension Travel

One-Way Portal (Default):

• Overworld → Chrono Dawn: Works
• Chrono Dawn → Overworld: Does NOT work

Two-Way Portal (with Portal Stabilizer):

• Overworld ↔ Chrono Dawn: Both directions work

---

Edge Cases

Player Dies in Chrono Dawn (No Bed Set)

Expected Behavior:

1. Player dies in Chrono Dawn
2. Player respawns at world spawn (Overworld)
3. Portal remains one-way (unless stabilized)

Result: Player must re-enter Chrono Dawn via portal

Player Sets Bed in Chrono Dawn

Expected Behavior:

1. Player sets bed in Chrono Dawn
2. Player dies in Chrono Dawn
3. Player respawns at bed in Chrono Dawn

Result: Player stays in Chrono Dawn after death

Player Wants to Leave Chrono Dawn (No Portal Stabilizer)

Options:

1. Craft Portal Stabilizer and return via portal
2. Break bed (if set) and die to respawn in Overworld
3. Use Ender Pearl/Enderman mechanics (if applicable)

Recommended: Option 2 (die to escape) for early-game players

Player Sets Bed in Overworld, Then Dies in Chrono Dawn

Expected Behavior:

1. Player sets bed in Overworld
2. Player enters Chrono Dawn
3. Player dies in Chrono Dawn
4. Player respawns at bed in Overworld

Result: Standard Minecraft behavior, no custom logic needed

---

Design Philosophy

Tension vs. Frustration Balance

Goal: Create challenging experience without frustrating players

Tension Mechanics (Good):

• One-way portal creates commitment
• Resource management in dangerous dimension
• Risk/reward for exploring

Frustration Mechanics (Avoid):

• Permanent trapping with no escape
• Losing all progress due to softlock
• Unclear mechanics that surprise players

Player Agency

Core Principle: Players should always have control over their fate

Implementation:

• Clear escape mechanism (die to return)
• Telegraphed danger (one-way portal is visible)
• Progression option (craft Portal Stabilizer for two-way travel)

Consistency with Minecraft

Follow Vanilla Patterns:

• Respawn at bed/respawn anchor
• Dimension travel via portals
• No custom respawn logic unless necessary

Benefits:

• Players understand mechanics intuitively
• Less documentation needed
• Fewer bugs from custom systems

---

Related Specifications

Full Game Design Philosophy: See

specs/chrono-dawn-mod/spec.md

→ "Game Design Philosophy" section

Portal Stabilizer Mechanics: See

specs/chrono-dawn-mod/data-model.md

→ "Portal Stabilizer" item

Dimension Configuration: See

common/src/main/resources/data/chronodawn/dimension/chrono_dawn.json

---

Future Considerations

Potential Extensions (Not Decided)

Question: Should Portal Stabilizer have additional effects?

Options:

1. Create temporary respawn point (like respawn anchor)
2. Prevent mob spawning near portal
3. Teleport player to portal on death

Status: Not decided, requires further design discussion

Recommendation: Keep simple for now, add features based on player feedback

Balancing Portal Stabilizer Cost

Current: Requires rare materials from Chrono Dawn

Consideration: Too expensive → frustrating, too cheap → removes tension

Recommendation: Playtest with different costs, adjust based on feedback

---

Testing Checklist

When implementing respawn mechanics:

• Player with no bed dies in Chrono Dawn → respawns at world spawn (Overworld)
• Player with bed in Overworld dies in Chrono Dawn → respawns at Overworld bed
• Player with bed in Chrono Dawn dies in Chrono Dawn → respawns at Chrono Dawn bed
• Player with bed in Chrono Dawn breaks bed and dies → respawns at world spawn (Overworld)
• Portal without Portal Stabilizer → one-way only (Overworld → Chrono Dawn)
• Portal with Portal Stabilizer → two-way (Overworld ↔ Chrono Dawn)
• Portal Stabilizer does NOT affect respawn location

---

Last Updated: 2026-01-16 Maintained by: Chrono Dawn Development Team