Support & Resources

Find help, tools, and resources for your TinyMUX server

Community Support

Get help from the TinyMUX community and connect with other administrators.

Admin Tools

Useful tools for managing and maintaining your TinyMUX server.

Documentation

Comprehensive guides and reference materials.

Downloads

Get the latest versions and updates for TinyMUX.

Database Conversion & Migration

Converting between different MUSH server platforms or upgrading from older versions of TinyMUX can be straightforward with the right tools and procedure.

Omega Flatfile Converter

The recommended tool for converting between different MUSH server formats. It supports conversion between TinyMUSH 3.x, PennMUSH, RhostMUSH, and TinyMUX formats, and can also help with password resets.

Download Omega

Converting from Other Servers

  1. Make a complete backup of your existing game
  2. Generate a flatfile from your current server
  3. Use the Omega Flatfile Converter to convert the flatfile to TinyMUX format
  4. Follow the installation instructions in the INSTALL file
  5. Load the converted flatfile using db_load
  6. Configure your new TinyMUX server with appropriate settings
  7. Start your server and test thoroughly before going live

Upgrading from Older TinyMUX Versions

  1. @shutdown your existing game and make a flatfile backup
  2. Install TinyMUX 2.13 following the instructions in INSTALL
  3. Copy your flatfile to the new game/data directory
  4. Use db_load to convert the flatfile to the binary format
  5. Copy your mail.db and comsys.db files to the new installation
  6. Update your configuration file with any new options
  7. Start your upgraded server

For more detailed instructions, see the CONVERSION document.

Common Support Questions

I've forgotten the Wizard (#1) password. How can I reset it?

Use the Omega Flatfile Converter to modify your flatfile and reset the password. First, make a flatfile backup of your database, then run Omega with the appropriate options to change the password. Alternatively, you can use Omega to extract Wizard's encrypted password from a different database where you know the password, and then set it in your current database.

Players can't connect to my server. What's wrong?

Check that your server is running, your firewall allows connections on your game port, and you've set up port forwarding if you're behind a router. You can test locally with telnet localhost portnumber. Also verify the port configuration in your .conf file is correct.

How do I convert my database from PennMUSH/TinyMUSH to TinyMUX?

Use the Omega Flatfile Converter to convert your flatfile to TinyMUX format. This is generally more reliable than older conversion methods. See the CONVERSION document for detailed instructions.

See the full FAQ for more answers

Reporting Bugs

If you encounter a bug in TinyMUX, please report it to help improve the server for everyone. Follow these steps to submit an effective bug report:

  1. Verify it's actually a bug and not a configuration issue or intended behavior
  2. Try to reproduce the issue and document the exact steps that trigger it
  3. Check if the bug has already been reported on GitHub Issues
  4. Collect relevant information:
    • TinyMUX version
    • Operating system and version
    • Error messages from the log
    • Steps to reproduce the issue
    • Any relevant configuration settings
  5. Submit your bug report to brazilofmux@gmail.com or create a new GitHub issue

For crashes, if possible, include the output of debugging tools:

gdb bin/netmux core
(gdb) where
(gdb) info locals
(gdb) quit