Home

---

Customizing HudClock with Texture Packs

With the release of v4.2.3, HudClock supports a "Custom" icon theme. This allows you to replace the seasonal and room-status icons with your own artwork without ever touching the core mod files.

In Vintage Story, texture packs are technically "Theme Mods". The game's engine is designed to prioritize files in these "Theme" folders over the default ones, making customization clean and safe.

---

1. Quick Start: The Folder Structure

To create a pack, you need to create a folder (e.g., MyClockIcons) and set up the following directory structure inside it:

Plaintext

MyClockIcons/
├── modinfo.json
└── assets/
    └── hudclock/
        └── textures/
            ├── hud/
            │   └── custom/     <-- Place large season icons here
            └── room/
                └── custom/     <-- Place small room icons here

---

2. Naming Conventions & Specs

HudClock looks for specific filenames inside those custom folders. If a file is missing, the HUD will simply render a transparent placeholder.

Season Icons (HUD)

These appear as the large background graphics behind the clock.

• Recommended Resolution: 200x200 (or 2:1 aspect ratio)

• Format: RGBA PNG (Transparency is highly recommended)

Event / Season | Filename -- | -- Spring | spring.png Summer | summer.png Fall | fall.png Winter | winter.png Temporal Storm | tempstorm.png

---

3. The modinfo.json

Every pack needs a modinfo.json in the root folder so the game knows it exists. Use the template below:

JSON

{
  "type": "Theme",
  "modId": "mycustomclockicons",
  "name": "My Custom Clock Icons",
  "authors": ["YourName"],
  "description": "Custom high-contrast icons for the HudClock mod.",
  "version": "1.0.0",
  "dependencies": {
    "game": "*",
    "hudclock": ">=4.2.3"
  }
}

Note: Setting the "type" to "Theme" tells Vintage Story that this mod contains assets only and no executable code, which is safer for performance.

---

4. Installation & Usage

1. Package it: You can leave the folder as-is or zip it up.

2. Move to Mods: Place the folder or .zip into your %appdata%/VintagestoryData/Mods folder.

3. Enable: Launch the game and ensure your pack is enabled in the Mod Manager.

4. Activate: Open the HudClock settings in-game (Default: Shift + O). Under the Appearance section, change the Icon Theme dropdown to Custom.

The HUD will immediately update to use your custom art. If you edit your PNGs while the game is running, you can usually force a refresh by toggling the Icon Theme off and back to "Custom."

---

Why use a Texture Pack instead of editing the mod?

• Updates: When you update HudClock to a new version, your custom icons won't be deleted.

• Sharing: You can upload your theme to the Vintage Story ModDB as a standalone "Theme" mod so others can use your art!