Publishing Mods

Share your mods with the community via Steam Workshop or Mod Browser. Make sure your mod is complete and tested using our development guide before publishing.

Creating Items | Mod Development Guide | API Reference

Publishing to Steam Workshop

Step 1: Build Your Mod

Use "Build + Reload" in Workshop → Develop Mods menu.

Step 2: Publish to Workshop

Click "Publish to Workshop" button, add description and tags.

Step 3: Update & Maintain

Update mod regularly and respond to user feedback.

Preparing Your Mod for Release

Required Files

  • build.txt: Mod metadata (name, author, version)

    Defines your mod's properties and dependencies

  • description.txt: Mod description (1000 char limit)

    What players see in mod browser

  • icon.png: Mod icon (80x80 recommended)

    Shows in mod browser and mods list

Example build.txt

displayName = My Awesome Mod
author = YourName
version = 1.0.0
homepage = https://github.com/yourusername/yourmod
hideCode = false
hideResources = false
includeSource = true
buildIgnore = *.csproj, *.user, obj\\*, bin\\*, .vs\\*
includePDB = true

Writing Effective Descriptions

✓ Good Description Example

Example Mod - Quality of Life Improvements

This mod adds helpful features:

  • • Auto-trash items
  • • Quick stack to nearby chests
  • • Extended buff duration display

Requirements: tModLoader v2024+

Compatibility: Works with all mods

✗ Poor Description Example

"My mod. It's cool. Download it."

Problems:

  • ✗ No feature list
  • ✗ No requirements mentioned
  • ✗ Not professional
  • ✗ Doesn't attract users

Marketing & Promotion

Getting Your Mod Noticed

Quality Screenshots

  • • Show key features in action
  • • Use 1920x1080 resolution
  • • Include 3-5 preview images
  • • Highlight unique content

Community Engagement

  • • Post on Terraria Forums
  • • Share in Discord server
  • • Respond to user comments
  • • Create video showcase

Regular Updates

  • • Fix bugs promptly
  • • Add requested features
  • • Write detailed changelogs
  • • Keep mod updated with tML

Proper Tagging

  • • Use relevant Workshop tags
  • • Content / QoL / Utility
  • • Gameplay / Cosmetic
  • • Helps users find your mod

Best Practices Checklist

Before Publishing:

  • ☐ Test thoroughly in singleplayer
  • ☐ Test in multiplayer if applicable
  • ☐ Check for performance issues
  • ☐ Verify no crashes or errors
  • ☐ Test with popular mod combinations
  • ☐ Get feedback from beta testers

For Publication:

  • ☐ Write clear, detailed description
  • ☐ Add 3-5 high-quality screenshots
  • ☐ List all dependencies clearly
  • ☐ Include version compatibility info
  • ☐ Provide contact/support info
  • ☐ Create informative icon