Chronicle Structure Addition Guide

Purpose: Guide for adding new structure information to Chronicle with visual hints (images).

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

• Adding new structures to Chronicle
• Converting screenshots to Chronicle images
• Adding image pages to Chronicle entries
• Creating visual hints for structures in Chronicle

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

---

Adding Structure to Chronicle (2025-12-27)

Overview: Adding a new structure to Chronicle involves three main steps:

1. Creating the structure entry JSON
2. Converting screenshots to Chronicle-style images
3. Adding image pages to the entry

Step 1: Create Structure Entry JSON

Location: common/src/main/resources/assets/chronodawn/chronicle/entries/structures/<structure_name>.json

Template:

{
  "category": "structures",
  "title": {
    "en_us": "Structure Name",
    "ja_jp": "構造物名"
  },
  "icon": "minecraft:block_name",
  "sortnum": 1,
  "pages": [
    {
      "text": {
        "en_us": "Structure description...",
        "ja_jp": "構造物の説明..."
      }
    },
    {
      "image": "chronodawn:textures/gui/chronicle/<structure_name>.png"
    },
    {
      "text": {
        "en_us": "Additional details...",
        "ja_jp": "追加の詳細..."
      }
    }
  ]
}

Step 2: Convert Screenshots to Chronicle Images

Tool: scripts/convert_chronicle_image.sh

Requirements:

• ImageMagick installed (brew install imagemagick on macOS)
• Screenshot placed in assets/screenshots/chronicle/

Conversion Process:

The script applies the following transformations:

1. Grayscale conversion (-colorspace Gray) - Convert to black and white
2. Sketch effect (-sketch 0x10+80) - Apply pencil sketch appearance
3. Auto-level (-auto-level) - Normalize brightness/contrast
4. Brightness/contrast adjustment (-brightness-contrast -5x-10) - Fine-tune for book aesthetic

Usage:

Single file:

./scripts/convert_chronicle_image.sh phantom_catacombs.png

All files in directory:

./scripts/convert_chronicle_image.sh --all

Input/Output:

• Input: assets/screenshots/chronicle/<structure_name>.png
• Output: common/src/main/resources/assets/chronodawn/textures/gui/chronicle/<structure_name>.png

Step 3: Add to Categories (if new structure type)

Location: common/src/main/resources/assets/chronodawn/chronicle/categories.json

Only needed if adding a new category. Existing categories: basics, progression, items, structures, bosses.

---

Complete Workflow Example

Scenario: Adding "Ancient Ruins" structure to Chronicle

1. Take screenshot:

   • Capture in-game screenshot of the structure
   • Save as assets/screenshots/chronicle/ancient_ruins.png

2. Convert to Chronicle style:

   ./scripts/convert_chronicle_image.sh ancient_ruins.png
   

3. Create JSON entry:

   • Create common/src/main/resources/assets/chronodawn/chronicle/entries/structures/ancient_ruins.json
   • Add description text pages
   • Insert image page reference: "image": "chronodawn:textures/gui/chronicle/ancient_ruins.png"

4. Test in-game:

   • Build mod: ./gradlew :fabric:build
   • Open Chronicle in-game
   • Navigate to Structures → Ancient Ruins
   • Verify image appears on page 2 with proper styling

---

Image Rendering Features

Chronicle image pages include:

1. Automatic scaling: Images scale to fit page dimensions while maintaining aspect ratio
2. Sepia tone: Warm beige/sepia color (0xF0E0D0) matches book background
3. Vignette effect: 15px fade on edges and corners for sketch-like appearance
4. Center alignment: Images centered on page

Technical Details:

• Maximum width: ~140px (page width minus margins)
• Maximum height: ~190px (page height minus margins and page number)
• Aspect ratio: Preserved automatically
• Format: PNG with transparency support

---

Directory Structure

ChronoDawn/
├── assets/screenshots/chronicle/          # Original screenshots
│   ├── phantom_catacombs.png
│   ├── master_clock.png
│   └── ancient_ruins.png                  # New screenshot
├── scripts/
│   └── convert_chronicle_image.sh         # Conversion script
└── common/src/main/resources/assets/chronodawn/
    ├── chronicle/entries/structures/      # Structure JSON entries
    │   ├── phantom_catacombs.json
    │   ├── master_clock.json
    │   └── ancient_ruins.json             # New entry
    └── textures/gui/chronicle/            # Converted Chronicle images
        ├── phantom_catacombs.png
        ├── master_clock.png
        └── ancient_ruins.png              # Converted image

---

Existing Structures with Images

As of 2025-12-27:

• Phantom Catacombs (phantom_catacombs.png)
• Master Clock (master_clock.png)
• Clockwork Depths (clockwork_depths.png)
• Desert Clock Tower (desert_clock_tower.png)
• Entropy Crypt (entropy_crypt.png)
• Guardian Vault (guardian_vault.png)

---

Troubleshooting

Image not appearing:

• Verify file exists: common/src/main/resources/assets/chronodawn/textures/gui/chronicle/<name>.png
• Check JSON syntax: Image path must be chronodawn:textures/gui/chronicle/<name>.png
• Rebuild mod: ./gradlew :fabric:build

Image quality issues:

• Adjust ImageMagick parameters in scripts/convert_chronicle_image.sh
• Sketch intensity: Change -sketch 0x10+80 (format: radius x sigma + angle)
• Brightness: Adjust -brightness-contrast -5x-10 (format: brightness x contrast)

Image too large/small:

• Original screenshot size doesn't matter (auto-scaled)
• Ensure aspect ratio is reasonable (avoid extreme wide/tall images)

---

Best Practices

1. Screenshot quality:

   • Use high resolution (e.g., 1920x1080)
   • Clear view of the structure
   • Good lighting (avoid too dark/bright)

2. Image naming:

   • Use snake_case (e.g., ancient_ruins.png)
   • Match structure entry JSON filename
   • Keep names descriptive but concise

3. Page ordering:

   • Page 1: Structure overview and description
   • Page 2: Image (visual hint)
   • Page 3+: Additional details, boss info, tips

4. Testing:

   • Always test in-game before committing
   • Verify on both Fabric and NeoForge if applicable
   • Check both English and Japanese text

---

Last Updated: 2025-12-27 Maintained by: Chrono Dawn Development Team