* fix: resolve cross-platform EPERM permissions errors
modManager.js:
- Switch from hardcoded 'junction' to dynamic symlink type based on OS (fixing Linux EPERM).
- Add retry logic for directory removal to handle file locking race conditions.
- Improve broken symlink detection during profile sync.
gameManager.js:
- Implement retry loop (3 attempts) for game directory removal in updateGameFiles to prevent EBUSY/EPERM errors on Windows.
paths.js:
- Prevent fs.mkdirSync failure in getModsPath by pre-checking for broken symbolic links.
* fix: missing pacman builds
* prepare release for 2.1.1
minor fix for EPERM error permission
* prepare release 2.1.1
minor fix EPERM permission error
* prepare release 2.1.1
* Update README.md Windows Prequisites for ARM64 builds
* fix: remove broken symlink after detected
* fix: add pathexists for paths.js to check symlink
* fix: isbrokenlink should be true to remove the symlink
* add arch package .pkg.tar.zst for release
* fix: release workflow for build-arch and build-linux
* build-arch job now only build arch .pkg.tar.zst package instead of the whole generic linux.
* build-linux job now exclude .pacman package since its deprecated and should not be used.
* fix: removes pacman build as it replaced by tar.zst and adds build:arch shortcut for pkgbuild
* aur: add proper VCS (-git) PKGBUILD
created clean VCS-based PKGBUILD following arch packaging conventions.
this explicitly marked as a rolling (-git) build and derives its version dynamically from git tags and commit history via pkgver(). previous hybrid approach has been changed.
key changes:
- use -git suffix to clearly indicate rolling source builds
- set pkgver=0 and compute the actual version via pkgver()
- build only a directory layout using electron-builder (--dir)
- avoid generating AppImage, deb, rpm, or pacman installers
- align build and package steps with Arch packaging guidelines
note: this PKGBUILD is intended for development and AUR use only and is not suitable for binary redistribution or release artifacts.
* ci: add fixed-version PKGBUILD for Arch Linux releases
this PKGBUILD intended for CI and GitHub release artifacts. targets tagged releases only and uses a fixed pkgver that matches the corresponding git tag. all of the VCS logic has been removed to PKGBUILD-git to ensure reproducible builds and stable versioning suitable for binary distribution.
the build process relies on electron-builder directory output (--dir) and packages only the unpacked application into a standard Arch Linux package (.pkg.tar.zst). other distro format are excluded from this path and handled separately.
this change establishes a clear separation between:
- rolling AUR development builds (-git)
- CI-generated, versioned Arch Linux release packages
the result is predictable artifact naming, correct version alignment, and Arch-compliant packaging for downstream users.
* Update README.md
adds information for Arch build
* Update README.md
BUILD.md location was changed and now this link is poiting to nothing
* Update PKGBUILD
* Update PKGBUILD-git
* chore: fix ubuntu/debian part in README.md
* Polish language support (#195)
* Update support_request.yml
Added hardware specification
* Update bug_report.yml
Add logs textfield to bug report
* chore: add changelog in README.md
* fix screenshot input in feature_request.yml
* add hardware spec input in bug_report.yml
* fix: PKGBUILD pkgname variable fix
* userdata migration [need review from other OS]
* french translate
* Add German and Swedish translations
Added de.json and sv.json locale files for German and Swedish language support. Updated i18n.js to register 'de' and 'sv' as available languages in the launcher.
* Update README.md
* chore: add offline-mode warning to the README.md
* chore: add downloads counter in README.md
* fix: Steam Deck/Ubuntu crash - use system libzstd.so
The bundled libzstd.so is incompatible with glibc 2.41's stricter heap
validation, causing "free(): invalid pointer" crashes.
Solution: Automatically replace bundled libzstd.so with system version
on Linux. The launcher detects and symlinks to /usr/lib/libzstd.so.1.
- Auto-detect system libzstd at common paths (Arch, Debian, Fedora)
- Backup bundled version as libzstd.so.bundled
- Create symlink to system version
- Add HYTALE_NO_LIBZSTD_FIX=1 to disable if needed
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: remove Windows and Linux ARM64 information on the README.md
* Update support_request.yml
* fix: improve update system UX and macOS compatibility
Update System Improvements:
- Fix duplicate update popups by disabling legacy updater.js
- Add skip button to update popup (shows after 30s, on error, or after download)
- Add macOS-specific handling with manual download as primary option
- Add missing open-download-page IPC handler
- Add missing unblockInterface() method to properly clean up after popup close
- Add quitAndInstallUpdate alias in preload for compatibility
- Remove pulse animation when download completes
- Fix manual download button to show correct status and close popup
- Sync player name to settings input after first install
Client Patcher Cleanup:
- Remove server patching code (server uses pre-patched JAR from CDN)
- Simplify to client-only patching
- Remove unused imports (crypto, AdmZip, execSync, spawn, javaManager)
- Remove unused methods (stringToUtf8, findAndReplaceDomainUtf8)
- Move localhost dev code to backup file for reference
Code Quality Fixes:
- Fix duplicate DOMContentLoaded handlers in install.js
- Fix duplicate checkForUpdates definition in preload.js
- Fix redundant if/else in onProgressUpdate callback
- Fix typo "Harwadre" -> "Hardware" in preload.js
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Add Russian language support
Added Russian (ru) to the list of available languages.
* chore: drafting documentation on SERVER.md
* Some updates in Russian language localization file
* fix
* Update ru.json
* Fixed Java runtime name and fixed typo
* fixed untranslated place
* Update ru.json
* Update ru.json
* Update ru.json
* Update ru.json
* Update ru.json
* fix: timeout getLatestClient
fixes#138
* fix: change default version to 7.pwr in main.js
* fix: change default release version to 7.pwr
* fix: change version release to 7.pwr
* docs: Add comprehensive troubleshooting guide (#209)
Add TROUBLESHOOTING.md with solutions for common issues including:
- Windows: Firewall configuration, duplicate mods, SmartScreen
- Linux: GPU detection (NVIDIA/AMD), SDL3_image/libpng dependencies,
Wayland/X11 issues, Steam Deck support
- macOS: Rosetta 2 for Apple Silicon, code signing, quarantine
- Connection: Server boot failures, regional restrictions
- Authentication: Token errors, config reset procedures
- Avatar/Cosmetics: F2P limitations documentation
- Backup locations for all platforms
- Log locations for bug reports
Solutions compiled from closed GitHub issues (#205, #155, #90, #60,
#144, #192) and community feedback.
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* Standardize language codes, improve formatting, and update all locale files. (#224)
* Update German (Germany) localization
* Update Español (España) localization
* Update French (France) localization
* Update Polish (Poland) localization
* Update Portuguese (Brazil) localization
* Update Russian (Russia) localization
* Update Swedish (Sweden) localization
* Update Turkish (Turkey) localization
* Update language codes, names and alphabetical in i18n system
* Changed Spanish language name to the Formal name "Spanish (Spain)"
* Fix PKGBUILD-git
* Fix PKGBUILD
* delete cache after installation
* Enforce 16-char player name limit and update mod sync
Added a maxlength attribute to the player name input and enforced a 16-character limit in both install and settings scripts, providing user feedback if exceeded. Refactored modManager.js to replace symlink-based mod management with a copy-based system, copying enabled mods to HytaleSaves\Mods and removing legacy symlink logic to improve compatibility and avoid permission issues.
* Update installation subtitle
* chore: update quickstart link in README.md
* chore: delete warning of Ubuntu-Debian at Linux Prequisites section
* added featured server list from api
* Add Featured Servers page to GUI
* Update Discord invite URL in client patcher
* Add differential update system
* Remove launcher chat and add Discord popup
* fix: removed 'check disk space' alert on permission file error
* fix: upgrade tar to ^7.5.6 version
* fix: re-add universal arch for mac
* fix: upgrade electron/rebuild to 4.0.3
* fix: removed override tar version
* fix: pkgbuild version to 2.1.2
* fix: src.tar.zst and srcinfo missing files
* feat: add Indonesian language translation
* fix: GPU preference hint to Laptop-only
* feat: create two columns for settings page
* Add Discord invite link to rpc
* docs: add recordings form, fix OS list
* Release v2.2.0
* Release v2.2.0
* Release v2.2.0
* chore: delete icon.ico, moved to build folder
* chore: delete icon.png, moved to build folder
* fix: build and release for tag push-only in release.yml
* fix: gamescope steam deck issue fixes#186 hopefully
* Support branch selection for server patching
* chose: add auto-patch system for pre-release JAR
---------
Co-authored-by: TalesAmaral <57869141+TalesAmaral@users.noreply.github.com>
Co-authored-by: walti0 <95646872+walti0@users.noreply.github.com>
Co-authored-by: AMIAY <letudiantenrap.collab@gmail.com>
Co-authored-by: sanasol <mail@sanasol.ws>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Terromur <79866197+Terromur@users.noreply.github.com>
Co-authored-by: Zakhar Smokotov <zaharb840@gmail.com>
Co-authored-by: xSamiVS <samtaiebc@gmail.com>
* Add electron-updater auto-update support
- Install electron-updater package
- Configure GitHub releases publish settings
- Create AppUpdater class with full update lifecycle
- Integrate auto-update into main.js
- Add comprehensive documentation (AUTO-UPDATES.md, TESTING-UPDATES.md)
- Set up dev-app-update.yml for testing
* Add cache clearing documentation for electron-updater
- Introduced CLEAR-UPDATE-CACHE.md to guide users on clearing the electron-updater cache across macOS, Windows, and Linux.
- Added programmatic method for cache clearing in JavaScript.
- Enhanced update handling in main.js and preload.js to support new update events.
- Updated GUI styles for download buttons and progress indicators in update.js and style.css.
* Update auto-update UI and configuration
- Fix version display (newVersion field)
- Add download progress bar with real-time updates
- Reorder buttons: Install & Restart (primary), Manually Download (secondary)
- Update dev-app-update.yml to point to fork
- Update package.json version to 2.0.2
* Add installation effects and draggable progress bar
Introduces animated installation effects overlay and makes the progress bar draggable. Adds maximize window support, improves window controls styling, and enforces a single app instance. Removes the unused Skins page and related translations. Refines various UI details for a more polished user experience.
* Adjust news card aspect ratio and add Play tab style
Set a default aspect ratio for .news-card and add a specific style for the LATEST NEWS section in the Play tab to override the aspect ratio and use full height.
* Add splash screen to launcher startup
Introduced a new splash screen (splash.html) and updated main.js to display it on startup before loading the main window. The splash screen is shown for 2.5 seconds as a placeholder for future loading logic, improving user experience during application launch.
* Display launcher version in UI
Adds a version display element to the bottom right of the UI, fetching the version from package.json via a new IPC handler. Updates main.js, preload.js, and ui.js to support retrieving and displaying the version, and adds relevant styles in style.css.
* Custom Mod loading fix (#92)
* feat: Add Repair Game functionality including UserData backup and cache clearing
* feat: Add In-App Logs Viewer and Logs Folder shortcut
* feat: Add Open Logs feature
* disable dev tools
* Fix Settings UI
* Implement custom mod loading, autoimport, auto repair
* Fixed Custom Mod loading issues and merge issues
* feat: Externalize sensitive API keys and Discord client ID into environment variables using dotenv.
* feat(mods): add profile-based mod management and auto-repair
* feat: add 'Close launcher on game start' option and improve app termination behavior (#93)
* update main branch to release/v2.0.2b (#86)
* add more linux pkgs, create auto-release and pre-release feature for Github Actions
* removed package-lock from gitignore
* update .gitignore for local build
* add package-lock.json to maintain stability development
* update version to 2.0.2b also add deps for rpm and arch
* update 2.0.2b: add arm64 support, product and executable name, maintainers; remove snap;
* update 2.0.2b: add latest.yml for win & linux, arm64 support; remove snap
* fix release build naming
* Prepare release v2.0.2b
* feat: add 'Close launcher on game start' option and improve app termination behavior
- Added 'Close launcher on game start' setting in GUI and backend.
- Implemented automatic app quit after game launch if setting is enabled.
- Added Cmd+Q (Mac) and Ctrl+Q/Alt+F4 (Win/Linux) shortcuts to quit the app.
- Updated 'window-close' handler to fully quit the app instead of just closing the window.
- Added i18n support for the new setting in English, Spanish, and Portuguese.
---------
Co-authored-by: Fazri Gading <fazrigading@gmail.com>
Co-authored-by: Arnav Singh <hi.arnavsingh3@gmail.com>
* Update publish config to point to chasem-dev fork
* Fix Linux metadata files in workflow and improve error handling
* Bump version to 2.0.5
* Bump version to 2.0.6
* Fix update popup showing for same version - add version comparison checks
* Bump version to 2.0.7
* Fix SHA512 checksum mismatch handling - clear cache and retry automatically
* Bump version to 2.0.8
* Bump version to 2.0.9
* Fix: Use explicit latest-linux.yml to prevent yml file collision
The glob pattern latest*.yml was matching both latest-linux.yml AND
latest.yml from the Linux build, causing the Windows latest.yml to be
overwritten with incorrect checksums.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
* Bump version to 2.0.10
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
* Fix: Remove portable target to fix SHA512 checksum mismatch
The portable and nsis targets both produced x64.exe files with the same
name, causing one to overwrite the other. The latest.yml contained the
checksum from one build while the actual file was from the other build.
Removed portable target - nsis installer is sufficient.
Bump version to 2.0.11
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
* Remove outdated documentation files related to auto-updates, build instructions, and testing updates. Update `dev-app-update.yml` and `package.json` to reflect the correct GitHub owner. This cleanup streamlines the project and ensures accurate configuration for future updates.
* Add semantic versioning policy documentation - numerical versions only
* Update package-lock.json to include new dependencies and versions, enhancing project stability and compatibility.
* fixed imgur restriction for UK
* fix: adds EGL env var to detect installed NVIDIA GPU
* Update release.yml
* patch v2.0.11-beta: fix env issue in GA release, warn Intel Mac users, add com templates. (#115)
* fix: throw error for Intel Mac user
* docs: first draft of issue and PR template
* fix: env of curseforge API key and discord client ID
* implemented late patch should be in #115
* Final patch for release.yml v2.0.11
---------
Co-authored-by: chasem-dev <myers.a.chase@gmail.com>
Co-authored-by: AMIAY <letudiantenrap.collab@gmail.com>
Co-authored-by: Rahul Sahani <110347707+Rahul-Sahani04@users.noreply.github.com>
Co-authored-by: Arnav Singh <72737311+ArnavSingh77@users.noreply.github.com>
Co-authored-by: Arnav Singh <hi.arnavsingh3@gmail.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
* update main branch to release/v2.0.2b (#86)
* add more linux pkgs, create auto-release and pre-release feature for Github Actions
* removed package-lock from gitignore
* update .gitignore for local build
* add package-lock.json to maintain stability development
* update version to 2.0.2b also add deps for rpm and arch
* update 2.0.2b: add arm64 support, product and executable name, maintainers; remove snap;
* update 2.0.2b: add latest.yml for win & linux, arm64 support; remove snap
* fix release build naming
* Prepare release v2.0.2b
* feat: add 'Close launcher on game start' option and improve app termination behavior
- Added 'Close launcher on game start' setting in GUI and backend.
- Implemented automatic app quit after game launch if setting is enabled.
- Added Cmd+Q (Mac) and Ctrl+Q/Alt+F4 (Win/Linux) shortcuts to quit the app.
- Updated 'window-close' handler to fully quit the app instead of just closing the window.
- Added i18n support for the new setting in English, Spanish, and Portuguese.
---------
Co-authored-by: Fazri Gading <fazrigading@gmail.com>
Co-authored-by: Arnav Singh <hi.arnavsingh3@gmail.com>
* feat: Add Repair Game functionality including UserData backup and cache clearing
* feat: Add In-App Logs Viewer and Logs Folder shortcut
* feat: Add Open Logs feature
* disable dev tools
* Fix Settings UI
* Implement custom mod loading, autoimport, auto repair
* Fixed Custom Mod loading issues and merge issues
* feat: Externalize sensitive API keys and Discord client ID into environment variables using dotenv.
* feat(mods): add profile-based mod management and auto-repair
Adds a version display element to the bottom right of the UI, fetching the version from package.json via a new IPC handler. Updates main.js, preload.js, and ui.js to support retrieving and displaying the version, and adds relevant styles in style.css.
Introduced a new splash screen (splash.html) and updated main.js to display it on startup before loading the main window. The splash screen is shown for 2.5 seconds as a placeholder for future loading logic, improving user experience during application launch.
Introduces animated installation effects overlay and makes the progress bar draggable. Adds maximize window support, improves window controls styling, and enforces a single app instance. Removes the unused Skins page and related translations. Refines various UI details for a more polished user experience.
* - Implemented i18n.
- Updated UI elements to use localized strings for various messages and confirmations.
- Added language selection functionality in settings with appropriate event handling.
- Created English localization file with translations for all new strings.
- Updated backend to save and load user-selected language preferences.
* Add Spanish localization for the GUI
* Add Portuguese (Brazil) localization for the GUI
* update main branch to release/v2.0.2b (#86)
* add more linux pkgs, create auto-release and pre-release feature for Github Actions
* removed package-lock from gitignore
* update .gitignore for local build
* add package-lock.json to maintain stability development
* update version to 2.0.2b also add deps for rpm and arch
* update 2.0.2b: add arm64 support, product and executable name, maintainers; remove snap;
* update 2.0.2b: add latest.yml for win & linux, arm64 support; remove snap
* fix release build naming
* Prepare release v2.0.2b
* Update localization for game repair and GPU settings
Added new localization entries for game repair and GPU preferences.
* Update spanish localization for game repair and GPU settings
* Update portuguese (brazil) for game repair and GPU settings
* Update localization for system logs in English, Spanish, and Portuguese
---------
Co-authored-by: Fazri Gading <fazrigading@gmail.com>
* modernized UI for GPU Preference option
* feat: auto-detect dedicated GPU on hybrid laptops (iGPU+dGPU)
* feat: detailed GPU info in auto-detection feature on startup
* feat: add GPU options for launcher
- Add GPU preference setting (Auto/Integrated/Dedicated)
- Implement Linux GPU selection with DRI_PRIME and NVIDIA env vars
- Add GPU detection using Electron's app.getGPUInfo()
- Update settings UI with GPU preference dropdown
- Integrate GPU preference into game launch process
* feat: auto-detect dedicated GPU on hybrid laptops (iGPU+dGPU)
* added fallbacks to and option to use integrated GPU.
* add package-lock and fix deps version
* changed 'Nvidia' string to 'NVIDIA'
* fix: selecting `dedicated` option while using nvidia GPU did not set its specific env variables
* remove unused `CONFIG_FILE` variable on launcher core modules
* fix: duplicated save-load gpu detection functions
* move game option settings to the top, while custom java to the bottom
* fix: settings-header margin-bottom from 3rem to 1rem and supress line-clamp warning
Added a full profile system and fixed a few critical mod loading issues.
What changed
Profiles — Implemented proper profile management (create, switch, delete). Each profile now has its own isolated mod list.
Mod Isolation — Fixed ModManager so mods are strictly scoped to the active profile. Browsing and installing only affects the selected profile.
Critical Fix — Fixed a path bug where mods were being saved to ~/AppData/Local on macOS (Windows path) instead of ~/Library/Application Support. Mods now save to the correct location and load correctly in-game.
Stability — Added an auto-sync step before every launch to make sure the physical mods folder always matches the active profile.
UI — Added a profile selector dropdown and a profile management modal.
- Introduced a new input field for Java path in the launcher UI.
- Updated the main process to handle saving and loading of the Java path.
- Enhanced game launch functionality to accept a Java path parameter.
- Added Java detection logic to find the Java executable on the system.
- Created a .gitignore file to exclude build artifacts and dependencies.
