October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk10 min

How to Install Mods, Asset Packs, and Plugins on a Hytale Server

A practical Hytale server guide covering global and world-local Mods folders, asset-pack manifests, plugin installation, HytaleJS paths, Update 6 compatibility, and troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Hytale mod installation is primarily server-side: stop and back up the server, copy a compatible asset pack or plugin into its mods directory, enable it in the world’s New World Options, restart, and inspect the logs. Players normally do not install a separate client mod.

What you are installing

Hytale uses two broad kinds of server content. Asset Packs add or override game assets—such as models, textures, sounds, blocks, items, worlds, or other content files. A pack can change existing content when the relevant asset is included. Plugins run program code through the Java server API, allowing behavior that an asset replacement alone cannot provide.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The distinction matters when you choose a download and troubleshoot it. An asset pack normally contains a manifest.json and is loaded as content. A plugin is usually a Java archive (JAR) and may have dependencies, a required server API version, or its own configuration and data directories.

Content type What it changes Typical file Where it is installed Player download normally required?
Asset Pack Game assets and packaged content; can add or override existing assets ZIP file or folder containing manifest.json Global Mods folder or a world’s mods folder No; the host supplies it
Plugin Programmatic server behavior through the Java API Usually a JAR, plus any files specified by the plugin Server mods directory No for a server-side plugin, unless its author explicitly documents a client component

Hytale’s technical director describes the design as “Server-side first: All modding in Hytale is based on the host of the server or host of the game.” The official asset guidance likewise says only the server or world host has to download Asset Packs and Mods. That means a player should generally be able to connect with an unmodified client while the server provides the required content.

#1 Best Overall
SKYESEV Prebuilt Gaming Desktop PC, AMD Ryzen 5 5600, GeForce RTX 3050 6GB,32GB DDR4 3200MHz RAM, 1TB NVMe SSD, ARGB Air Cooling, Wi-Fi,Tower Computer for Gaming, Streaming, Editing
  • Processor specifications: Adopting AMD Ryzen 5 5600 processor, with a basic clock speed of 3.5GHz and a turbo frequency of 4.4GHz, it can achieve fast response computing performance
  • Graphics Card: Features GeForce RTX 3050 graphics card with 6GB dedicated video memory for gaming and multimedia applications
  • Memory configuration: Equipped with 32GB DDR4 RAM (16GB * 2), providing sufficient memory capacity for multitasking and demanding applications
  • Gaming Performance: Designed to handle modern gaming titles and graphics-intensive tasks with smooth frame rates and visual quality
  • Desktop System: Complete gaming desktop computer system ready for setup and use out of the box

Before you copy anything

Confirm the Hytale build

Check the package page or release notes for the Hytale version it supports, plus required dependencies. Documentation was showing Release 0.7.2 when this guide’s information was gathered, but your server may be on a different build. Do not assume a package that worked on one release will load unchanged on another.

Update 6 changed the network protocol from hytale/2 to hytale/3 and changed packet layouts later in the cycle. Its release notes say servers and plugins must be rebuilt before they can connect after that change. A plugin compiled for an older protocol can therefore fail even when its files are in the correct folder.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Make a backup and stop the server

Back up the server directory and the affected world before changing files. Include the world save, configuration, plugin data, and logs. Stop the server using the control panel or service method supplied by your hosting platform; there is no single universal stop command that is official for every installation. Copying files while the process is writing them can leave a partial archive or inconsistent configuration.

Inspect the download

  • Use a package from a source you trust and verify that it is intended for Hytale.
  • Check the supported game version, required dependencies, load order, and whether the author documents a server-only or client-side component.
  • For an asset pack, open the ZIP or folder and confirm that manifest.json is at the expected package level rather than buried inside an extra wrapper folder.
  • For a plugin, read its deployment instructions before moving the JAR. Some plugins create a data folder only after the first launch.

Find the server’s Mods folder

Global user installation on Windows

The official asset documentation gives this user-installation path:

C:Users<user>AppDataRoamingHytaleUserDataMods

Replace <user> with the Windows account that owns the Hytale data. This global Mods folder is appropriate when the content should be available to more than one world.

