Docs

Installing, connecting, living in the village

Docs›How-to

Making a pack

A pack is a folder at ~/.devalley/packs/<name>/. The name is up to 32 lowercase letters, digits, _ or -.

File Role
pack.json { "name": "...", "author": "..." } (40 characters each)
theme.json A patch over the built-in theme's colour ramps and colours: same names, same ramp lengths, lowercase #rrggbb. It can recolour the map and the residents' skin, hair and dye ramps.
map/<sheet>.png + .json Replaces built-in map objects with the same id. One row per object, one column per variant.
parts/<group>/<name>.png + .json Resident parts. The same id replaces, a new id joins the wardrobe. Parts whose unlock is pack:<folder> are free while that pack dresses the village.

Pick the pack in the app's "Dress the village"; problems are listed there. From a terminal: devalley pack check <folder>.

Making a pack and using it on your own PC is free for everyone. Sharing it on the site is a Pro feature.

Uploading (Pro): in the Studio, upload the folder as a zip; your browser checks it and renders a preview first. There is no limit on how many packs you make.

  • Limits: 10 versions a day; a zip of up to 50 MB, 60 MB and 400 files once unpacked. PNGs must be real PNG files of up to 4096×4096 pixels; covers up to 5 MB.
  • Warranty: each version upload asks you to confirm the material is your own work or used with permission. No assets from other games or works; conversions of other asset packs are allowed only when their license permits redistribution.
  • License: CC0 1.0, CC BY 4.0 or all rights reserved (the default). Once published, a license can only become more open (all rights reserved → CC BY 4.0 → CC0 1.0).
  • Price: 0 to 500 coins (0 is free). A pack with a price is published as all rights reserved only; a pack already published under CC can't get a price, so upload it as a new pack. Coins from a sale land in your wallet at once.
  • Review: staff review the first publication against the criteria in the Community Rules, aiming at 3 business days; a rejection names the criterion and the reason. New versions of an approved pack and changes to its name, description or cover go out at once and staff check them afterwards.
  • Versions: numbers only go up. Withdrawing a published version makes the one before it the latest, and its number can't be used again. Whoever already has it keeps it.
  • Unpublishing and deleting: you may unpublish or delete a pack. Whoever already has it keeps it and can download it again on another PC.
  • When Pro ends: your published packs stay; only new packs and versions stop.

Getting packs: members hold up to 3 free community packs at a time (bought packs and official packs don't count); let one go to take a fourth. Pro has no limit.