Hytale Panel

Installing Mods

How to find, install, and manage mods for your Hytale server.

Introduction

This guide covers the complete process of finding, installing, and managing mods for your Hytale server using the integrated Modtale marketplace.

Prerequisites

  • A running Hytale server
  • Modtale API key configured in Settings

Finding Mods

Browsing the Marketplace

  1. Navigate to Mods in the sidebar
  2. Browse the featured mods or use search
  3. Filter by category:
    • Plugins: Server-side modifications
    • Data Assets: Game data modifications
    • Art Assets: Visual content
    • World Saves: Pre-built worlds

Evaluating Mods

Before installing, check:

  • Downloads: Higher numbers indicate popularity
  • Rating: Community feedback
  • Last Updated: Recent updates suggest active maintenance
  • Description: Understand what the mod does

Installing a Mod

Step-by-Step Installation

  1. Find the mod you want to install
  2. Click the Install button
  3. Select your target server from the dropdown
  4. Confirm the installation
  5. Wait for the download and installation to complete

Post-Installation

After installation:

  1. Check the server console for any mod-specific messages
  2. Some mods may require a server restart
  3. Test the mod functionality in-game

Managing Installed Mods

Viewing Installed Mods

  1. Go to your server’s detail page
  2. Click on the Mods tab
  3. View all installed mods with their versions

Uninstalling Mods

  1. Find the mod in your installed list
  2. Click Uninstall
  3. Confirm the removal
  4. Restart the server if prompted

Troubleshooting

Mod Conflicts

If you experience issues after installing a mod:

  1. Check the console for errors
  2. Try disabling recently installed mods
  3. Verify mod compatibility with your server version

Installation Failures

If a mod fails to install:

  1. Check your internet connection
  2. Verify your Modtale API key is valid
  3. Ensure sufficient disk space
  4. Check the installation logs for details

Performance Issues

If your server runs slowly after installing mods:

  1. Check resource usage in the dashboard
  2. Consider allocating more memory
  3. Review mod descriptions for performance notes
  4. Remove unnecessary mods

Best Practices

Before Installing

  1. Backup First: Always create a backup before adding mods
  2. Read Documentation: Check the mod’s description and requirements
  3. Test Environment: Try mods on a test server first

After Installing

  1. Monitor Performance: Watch CPU and memory usage
  2. Check Logs: Look for errors or warnings
  3. Gather Feedback: Ask players about their experience

Maintenance

  1. Regular Updates: Keep mods updated when new versions release
  2. Clean Up: Remove unused mods to reduce complexity
  3. Document Changes: Keep track of what mods you install and why

Advanced Tips

Mod Load Order

Some mods may need to load in a specific order. Check mod documentation for load order requirements.

Configuration Files

Many mods create configuration files. Look in your server’s config or mods directory for customization options.

Compatibility Matrix

Keep a list of your installed mods and their versions. This helps when troubleshooting or reporting issues.