Rank #2
Sale
suevery Gaming PC Desktop Computer Ryzen 5,16GB DDR4 512G SSD, RX 560 4G | 6-Core Up to 4.1GHz | RGB Prebuilt Tower | Wi-Fi 6 Gamer for Student Home Office Black
  • 【6-Core Ryzen 5 Prebuilt Gaming PC | Smooth Large Game & Streaming Performance】 The Suevery prebuilt gaming PC features an Ryzen 5 6-Core processor (3.6GHz Base, 4.1GHz Boost) and Radeon RX 560 4GB Graphics Card. It delivers lag-free gameplay for large games, seamless high-definition streaming, and smooth creative software operation, meeting gamers and content creators' reliable performance needs.
  • 【16GB DDR4 RAM + 512GB NVMe SSD | Blazing-Fast Boot & Load Speeds】 16GB DDR4 RAM supports simultaneous operation of multiple games, browser tabs and office apps without slowdowns. The 512GB NVMe SSD (up to 30x faster than traditional HDDs) enables fast boot-ups, instant game loads and quick file transfers, with ample storage for games, videos and work files.
  • 【Wi-Fi 6 Gaming Tower | Versatile Connectivity for Multi-Scenarios】 This tower gaming desktop has Wi-Fi 6 for fast, stable wireless internet, ideal for online gaming and high-definition streaming. It also includes 2× USB 3.0 and 4× USB 2.0 ports to connect peripherals, storage and office devices, suitable for gaming, home and office use.
  • 【RGB Cooling System | Stable Operation】 The advanced air cooling system with customizable RGB fans keeps the gaming tower PC cool and quiet during intense gaming. Optimized airflow maintains optimal component temperatures, preventing overheating and ensuring stable performance for long gaming sessions or heavy office workloads. Sleek RGB lighting adds a gaming-inspired aesthetic.
  • 【Prebuilt Tower PC | Adapt to Gaming/Work/Home/Office】 This prebuilt tower gaming PC is versatile for streaming, work, home and office tasks—from video editing and design software to daily office work and browsing. Ready to use with no extra setup, it meets the needs of gamers, remote workers and home users.

World-local content

A world can have its own Mods directory at:

Saves<world>mods

Replace <world> with the save’s directory name. World-local installation is useful when a pack should affect only one save. If an asset made in the Asset Editor works in the world where it was created but not in another world, copy it from that world’s mods folder to the global Mods folder when you want it available elsewhere.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Dedicated server layout

For a self-hosted or dedicated server, use the server directory’s mods folder. The exact parent directory depends on how you installed and launch Hytale, so identify the folder that contains the server executable and its existing configuration rather than creating a second, similarly named directory. A plugin’s own documentation takes precedence if it specifies a subdirectory or additional file.

Install an Asset Pack

  1. Stop the server and make the backup. Keep a copy of the original ZIP and note the current server and world versions.
  2. Open the applicable Mods folder. Choose the global Mods folder for use across worlds, or Saves<world>mods for one world. On a dedicated server, use the server’s mods directory.
  3. Copy the package without changing its structure. Place the ZIP or the extracted folder that contains manifest.json directly in the Mods folder. Do not add another level of nesting unless the author explicitly requires it.
  4. Review the manifest and dependencies. The official example includes fields such as Group, Name, Version, Description, Authors, Website, Dependencies, OptionalDependencies, LoadBefore, DisabledByDefault, IncludesAssetPack, and SubPlugins. Use the schema and Asset Editor workflow where possible instead of inventing field names.
  5. Start the server and open the world’s New World menu. Installed Asset Packs and Mods appear under the menu’s Options. Enable the pack for that world; merely copying the file does not necessarily turn it on.
  6. Restart and check the log. Look for the pack’s name, dependency resolution, and any parse or load errors. A clean file copy is not proof that the pack loaded.
  7. Join with a normal client. Test the affected asset in-game. Other players should generally not need to install the pack separately because the host controls server-side modding.

When to use ZIP versus an extracted folder

The official guidance accepts a ZIP file or a folder containing manifest.json. Keep the format supplied by the author unless the package instructions say otherwise. If you extract a ZIP, preserve every subfolder and filename; moving only the visible textures or models will usually break the manifest’s paths.

Install a plugin

Plugins use the server’s mods directory, but each plugin can have different dependencies and startup requirements. Follow its deployment notes and verify that it was built for your Hytale server version.

HytaleJS example

