# PH package format spec

## Container

- Standard ZIP file.
- Exclusively uses UTF-8 for file naming for ease of parsing by other programs. (the ZIP spec has no way to tell which encoding is used for file names).
- Contains the bare mod data (song.json, resource_pack.json etc).
- Contains a meta.json file with extra mod information (mostly from the workshop).


## meta.json format

```
{
  "items": [
    {
      "item_type": 0, // 0 for song, 1 for resource pack
      "item_directory": "song_folder",
      "ugc_metadata": {
        "title": "My song",
        "description": "Item description",
        "ugc_provider": "Steam Workshop",
        "item_id": <steam_worskhop_ID>,
        "extra_metadata": {} // platform specific UGC metadata, for archival purposes
      }
    }
  ]
}
```