Sonic Terraria 0.8.2 — Melty edition

Explore Terraria as Sonic, Tails, Knuckles, Mighty or Ray. Rescue friends, collect Rings and Chaos Emeralds, unlock Super forms, and challenge Metal Sonic and Giga Metal Sonic. Metal Sonic becomes playable through progression. You can also play as a normal Terrarian with shared Ring and Emerald progression.

Requirements

• Windows x64, Steam running, and legitimate installed Steam copies of Terraria and Sonic Mania.
• This release includes the official tModLoader 1.4.3 legacy 2022.9.48.2 runtime (Terraria 1.4.3.6) and its matching .NET 6 runtime. Terraria and Sonic Mania game content is read from your own installations and is not included. Seven legacy compatibility images from the loader distribution are excluded and populated locally from the owned Terraria content at launch.
• Everyone in a room needs this same release and the required games. Supports up to 8 players using native Terraria networking and Melty rooms.

Play

Install this release in Melty and choose Play, or join a friend's Melty room. The launcher opens a separate character/world profile, enables the mod and connects to the host. A new host starts in a fresh generated world; later sessions retain that world's progress. Melty lets the host choose private, friends-only or public rooms.

Press H to switch to an available hero. The Hero Instruction Manual in your inventory shows current move bindings; the Hero Command Handbook lists player commands and sidekick controls. Cream and Amy sell replacements. Change hero bindings in Mod Configuration → SonicControlsConfig or Terraria's Mod Controls menu. /sonicheroturnoff returns to a normal Terrarian.

Stardust weapons, armor and crafting rewards are earned through Giga Metal Sonic. Stardust armor uses normal Terraria equipment visuals on Terrarians. Hero sprites, including ball and Super forms, keep their Sonic Mania appearance.

Saves, uninstall and troubleshooting

Melty profiles, worlds and logs are stored under %LOCALAPPDATA%\SonicTerrariaMelty. Your ordinary Terraria and tModLoader profiles are separate. Back up this folder if you want to preserve Melty progress. Uninstall the release in Melty; remove that data folder yourself only if you also want to erase its saves.

For startup issues, verify both games are installed and Steam is running. Logs are in the above data folder and the managed runtime's tModLoader-Logs directory. Include the launcher and native client/server logs when reporting an issue. Compatibility with additional third-party mods is not established; this edition uses its own mod list.

Credits and disclosure

• Mod design, direction and playtesting: JayJ860.
• Implementation and release tooling: OpenAI Codex / GPT-6 with AI-assisted code and asset workflows.
• Terraria and its original content: Re-Logic. Sonic characters, Sonic Mania and original Sonic assets: SEGA / Sonic Team / Sonic Mania developers. This is an unofficial fan mod with no endorsement or affiliation.
• Original Mania graphics and sounds are loaded at runtime from the player's Sonic Mania installation. Original Terraria content is loaded by tModLoader from the player's Terraria installation.
• Custom mod artwork was made with OpenAI image generation and edited/assembled for the mod. Generated promotional art is separate from real gameplay evidence.
• tModLoader Team: official unmodified runtime binaries, MIT license and terms in runtime/. Unused server examples and seven images duplicated from Terraria are excluded from this distribution.
• Microsoft / .NET contributors: .NET runtime, license and third-party notices in runtime/dotnet/.
• Microsoft Visual C++: unmodified app-local runtime DLLs from the Visual Studio 2022 Community redistributable, with license and redistribution notice in runtime/.
• The launcher and Melty support mod were authored for this release. They use native Terraria networking; test-only checks run only when Melty provides a release-test descriptor.

Melty remixes are allowed. Third-party software and game content retain their respective licenses and ownership. No rights to the original games are granted by this package.

Release notes

0.8.2 fixes the faint rectangular outlines around Super forms by removing atlas packing guides and using transparent padding for adjacent animation frames. Original Mania art, animations and Super colors remain. Sonic spikes and their special ring-loss behavior are removed; existing worlds automatically clear the retired spikes and stored items while preserving other terrain. The temporary Moon Lord testing add-on is excluded. Metal Sonic's grounded-height correction and starter guidebook delivery remain.

The Melty edition includes an automatic launcher, separate profiles, native host/join integration, an original starter-world template and release checks. All room members must update to the same release.