The HytaleJS deployment documented by its project uses this sequence:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Qehi Desktop Gaming PC Computer,16G DDR4 512G SSD, RX560 4G Prebuilt Tower
  • 【Sleek Design & Efficient Cooling】 Features an A-pillar-free dual tempered glass design, showcasing a clean internal layout and RGB lighting. High-quality tempered glass offers durability and a stylish appearance for gaming and office environments. The optimized airflow system enhances ventilation, rapidly dissipating heat to maintain stable and quiet performance during long-term use.
  • 【Powerful Processing & Smooth Multi-Tasking】 Equipped with AMD Ryzen 5 3500X 6-core 6-thread processor (32MB L3 cache, 3.6GHz base, 4.1GHz boost). Delivers responsive and stable performance for seamless multitasking, office work, HD streaming, and daily computing. Runs creative and productivity software smoothly, suitable for streamers, remote workers, and home users.
  • 【Entry-Level Gaming Graphics for Esports & Online Games】 Powered by AMD Radeon RX 560 4GB GDDR5 discrete graphics card, supporting DirectX 12 and Vulkan API. Provides smooth gameplay for popular esports titles like League of Legends, CS:GO, and Overwatch. Handles light AAA games at medium-low settings, meeting the entertainment needs of casual gamers and students.
  • 【16GB DDR4 + 512GB NVMe SSD: Ultra-Fast Speed】 16GB high-speed DDR4 RAM supports simultaneous operation of multiple games, browsers, and office apps without slowdowns or freezes. The 512GB NVMe PCIe SSD enables fast boot and instant loading of games/software, with file transfer speeds up to 30 times faster than traditional HDDs, offering ample storage for games, videos, and work files.
  • 【WiFi 6 & Rich Interfaces: Ready-to-Use Prebuilt PC】 Features the latest WiFi 6 technology for fast and stable wireless connectivity, ideal for online gaming, HD live streaming, and remote work. Equipped with multiple USB 3.0, USB 2.0, HDMI, and LAN ports for easy connection of gaming peripherals, monitors, external storage, and office devices. Plug-and-play design requires no extra setup, adapting to gaming, live streaming, office work, online learning, and home entertainment scenarios.
  1. Stop the server and back up its files.
  2. Copy HytaleJS.jar to hytale-server/mods/HytaleJS.jar.
  3. Start the server once. On first startup, it generates the JavaScript location hytale-server/mods/bmstefanski_HytaleJS/scripts/.
  4. Place your .js files in that generated scripts directory.
  5. Restart the server so HytaleJS loads the scripts and inspect the startup log for errors.

The generated directory name is significant. Putting scripts beside the JAR, in the server root, or in a similarly named folder will not make them load. For later script changes, use the restart behavior documented by HytaleJS rather than assuming every edit is hot-reloaded.

Java plugins in general

  • Place the plugin JAR directly in the server’s mods directory unless its author specifies another path.
  • Install every required dependency and observe any ordering instruction such as LoadBefore.
  • Do not rename a JAR or edit its manifest unless the plugin documentation explicitly permits it.
  • After the first launch, inspect newly generated configuration or data folders and apply the plugin’s documented settings.
  • If a plugin targets an older protocol or API, obtain a rebuilt release rather than trying to bypass the version check.

Enable and scope content per world

Hytale separates “installed” from “enabled.” After the files are present, open the world’s New World menu and select Options. The installed Mods and Asset Packs are listed there. Enable the entries intended for that world, then create or restart the world as required by the package.

A global installation makes a package available for selection in multiple worlds; it does not force every world to use it. A world-local installation keeps the package tied to one save. This distinction explains why an Asset Editor result can appear in its original world but be absent from another: the second world cannot see a pack that exists only under the first world’s mods directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Find and update mods through the in-game browser

Update 6 introduced an in-game mod browser from the Hytale main menu. Its first version shows featured, popular, and recently updated mods, with categories and search, supported-version information, install buttons, and a My Library view for updating or removing installed mods.

This route can reduce manual copying and makes the supported game version visible before installation. It does not eliminate compatibility checks: read the package’s dependencies and changelog, and verify that the server build and the selected world support it. Manual server installation remains necessary for packages distributed only as files or for plugins with custom deployment steps.

