Skip to content

Publishing on Canopy

From your first upload to your fiftieth update. It takes about five minutes.

Set up your account

  1. Create an account and pick a username

    Your username is your public address, like /yourname.

  2. Verify your email

    Required before you can publish or comment.

  3. Set your creator defaults

    In Settings → Creator defaults, choose your usual loader, platforms, and game version so forms are pre-filled.

Package your mod

Upload a single .dll, or a .zip if your mod has extra files. Files can be up to 100 MB.

What zips can and can’t contain

Zips are inspected without being unpacked. They can’t contain executables or scripts (.exe, .bat, .ps1…), password-protected files, other archive types (.7z, .rar), or paths that escape the folder. Nested zips are fine up to two levels.

Create the listing

  1. Open Dashboard → New mod

    Give it a name and a one-line summary. The name becomes your mod’s URL, which never changes.

  2. Describe it

    Write the description in Markdown. Add install steps if yours differ from the standard loader setup, and list dependencies.

  3. Add pictures

    A square or 16:9 thumbnail and a few screenshots help a lot. PNG, JPEG, or WebP.

Upload and scan

  1. Create a release

    Pick a version number (like 1.0.0) and write a changelog.

  2. Upload your file

    It goes into private storage. Nobody can download it yet.

  3. Validation

    We check the file is a real DLL or zip, measure it, and record its SHA-256 fingerprint.

  4. Malware scan

    A background job scans the file. You can watch the progress bar in your dashboard.

  5. Go live

    Your first release is reviewed by a moderator. After that, updates go live as soon as the scan passes.

If a scan flags your file

The release is rejected and never offered for download. If you think it’s a false positive, contact the moderators with the version number.

Connect GitHub

Link a public repository and players can read your code right on your mod page — folders, files with syntax highlighting, and your README.

  1. Paste the repo link

    When creating a mod, or later in Dashboard → your mod → GitHub.

  2. Point releases at a tag or commit

    When you create a release, add the tag (like v1.2.0) it was built from.

  3. Verify ownership (optional)

    Commit a file named .canopy with the token from your dashboard, then press Verify. Your mod shows “Owner verified”.

Ship updates

Create a new release with a higher version number. Older versions stay listed so players can roll back. You can unpublish any release — or the whole mod — at any time from the dashboard.

Rules of the jungle

No malware, no cheats that harm other players, only your own work (or work you have permission to share), and honest descriptions. Full details are in the Community Guidelines.

Publish a mod →

Start your first listing.

Community guidelines →

What’s allowed and how moderation works.