Projects Guide
Everything about creating, managing, and distributing projects on Foundry.
Project Structure
Each project has:
- Slug — unique URL identifier (e.g.,
my-cool-mod) - Title and description — what users see when browsing
- Game association — links the project to a supported game
- Releases — versioned distributions with files
- Categories and tags — for discovery and filtering
Creating a Project
Navigate to /projects/new and fill in the form:
- Slug — kebab-case, unique across the platform.
- Title — human-readable project name.
- Short description — one-liner for browse cards.
- Description — full markdown-supported body.
- Game — pick from the supported game registry.
- Categories — optional organizational tags.
Releases
Releases bundle your project's files into versioned distributions:
| Type | Purpose |
|---|---|
| Release | Stable, recommended for users |
| Beta | Feature-complete, testing needed |
| Alpha | Early builds, unstable |
| Testing | Experimental, may not work |
Each release can have multiple files (primary, source, addons, resource packs, media).
File Management
Files are scanned for malware on upload. Supported types:
- Primary — main download (e.g., the mod
.jaror.dll) - Source — source code archive
- Addon — supplementary content
- Resource Pack — texture or audio packs
- Media — screenshots, banners
- Docs — supplementary documentation
Archiving
Projects and releases can be archived. Archived items are hidden from browse but remain accessible via direct links. Archiving preserves download counts and endorsements.