NyoUpdates

NyoUpdates is the fastest mod manager for Hytale. It uses the nyoCF API, a dedicated Hytale mod database that synchronizes with CurseForge significantly faster than other APIs. Update checks that take ~50ms instead of 50+ seconds.

Performance

The nyoCF API is optimized specifically for Hytale mod management:

• Bulk endpoint checks ALL installed mods in a single HTTP request
• Response time typically under 100ms for 200+ mods
• Database synchronizes with CurseForge faster than CFWidget or others
• Automatic fallback to CFWidget if the primary API is unavailable
• No API key required

In-Game UI

Version 2.0 introduces a complete in-game interface for mod management:

• Open with /upd ui
• Browse installed mods with update status
• Search and install mods directly from CurseForge
• Select specific versions to install (not just latest)
• Enable/disable mods without leaving the game
• Ignore mods from update checks
• Configure plugin settings visually

The UI displays mod icons, version history, release types, and file sizes. Version changes are staged as pending updates and applied on restart.

How It Works

1. When the server starts (or when you run /updates check), NyoUpdates scans your mods folder
2. It sends a single bulk request to the nyoCF API with all mod information
3. The API returns update status for all mods at once
4. Available updates are downloaded to a .updates folder
5. An apply_updates.bat/sh script is created for manual application
6. Updates can also be applied automatically via EarlyPlugin on restart

Features

• Bulk API for fast update checks (~50ms for all mods)
• In-game UI for mod management, installation, and version selection
• No API key required
• Bundle support (extracts mods from zip files with mods/earlyplugins structure)
• Interactive update script with mod selection
• Backup system before updating
• Release type filtering (release, beta, alpha)
• Ignore list for specific mods
• Manual CurseForge mapping for edge cases
• Singleplayer and server support
• EarlyPlugin for automatic updates on restart

Hosting Service Compatibility

Many hosting services do NOT support the --accept-early-plugins argument required for automatic updates.

NyoUpdates works in MANUAL mode by default, which is compatible with ALL hosting services. Use manual mode and run apply_updates.bat/sh during server maintenance.

Quick Start

Singleplayer / Manual Mode

1. Install NyoUpdates in your mods/ folder
2. Start the game - it will check for updates automatically
3. Use /updates ui to manage mods visually, or /updates check via command
4. When updates are found, close the game
5. Go to your mods/.updates folder and double-click apply_updates.bat/sh
6. Select which mods to update and confirm
7. Start the game again

Dedicated Servers (Auto Mode)

If you have full control over your server:

1. Run /updates enable in-game or console
2. Add --accept-early-plugins to your startup command
3. Restart the server

Updates will be applied automatically on each restart.

Example startup command:

java -jar HytaleServer.jar --assets Assets.zip --accept-early-plugins

Commands

Command aliases: /updates, /upd, /nyo

The apply_updates.bat/sh Script

When updates are found, an interactive script is created in your mods folder:

  Updates ready to install:

  [X]  1. GoneFishing -> 0.1.2
  [X]  2. Playtime -> 1.3.0
  [X]  3. HyFixes -> 1.9.7
  [X]  4. [EP] HyFixes (EarlyPlugin) -> 1.9.7
  [ ]  5. SomeMod -> 2.0.0    (deselected)

  [EP] = EarlyPlugin (installed to earlyplugins folder)

  Commands:
    [number]  Toggle specific mod
    [A]       Apply all selected updates
    [S]       Select all  |  [D] Deselect all
    [Q]       Quit without applying

  Enter command: _

Configuration

Config file location: mods/dotJunyo_nyoUpdates/config.json

{
  "autoUpdateOnStartup": true,
  "checkIntervalHours": 12,
  "enableEarlyPlugin": false,
  "maxConcurrentDownloads": 2,
  "createBackups": true,
  "backupRetentionDays": 7,
  "gameVersionFilter": "",
  "releaseTypesAllowed": ["release", "beta"],
  "ignoredMods": [],
  "debugMode": false,
  "notifyOnAvailableUpdates": true,
  "autoRestartAfterUpdate": false,
  "modsFolderPath": "",
  "connectionTimeoutSeconds": 30,
  "readTimeoutSeconds": 60,
  "maxRetries": 3,
  "verifyChecksums": true,
  "curseforgeMapping": {},
  "language": "en-us",
  "enableFallback": true,
  "enableBulkApi": true,
  "betaMessageShown": false
}

Configuration Options

Translations

NyoUpdates supports multiple languages. Built-in translations:

• English (en-us) - Default
• Portuguese (pt-br) - Translation by dotJunyo
• German (de-de) - Translation by TomberWolf
• French (fr-fr) - Translation by Kraoc
• Italian (it-it) - Translation by Lasersonico83
• Polish (pl-pl) - Translation by Arcadiomo

If you find any issues with these translations, please reach out!

• Russian (ru-ru) - Translation by dotJunyo (with AI)
• Spanish (es-es) - Translation by dotJunyo (with AI)

Custom Translations

You can add your own translations:

1. Create a file named <locale>.json (e.g., es-es.json for Spanish)
2. Place it in mods/dotJunyo_nyoUpdates/lang/
3. Use /updates lang list to verify it was detected
4. Use /updates lang <locale> to activate it

Copy en-us.json as a template for your translation. The file must include the _meta section with language information.

https://tools.junyo.dev/en or https://tools.junyo.dev/pt

Permissions

NyoUpdates uses permission system. By default, all commands require the operator group. For granular control with permission plugins like LuckPerms, use the individual permission nodes below.

Permission Nodes

Usage Examples

Grant all permissions to a player (LuckPerms):

/lp user <player> permission set nyoupdates.* true

Grant only UI and check permissions:

/lp user <player> permission set nyoupdates.base true
/lp user <player> permission set nyoupdates.ui true
/lp user <player> permission set nyoupdates.check true

Grant all permissions to a group:

/lp group moderator permission set nyoupdates.* true

Remove operator requirement (allow all players to use /updates ui):

/lp group default permission set nyoupdates.base true
/lp group default permission set nyoupdates.ui true

Recommended Permission Sets

For moderators (management):

• All player permissions, plus:
• nyoupdates.check - Manually trigger update checks
• nyoupdates.ignore / nyoupdates.unignore - Manage ignored mods
• nyoupdates.mapping.* - Configure CurseForge mappings

For administrators (full control):

• nyoupdates.* - All permissions (wildcard)

Bundle Support

NyoUpdates handles mods that come as bundle zip files containing both the mod and an EarlyPlugin.

Example bundle structure:

hyfixes-bundle-v1.9.7/
  mods/
    hyfixes-1.9.7.jar
  earlyplugins/
    hyfixes-early-1.9.7.jar
  README.md

The plugin detects bundle structures, extracts the jar files to the correct locations, and tracks them for updates. EarlyPlugins from bundles are only installed if your server already has an earlyplugins/ folder with existing jars.

Manual CurseForge Mapping

If NyoUpdates cannot automatically identify a mod on CurseForge (due to naming differences), you can add a manual mapping.

Using the command:

/updates mapping add <id|name> <curseforge-slug>

Or edit config.json:

{
  "curseforgeMapping": {
    "hytale-votifier-1.0.0-SNAPSHOT.jar": "hytale-votifier",
    "votifier-1.4.jar": "votifier"
  }
}

The key is your mod's filename, the value is the CurseForge project slug from the URL.

Platform Support

• Windows (AppData and server paths)
• Linux (XDG paths, Flatpak, Snap)
• macOS (Application Support)