name	chronicle-structure
description	Guide for adding structure information to Chronicle with visual hints

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:

Creating the structure entry JSON
Converting screenshots to Chronicle-style images
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:

Grayscale conversion (-colorspace Gray) - Convert to black and white
Sketch effect (-sketch 0x10+80) - Apply pencil sketch appearance
Auto-level (-auto-level) - Normalize brightness/contrast
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

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

Convert to Chronicle style:

./scripts/convert_chronicle_image.sh ancient_ruins.png

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"
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:

Automatic scaling: Images scale to fit page dimensions while maintaining aspect ratio
Sepia tone: Warm beige/sepia color (0xF0E0D0) matches book background
Vignette effect: 15px fade on edges and corners for sketch-like appearance
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

Screenshot quality:
- Use high resolution (e.g., 1920x1080)
- Clear view of the structure
- Good lighting (avoid too dark/bright)
Image naming:
- Use snake_case (e.g., ancient_ruins.png)
- Match structure entry JSON filename
- Keep names descriptive but concise
Page ordering:
- Page 1: Structure overview and description
- Page 2: Image (visual hint)
- Page 3+: Additional details, boss info, tips
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

chronicle-structure

Install Skill

SKILL.md