Rank #4
Sale
CyberPowerPC Gamer Xtreme VR Gaming PC, Intel Core i5-13400F 2.5GHz, GeForce RTX 5060 8GB, 16GB DDR5, 1TB PCIe 4.0 SSD, WiFi Ready & Windows 11 Home (GXiVR8060A40)
  • System: Intel Core i5-13400F 2.5GHz 10 Cores | Intel B760 Chipset | 16GB DDR5 | 1TB PCIe 4.0 NVMe SSD | Windows 11 Home
  • Graphics: NVIDIA GeForce RTX 5060 8GB Graphics | 1x HDMI | 2x DisplayPort
  • Connectivity: 1 x USB-C 3.2 | 2 x USB-A 3.2 | 6 x USB-A 2.0 | 1 x LAN | WiFi 6 | Bluetooth 5.3 | 7.1 Channel Audio
  • Tempered Side Case Panel | Custom RGB Lighting | Keyboard and Mouse
  • 1 Year Parts & Labor Warranty, Free Lifetime Tech Support

CurseForge distribution

CurseForge identifies its website and application as a distribution route for Hytale mods, supporting discovery, installation, and updates. Creators can use the in-game Asset Editor without an account, while publishing through CurseForge requires an account and moderation approval. Treat a listing as a source and update mechanism, not as a guarantee that every release works with every server build.

Version compatibility and dependency failures

Protocol or API mismatch

Symptoms include a plugin refusing to load, a server failing during startup, or clients being unable to connect after an update. Check the server version, the plugin’s target version, and whether a rebuilt release exists. Update 6’s hytale/2-to-hytale/3 protocol change is a concrete example of why rebuilding is required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Sub-plugin boot crash

Update 6 records a server boot crash involving sub-plugins with a non-zero parent patch version. If a package uses sub-plugins, compare its parent and child version metadata and install a release that addresses the issue. Do not “fix” the manifest by changing version numbers without the author’s guidance; that can make dependency resolution less reliable.

Missing dependency or wrong load order

A manifest can declare required and optional dependencies and a LoadBefore relationship. A missing required package should be installed first. If the log reports an ordering problem, follow the declared relationship and remove duplicate or obsolete copies from other Mods folders.

Troubleshoot a pack or plugin that does not work

Symptom Likely cause What to check
Nothing appears in New World Options Wrong directory, nested archive, malformed manifest, or incompatible package Confirm the global or world-local path, place manifest.json at the expected level, and read startup logs
Works in one world only Pack is installed under that world’s mods folder Copy it to the global Mods folder for cross-world availability, then enable it in the other world
Server crashes during boot Version mismatch, missing dependency, bad sub-plugin metadata, or malformed files Stop the server, remove the newest package using the backup, and inspect the first relevant error in the log
Plugin JAR loads but scripts do not Scripts are in the wrong directory or the server was not restarted For HytaleJS, use bmstefanski_HytaleJS/scripts/ and restart
Players cannot connect after an update Protocol or plugin build is outdated Check whether the server and plugins were rebuilt for the current protocol, including the hytale/3 transition
Asset changes are absent in-game Pack installed but not enabled, or asset path preserved incorrectly Enable it under New World Options and restore the package’s original folder structure

When testing, change one package at a time. Keep the server stopped while removing files, restore the backup if the world will not boot, and save the relevant log excerpt for the package author. Avoid deleting a world to solve a file-placement problem; first verify the path, manifest, dependency list, and enabled state.

Safe sources and operator responsibilities

Prefer the Hytale mod browser, the package author’s documented release page, or an established distribution service. Check downloads for a stated Hytale version and dependencies, and do not run unknown executables as part of an “installer.” A server-side mod still has access to the server process and world data, so source trust matters.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Hytale’s EULA permits independent mod monetization subject to restrictions. Do not redistribute Hytale game files, imply official endorsement, include malware, violate law or third-party rights, or use prohibited NFT or cryptocurrency schemes. Those policy limits apply whether a package is installed manually or obtained through a browser.

Quick installation checklist

  • Back up the world, configuration, plugin data, and logs.
  • Stop the server through its own panel or service method.
  • Confirm the package supports the exact Hytale server build and list every dependency.
  • Put an asset ZIP or folder containing manifest.json in the global Mods folder or the target world’s mods folder.
  • Put plugins in the server’s mods directory and follow any project-specific subfolder instructions.
  • For HytaleJS, copy HytaleJS.jar to hytale-server/mods/, then use bmstefanski_HytaleJS/scripts/ after the first start.
  • Open New World > Options and enable the installed Mod or Asset Pack.
  • Restart, read the server log, and resolve the first compatibility or dependency error before adding another package.
  • Connect with a normal client to verify the result; players generally do not need a separate client mod.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.