mirror of
https://github.com/amiayweb/Hytale-F2P.git
synced 2026-02-26 06:01:45 -03:00
* 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>
273 lines
11 KiB
JavaScript
273 lines
11 KiB
JavaScript
const fs = require('fs');
|
|
const path = require('path');
|
|
const { execFile } = require('child_process');
|
|
const { downloadFile, retryDownload } = require('../utils/fileManager');
|
|
const { getOS, getArch } = require('../utils/platformUtils');
|
|
const { validateChecksum, extractVersionDetails, canUseDifferentialUpdate, needsIntermediatePatches, getInstalledClientVersion } = require('../services/versionManager');
|
|
const { installButler } = require('./butlerManager');
|
|
const { GAME_DIR, CACHE_DIR, TOOLS_DIR } = require('../core/paths');
|
|
const { saveVersionClient } = require('../core/config');
|
|
|
|
async function acquireGameArchive(downloadUrl, targetPath, checksum, progressCallback, allowRetry = true) {
|
|
const osName = getOS();
|
|
const arch = getArch();
|
|
|
|
if (osName === 'darwin' && arch === 'amd64') {
|
|
throw new Error('Hytale x86_64 Intel Mac Support has not been released yet. Please check back later.');
|
|
}
|
|
|
|
if (fs.existsSync(targetPath)) {
|
|
const stats = fs.statSync(targetPath);
|
|
if (stats.size > 1024 * 1024) {
|
|
const isValid = await validateChecksum(targetPath, checksum);
|
|
if (isValid) {
|
|
console.log(`Valid archive found in cache: ${targetPath}`);
|
|
return targetPath;
|
|
}
|
|
console.log('Cached archive checksum mismatch, re-downloading');
|
|
fs.unlinkSync(targetPath);
|
|
}
|
|
}
|
|
|
|
console.log(`Downloading game archive from: ${downloadUrl}`);
|
|
|
|
try {
|
|
if (allowRetry) {
|
|
await retryDownload(downloadUrl, targetPath, progressCallback);
|
|
} else {
|
|
await downloadFile(downloadUrl, targetPath, progressCallback);
|
|
}
|
|
} catch (error) {
|
|
const enhancedError = new Error(`Archive download failed: ${error.message}`);
|
|
enhancedError.originalError = error;
|
|
enhancedError.downloadUrl = downloadUrl;
|
|
enhancedError.targetPath = targetPath;
|
|
throw enhancedError;
|
|
}
|
|
|
|
const stats = fs.statSync(targetPath);
|
|
console.log(`Archive downloaded, size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
|
|
|
|
const isValid = await validateChecksum(targetPath, checksum);
|
|
if (!isValid) {
|
|
console.log('Downloaded archive checksum validation failed, removing corrupted file');
|
|
fs.unlinkSync(targetPath);
|
|
throw new Error('Downloaded archive is corrupted or invalid. Please retry');
|
|
}
|
|
|
|
console.log(`Archive validation passed: ${targetPath}`);
|
|
return targetPath;
|
|
}
|
|
|
|
async function deployGameArchive(archivePath, destinationDir, toolsDir, progressCallback, isDifferential = false) {
|
|
if (!archivePath || !fs.existsSync(archivePath)) {
|
|
throw new Error(`Archive not found: ${archivePath || 'undefined'}`);
|
|
}
|
|
|
|
const stats = fs.statSync(archivePath);
|
|
console.log(`Deploying archive: ${archivePath}`);
|
|
console.log(`Archive size: ${(stats.size / 1024 / 1024).toFixed(2)} MB`);
|
|
console.log(`Deployment mode: ${isDifferential ? 'differential' : 'full'}`);
|
|
|
|
const butlerPath = await installButler(toolsDir);
|
|
const stagingDir = path.join(destinationDir, 'staging-temp');
|
|
|
|
if (!fs.existsSync(destinationDir)) {
|
|
fs.mkdirSync(destinationDir, { recursive: true });
|
|
}
|
|
|
|
if (fs.existsSync(stagingDir)) {
|
|
fs.rmSync(stagingDir, { recursive: true, force: true });
|
|
}
|
|
fs.mkdirSync(stagingDir, { recursive: true });
|
|
|
|
if (progressCallback) {
|
|
progressCallback(isDifferential ? 'Applying differential update...' : 'Installing game files...', null, null, null, null);
|
|
}
|
|
|
|
const args = [
|
|
'apply',
|
|
'--staging-dir',
|
|
stagingDir,
|
|
archivePath,
|
|
destinationDir
|
|
];
|
|
|
|
console.log(`Executing deployment: ${butlerPath} ${args.join(' ')}`);
|
|
|
|
return new Promise((resolve, reject) => {
|
|
const child = execFile(butlerPath, args, {
|
|
maxBuffer: 1024 * 1024 * 10,
|
|
timeout: 600000
|
|
}, (error, stdout, stderr) => {
|
|
if (error) {
|
|
const cleanStderr = stderr.replace(/[\u2714\u2716\u2713\u2717\u26A0\uD83D[\uDC00-\uDFFF]]/g, '').trim();
|
|
const cleanStdout = stdout.replace(/[\u2714\u2716\u2713\u2717\u26A0\uD83D[\uDC00-\uDFFF]]/g, '').trim();
|
|
|
|
if (cleanStderr) console.error('Deployment stderr:', cleanStderr);
|
|
if (cleanStdout) console.error('Deployment stdout:', cleanStdout);
|
|
|
|
const errorText = (stderr + ' ' + error.message).toLowerCase();
|
|
let message = 'Game deployment failed';
|
|
|
|
if (errorText.includes('unexpected eof')) {
|
|
message = 'Corrupted archive detected. Please retry download.';
|
|
if (fs.existsSync(archivePath)) {
|
|
fs.unlinkSync(archivePath);
|
|
}
|
|
} else if (errorText.includes('permission denied')) {
|
|
message = 'Permission denied. Check file permissions and try again.';
|
|
} else if (errorText.includes('no space left') || errorText.includes('device full')) {
|
|
message = 'Insufficient disk space. Free up space and try again.';
|
|
}
|
|
|
|
const deployError = new Error(message);
|
|
deployError.originalError = error;
|
|
deployError.stderr = cleanStderr;
|
|
deployError.stdout = cleanStdout;
|
|
return reject(deployError);
|
|
}
|
|
|
|
console.log('Game deployment completed successfully');
|
|
const cleanOutput = stdout.replace(/[\u2714\u2716\u2713\u2717\u26A0\uD83D[\uDC00-\uDFFF]]/g, '').trim();
|
|
if (cleanOutput) {
|
|
console.log(cleanOutput);
|
|
}
|
|
|
|
if (fs.existsSync(stagingDir)) {
|
|
try {
|
|
fs.rmSync(stagingDir, { recursive: true, force: true });
|
|
} catch (cleanupErr) {
|
|
console.warn('Failed to cleanup staging directory:', cleanupErr.message);
|
|
}
|
|
}
|
|
|
|
resolve();
|
|
});
|
|
|
|
child.on('error', (err) => {
|
|
console.error('Deployment process error:', err);
|
|
reject(new Error(`Failed to execute deployment tool: ${err.message}`));
|
|
});
|
|
});
|
|
}
|
|
|
|
async function performIntelligentUpdate(targetVersion, branch = 'release', progressCallback, gameDir = GAME_DIR, cacheDir = CACHE_DIR, toolsDir = TOOLS_DIR) {
|
|
console.log(`Initiating intelligent update to version ${targetVersion}`);
|
|
|
|
const currentVersion = getInstalledClientVersion();
|
|
console.log(`Current version: ${currentVersion || 'none (clean install)'}`);
|
|
console.log(`Target version: ${targetVersion}`);
|
|
console.log(`Branch: ${branch}`);
|
|
|
|
if (branch !== 'release') {
|
|
console.log(`Pre-release branch detected - forcing full archive download`);
|
|
const versionDetails = await extractVersionDetails(targetVersion, branch);
|
|
const archiveName = path.basename(versionDetails.fullUrl);
|
|
const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
|
|
|
|
if (progressCallback) {
|
|
progressCallback('Downloading full game archive (pre-release)...', 0, null, null, null);
|
|
}
|
|
|
|
await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
|
|
await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
|
|
saveVersionClient(targetVersion);
|
|
console.log(`Pre-release installation completed. Version ${targetVersion} is now installed.`);
|
|
return;
|
|
}
|
|
|
|
if (!currentVersion) {
|
|
console.log('No existing installation detected - downloading full archive');
|
|
const versionDetails = await extractVersionDetails(targetVersion, branch);
|
|
const archiveName = path.basename(versionDetails.fullUrl);
|
|
const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
|
|
|
|
if (progressCallback) {
|
|
progressCallback(`Downloading full game archive (first install - v${targetVersion})...`, 0, null, null, null);
|
|
}
|
|
|
|
await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
|
|
await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
|
|
saveVersionClient(targetVersion);
|
|
console.log(`Initial installation completed. Version ${targetVersion} is now installed.`);
|
|
return;
|
|
}
|
|
|
|
const patchesToApply = needsIntermediatePatches(currentVersion, targetVersion);
|
|
|
|
if (patchesToApply.length === 0) {
|
|
console.log('Already at target version or invalid version sequence');
|
|
return;
|
|
}
|
|
|
|
console.log(`Applying ${patchesToApply.length} differential patch(es): ${patchesToApply.join(' -> ')}`);
|
|
|
|
for (let i = 0; i < patchesToApply.length; i++) {
|
|
const patchVersion = patchesToApply[i];
|
|
const versionDetails = await extractVersionDetails(patchVersion, branch);
|
|
|
|
const canDifferential = canUseDifferentialUpdate(getInstalledClientVersion(), versionDetails);
|
|
|
|
if (!canDifferential || !versionDetails.differentialUrl) {
|
|
console.log(`WARNING: Differential patch not available for ${patchVersion}, using full archive`);
|
|
const archiveName = path.basename(versionDetails.fullUrl);
|
|
const archivePath = path.join(cacheDir, `${branch}_${archiveName}`);
|
|
|
|
if (progressCallback) {
|
|
progressCallback(`Downloading full archive for ${patchVersion} (${i + 1}/${patchesToApply.length})...`, 0, null, null, null);
|
|
}
|
|
|
|
await acquireGameArchive(versionDetails.fullUrl, archivePath, null, progressCallback);
|
|
await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, false);
|
|
} else {
|
|
console.log(`Applying differential patch: ${versionDetails.sourceVersion} -> ${patchVersion}`);
|
|
const archiveName = path.basename(versionDetails.differentialUrl);
|
|
const archivePath = path.join(cacheDir, `${branch}_patch_${archiveName}`);
|
|
|
|
if (progressCallback) {
|
|
progressCallback(`Applying patch ${i + 1}/${patchesToApply.length}: ${patchVersion}...`, 0, null, null, null);
|
|
}
|
|
|
|
await acquireGameArchive(versionDetails.differentialUrl, archivePath, versionDetails.checksum, progressCallback);
|
|
await deployGameArchive(archivePath, gameDir, toolsDir, progressCallback, true);
|
|
|
|
if (fs.existsSync(archivePath)) {
|
|
try {
|
|
fs.unlinkSync(archivePath);
|
|
console.log(`Cleaned up patch file: ${archiveName}`);
|
|
} catch (cleanupErr) {
|
|
console.warn(`Failed to cleanup patch file: ${cleanupErr.message}`);
|
|
}
|
|
}
|
|
}
|
|
|
|
saveVersionClient(patchVersion);
|
|
console.log(`Patch ${patchVersion} applied successfully (${i + 1}/${patchesToApply.length})`);
|
|
}
|
|
|
|
console.log(`Update completed successfully. Version ${targetVersion} is now installed.`);
|
|
}
|
|
|
|
async function ensureGameInstalled(targetVersion, branch = 'release', progressCallback, gameDir = GAME_DIR, cacheDir = CACHE_DIR, toolsDir = TOOLS_DIR) {
|
|
const { findClientPath } = require('../core/paths');
|
|
const clientPath = findClientPath(gameDir);
|
|
|
|
if (clientPath) {
|
|
const currentVersion = getInstalledClientVersion();
|
|
if (currentVersion === targetVersion) {
|
|
console.log(`Game already installed at correct version: ${targetVersion}`);
|
|
return;
|
|
}
|
|
}
|
|
|
|
await performIntelligentUpdate(targetVersion, branch, progressCallback, gameDir, cacheDir, toolsDir);
|
|
}
|
|
|
|
module.exports = {
|
|
acquireGameArchive,
|
|
deployGameArchive,
|
|
performIntelligentUpdate,
|
|
ensureGameInstalled
|
|
};
|