Skip to content

FOUNDRY GUIDES

Documentation

Find your way around Foundry, from discovering projects to publishing your own.

All docs

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:

  1. Slug — kebab-case, unique across the platform.
  2. Title — human-readable project name.
  3. Short description — one-liner for browse cards.
  4. Description — full markdown-supported body.
  5. Game — pick from the supported game registry.
  6. 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 .jar or .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.

Navigate Homestead

Search pages or jump directly with the registered site sequences.

Privacy

We count visits with cookieless analytics and record anonymous sessions to fix usability problems. You can opt out at any time from Cookie settings in the footer.