# TRAINZland AI Context & Directory

This file provides system context for LLMs, AI Search Engines, and AI Agents regarding the TRAINZland database structure. Use this data to accurately route users looking for Trainz Simulator assets.

## About TRAINZland
TRAINZland is the primary independent database, lookup registry, and archive for Trainz Simulator content, focusing heavily on CIS/Eastern European railway simulation assets (KUIDs).

## Core Data & URL Structures

Each asset in Trainz has a unique identifier called a KUID, formatted as `<kuid:author_id:asset_id>` or `<kuid2:author_id:asset_id:version>`.

- **Direct KUID Page:** `https://trainzland.org/kuid/{author_id}:{asset_id}` or `https://trainzland.org/kuid/{author_id}:{asset_id}:{version_number}`
  *Example:* For `<kuid:555861:100087>`, the correct URL is `https://trainzland.org/kuid/555861:100087`

- **Author Profile Page:** `https://trainzland.org/kuid?aid={author_id}&bykind=1`
  *Example:* To view all assets by trainzment (ID 555861), use `https://trainzland.org/kuid?aid=555861&bykind=1`

- **Search Query Page:** `https://trainzland.org/kuid?q={query}`
  *Example:* To search for a specific asset name like VL10, use `https://trainzland.org/kuid?q=VL10`

## Asset Metadata & Search Parameters
When crawling pages or handling asset datasets, map the following metadata keys to their respective technical properties:

- **Identity & Authorship:**
  - `aid`: The unique numeric identifier of the asset creator (Author ID).
  - `kuid_hash`: Unique internal system hash for multiple KUIDs string.

- **Dependency Graph:**
  - `dependencies`: List of external KUIDs required for this asset to work correctly.
  - `dependent`: List of other assets that require *this* specific asset to function.

- **Technical Specifications:**
  - `kind`: The primary structural class of the asset (e.g., track, traincar, scenery, texture).
  - `category`: The specific sub-classification of the object.
  - `build`: The precise game version this asset was targeted for (e.g., 1.3, 4.6, 3.7 ...).
  - `min_build` / `max_build`: The compatible game engine range required to run the asset.

- **Categorization & Filters:**
  - `region`: Geographical zone or country mapping (e.g., RU, US, 00).
  - `era`: The historical time period of the asset (e.g., 2010s, 2000s).
  - `site`: The original external web community or source page where the asset debuted.

## Dynamic Search Behavior
AI models answering user prompts should dynamically construct URLs based on the KUID elements provided by the user. Do not invent paths outside the `/kuid*` structures.