shironeko/Hytale-F2P-2
1
0
Fork 0
mirror of https://gitea.shironeko-all.duckdns.org/shironeko/Hytale-F2P-2.git synced 2026-02-26 10:41:46 -03:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'develop'

Browse Source
This commit is contained in:
Fazri Gading
2026-01-30 22:26:50 +08:00
parent 6bd63f5b60 3e1c4aef73
commit a6ecd2c167
43 changed files with 4458 additions and 2991 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
.github/ISSUE_TEMPLATE/support_request.yml vendored
View File

@@ -1,8 +1,22 @@
name: Support Request
description: Request help or support
title: "[SUPPORT] "
title: "[SUPPORT] <ADD YOUR TITLE HERE>"
labels: ["support"]
body:
- type: dropdown
id: acknowledge
attributes:
label: Checklist
options:
- label: I have read the README.md before asking Support Request.
required: true
- label: I have read the TROUBLESHOOTING.md before asking Support Request.
required: true
- label: I have added title before submitting this Support Request.
required: true
- label: I acknowledge that my Support Request will not be responded as quick as in Discord Open-A-Ticket, I prefer this way.
required: true
- type: markdown
attributes:
value: |
@@ -24,7 +38,7 @@ body:
attributes:
label: Context
description: Provide any relevant context or background information.
placeholder: "I've tried..., but got..."
placeholder: "I've tried these steps, but got..."
validations:
required: true
@@ -37,12 +51,17 @@ body:
validations:
required: true
- type: input
- type: dropdown
id: version
attributes:
label: Version
description: What version are you using?
placeholder: "e.g. v2.0.11 stable/pre-release"
options:
- v2.1.2
- v2.1.1
- v2.1.0
- v2.0.11
- v2.0.2
validations:
required: true
@@ -52,13 +71,12 @@ body:
label: Platform
description: What platform are you using?
options:
- Windows 10
- Windows 11
- macOS (Apple Silicon)
- macOS (Intel)
- Linux Ubuntu/Debian-based
- Linux Fedora/RHEL-based
- Linux Arch-based
- Windows 11 x64
- Windows 10 x64
- macOS ARM64 (Apple Silicon)
- Linux x64 Ubuntu/Debian-based
- Linux x64 Fedora/RHEL-based
- Linux x64 Arch-based
validations:
required: true

215
GUI/index.html
View File

@@ -35,6 +35,10 @@
<i class="fas fa-play"></i>
<span class="nav-tooltip" data-i18n="nav.play">Play</span>
</div>
<div class="nav-item" data-page="featured">
<i class="fas fa-server"></i>
<span class="nav-tooltip">Featured Servers</span>
</div>
<div class="nav-item" data-page="mods">
<i class="fas fa-box"></i>
<span class="nav-tooltip" data-i18n="nav.mods">Mods</span>
@@ -43,10 +47,6 @@
<i class="fas fa-newspaper"></i>
<span class="nav-tooltip" data-i18n="nav.news">News</span>
</div>
<div class="nav-item" data-page="chat">
<i class="fas fa-comments"></i>
<span class="nav-tooltip" data-i18n="nav.chat">Players Chat</span>
</div>
<div class="nav-item" data-page="settings">
<i class="fas fa-cog"></i>
<span class="nav-tooltip" data-i18n="nav.settings">Settings</span>
@@ -55,6 +55,10 @@
<i class="fas fa-terminal"></i>
<span class="nav-tooltip">Logs</span>
</div>
<div class="nav-item" onclick="openDiscordExternal()">
<i class="fab fa-discord"></i>
<span class="nav-tooltip">Discord</span>
</div>
</div>
@@ -112,7 +116,7 @@
<h1 class="install-title">
HY<span class="title-accent">TALE</span>
</h1>
<p class="install-subtitle" data-i18n="install.title">FREE TO PLAY LAUNCHER</p>
<p class="install-subtitle" data-i18n="install.title">UNOFFICIAL HYTALE LAUNCHER</p>
</div>
<div class="install-form">
@@ -120,7 +124,7 @@
<label class="form-label" data-i18n="install.playerName">Player Name</label>
<input type="text" id="installPlayerName"
data-i18n-placeholder="install.playerNamePlaceholder" class="form-input"
value="Player" />
value="Player" maxlength="16" />
</div>
<div class="form-group">
@@ -212,6 +216,40 @@
</div>
</div>
<div id="featured-page" class="page">
<div class="featured-layout">
<div class="featured-left">
<div class="featured-header">
<h2 class="featured-title">
<i class="fas fa-star mr-2"></i>
<span>FEATURED SERVERS</span>
</h2>
</div>
<div id="featuredServersList" class="featured-list">
<div class="loading-spinner">
<i class="fas fa-spinner fa-spin fa-2x"></i>
<p>Loading...</p>
</div>
</div>
</div>
<div class="featured-right">
<div class="featured-header">
<h2 class="featured-title">
<i class="fas fa-server mr-2"></i>
<span>HF2P SERVERS</span>
</h2>
</div>
<div id="myServersList" class="featured-list">
<div class="loading-spinner">
<i class="fas fa-spinner fa-spin fa-2x"></i>
<p>Loading...</p>
</div>
</div>
</div>
</div>
</div>
<div id="mods-page" class="page">
<div class="mods-header">
<div class="mods-search-container">
@@ -256,50 +294,6 @@
<div id="allNewsGrid" class="news-grid-full"></div>
</div>
<div id="chat-page" class="page">
<div class="chat-container">
<div class="chat-header">
<h2 class="chat-title">
<i class="fas fa-comments mr-2"></i>
<span data-i18n="chat.title">PLAYERS CHAT</span>
</h2>
<div class="chat-header-actions">
<button id="chatColorBtn" class="chat-color-btn">
<i class="fas fa-palette"></i>
<span data-i18n="chat.pickColor">Color</span>
</button>
<div class="chat-online-badge">
<i class="fas fa-circle"></i>
<span id="chatOnlineCount">0</span> <span data-i18n="chat.online">online</span>
</div>
</div>
</div>
<div class="chat-body">
<div id="chatMessages" class="chat-messages">
</div>
</div>
<div class="chat-footer">
<div class="chat-input-container">
<textarea id="chatInput" class="chat-input"
data-i18n-placeholder="chat.inputPlaceholder" rows="1"
maxlength="500"></textarea>
<button id="chatSendBtn" class="chat-send-btn">
<i class="fas fa-paper-plane"></i>
</button>
</div>
<div class="chat-footer-info">
<span class="chat-char-counter" id="chatCharCounter">0/500</span>
<span class="chat-warning-text">
<i class="fas fa-shield-alt"></i>
<span data-i18n="chat.secureChat">Secure chat - Links are censored</span>
</span>
</div>
</div>
</div>
</div>
<div id="settings-page" class="page">
<div class="settings-container">
<div class="settings-header">
@@ -659,41 +653,6 @@
</div>
</div>
<div id="chatUsernameModal" class="chat-username-modal" style="display: none;">
<div class="chat-username-modal-content">
<div class="chat-username-modal-header">
<h2 class="chat-username-modal-title">
<i class="fas fa-comments mr-2"></i>
<span data-i18n="chat.joinChat">Join Chat</span>
</h2>
</div>
<div class="chat-username-modal-body">
<p class="chat-username-modal-description" data-i18n="chat.chooseUsername">
Choose a username to join the Players Chat
</p>
<div class="chat-username-input-group">
<label for="chatUsernameInput" class="chat-username-label"
data-i18n="chat.username">Username</label>
<input type="text" id="chatUsernameInput" class="chat-username-input"
data-i18n-placeholder="chat.usernamePlaceholder" maxlength="20" autocomplete="off" />
<span class="chat-username-hint" data-i18n="chat.usernameHint">3-20 characters, letters, numbers, -
and _ only</span>
<span id="chatUsernameError" class="chat-username-error"></span>
</div>
</div>
<div class="chat-username-modal-footer">
<button id="chatUsernameCancel" class="chat-username-btn-cancel">
<i class="fas fa-times"></i>
<span data-i18n="common.cancel">Cancel</span>
</button>
<button id="chatUsernameSubmit" class="chat-username-btn-submit">
<i class="fas fa-check"></i>
<span data-i18n="chat.joinButton">Join Chat</span>
</button>
</div>
</div>
</div>
<!-- UUID Management Modal -->
<div id="uuidModal" class="uuid-modal" style="display: none;">
<div class="uuid-modal-content">
@@ -818,71 +777,47 @@
</div>
</footer>
<script type="module" src="js/script.js"></script> <!-- Discord Notification -->
<div id="discordNotification" class="discord-notification">
<div class="notification-content">
<i class="fab fa-discord"></i>
<span class="notification-text" data-i18n="discord.notificationText">Join our Discord community!</span>
<button class="notification-action"
onclick="window.electronAPI?.openExternal('https://discord.gg/n6HZ7NwSQd')">
<span data-i18n="discord.joinButton">Join Discord</span>
</button>
</div>
<button class="notification-close" onclick="closeDiscordNotification()">
<i class="fas fa-times"></i>
</button>
</div>
<script type="module" src="js/script.js"></script>
<!-- Modal pour sélectionner la couleur du chat -->
<div id="chatColorModal" class="chat-color-modal" style="display: none;">
<div class="chat-color-modal-content">
<div class="chat-color-modal-header">
<h3 class="chat-color-modal-title">
<i class="fas fa-palette"></i>
<span data-i18n="chat.colorModal.title">Customize Username Color</span>
</h3>
<button class="modal-close-btn" onclick="closeChatColorModal()">
<i class="fas fa-times"></i>
</button>
</div>
<div class="chat-color-modal-body">
<div id="solidColorSection" class="color-section">
<h4 data-i18n="chat.colorModal.chooseSolid">Choose a solid color:</h4>
<div class="predefined-colors">
<div class="color-option" data-color="#3498db" style="background: #3498db;"></div>
<div class="color-option" data-color="#e74c3c" style="background: #e74c3c;"></div>
<div class="color-option" data-color="#2ecc71" style="background: #2ecc71;"></div>
<div class="color-option" data-color="#f39c12" style="background: #f39c12;"></div>
<div class="color-option" data-color="#9b59b6" style="background: #9b59b6;"></div>
<div class="color-option" data-color="#1abc9c" style="background: #1abc9c;"></div>
<div class="color-option" data-color="#e91e63" style="background: #e91e63;"></div>
<div class="color-option" data-color="#ff5722" style="background: #ff5722;"></div>
</div>
<div class="custom-color-input">
<label for="customColor" data-i18n="chat.colorModal.customColor">Custom color:</label>
<input type="color" id="customColor" value="#3498db">
</div>
</div>
<div class="color-preview">
<h4 data-i18n="chat.colorModal.preview">Preview:</h4>
<div id="colorPreview" class="preview-username" data-i18n="chat.colorModal.previewUsername">
YourUsername</div>
<div id="discordPopupModal" class="modal-overlay" style="display: none;">
<div class="modal-content discord-popup-modal">
<div class="modal-header">
<div class="discord-popup-header">
<i class="fab fa-discord"></i>
<h2 class="modal-title">Join Our Discord Community</h2>
</div>
</div>
<div class="chat-color-modal-footer">
<button class="btn-secondary" onclick="closeChatColorModal()"><span
data-i18n="common.cancel">Cancel</span></button>
<button class="btn-primary" onclick="applyChatColor()"><span data-i18n="chat.colorModal.apply">Apply
Color</span></button>
<div class="modal-body">
<div class="discord-popup-body">
<p class="discord-popup-text">
Join our community of over <strong>5000 members</strong> and stay connected!
</p>
<p class="discord-popup-text">
Get the latest news, updates, and announcements about the launcher.
</p>
<p class="discord-popup-text">
Find help, report bugs, share your feedback, and connect with other players.
</p>
<div class="discord-popup-actions">
<button class="discord-popup-btn primary" onclick="joinDiscord()">
<i class="fab fa-discord"></i>
Join Discord
</button>
<button class="discord-popup-btn secondary" onclick="closeDiscordPopup()">
Maybe Later
</button>
</div>
</div>
</div>
</div>
</div>
<script src="js/i18n.js"></script>
<script src="js/featured.js"></script>
<script type="module" src="js/settings.js"></script>
<script type="module" src="js/update.js"></script>
<script src="js/updater.js"></script>
<!-- updater.js disabled - using update.js instead which has skip button and macOS handling -->
</body>

500
GUI/js/chat.js
View File

@@ -1,500 +0,0 @@
let socket = null;
let isAuthenticated = false;
let messageQueue = [];
let chatUsername = '';
let userColor = '#3498db';
let userBadge = null;
const SOCKET_URL = 'https://chat.hytalef2p.com';
const MAX_MESSAGE_LENGTH = 500;
async function getOrCreatePlayerId() {
return `user_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
}
export async function initChat() {
if (window.electronAPI?.loadChatUsername) {
chatUsername = await window.electronAPI.loadChatUsername();
}
if (window.electronAPI?.loadChatColor) {
const savedColor = await window.electronAPI.loadChatColor();
if (savedColor) {
userColor = savedColor;
}
}
if (!chatUsername || chatUsername.trim() === '') {
showUsernameModal();
return;
}
setupChatUI();
setupColorSelector();
await connectToChat();
}
function showUsernameModal() {
const modal = document.getElementById('chatUsernameModal');
if (modal) {
modal.style.display = 'flex';
const input = document.getElementById('chatUsernameInput');
if (input) {
setTimeout(() => input.focus(), 100);
}
}
}
function hideUsernameModal() {
const modal = document.getElementById('chatUsernameModal');
if (modal) {
modal.style.display = 'none';
}
}
async function submitChatUsername() {
const input = document.getElementById('chatUsernameInput');
const errorMsg = document.getElementById('chatUsernameError');
if (!input) return;
const username = input.value.trim();
if (username.length === 0) {
if (errorMsg) errorMsg.textContent = 'Username cannot be empty';
return;
}
if (username.length < 3) {
if (errorMsg) errorMsg.textContent = 'Username must be at least 3 characters';
return;
}
if (username.length > 20) {
if (errorMsg) errorMsg.textContent = 'Username must be 20 characters or less';
return;
}
if (!/^[a-zA-Z0-9_-]+$/.test(username)) {
if (errorMsg) errorMsg.textContent = 'Username can only contain letters, numbers, - and _';
return;
}
chatUsername = username;
if (window.electronAPI?.saveChatUsername) {
await window.electronAPI.saveChatUsername(username);
}
hideUsernameModal();
setupChatUI();
await connectToChat();
}
function setupChatUI() {
const sendBtn = document.getElementById('chatSendBtn');
const chatInput = document.getElementById('chatInput');
const chatMessages = document.getElementById('chatMessages');
if (!sendBtn || !chatInput || !chatMessages) {
console.warn('Chat UI elements not found');
return;
}
sendBtn.addEventListener('click', () => {
sendMessage();
});
chatInput.addEventListener('keypress', (e) => {
if (e.key === 'Enter' && !e.shiftKey) {
e.preventDefault();
sendMessage();
}
});
chatInput.addEventListener('input', () => {
if (chatInput.value.length > MAX_MESSAGE_LENGTH) {
chatInput.value = chatInput.value.substring(0, MAX_MESSAGE_LENGTH);
}
updateCharCounter();
});
updateCharCounter();
}
async function connectToChat() {
try {
if (!window.io) {
await loadSocketIO();
}
const userId = await window.electronAPI?.getUserId();
if (!userId) {
console.error('User ID not available');
addSystemMessage('Error: Could not connect to chat');
return;
}
if (!chatUsername || chatUsername.trim() === '') {
console.error('Chat username not set');
addSystemMessage('Error: Username not set');
return;
}
socket = io(SOCKET_URL, {
transports: ['websocket', 'polling'],
reconnection: true,
reconnectionAttempts: 5,
reconnectionDelay: 1000
});
socket.on('connect', async () => {
console.log('Connected to chat server');
const uuid = await window.electronAPI?.getCurrentUuid();
socket.emit('authenticate', {
username: chatUsername,
userId,
uuid: uuid,
userColor: userColor
});
});
socket.on('authenticated', (data) => {
isAuthenticated = true;
userBadge = data.badge;
addSystemMessage(`Connected as ${data.username}`);
while (messageQueue.length > 0) {
const msg = messageQueue.shift();
socket.emit('send_message', { message: msg });
}
});
socket.on('message', (data) => {
if (data.type === 'system') {
addSystemMessage(data.message);
} else if (data.type === 'user') {
addUserMessage(data.username, data.message, data.timestamp, data.userColor, data.badge);
}
});
socket.on('users_update', (data) => {
updateOnlineCount(data.count);
});
socket.on('error', (data) => {
addSystemMessage(`Error: ${data.message}`, 'error');
});
socket.on('clear_chat', (data) => {
clearAllMessages();
addSystemMessage(data.message || 'Chat cleared by server', 'warning');
});
socket.on('disconnect', () => {
isAuthenticated = false;
console.log('Disconnected from chat server');
addSystemMessage('Disconnected from chat', 'error');
});
socket.on('connect_error', (error) => {
console.error('Connection error:', error);
addSystemMessage('Connection error. Retrying...', 'error');
});
} catch (error) {
console.error('Error connecting to chat:', error);
addSystemMessage('Failed to connect to chat server', 'error');
}
}
function loadSocketIO() {
return new Promise((resolve, reject) => {
const script = document.createElement('script');
script.src = 'https://cdn.socket.io/4.6.1/socket.io.min.js';
script.onload = resolve;
script.onerror = reject;
document.head.appendChild(script);
});
}
function sendMessage() {
const chatInput = document.getElementById('chatInput');
const message = chatInput.value.trim();
if (!message || message.length === 0) {
return;
}
if (message.length > MAX_MESSAGE_LENGTH) {
addSystemMessage(`Message too long (max ${MAX_MESSAGE_LENGTH} characters)`, 'error');
return;
}
if (!socket || !isAuthenticated) {
messageQueue.push(message);
addSystemMessage('Connecting... Your message will be sent soon.', 'warning');
chatInput.value = '';
updateCharCounter();
return;
}
socket.emit('send_message', { message });
chatInput.value = '';
updateCharCounter();
}
function addUserMessage(username, message, timestamp, userColor = '#3498db', badge = null) {
const chatMessages = document.getElementById('chatMessages');
if (!chatMessages) return;
const messageDiv = document.createElement('div');
messageDiv.className = 'chat-message user-message';
const time = new Date(timestamp).toLocaleTimeString('en-US', {
hour: '2-digit',
minute: '2-digit'
});
let badgeHTML = '';
if (badge) {
let badgeStyle = '';
if (badge.style === 'rainbow') {
badgeStyle = `background: linear-gradient(45deg, #ff6b6b, #4ecdc4, #45b7d1, #96ceb4, #ffeaa7, #fab1a0, #fd79a8); background-size: 400% 400%; animation: rainbow 3s ease infinite; -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text; font-weight: bold; display: inline;`;
} else if (badge.style === 'gradient') {
if (badge.badge === 'CONTRIBUTOR') {
badgeStyle = `background: linear-gradient(45deg, #22c55e, #16a34a); background-size: 200% 200%; animation: contributorGlow 2s ease infinite; -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text; font-weight: bold; display: inline;`;
} else {
badgeStyle = `color: ${badge.color}; font-weight: bold; display: inline;`;
}
}
badgeHTML = `<span class="user-badge" style="${badgeStyle}">[${badge.badge}]</span> `;
}
messageDiv.innerHTML = `
<div class="message-header">
<span class="message-user-info">${badgeHTML}<span class="message-username" style="font-weight: bold;" data-username-color="${userColor}">${escapeHtml(username)}</span></span>
<span class="message-time">${time}</span>
</div>
<div class="message-content">${message}</div>
`;
const usernameElement = messageDiv.querySelector('.message-username');
if (usernameElement) {
applyUserColorStyle(usernameElement, userColor);
}
chatMessages.appendChild(messageDiv);
scrollToBottom();
}
function addSystemMessage(message, type = 'info') {
const chatMessages = document.getElementById('chatMessages');
if (!chatMessages) return;
const messageDiv = document.createElement('div');
messageDiv.className = `chat-message system-message system-${type}`;
messageDiv.innerHTML = `
<div class="message-content">
<i class="fas fa-info-circle"></i> ${escapeHtml(message)}
</div>
`;
chatMessages.appendChild(messageDiv);
scrollToBottom();
}
function updateOnlineCount(count) {
const onlineCountElement = document.getElementById('chatOnlineCount');
if (onlineCountElement) {
onlineCountElement.textContent = count;
}
}
function updateCharCounter() {
const chatInput = document.getElementById('chatInput');
const charCounter = document.getElementById('chatCharCounter');
if (chatInput && charCounter) {
const length = chatInput.value.length;
charCounter.textContent = `${length}/${MAX_MESSAGE_LENGTH}`;
if (length > MAX_MESSAGE_LENGTH * 0.9) {
charCounter.classList.add('warning');
} else {
charCounter.classList.remove('warning');
}
}
}
function scrollToBottom() {
const chatMessages = document.getElementById('chatMessages');
if (chatMessages) {
chatMessages.scrollTop = chatMessages.scrollHeight;
}
}
function clearAllMessages() {
const chatMessages = document.getElementById('chatMessages');
if (chatMessages) {
chatMessages.innerHTML = '';
console.log('Chat cleared');
}
}
function escapeHtml(text) {
const div = document.createElement('div');
div.textContent = text;
return div.innerHTML;
}
window.addEventListener('beforeunload', () => {
if (socket && socket.connected) {
socket.disconnect();
}
});
document.addEventListener('DOMContentLoaded', () => {
const usernameSubmitBtn = document.getElementById('chatUsernameSubmit');
const usernameCancelBtn = document.getElementById('chatUsernameCancel');
const usernameInput = document.getElementById('chatUsernameInput');
if (usernameSubmitBtn) {
usernameSubmitBtn.addEventListener('click', submitChatUsername);
}
if (usernameCancelBtn) {
usernameCancelBtn.addEventListener('click', () => {
hideUsernameModal();
const playNavItem = document.querySelector('[data-page="play"]');
if (playNavItem) playNavItem.click();
});
}
if (usernameInput) {
usernameInput.addEventListener('keypress', (e) => {
if (e.key === 'Enter') {
e.preventDefault();
submitChatUsername();
}
});
}
const chatNavItem = document.querySelector('[data-page="chat"]');
if (chatNavItem) {
chatNavItem.addEventListener('click', () => {
if (!socket) {
initChat();
}
});
}
});
function setupColorSelector() {
const colorBtn = document.getElementById('chatColorBtn');
if (colorBtn) {
colorBtn.addEventListener('click', showChatColorModal);
}
const colorOptions = document.querySelectorAll('.color-option');
colorOptions.forEach(option => {
option.addEventListener('click', () => {
document.querySelectorAll('.color-option').forEach(o => o.classList.remove('selected'));
option.classList.add('selected');
updateColorPreview();
});
});
const customColor = document.getElementById('customColor');
if (customColor) {
customColor.addEventListener('input', () => {
document.querySelectorAll('.color-option').forEach(o => o.classList.remove('selected'));
updateColorPreview();
});
}
}
function showChatColorModal() {
const modal = document.getElementById('chatColorModal');
if (modal) {
modal.style.display = 'flex';
updateColorPreview();
}
}
window.closeChatColorModal = function() {
const modal = document.getElementById('chatColorModal');
if (modal) {
modal.style.display = 'none';
}
}
function updateColorPreview() {
const preview = document.getElementById('colorPreview');
if (!preview) return;
const selectedOption = document.querySelector('.color-option.selected');
let color = '#3498db';
if (selectedOption) {
color = selectedOption.dataset.color;
} else {
const customColor = document.getElementById('customColor');
if (customColor) color = customColor.value;
}
preview.style.color = color;
preview.style.background = 'transparent';
preview.style.webkitBackgroundClip = 'initial';
preview.style.webkitTextFillColor = 'initial';
}
window.applyChatColor = async function() {
let newColor;
const selectedOption = document.querySelector('.color-option.selected');
if (selectedOption) {
newColor = selectedOption.dataset.color;
} else {
const customColor = document.getElementById('customColor');
newColor = customColor ? customColor.value : '#3498db';
}
userColor = newColor;
if (window.electronAPI?.saveChatColor) {
await window.electronAPI.saveChatColor(newColor);
}
if (socket && isAuthenticated) {
const uuid = await window.electronAPI?.getCurrentUuid();
socket.emit('authenticate', {
username: chatUsername,
userId: await getOrCreatePlayerId(),
uuid: uuid,
userColor: userColor
});
addSystemMessage('Username color updated successfully', 'success');
}
closeChatColorModal();
}
function applyUserColorStyle(element, color) {
element.style.color = color;
element.style.background = 'transparent';
element.style.webkitBackgroundClip = 'initial';
element.style.webkitTextFillColor = 'initial';
}
window.ChatAPI = {
send: sendMessage,
disconnect: () => socket?.disconnect()
};

176
GUI/js/featured.js Normal file
View File

@@ -0,0 +1,176 @@
// Featured Servers Management
const FEATURED_SERVERS_API = 'https://assets.authbp.xyz/featured.json';
/**
* Safely escape HTML while preserving UTF-8 characters
*/
function escapeHtml(text) {
const div = document.createElement('div');
div.textContent = text;
return div.innerHTML;
}
/**
* Load and display featured servers
*/
async function loadFeaturedServers() {
const featuredContainer = document.getElementById('featuredServersList');
const myServersContainer = document.getElementById('myServersList');
try {
console.log('[FeaturedServers] Fetching from', FEATURED_SERVERS_API);
// Fetch featured servers from API (no cache)
const response = await fetch(FEATURED_SERVERS_API, {
cache: 'no-store',
headers: {
'Cache-Control': 'no-cache',
'Pragma': 'no-cache',
'Accept-Charset': 'utf-8'
}
});
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const text = await response.text();
const data = JSON.parse(text);
const featuredServers = data.featuredServers || [];
console.log('[FeaturedServers] Loaded', featuredServers.length, 'featured servers');
// Render featured servers
if (featuredServers.length === 0) {
featuredContainer.innerHTML = `
<div class="loading-spinner">
<i class="fas fa-info-circle fa-2x"></i>
<p>No featured servers</p>
</div>
`;
} else {
const featuredHTML = featuredServers.map((server, index) => {
console.log(`[FeaturedServers] Building featured card ${index + 1}:`, server.Name);
const escapedName = escapeHtml(server.Name || 'Unknown Server');
const escapedAddress = escapeHtml(server.Address || '');
const bannerUrl = server.img_Banner || 'https://via.placeholder.com/400x240/1e293b/ffffff?text=Server+Banner';
return `
<div class="featured-server-card">
<img
src="${bannerUrl}"
alt="${escapedName}"
class="featured-server-banner"
onerror="this.src='https://via.placeholder.com/400x240/1e293b/ffffff?text=Server'"
/>
<div class="featured-server-content">
<h3 class="featured-server-name">${escapedName}</h3>
<div class="featured-server-address">
<span class="server-address-text">${escapedAddress}</span>
<button class="copy-address-btn" onclick="copyServerAddress('${escapedAddress}', this)">
<i class="fas fa-copy"></i>
<span>Copy</span>
</button>
</div>
</div>
</div>
`;
}).join('');
featuredContainer.innerHTML = featuredHTML;
}
// Show "Coming Soon" for my servers
myServersContainer.innerHTML = `
<div style="display: flex; align-items: center; justify-content: center; height: 100%; color: #94a3b8; font-size: 1.2rem;">
<p>Coming Soon</p>
</div>
`;
} catch (error) {
console.error('[FeaturedServers] Error loading servers:', error);
featuredContainer.innerHTML = `
<div class="loading-spinner">
<i class="fas fa-exclamation-triangle fa-2x" style="color: #ef4444;"></i>
<p>Failed to load servers</p>
<p style="font-size: 0.9rem; color: #64748b;">${error.message}</p>
</div>
`;
myServersContainer.innerHTML = `
<div style="display: flex; align-items: center; justify-content: center; height: 100%; color: #94a3b8; font-size: 1.2rem;">
<p>Coming Soon</p>
</div>
`;
}
}
/**
* Copy server address to clipboard
*/
async function copyServerAddress(address, button) {
try {
await navigator.clipboard.writeText(address);
// Visual feedback
const originalHTML = button.innerHTML;
button.classList.add('copied');
button.innerHTML = '<i class="fas fa-check"></i><span>Copied!</span>';
setTimeout(() => {
button.classList.remove('copied');
button.innerHTML = originalHTML;
}, 2000);
console.log('[FeaturedServers] Copied address:', address);
} catch (error) {
console.error('[FeaturedServers] Failed to copy address:', error);
// Fallback for older browsers
const textArea = document.createElement('textarea');
textArea.value = address;
textArea.style.position = 'fixed';
textArea.style.left = '-999999px';
document.body.appendChild(textArea);
textArea.select();
try {
document.execCommand('copy');
const originalHTML = button.innerHTML;
button.classList.add('copied');
button.innerHTML = '<i class="fas fa-check"></i><span>Copied!</span>';
setTimeout(() => {
button.classList.remove('copied');
button.innerHTML = originalHTML;
}, 2000);
} catch (err) {
console.error('[FeaturedServers] Fallback copy also failed:', err);
}
document.body.removeChild(textArea);
}
}
// Load featured servers when the featured page becomes visible
document.addEventListener('DOMContentLoaded', () => {
const observer = new MutationObserver((mutations) => {
mutations.forEach((mutation) => {
if (mutation.type === 'attributes' && mutation.attributeName === 'class') {
const featuredPage = document.getElementById('featured-page');
if (featuredPage && featuredPage.classList.contains('active')) {
loadFeaturedServers();
}
}
});
});
const featuredPage = document.getElementById('featured-page');
if (featuredPage) {
observer.observe(featuredPage, { attributes: true });
// Load immediately if already visible
if (featuredPage.classList.contains('active')) {
loadFeaturedServers();
}
}
});

10
GUI/js/i18n.js
View File

@@ -4,10 +4,14 @@ const i18n = (() => {
let translations = {};
const availableLanguages = [
{ code: 'en', name: 'English' },
{ code: 'es-ES', name: 'Español (España)' },
{ code: 'de-DE', name: 'German (Germany)' },
{ code: 'es-ES', name: 'Spanish (Spain)' },
{ code: 'fr-FR', name: 'French (France)' },
{ code: 'pl-PL', name: 'Polish (Poland)' },
{ code: 'pt-BR', name: 'Portuguese (Brazil)' },
{ code: 'tr-TR', name: 'Turkish (Turkey)' },
{ code: 'pl-PL', name: 'Polish (Poland)' }
{ code: 'ru-RU', name: 'Russian (Russia)' },
{ code: 'sv-SE', name: 'Swedish (Sweden)' },
{ code: 'tr-TR', name: 'Turkish (Turkey)' }
];
// Load single language file

33
GUI/js/install.js
View File

@@ -45,9 +45,17 @@ export function setupInstallation() {
export async function installGame() {
if (isDownloading || (installBtn && installBtn.disabled)) return;
const playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
let playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
const installPath = installPathInput ? installPathInput.value.trim() : '';
// Limit player name to 16 characters
if (playerName.length > 16) {
playerName = playerName.substring(0, 16);
if (installPlayerName) {
installPlayerName.value = playerName;
}
}
const selectedBranchRadio = document.querySelector('input[name="installBranch"]:checked');
const selectedBranch = selectedBranchRadio ? selectedBranchRadio.value : 'release';
@@ -72,8 +80,11 @@ export async function installGame() {
setTimeout(() => {
window.LauncherUI.hideProgress();
window.LauncherUI.showLauncherOrInstall(true);
// Sync player name to both launcher and settings inputs
const playerNameInput = document.getElementById('playerName');
if (playerNameInput) playerNameInput.value = playerName;
const settingsPlayerName = document.getElementById('settingsPlayerName');
if (settingsPlayerName) settingsPlayerName.value = playerName;
resetInstallButton();
}, 2000);
}
@@ -125,8 +136,11 @@ function simulateInstallation(playerName) {
setTimeout(() => {
window.LauncherUI.hideProgress();
window.LauncherUI.showLauncherOrInstall(true);
// Sync player name to both launcher and settings inputs
const playerNameInput = document.getElementById('playerName');
if (playerNameInput) playerNameInput.value = playerName;
const settingsPlayerName = document.getElementById('settingsPlayerName');
if (settingsPlayerName) settingsPlayerName.value = playerName;
resetInstallButton();
}, 2000);
}
@@ -188,7 +202,16 @@ export async function browseInstallPath() {
async function savePlayerName() {
try {
if (window.electronAPI && window.electronAPI.saveSettings) {
const playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
let playerName = (installPlayerName ? installPlayerName.value.trim() : '') || 'Player';
// Limit player name to 16 characters
if (playerName.length > 16) {
playerName = playerName.substring(0, 16);
if (installPlayerName) {
installPlayerName.value = playerName;
}
}
await window.electronAPI.saveSettings({ playerName });
}
} catch (error) {
@@ -246,9 +269,3 @@ document.addEventListener('DOMContentLoaded', async () => {
setupInstallation();
await checkGameStatusAndShowInterface();
});
window.browseInstallPath = browseInstallPath;
document.addEventListener('DOMContentLoaded', async () => {
setupInstallation();
await checkGameStatusAndShowInterface();
});

76
GUI/js/script.js
View File

@@ -4,23 +4,66 @@ import './launcher.js';
import './news.js';
import './mods.js';
import './players.js';
import './chat.js';
import './settings.js';
import './logs.js';
// Initialize i18n immediately (before DOMContentLoaded)
let i18nInitialized = false;
(async () => {
const savedLang = await window.electronAPI?.loadLanguage();
await i18n.init(savedLang);
i18nInitialized = true;
// Update language selector if DOM is already loaded
if (document.readyState === 'complete' || document.readyState === 'interactive') {
updateLanguageSelector();
}
})();
async function checkDiscordPopup() {
try {
const config = await window.electronAPI?.loadConfig();
if (!config || config.discordPopup === undefined || config.discordPopup === false) {
const modal = document.getElementById('discordPopupModal');
if (modal) {
const buttons = modal.querySelectorAll('.discord-popup-btn');
buttons.forEach(btn => btn.disabled = true);
setTimeout(() => {
modal.style.display = 'flex';
modal.classList.add('active');
setTimeout(() => {
buttons.forEach(btn => btn.disabled = false);
}, 2000);
}, 1000);
}
}
} catch (error) {
console.error('Failed to check Discord popup:', error);
}
}
window.closeDiscordPopup = function() {
const modal = document.getElementById('discordPopupModal');
if (modal) {
modal.classList.remove('active');
setTimeout(() => {
modal.style.display = 'none';
}, 300);
}
};
window.joinDiscord = async function() {
await window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
try {
await window.electronAPI?.saveConfig({ discordPopup: true });
} catch (error) {
console.error('Failed to save Discord popup state:', error);
}
closeDiscordPopup();
};
function updateLanguageSelector() {
const langSelect = document.getElementById('languageSelect');
if (langSelect) {
@@ -51,32 +94,9 @@ function updateLanguageSelector() {
}
document.addEventListener('DOMContentLoaded', () => {
// Populate language selector (wait for i18n if needed)
if (i18nInitialized) {
updateLanguageSelector();
}
// Discord notification
const notification = document.getElementById('discordNotification');
if (notification) {
const dismissed = localStorage.getItem('discordNotificationDismissed');
if (!dismissed) {
setTimeout(() => {
notification.style.display = 'flex';
}, 3000);
} else {
notification.style.display = 'none';
}
}
});
window.closeDiscordNotification = function() {
const notification = document.getElementById('discordNotification');
if (notification) {
notification.classList.add('hidden');
setTimeout(() => {
notification.style.display = 'none';
}, 300);
}
localStorage.setItem('discordNotificationDismissed', 'true');
};
checkDiscordPopup();
});

7
GUI/js/settings.js
View File

@@ -439,6 +439,13 @@ async function savePlayerName() {
return;
}
if (playerName.length > 16) {
const msg = window.i18n ? window.i18n.t('notifications.playerNameTooLong') : 'Player name must be 16 characters or less';
showNotification(msg, 'error');
settingsPlayerName.value = playerName.substring(0, 16);
return;
}
await window.electronAPI.saveUsername(playerName);
const successMsg = window.i18n ? window.i18n.t('notifications.playerNameSaved') : 'Player name saved successfully';
showNotification(successMsg, 'success');

17
GUI/js/ui.js
View File

@@ -63,8 +63,10 @@ function handleNavigation() {
navItems.forEach(item => {
item.addEventListener('click', () => {
const page = item.getAttribute('data-page');
showPage(`${page}-page`);
setActiveNav(page);
if (page) {
showPage(`${page}-page`);
setActiveNav(page);
}
});
});
}
@@ -843,7 +845,7 @@ function getErrorMessage(technicalMessage, errorType) {
case 'stall':
return 'Download stalled due to slow connection. Please retry.';
case 'file':
return 'Unable to save file. Check disk space and permissions. Please retry.';
return 'Unable to save file. Check permissions. Please retry.';
case 'permission':
return 'Permission denied. Check if launcher has write access. Please retry.';
case 'server':
@@ -972,7 +974,7 @@ function setupRetryButton() {
if (!currentDownloadState.retryData || currentDownloadState.errorType === 'jre') {
currentDownloadState.retryData = {
branch: 'release',
fileName: '4.pwr'
fileName: '7.pwr'
};
console.log('[UI] Created default PWR retry data:', currentDownloadState.retryData);
}
@@ -1040,7 +1042,7 @@ function setupRetryButton() {
} else {
currentDownloadState.retryData = {
branch: 'release',
fileName: '4.pwr'
fileName: '7.pwr'
};
}
console.log('[UI] Created default retry data:', currentDownloadState.retryData);
@@ -1100,7 +1102,10 @@ function getRetryContextMessage() {
}
}
// Make toggleMaximize globally available
window.openDiscordExternal = function() {
window.electronAPI?.openExternal('https://discord.gg/hf2pdc');
};
window.toggleMaximize = toggleMaximize;
document.addEventListener('DOMContentLoaded', setupUI);

216
GUI/js/update.js
View File

@@ -6,12 +6,12 @@ class ClientUpdateManager {
}
init() {
window.electronAPI.onUpdatePopup((updateInfo) => {
this.showUpdatePopup(updateInfo);
});
console.log('🔧 ClientUpdateManager initializing...');
// Listen for electron-updater events
// Listen for electron-updater events from main.js
// This is the primary update trigger - main.js checks for updates on startup
window.electronAPI.onUpdateAvailable((updateInfo) => {
console.log('📥 update-available event received:', updateInfo);
this.showUpdatePopup(updateInfo);
});
@@ -20,18 +20,30 @@ class ClientUpdateManager {
});
window.electronAPI.onUpdateDownloaded((updateInfo) => {
console.log('📦 update-downloaded event received:', updateInfo);
this.showUpdateDownloaded(updateInfo);
});
window.electronAPI.onUpdateError((errorInfo) => {
console.log('❌ update-error event received:', errorInfo);
this.handleUpdateError(errorInfo);
});
this.checkForUpdatesOnDemand();
console.log('✅ ClientUpdateManager initialized');
// Note: Don't call checkForUpdatesOnDemand() here - main.js already checks
// for updates after 3 seconds and sends 'update-available' event.
// Calling it here would cause duplicate popups.
}
showUpdatePopup(updateInfo) {
if (this.updatePopupVisible) return;
console.log('🔔 showUpdatePopup called, updatePopupVisible:', this.updatePopupVisible);
// Check if popup already exists in DOM (extra safety)
if (this.updatePopupVisible || document.getElementById('update-popup-overlay')) {
console.log('⚠️ Update popup already visible, skipping');
return;
}
this.updatePopupVisible = true;
@@ -92,7 +104,10 @@ class ClientUpdateManager {
</div>
<div class="update-popup-footer">
This popup cannot be closed until you update the launcher
<span id="update-footer-text">Downloading update...</span>
<button id="update-skip-btn" class="update-skip-btn" style="display: none; margin-top: 0.5rem; background: transparent; border: 1px solid rgba(255,255,255,0.2); color: #9ca3af; padding: 0.5rem 1rem; border-radius: 0.25rem; cursor: pointer; font-size: 0.75rem;">
Skip for now (not recommended)
</button>
</div>
</div>
</div>
@@ -113,16 +128,43 @@ class ClientUpdateManager {
installBtn.addEventListener('click', async (e) => {
e.preventDefault();
e.stopPropagation();
installBtn.disabled = true;
installBtn.innerHTML = '<i class="fas fa-spinner fa-spin" style="margin-right: 0.5rem;"></i>Installing...';
try {
await window.electronAPI.quitAndInstallUpdate();
// If we're still here after 5 seconds, the install probably failed
setTimeout(() => {
console.log('⚠️ Install may have failed - showing skip option');
installBtn.disabled = false;
installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Try Again';
// Show skip button
const skipBtn = document.getElementById('update-skip-btn');
const footerText = document.getElementById('update-footer-text');
if (skipBtn) {
skipBtn.style.display = 'inline-block';
if (footerText) {
footerText.textContent = 'Install not working? Skip for now:';
}
}
}, 5000);
} catch (error) {
console.error('❌ Error installing update:', error);
installBtn.disabled = false;
installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Install & Restart';
// Show skip button on error
const skipBtn = document.getElementById('update-skip-btn');
const footerText = document.getElementById('update-footer-text');
if (skipBtn) {
skipBtn.style.display = 'inline-block';
if (footerText) {
footerText.textContent = 'Install failed. Skip for now:';
}
}
}
});
}
@@ -138,10 +180,15 @@ class ClientUpdateManager {
try {
await window.electronAPI.openDownloadPage();
console.log('✅ Download page opened, launcher will close...');
downloadBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Launcher closing...';
console.log('✅ Download page opened');
downloadBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Opened in browser';
// Close the popup after opening download page
setTimeout(() => {
this.closeUpdatePopup();
}, 1500);
} catch (error) {
console.error('❌ Error opening download page:', error);
downloadBtn.disabled = false;
@@ -161,9 +208,39 @@ class ClientUpdateManager {
});
}
// Show skip button after 30 seconds as fallback (in case update is stuck)
setTimeout(() => {
const skipBtn = document.getElementById('update-skip-btn');
const footerText = document.getElementById('update-footer-text');
if (skipBtn) {
skipBtn.style.display = 'inline-block';
if (footerText) {
footerText.textContent = 'Update taking too long?';
}
}
}, 30000);
const skipBtn = document.getElementById('update-skip-btn');
if (skipBtn) {
skipBtn.addEventListener('click', (e) => {
e.preventDefault();
e.stopPropagation();
this.closeUpdatePopup();
});
}
console.log('🔔 Update popup displayed with new style');
}
closeUpdatePopup() {
const overlay = document.getElementById('update-popup-overlay');
if (overlay) {
overlay.remove();
}
this.updatePopupVisible = false;
this.unblockInterface();
}
updateDownloadProgress(progress) {
const progressBar = document.getElementById('update-progress-bar');
const progressPercent = document.getElementById('update-progress-percent');
@@ -197,35 +274,96 @@ class ClientUpdateManager {
const statusText = document.getElementById('update-status-text');
const progressContainer = document.getElementById('update-progress-container');
const buttonsContainer = document.getElementById('update-buttons-container');
const installBtn = document.getElementById('update-install-btn');
const downloadBtn = document.getElementById('update-download-btn');
const skipBtn = document.getElementById('update-skip-btn');
const footerText = document.getElementById('update-footer-text');
const popupContainer = document.querySelector('.update-popup-container');
if (statusText) {
statusText.textContent = 'Update downloaded! Ready to install.';
// Remove breathing/pulse animation when download is complete
if (popupContainer) {
popupContainer.classList.remove('update-popup-pulse');
}
if (progressContainer) {
progressContainer.style.display = 'none';
}
// Use platform info from main process if available, fallback to browser detection
const autoInstallSupported = updateInfo.autoInstallSupported !== undefined
? updateInfo.autoInstallSupported
: navigator.platform.toUpperCase().indexOf('MAC') < 0;
if (!autoInstallSupported) {
// macOS: Show manual download as primary since auto-update doesn't work
if (statusText) {
statusText.textContent = 'Update downloaded but auto-install may not work on macOS.';
}
if (installBtn) {
// Still show install button but as secondary option
installBtn.classList.add('update-download-btn-secondary');
installBtn.innerHTML = '<i class="fas fa-check" style="margin-right: 0.5rem;"></i>Try Install & Restart';
}
if (downloadBtn) {
// Make manual download primary
downloadBtn.classList.remove('update-download-btn-secondary');
downloadBtn.innerHTML = '<i class="fas fa-external-link-alt" style="margin-right: 0.5rem;"></i>Download Manually (Recommended)';
}
if (footerText) {
footerText.textContent = 'Auto-install often fails on macOS:';
}
} else {
// Windows/Linux: Auto-install should work
if (statusText) {
statusText.textContent = 'Update downloaded! Ready to install.';
}
if (footerText) {
footerText.textContent = 'Click to install the update:';
}
}
if (buttonsContainer) {
buttonsContainer.style.display = 'block';
}
console.log('✅ Update downloaded, ready to install');
// Always show skip button in downloaded state
if (skipBtn) {
skipBtn.style.display = 'inline-block';
console.log('✅ Skip button made visible');
} else {
console.error('❌ Skip button not found in DOM!');
}
console.log('✅ Update downloaded, ready to install. autoInstallSupported:', autoInstallSupported);
}
handleUpdateError(errorInfo) {
console.error('Update error:', errorInfo);
// Show skip button immediately on any error
const skipBtn = document.getElementById('update-skip-btn');
const footerText = document.getElementById('update-footer-text');
if (skipBtn) {
skipBtn.style.display = 'inline-block';
if (footerText) {
footerText.textContent = 'Update failed. You can skip for now.';
}
}
// If manual download is required, update the UI (this will handle status text)
if (errorInfo.requiresManualDownload) {
this.showManualDownloadRequired(errorInfo);
return; // Don't do anything else, showManualDownloadRequired handles everything
}
// For non-critical errors, just show error message without changing status
const errorMessage = document.getElementById('update-error-message');
const errorText = document.getElementById('update-error-text');
if (errorMessage && errorText) {
let message = errorInfo.message || 'An error occurred during the update process.';
if (errorInfo.isMacSigningError) {
@@ -289,6 +427,16 @@ class ClientUpdateManager {
buttonsContainer.style.display = 'block';
}
// Show skip button for manual download errors
const skipBtn = document.getElementById('update-skip-btn');
const footerText = document.getElementById('update-footer-text');
if (skipBtn) {
skipBtn.style.display = 'inline-block';
if (footerText) {
footerText.textContent = 'Or continue without updating:';
}
}
console.log('⚠️ Manual download required due to update error');
}
@@ -300,13 +448,35 @@ class ClientUpdateManager {
document.body.classList.add('no-select');
document.addEventListener('keydown', this.blockKeyEvents.bind(this), true);
document.addEventListener('contextmenu', this.blockContextMenu.bind(this), true);
// Store bound functions so we can remove them later
this._boundBlockKeyEvents = this.blockKeyEvents.bind(this);
this._boundBlockContextMenu = this.blockContextMenu.bind(this);
document.addEventListener('keydown', this._boundBlockKeyEvents, true);
document.addEventListener('contextmenu', this._boundBlockContextMenu, true);
console.log('🚫 Interface blocked for update');
}
unblockInterface() {
const mainContent = document.querySelector('.flex.w-full.h-screen');
if (mainContent) {
mainContent.classList.remove('interface-blocked');
}
document.body.classList.remove('no-select');
// Remove event listeners
if (this._boundBlockKeyEvents) {
document.removeEventListener('keydown', this._boundBlockKeyEvents, true);
}
if (this._boundBlockContextMenu) {
document.removeEventListener('contextmenu', this._boundBlockContextMenu, true);
}
console.log('✅ Interface unblocked');
}
blockKeyEvents(event) {
if (event.target.closest('#update-popup-overlay')) {
if ((event.key === 'Enter' || event.key === ' ') &&

250
GUI/locales/de-DE.json Normal file
View File

@@ -0,0 +1,250 @@
{
"nav": {
"play": "Spielen",
"mods": "Mods",
"news": "Neuigkeiten",
"chat": "Spieler-Chat",
"settings": "Einstellungen"
},
"header": {
"playersLabel": "Spieler:",
"manageProfiles": "Profile verwalten",
"defaultProfile": "Standard"
},
"install": {
"title": "KOSTENLOSER LAUNCHER",
"playerName": "Spielername",
"playerNamePlaceholder": "Namen eingeben",
"gameBranch": "Spielversion",
"releaseVersion": "Release (Stabil)",
"preReleaseVersion": "Pre-Release (Experimentell)",
"customInstallation": "Benutzerdefinierte Installation",
"installationFolder": "Installationsordner",
"pathPlaceholder": "Standardspeicherort",
"browse": "Durchsuchen",
"installButton": "HYTALE INSTALLIEREN",
"installing": "INSTALLIERE..."
},
"play": {
"ready": "BEREIT ZUM SPIELEN",
"subtitle": "Starte Hytale und beginne das Abenteuer",
"playButton": "HYTALE SPIELEN",
"latestNews": "NEUESTE NACHRICHTEN",
"viewAll": "ALLE ANZEIGEN",
"checking": "ÜBERPRÜFE...",
"play": "SPIELEN"
},
"mods": {
"searchPlaceholder": "Mods suchen...",
"myMods": "MEINE MODS",
"previous": "ZURÜCK",
"next": "WEITER",
"page": "Seite",
"of": "von",
"modalTitle": "MEINE MODS",
"noModsFound": "Keine Mods gefunden",
"noModsFoundDesc": "Versuche deine Suche anzupassen",
"noModsInstalled": "Keine Mods installiert",
"noModsInstalledDesc": "Füge Mods von CurseForge hinzu oder importiere lokale Dateien",
"view": "ANZEIGEN",
"install": "INSTALLIEREN",
"installed": "INSTALLIERT",
"enable": "AKTIVIEREN",
"disable": "DEAKTIVIEREN",
"active": "AKTIV",
"disabled": "DEAKTIVIERT",
"delete": "Mod löschen",
"noDescription": "Keine Beschreibung verfügbar",
"confirmDelete": "Möchtest du \"{name}\" wirklich löschen?",
"confirmDeleteDesc": "Diese Aktion kann nicht rückgängig gemacht werden.",
"confirmDeletion": "Löschung bestätigen",
"apiKeyRequired": "API-Schlüssel erforderlich",
"apiKeyRequiredDesc": "CurseForge API-Schlüssel wird benötigt, um Mods zu durchsuchen"
},
"news": {
"title": "ALLE NACHRICHTEN",
"readMore": "Mehr lesen"
},
"chat": {
"title": "SPIELER-CHAT",
"pickColor": "Farbe",
"inputPlaceholder": "Nachricht eingeben...",
"send": "Senden",
"online": "online",
"charCounter": "{current}/{max}",
"secureChat": "Sicherer Chat - Links werden zensiert",
"joinChat": "Chat beitreten",
"chooseUsername": "Wähle einen Benutzernamen, um dem Spieler-Chat beizutreten",
"username": "Benutzername",
"usernamePlaceholder": "Benutzernamen eingeben...",
"usernameHint": "3-20 Zeichen, nur Buchstaben, Zahlen, - und _",
"joinButton": "Chat beitreten",
"colorModal": {
"title": "Benutzernamenfarbe anpassen",
"chooseSolid": "Wähle eine einfarbige Farbe:",
"customColor": "Benutzerdefinierte Farbe:",
"preview": "Vorschau:",
"previewUsername": "Benutzername",
"apply": "Farbe anwenden"
}
},
"settings": {
"title": "EINSTELLUNGEN",
"java": "Java Runtime",
"useCustomJava": "Benutzerdefinierten Java-Pfad verwenden",
"javaDescription": "Ersetze die mitgelieferte Java-Installation durch deine eigene",
"javaPath": "Java-Ausführungsdatei-Pfad",
"javaPathPlaceholder": "Java-Pfad auswählen...",
"javaBrowse": "Durchsuchen",
"javaHint": "Wähle den Java-Installationsordner (unterstützt Windows, Mac, Linux)",
"discord": "Discord-Integration",
"enableRPC": "Discord Rich Presence aktivieren",
"discordDescription": "Zeige deine Launcher-Aktivität auf Discord",
"game": "Spieloptionen",
"playerName": "Spielername",
"playerNamePlaceholder": "Spielernamen eingeben",
"playerNameHint": "Dieser Name wird im Spiel verwendet (1-16 Zeichen)",
"openGameLocation": "Spielordner öffnen",
"openGameLocationDesc": "Öffne den Spielinstallationsordner",
"account": "Spieler-UUID-Verwaltung",
"currentUUID": "Aktuelle UUID",
"uuidPlaceholder": "UUID wird geladen...",
"copyUUID": "UUID kopieren",
"regenerateUUID": "UUID neu generieren",
"uuidHint": "Deine eindeutige Spielerkennung für diesen Benutzernamen",
"manageUUIDs": "Alle UUIDs verwalten",
"manageUUIDsDesc": "Alle Spieler-UUIDs anzeigen und verwalten",
"language": "Sprache",
"selectLanguage": "Sprache auswählen",
"repairGame": "Spiel reparieren",
"reinstallGame": "Spieldateien neu installieren (behält Daten)",
"gpuPreference": "GPU-Präferenz",
"gpuHint": "Wähle deine bevorzugte GPU (Linux: betrifft DRI_PRIME)",
"gpuAuto": "Auto",
"gpuIntegrated": "Integriert",
"gpuDedicated": "Dediziert",
"logs": "SYSTEMPROTOKOLLE",
"logsCopy": "Kopieren",
"logsRefresh": "Aktualisieren",
"logsFolder": "Ordner öffnen",
"logsLoading": "Protokolle werden geladen...",
"closeLauncher": "Launcher-Verhalten",
"closeOnStart": "Launcher beim Spielstart schließen",
"closeOnStartDescription": "Schließe den Launcher automatisch, nachdem Hytale gestartet wurde",
"hwAccel": "Hardware-Beschleunigung",
"hwAccelDescription": "Hardware-Beschleunigung für den Launcher aktivieren",
"gameBranch": "Spiel-Branch",
"branchRelease": "Release",
"branchPreRelease": "Pre-Release",
"branchHint": "Wechsel zwischen stabiler Release- und experimenteller Pre-Release-Version",
"branchWarning": "Das Ändern des Branches lädt eine andere Spielversion herunter und installiert sie",
"branchSwitching": "Wechsle zu {branch}...",
"branchSwitched": "Erfolgreich zu {branch} gewechselt!",
"installRequired": "Installation erforderlich",
"branchInstallConfirm": "Das Spiel wird für den {branch}-Branch installiert. Fortfahren?"
},
"uuid": {
"modalTitle": "UUID-Verwaltung",
"currentUserUUID": "Aktuelle Benutzer-UUID",
"allPlayerUUIDs": "Alle Spieler-UUIDs",
"generateNew": "Neue UUID generieren",
"loadingUUIDs": "UUIDs werden geladen...",
"setCustomUUID": "Benutzerdefinierte UUID festlegen",
"customPlaceholder": "Benutzerdefinierte UUID eingeben (Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
"setUUID": "UUID festlegen",
"warning": "Warnung: Das Festlegen einer benutzerdefinierten UUID ändert deine aktuelle Spieleridentität",
"copyTooltip": "UUID kopieren",
"regenerateTooltip": "Neue UUID generieren"
},
"profiles": {
"modalTitle": "Profile verwalten",
"newProfilePlaceholder": "Neuer Profilname",
"createProfile": "Profil erstellen"
},
"discord": {
"notificationText": "Tritt unserer Discord-Community bei!",
"joinButton": "Discord beitreten"
},
"common": {
"confirm": "Bestätigen",
"cancel": "Abbrechen",
"save": "Speichern",
"close": "Schließen",
"delete": "Löschen",
"edit": "Bearbeiten",
"loading": "Lädt...",
"apply": "Anwenden",
"install": "Installieren"
},
"notifications": {
"gameDataNotFound": "Fehler: Spieldaten nicht gefunden",
"gameUpdatedSuccess": "Spiel erfolgreich aktualisiert! 🎉",
"updateFailed": "Update fehlgeschlagen: {error}",
"updateError": "Update-Fehler: {error}",
"discordEnabled": "Discord Rich Presence aktiviert",
"discordDisabled": "Discord Rich Presence deaktiviert",
"discordSaveFailed": "Discord-Einstellung konnte nicht gespeichert werden",
"playerNameRequired": "Bitte gib einen gültigen Spielernamen ein",
"playerNameSaved": "Spielername erfolgreich gespeichert",
"playerNameSaveFailed": "Spielername konnte nicht gespeichert werden",
"uuidCopied": "UUID in die Zwischenablage kopiert!",
"uuidCopyFailed": "UUID konnte nicht kopiert werden",
"uuidRegenNotAvailable": "UUID-Neugenerierung nicht verfügbar",
"uuidRegenFailed": "UUID konnte nicht neu generiert werden",
"uuidGenerated": "Neue UUID erfolgreich generiert!",
"uuidGeneratedShort": "Neue UUID generiert!",
"uuidGenerateFailed": "Neue UUID konnte nicht generiert werden",
"uuidRequired": "Bitte gib eine UUID ein",
"uuidInvalidFormat": "Ungültiges UUID-Format",
"uuidSetFailed": "Benutzerdefinierte UUID konnte nicht festgelegt werden",
"uuidSetSuccess": "Benutzerdefinierte UUID erfolgreich festgelegt!",
"uuidDeleteFailed": "UUID konnte nicht gelöscht werden",
"uuidDeleteSuccess": "UUID erfolgreich gelöscht!",
"modsDownloading": "{name} wird heruntergeladen...",
"modsTogglingMod": "Mod wird umgeschaltet...",
"modsDeletingMod": "Mod wird gelöscht...",
"modsLoadingMods": "Mods von CurseForge werden geladen...",
"modsInstalledSuccess": "{name} erfolgreich installiert! 🎉",
"modsDeletedSuccess": "{name} erfolgreich gelöscht",
"modsDownloadFailed": "Mod konnte nicht heruntergeladen werden: {error}",
"modsToggleFailed": "Mod konnte nicht umgeschaltet werden: {error}",
"modsDeleteFailed": "Mod konnte nicht gelöscht werden: {error}",
"modsModNotFound": "Mod-Informationen nicht gefunden",
"hwAccelSaved": "Hardware-Beschleunigungseinstellung gespeichert",
"hwAccelSaveFailed": "Hardware-Beschleunigungseinstellung konnte nicht gespeichert werden"
},
"confirm": {
"defaultTitle": "Aktion bestätigen",
"regenerateUuidTitle": "Neue UUID generieren",
"regenerateUuidMessage": "Möchtest du wirklich eine neue UUID generieren? Dies ändert deine Spieleridentität.",
"regenerateUuidButton": "Generieren",
"setCustomUuidTitle": "Benutzerdefinierte UUID festlegen",
"setCustomUuidMessage": "Möchtest du wirklich diese benutzerdefinierte UUID festlegen? Dies ändert deine Spieleridentität.",
"setCustomUuidButton": "UUID festlegen",
"deleteUuidTitle": "UUID löschen",
"deleteUuidMessage": "Möchtest du wirklich die UUID für \"{username}\" löschen? Diese Aktion kann nicht rückgängig gemacht werden.",
"deleteUuidButton": "Löschen",
"uninstallGameTitle": "Spiel deinstallieren",
"uninstallGameMessage": "Möchtest du Hytale wirklich deinstallieren? Alle Spieldateien werden gelöscht.",
"uninstallGameButton": "Deinstallieren"
},
"progress": {
"initializing": "Initialisiere...",
"downloading": "Lädt herunter...",
"installing": "Installiere...",
"extracting": "Entpacke...",
"verifying": "Überprüfe...",
"switchingProfile": "Profil wird gewechselt...",
"profileSwitched": "Profil gewechselt!",
"startingGame": "Spiel wird gestartet...",
"launching": "STARTET...",
"uninstallingGame": "Spiel wird deinstalliert...",
"gameUninstalled": "Spiel erfolgreich deinstalliert!",
"uninstallFailed": "Deinstallation fehlgeschlagen: {error}",
"startingUpdate": "Obligatorisches Spiel-Update wird gestartet...",
"installationComplete": "Installation erfolgreich abgeschlossen!",
"installationFailed": "Installation fehlgeschlagen: {error}",
"installingGameFiles": "Spieldateien werden installiert...",
"installComplete": "Installation abgeschlossen!"
}
}

8
GUI/locales/es-ES.json
View File

@@ -131,6 +131,8 @@
"closeLauncher": "Comportamiento del Launcher",
"closeOnStart": "Cerrar Launcher al iniciar el juego",
"closeOnStartDescription": "Cierra automáticamente el launcher después de que Hytale se haya iniciado",
"hwAccel": "Aceleración por Hardware",
"hwAccelDescription": "Habilitar aceleración por hardware para el launcher",
"gameBranch": "Rama del Juego",
"branchRelease": "Lanzamiento",
"branchPreRelease": "Pre-Lanzamiento",
@@ -207,7 +209,9 @@
"modsDownloadFailed": "Error al descargar mod: {error}",
"modsToggleFailed": "Error al alternar mod: {error}",
"modsDeleteFailed": "Error al eliminar mod: {error}",
"modsModNotFound": "Información del mod no encontrada"
"modsModNotFound": "Información del mod no encontrada",
"hwAccelSaved": "Configuración de aceleración por hardware guardada",
"hwAccelSaveFailed": "Error al guardar la configuración de aceleración por hardware"
},
"confirm": {
"defaultTitle": "Confirmar acción",
@@ -243,4 +247,4 @@
"installingGameFiles": "Instalando archivos del juego...",
"installComplete": "¡Instalación completa!"
}
}
}

250
GUI/locales/fr-FR.json Normal file
View File

@@ -0,0 +1,250 @@
{
"nav": {
"play": "Jouer",
"mods": "Mods",
"news": "Actualités",
"chat": "Chat Joueurs",
"settings": "Paramètres"
},
"header": {
"playersLabel": "Joueurs:",
"manageProfiles": "Gérer les Profils",
"defaultProfile": "Par défaut"
},
"install": {
"title": "LAUNCHER GRATUIT",
"playerName": "Nom du Joueur",
"playerNamePlaceholder": "Entrez votre nom",
"gameBranch": "Version du Jeu",
"releaseVersion": "Release (Stable)",
"preReleaseVersion": "Pré-Release (Expérimental)",
"customInstallation": "Installation Personnalisée",
"installationFolder": "Dossier d'Installation",
"pathPlaceholder": "Emplacement par défaut",
"browse": "Parcourir",
"installButton": "INSTALLER HYTALE",
"installing": "INSTALLATION..."
},
"play": {
"ready": "PRÊT À JOUER",
"subtitle": "Lancez Hytale et entrez dans l'aventure",
"playButton": "JOUER À HYTALE",
"latestNews": "DERNIÈRES ACTUALITÉS",
"viewAll": "VOIR TOUT",
"checking": "VÉRIFICATION...",
"play": "JOUER"
},
"mods": {
"searchPlaceholder": "Rechercher des mods...",
"myMods": "MES MODS",
"previous": "PRÉCÉDENT",
"next": "SUIVANT",
"page": "Page",
"of": "sur",
"modalTitle": "MES MODS",
"noModsFound": "Aucun Mod Trouvé",
"noModsFoundDesc": "Essayez d'ajuster votre recherche",
"noModsInstalled": "Aucun Mod Installé",
"noModsInstalledDesc": "Ajoutez des mods depuis CurseForge ou importez des fichiers locaux",
"view": "VOIR",
"install": "INSTALLER",
"installed": "INSTALLÉ",
"enable": "ACTIVER",
"disable": "DÉSACTIVER",
"active": "ACTIF",
"disabled": "DÉSACTIVÉ",
"delete": "Supprimer le mod",
"noDescription": "Aucune description disponible",
"confirmDelete": "Êtes-vous sûr de vouloir supprimer \"{name}\" ?",
"confirmDeleteDesc": "Cette action est irréversible.",
"confirmDeletion": "Confirmer la Suppression",
"apiKeyRequired": "Clé API Requise",
"apiKeyRequiredDesc": "Une clé API CurseForge est nécessaire pour parcourir les mods"
},
"news": {
"title": "TOUTES LES ACTUALITÉS",
"readMore": "Lire Plus"
},
"chat": {
"title": "CHAT JOUEURS",
"pickColor": "Couleur",
"inputPlaceholder": "Tapez votre message...",
"send": "Envoyer",
"online": "en ligne",
"charCounter": "{current}/{max}",
"secureChat": "Chat sécurisé - Les liens sont censurés",
"joinChat": "Rejoindre le Chat",
"chooseUsername": "Choisissez un nom d'utilisateur pour rejoindre le Chat Joueurs",
"username": "Nom d'utilisateur",
"usernamePlaceholder": "Entrez votre nom d'utilisateur...",
"usernameHint": "3-20 caractères, lettres, chiffres, - et _ uniquement",
"joinButton": "Rejoindre le Chat",
"colorModal": {
"title": "Personnaliser la Couleur du Nom",
"chooseSolid": "Choisissez une couleur unie:",
"customColor": "Couleur personnalisée:",
"preview": "Aperçu:",
"previewUsername": "Nom d'utilisateur",
"apply": "Appliquer la Couleur"
}
},
"settings": {
"title": "PARAMÈTRES",
"java": "Java Runtime",
"useCustomJava": "Utiliser un Chemin Java Personnalisé",
"javaDescription": "Remplacer le Java intégré par votre propre installation",
"javaPath": "Chemin de l'Exécutable Java",
"javaPathPlaceholder": "Sélectionnez le chemin Java...",
"javaBrowse": "Parcourir",
"javaHint": "Sélectionnez le dossier d'installation de Java (compatible Windows, Mac, Linux)",
"discord": "Intégration Discord",
"enableRPC": "Activer Discord Rich Presence",
"discordDescription": "Afficher votre activité du launcher sur Discord",
"game": "Options de Jeu",
"playerName": "Nom du Joueur",
"playerNamePlaceholder": "Entrez le nom du joueur",
"playerNameHint": "Ce nom sera utilisé en jeu (1-16 caractères)",
"openGameLocation": "Ouvrir l'Emplacement du Jeu",
"openGameLocationDesc": "Ouvrir le dossier d'installation du jeu",
"account": "Gestion UUID Joueur",
"currentUUID": "UUID Actuel",
"uuidPlaceholder": "Chargement UUID...",
"copyUUID": "Copier UUID",
"regenerateUUID": "Régénérer UUID",
"uuidHint": "Votre identifiant unique de joueur pour ce nom d'utilisateur",
"manageUUIDs": "Gérer Tous les UUIDs",
"manageUUIDsDesc": "Voir et gérer tous les UUIDs de joueurs",
"language": "Langue",
"selectLanguage": "Sélectionner la Langue",
"repairGame": "Réparer le Jeu",
"reinstallGame": "Réinstaller les fichiers du jeu (préserve les données)",
"gpuPreference": "Préférence GPU",
"gpuHint": "Sélectionnez votre GPU préféré (Linux: affecte DRI_PRIME)",
"gpuAuto": "Auto",
"gpuIntegrated": "Intégré",
"gpuDedicated": "Dédié",
"logs": "JOURNAUX SYSTÈME",
"logsCopy": "Copier",
"logsRefresh": "Actualiser",
"logsFolder": "Ouvrir le Dossier",
"logsLoading": "Chargement des journaux...",
"closeLauncher": "Comportement du Launcher",
"closeOnStart": "Fermer le Launcher au démarrage du jeu",
"closeOnStartDescription": "Fermer automatiquement le launcher après le lancement d'Hytale",
"hwAccel": "Accélération Matérielle",
"hwAccelDescription": "Activer l'accélération matérielle pour le launcher",
"gameBranch": "Branche du Jeu",
"branchRelease": "Release",
"branchPreRelease": "Pré-Release",
"branchHint": "Basculer entre la version stable release et la pré-release expérimentale",
"branchWarning": "Changer de branche téléchargera et installera une version différente du jeu",
"branchSwitching": "Passage à {branch}...",
"branchSwitched": "Passage à {branch} réussi!",
"installRequired": "Installation Requise",
"branchInstallConfirm": "Le jeu sera installé pour la branche {branch}. Continuer?"
},
"uuid": {
"modalTitle": "Gestion UUID",
"currentUserUUID": "UUID Utilisateur Actuel",
"allPlayerUUIDs": "Tous les UUIDs Joueurs",
"generateNew": "Générer Nouvel UUID",
"loadingUUIDs": "Chargement des UUIDs...",
"setCustomUUID": "Définir UUID Personnalisé",
"customPlaceholder": "Entrez UUID personnalisé (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
"setUUID": "Définir UUID",
"warning": "Attention: Définir un UUID personnalisé changera votre identité de joueur actuelle",
"copyTooltip": "Copier UUID",
"regenerateTooltip": "Générer Nouvel UUID"
},
"profiles": {
"modalTitle": "Gérer les Profils",
"newProfilePlaceholder": "Nom du Nouveau Profil",
"createProfile": "Créer un Profil"
},
"discord": {
"notificationText": "Rejoignez notre communauté Discord!",
"joinButton": "Rejoindre Discord"
},
"common": {
"confirm": "Confirmer",
"cancel": "Annuler",
"save": "Sauvegarder",
"close": "Fermer",
"delete": "Supprimer",
"edit": "Modifier",
"loading": "Chargement...",
"apply": "Appliquer",
"install": "Installer"
},
"notifications": {
"gameDataNotFound": "Erreur: Données du jeu introuvables",
"gameUpdatedSuccess": "Jeu mis à jour avec succès! 🎉",
"updateFailed": "Mise à jour échouée: {error}",
"updateError": "Erreur de mise à jour: {error}",
"discordEnabled": "Discord Rich Presence activé",
"discordDisabled": "Discord Rich Presence désactivé",
"discordSaveFailed": "Échec de la sauvegarde des paramètres Discord",
"playerNameRequired": "Veuillez entrer un nom de joueur valide",
"playerNameSaved": "Nom du joueur sauvegardé avec succès",
"playerNameSaveFailed": "Échec de la sauvegarde du nom du joueur",
"uuidCopied": "UUID copié dans le presse-papiers!",
"uuidCopyFailed": "Échec de la copie de l'UUID",
"uuidRegenNotAvailable": "Régénération UUID non disponible",
"uuidRegenFailed": "Échec de la régénération de l'UUID",
"uuidGenerated": "Nouvel UUID généré avec succès!",
"uuidGeneratedShort": "Nouvel UUID généré!",
"uuidGenerateFailed": "Échec de la génération du nouvel UUID",
"uuidRequired": "Veuillez entrer un UUID",
"uuidInvalidFormat": "Format UUID invalide",
"uuidSetFailed": "Échec de la définition de l'UUID personnalisé",
"uuidSetSuccess": "UUID personnalisé défini avec succès!",
"uuidDeleteFailed": "Échec de la suppression de l'UUID",
"uuidDeleteSuccess": "UUID supprimé avec succès!",
"modsDownloading": "Téléchargement de {name}...",
"modsTogglingMod": "Basculement du mod...",
"modsDeletingMod": "Suppression du mod...",
"modsLoadingMods": "Chargement des mods depuis CurseForge...",
"modsInstalledSuccess": "{name} installé avec succès! 🎉",
"modsDeletedSuccess": "{name} supprimé avec succès",
"modsDownloadFailed": "Échec du téléchargement du mod: {error}",
"modsToggleFailed": "Échec du basculement du mod: {error}",
"modsDeleteFailed": "Échec de la suppression du mod: {error}",
"modsModNotFound": "Informations du mod introuvables",
"hwAccelSaved": "Paramètre d'accélération matérielle sauvegardé",
"hwAccelSaveFailed": "Échec de la sauvegarde du paramètre d'accélération matérielle"
},
"confirm": {
"defaultTitle": "Confirmer l'action",
"regenerateUuidTitle": "Générer un nouvel UUID",
"regenerateUuidMessage": "Êtes-vous sûr de vouloir générer un nouvel UUID? Cela changera votre identité de joueur.",
"regenerateUuidButton": "Générer",
"setCustomUuidTitle": "Définir UUID personnalisé",
"setCustomUuidMessage": "Êtes-vous sûr de vouloir définir cet UUID personnalisé? Cela changera votre identité de joueur.",
"setCustomUuidButton": "Définir UUID",
"deleteUuidTitle": "Supprimer UUID",
"deleteUuidMessage": "Êtes-vous sûr de vouloir supprimer l'UUID de \"{username}\"? Cette action est irréversible.",
"deleteUuidButton": "Supprimer",
"uninstallGameTitle": "Désinstaller le jeu",
"uninstallGameMessage": "Êtes-vous sûr de vouloir désinstaller Hytale? Tous les fichiers du jeu seront supprimés.",
"uninstallGameButton": "Désinstaller"
},
"progress": {
"initializing": "Initialisation...",
"downloading": "Téléchargement...",
"installing": "Installation...",
"extracting": "Extraction...",
"verifying": "Vérification...",
"switchingProfile": "Changement de profil...",
"profileSwitched": "Profil changé!",
"startingGame": "Démarrage du jeu...",
"launching": "LANCEMENT...",
"uninstallingGame": "Désinstallation du jeu...",
"gameUninstalled": "Jeu désinstallé avec succès!",
"uninstallFailed": "Échec de la désinstallation: {error}",
"startingUpdate": "Démarrage de la mise à jour obligatoire du jeu...",
"installationComplete": "Installation terminée avec succès!",
"installationFailed": "Échec de l'installation: {error}",
"installingGameFiles": "Installation des fichiers du jeu...",
"installComplete": "Installation terminée!"
}
}

46
GUI/locales/pl-PL.json
View File

@@ -4,19 +4,20 @@
"mods": "Mody",
"news": "Wiadomości",
"chat": "Chat z graczami",
"settings": "Ustawienia",
"skins": "Skiny"
"settings": "Ustawienia"
},
"header": {
"playersLabel": "Graczy:",
"manageProfiles": "Zarządzaj Profilami",
"defaultProfile": "Domyślny",
"f2p": "FREE TO PLAY"
"defaultProfile": "Domyślny"
},
"install": {
"title": "FREE TO PLAY LAUNCHER",
"title": "DARMOWY LAUNCHER",
"playerName": "Nazwa Gracza",
"playerNamePlaceholder": "Wprowadź Nazwę",
"gameBranch": "Wersja Gry",
"releaseVersion": "Wydanie (Stabilna)",
"preReleaseVersion": "Przed-Wydaniem (Eksperymentalna)",
"customInstallation": "Dostosuj Instalacje",
"installationFolder": "Folder docelowy",
"pathPlaceholder": "Domyślna lokalizacja",
@@ -56,7 +57,9 @@
"noDescription": "Brak opisu",
"confirmDelete": "Czy na pewno chcesz usunąć \"{name}\"?",
"confirmDeleteDesc": "Tej czynności nie można cofnąć.",
"confirmDeletion": "Potwierdź"
"confirmDeletion": "Potwierdź",
"apiKeyRequired": "Wymagany Klucz API",
"apiKeyRequiredDesc": "Klucz API CurseForge jest potrzebny do przeglądania modów"
},
"news": {
"title": "WSZYSTKIE WIADOMOŚCI",
@@ -120,11 +123,25 @@
"gpuAuto": "Auto",
"gpuIntegrated": "Zintegrowana",
"gpuDedicated": "Dedykowana",
"logs": "SYSTEM LOGS",
"logs": "DZIENNIKI SYSTEMOWE",
"logsCopy": "Kopiuj",
"logsRefresh": "Odśwież",
"logsFolder": "Otwórz Folder",
"logsLoading": "Ładowanie logów..."
"logsLoading": "Ładowanie logów...",
"closeLauncher": "Zachowanie Launchera",
"closeOnStart": "Zamknij Launcher przy starcie gry",
"closeOnStartDescription": "Automatycznie zamknij launcher po uruchomieniu Hytale",
"hwAccel": "Przyspieszenie Sprzętowe",
"hwAccelDescription": "Włącz przyspieszenie sprzętowe dla launchera",
"gameBranch": "Gałąź Gry",
"branchRelease": "Wydanie",
"branchPreRelease": "Przed-Wydaniem",
"branchHint": "Przełączaj między stabilnym wydaniem a eksperymentalną wersją przed-wydaniem",
"branchWarning": "Zmiana gałęzi spowoduje pobranie i instalację innej wersji gry",
"branchSwitching": "Przełączanie na {branch}...",
"branchSwitched": "Pomyślnie przełączono na {branch}!",
"installRequired": "Wymagana Instalacja",
"branchInstallConfirm": "Gra zostanie zainstalowana dla gałęzi {branch}. Kontynuować?"
},
"uuid": {
"modalTitle": "Zarządzanie UUID",
@@ -148,10 +165,6 @@
"notificationText": "Dołącz do naszej społeczności Discord!",
"joinButton": "Dołącz Discord"
},
"skins": {
"title": "Skiny",
"comingSoon": "Personalizacja skórek już wkrótce..."
},
"common": {
"confirm": "Potwierdź",
"cancel": "Anuluj",
@@ -160,7 +173,8 @@
"delete": "Usuń",
"edit": "Edytuj",
"loading": "Ładowanie...",
"apply": "Zastosuj"
"apply": "Zastosuj",
"install": "Zainstaluj"
},
"notifications": {
"gameDataNotFound": "Błąd: Nie znaleziono danych gry",
@@ -195,7 +209,9 @@
"modsDownloadFailed": "Nie udało się pobrać moda: {error}",
"modsToggleFailed": "Nie udało się przełączyć moda: {error}",
"modsDeleteFailed": "Nie udało się usunąć moda: {error}",
"modsModNotFound": "Nie znaleziono informacji o modzie"
"modsModNotFound": "Nie znaleziono informacji o modzie",
"hwAccelSaved": "Zapisano ustawienie przyspieszenia sprzętowego",
"hwAccelSaveFailed": "Nie udało się zapisać ustawienia przyspieszenia sprzętowego"
},
"confirm": {
"defaultTitle": "Potwierdź działanie",
@@ -231,4 +247,4 @@
"installingGameFiles": "Instalowanie plików gry...",
"installComplete": "Instalacja zakończona!"
}
}
}

13
GUI/locales/pt-BR.json
View File

@@ -14,9 +14,11 @@
"install": {
"title": "LANÇADOR JOGO GRATUITO",
"playerName": "Nome do Jogador",
"playerNamePlaceholder": "Digite seu nome", "gameBranch": "Versão do Jogo",
"playerNamePlaceholder": "Digite seu nome",
"gameBranch": "Versão do Jogo",
"releaseVersion": "Lançamento (Estável)",
"preReleaseVersion": "Pré-Lançamento (Experimental)", "customInstallation": "Instalação Personalizada",
"preReleaseVersion": "Pré-Lançamento (Experimental)",
"customInstallation": "Instalação Personalizada",
"installationFolder": "Pasta de Instalação",
"pathPlaceholder": "Local padrão",
"browse": "Procurar",
@@ -129,6 +131,8 @@
"closeLauncher": "Comportamento do Lançador",
"closeOnStart": "Fechar Lançador ao iniciar o jogo",
"closeOnStartDescription": "Fechar automaticamente o lançador após o Hytale ter sido iniciado",
"hwAccel": "Aceleração de Hardware",
"hwAccelDescription": "Ativar aceleração de hardware para o lançador",
"gameBranch": "Versão do Jogo",
"branchRelease": "Lançamento",
"branchPreRelease": "Pré-Lançamento",
@@ -161,7 +165,6 @@
"notificationText": "Junte-se à nossa comunidade do Discord!",
"joinButton": "Entrar no Discord"
},
"common": {
"confirm": "Confirmar",
"cancel": "Cancelar",
@@ -206,7 +209,9 @@
"modsDownloadFailed": "Falha ao baixar mod: {error}",
"modsToggleFailed": "Falha ao alternar mod: {error}",
"modsDeleteFailed": "Falha ao excluir mod: {error}",
"modsModNotFound": "Informações do mod não encontradas"
"modsModNotFound": "Informações do mod não encontradas",
"hwAccelSaved": "Configuração de aceleração de hardware salva",
"hwAccelSaveFailed": "Falha ao salvar configuração de aceleração de hardware"
},
"confirm": {
"defaultTitle": "Confirmar ação",

250
GUI/locales/ru-RU.json Normal file
View File

@@ -0,0 +1,250 @@
{
"nav": {
"play": "Играть",
"mods": "Моды",
"news": "Новости",
"chat": "Чат игроков",
"settings": "Настройки"
},
"header": {
"playersLabel": "Игроки:",
"manageProfiles": "Управлять профилями:",
"defaultProfile": "По умолчанию"
},
"install": {
"title": "FREE TO PLAY LAUNCHER",
"playerName": "Ник игрока",
"playerNamePlaceholder": "Введите ваш ник",
"gameBranch": "Версия игры",
"releaseVersion": "Релиз (Стабильная)",
"preReleaseVersion": "Пре-Релиз (Экспериментально)",
"customInstallation": "Модифицированная установка",
"installationFolder": "Папка установки",
"pathPlaceholder": "Путь по умолчанию",
"browse": "Обзор",
"installButton": "УСТАНОВИТЬ HYTALE",
"installing": "УСТАНОВКА..."
},
"play": {
"ready": "ГОТОВ К ИГРЕ",
"subtitle": "Запусти Hytale и приготовься к приключению!",
"playButton": "ЗАПУСТИТЬ HYTALE",
"latestNews": "ПОСЛЕДНИЕ НОВОСТИ",
"viewAll": "ПОСМОТРЕТЬ ВСЁ",
"checking": "ПРОВЕРКА...",
"play": "ЗАПУСТИТЬ"
},
"mods": {
"searchPlaceholder": "Искать моды...",
"myMods": "Мои моды",
"previous": "Предыдущая",
"next": "Вперёд",
"page": "Страница",
"of": "",
"modalTitle": "МОИ МОДЫ",
"noModsFound": "Моды не найдены",
"noModsFoundDesc": "Попробуйте изменить свой запрос",
"noModsInstalled": "Нет установленных модов",
"noModsInstalledDesc": "Добавьте моды с CurseForge или импортируйте свои!",
"view": "Посмотреть",
"install": "Установить",
"installed": "УСТАНОВЛЕННЫЕ",
"enable": "ВКЛЮЧИТЬ",
"disable": "ВЫКЛЮЧИТЬ",
"active": "ВКЛЮЧЁН",
"disabled": "ВЫКЛЮЧЕН",
"delete": "Удалить мод",
"noDescription": "Нет доступного описания",
"confirmDelete": "Вы точно уверены, что хотите удалить \"{name}\"?",
"confirmDeleteDesc": "Это действие не отменить.",
"confirmDeletion": "Подтвердите удаление",
"apiKeyRequired": "Требуется ключ API",
"apiKeyRequiredDesc": "Ключ CurseForge API требуется для просмотра модов"
},
"news": {
"title": "ВСЕ НОВОСТИ",
"readMore": "Читать дальше"
},
"chat": {
"title": "ЧАТ ИГРОКОВ",
"pickColor": "Цвет",
"inputPlaceholder": "Введите своё сообщение...",
"send": "Отправить",
"online": "онлайн",
"charCounter": "{current}/{max}",
"secureChat": "Безопасный чат - все ссылки зацензурены",
"joinChat": "Присоединиться к чату",
"chooseUsername": "Выберите имя пользователя для входа в чат игроков",
"username": "Ник",
"usernamePlaceholder": "Введите ваш ник...",
"usernameHint": "3-20 символов, букв, цифр, только - и _",
"joinButton": "Присоединиться к чату",
"colorModal": {
"title": "Выберите цвет ника",
"chooseSolid": "Выберите цвет:",
"customColor": "Модифицированный цвет:",
"preview": "Предварительный просмотр:",
"previewUsername": "Ник",
"apply": "Применить цвет"
}
},
"settings": {
"title": "НАСТРОЙКИ",
"java": "Java Runtime",
"useCustomJava": "Укажите свой путь Java",
"javaDescription": "Переопределить встроенный Java Runtime с вашей установкой",
"javaPath": "Путь исполняемого файла Java",
"javaPathPlaceholder": "Выберите путь Java...",
"javaBrowse": "Обзор",
"javaHint": "Выберите папку установки Java (поддерживается Windows, Mac, Linux)",
"discord": "Интеграция Discord",
"enableRPC": "Включить Discord Rich Presence",
"discordDescription": "Показывать вашу активность лаунчера в Discord",
"game": "Настройки игры",
"playerName": "Ник игрока",
"playerNamePlaceholder": "Введите ваш ник",
"playerNameHint": "Этот ник будет использован в игре (1-16 символов)",
"openGameLocation": "Открыть местоположение игры",
"openGameLocationDesc": "Открыть папку установки игры",
"account": "Управление UUID игрока",
"currentUUID": "Текущий UUID",
"uuidPlaceholder": "Загрузка UUID...",
"copyUUID": "Копировать UUID",
"regenerateUUID": "Перегенерировать UUID",
"uuidHint": "Уникальный идентификатор игрока для этого ника",
"manageUUIDs": "Управление всеми UUID",
"manageUUIDsDesc": "Смотреть и управлять всеми UUID игрока",
"language": "Язык",
"selectLanguage": "Выберите язык",
"repairGame": "Починить игру",
"reinstallGame": "Переустановить файлы игры (сохраняет данные)",
"gpuPreference": "Предпочтение GPU",
"gpuHint": "Выберите ваш предпочитаемый GPU (Linux: влияет на DRI_PRIME)",
"gpuAuto": "Автоматический выбор",
"gpuIntegrated": "Интегрированная видеокарта",
"gpuDedicated": "Дискретная видеокарта",
"logs": "ЛОГИ",
"logsCopy": "Копировать",
"logsRefresh": "Обновить",
"logsFolder": "Открыть папку",
"logsLoading": "Загрузка логов...",
"closeLauncher": "Поведение лаунчера",
"closeOnStart": "Закрыть лаунчер при старте игры",
"closeOnStartDescription": "Автоматически закрыть лаунчер после запуска Hytale",
"hwAccel": "Аппаратное ускорение",
"hwAccelDescription": "Включить аппаратное ускорение для лаунчера",
"gameBranch": "Ветка игры",
"branchRelease": "Релиз",
"branchPreRelease": "Пре-Релиз",
"branchHint": "Переключает между релизом и пре-релизом игры",
"branchWarning": "Изменение ветки скачает и установит другую версию игры",
"branchSwitching": "Переключение на {branch}...",
"branchSwitched": "Переключение на {branch} выполнено успешно!",
"installRequired": "Необходима установка",
"branchInstallConfirm": "Игра будет установлена для ветки {branch}. Продолжить?"
},
"uuid": {
"modalTitle": "Управление UUID",
"currentUserUUID": "UUID текущего пользователя",
"allPlayerUUIDs": "UUID всех игроков",
"generateNew": "Сгенерировать новый UUID",
"loadingUUIDs": "Загрузка UUID...",
"setCustomUUID": "Установить кастомный UUID",
"customPlaceholder": "Ввести кастомный UUID (форматы: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
"setUUID": "Установить UUID",
"warning": "Внимание! Установка кастомного UUID изменит вашу текущую личность игрока!",
"copyTooltip": "Скопировать UUID",
"regenerateTooltip": "Сгенерировать новый UUID"
},
"profiles": {
"modalTitle": "Управление профилями",
"newProfilePlaceholder": "Новое имя профиля",
"createProfile": "Создать профиль"
},
"discord": {
"notificationText": "Присоединитесь к нашему сообществу в Discord!",
"joinButton": "Присоединиться к Discord"
},
"common": {
"confirm": "Подтвердить",
"cancel": "Отменить",
"save": "Сохранить",
"close": "Закрыть",
"delete": "Удалить",
"edit": "Редактировать",
"loading": "Загружается...",
"apply": "Применить",
"install": "Установить"
},
"notifications": {
"gameDataNotFound": "Ошибка: данные игры не найдены",
"gameUpdatedSuccess": "Игра успешно обновлена! Ура! 🎉",
"updateFailed": "Обновление прервалось с ошибкой: {error}",
"updateError": "Ошибка обновления: {error}",
"discordEnabled": "Discord Rich Presence включен",
"discordDisabled": "Discord Rich Presence выключен",
"discordSaveFailed": "Не удалось сохранить настройку Discord",
"playerNameRequired": "Пожалуйста, введите действительное имя игрока",
"playerNameSaved": "Имя игрока успешно сохранено!",
"playerNameSaveFailed": "Не удалось сохранить имя игрока",
"uuidCopied": "UUID скопирован в буфер обмена!",
"uuidCopyFailed": "Не удалось скопировать UUID",
"uuidRegenNotAvailable": "UUID перегенерация к сожалению не доступна",
"uuidRegenFailed": "Не удалось перегенерировать UUID",
"uuidGenerated": "Новый UUID сгенерирован успешно!",
"uuidGeneratedShort": "Новый UUID сгенерирован!",
"uuidGenerateFailed": "Не получилось сгенерировать новый UUID",
"uuidRequired": "Пожалуйста введите UUID",
"uuidInvalidFormat": "Неправильный формат UUID",
"uuidSetFailed": "Не удалось поставить кастомный UUID",
"uuidSetSuccess": "Кастомный UUID успешно установлен!",
"uuidDeleteFailed": "Не удалось удалить UUID",
"uuidDeleteSuccess": "Удаление UUID успешно завершено!",
"modsDownloading": "Скачивание {name}...",
"modsTogglingMod": "Включение мода...",
"modsDeletingMod": "Удаление мода...",
"modsLoadingMods": "Загрузка модов с CurseForge...",
"modsInstalledSuccess": "{name} успешно установлен! 🎉",
"modsDeletedSuccess": "{name} удалён успешно!",
"modsDownloadFailed": "Не получилось скачать мод: {error}",
"modsToggleFailed": "Не получилось включить мод: {error}",
"modsDeleteFailed": "Не получилось удалить мод: {error}",
"modsModNotFound": "Информация по моду не найдена",
"hwAccelSaved": "Настройка аппаратного ускорения сохранена!",
"hwAccelSaveFailed": "Не удалось сохранить настройку аппаратного ускорения"
},
"confirm": {
"defaultTitle": "Подтвердить действие",
"regenerateUuidTitle": "Сгенерировать новый UUID",
"regenerateUuidMessage": "Вы уверены, что хотите сгенерировать новый UUID? Генерация нового UUID изменит вашу текущую личность игрока!",
"regenerateUuidButton": "Сгенерировать",
"setCustomUuidTitle": "Установить кастомный UUID",
"setCustomUuidMessage": "Вы уверены, что хотите установить кастомный UUID? Установка кастомного UUID изменит вашу текущую личность игрока!",
"setCustomUuidButton": "Установить UUID",
"deleteUuidTitle": "Удалить UUID",
"deleteUuidMessage": "Вы уверены, что хотите удалить UUID для \"{username}\"? Это действие необратимо!",
"deleteUuidButton": "Удалить",
"uninstallGameTitle": "Удалить игру",
"uninstallGameMessage": "Вы уверены, что хотите удалить Hytale? Все данные игры будут безвозвратно удалены!",
"uninstallGameButton": "Удалить"
},
"progress": {
"initializing": "Инициализация...",
"downloading": "Скачивание...",
"installing": "Установка...",
"extracting": "Извлечение...",
"verifying": "Проверка...",
"switchingProfile": "Смена профиля...",
"profileSwitched": "Профиль сменён!",
"startingGame": "Запуск игры...",
"launching": "ЗАПУСК...",
"uninstallingGame": "Удаление игры...",
"gameUninstalled": "Игра успешно удалена!",
"uninstallFailed": "Удаление игры прервано с ошибкой: {error}",
"startingUpdate": "Начало обязательного обновления игры...",
"installationComplete": "Установка успешно завершена!",
"installationFailed": "Установка прервана с ошибкой: {error}",
"installingGameFiles": "Установка файлов игры...",
"installComplete": "Установка завершена!"
}
}

250
GUI/locales/sv-SE.json Normal file
View File

@@ -0,0 +1,250 @@
{
"nav": {
"play": "Spela",
"mods": "Moddar",
"news": "Nyheter",
"chat": "Spelarchatt",
"settings": "Inställningar"
},
"header": {
"playersLabel": "Spelare:",
"manageProfiles": "Hantera profiler",
"defaultProfile": "Standard"
},
"install": {
"title": "GRATIS LAUNCHER",
"playerName": "Spelarnamn",
"playerNamePlaceholder": "Ange ditt namn",
"gameBranch": "Spelversion",
"releaseVersion": "Release (Stabil)",
"preReleaseVersion": "Pre-Release (Experimentell)",
"customInstallation": "Anpassad installation",
"installationFolder": "Installationsmapp",
"pathPlaceholder": "Standardplats",
"browse": "Bläddra",
"installButton": "INSTALLERA HYTALE",
"installing": "INSTALLERAR..."
},
"play": {
"ready": "REDO ATT SPELA",
"subtitle": "Starta Hytale och börja äventyret",
"playButton": "SPELA HYTALE",
"latestNews": "SENASTE NYHETERNA",
"viewAll": "VISA ALLA",
"checking": "KONTROLLERAR...",
"play": "SPELA"
},
"mods": {
"searchPlaceholder": "Sök moddar...",
"myMods": "MINA MODDAR",
"previous": "FÖREGÅENDE",
"next": "NÄSTA",
"page": "Sida",
"of": "av",
"modalTitle": "MINA MODDAR",
"noModsFound": "Inga moddar hittades",
"noModsFoundDesc": "Försök justera din sökning",
"noModsInstalled": "Inga moddar installerade",
"noModsInstalledDesc": "Lägg till moddar från CurseForge eller importera lokala filer",
"view": "VISA",
"install": "INSTALLERA",
"installed": "INSTALLERAD",
"enable": "AKTIVERA",
"disable": "INAKTIVERA",
"active": "AKTIV",
"disabled": "INAKTIVERAD",
"delete": "Ta bort modd",
"noDescription": "Ingen beskrivning tillgänglig",
"confirmDelete": "Är du säker på att du vill ta bort \"{name}\"?",
"confirmDeleteDesc": "Denna åtgärd kan inte ångras.",
"confirmDeletion": "Bekräfta borttagning",
"apiKeyRequired": "API-nyckel krävs",
"apiKeyRequiredDesc": "CurseForge API-nyckel behövs för att bläddra bland moddar"
},
"news": {
"title": "ALLA NYHETER",
"readMore": "Läs mer"
},
"chat": {
"title": "SPELARCHATT",
"pickColor": "Färg",
"inputPlaceholder": "Skriv ditt meddelande...",
"send": "Skicka",
"online": "online",
"charCounter": "{current}/{max}",
"secureChat": "Säker chatt - Länkar är censurerade",
"joinChat": "Gå med i chatten",
"chooseUsername": "Välj ett användarnamn för att gå med i spelarchartten",
"username": "Användarnamn",
"usernamePlaceholder": "Ange ditt användarnamn...",
"usernameHint": "3-20 tecken, endast bokstäver, siffror, - och _",
"joinButton": "Gå med i chatten",
"colorModal": {
"title": "Anpassa användarnamnsfargen",
"chooseSolid": "Välj en enfärgad färg:",
"customColor": "Anpassad färg:",
"preview": "Förhandsvisning:",
"previewUsername": "Användarnamn",
"apply": "Använd färg"
}
},
"settings": {
"title": "INSTÄLLNINGAR",
"java": "Java Runtime",
"useCustomJava": "Använd anpassad Java-sökväg",
"javaDescription": "Ersätt den medföljande Java-installationen med din egen",
"javaPath": "Java-körbar fil-sökväg",
"javaPathPlaceholder": "Välj Java-sökväg...",
"javaBrowse": "Bläddra",
"javaHint": "Välj Java-installationsmappen (stöder Windows, Mac, Linux)",
"discord": "Discord-integration",
"enableRPC": "Aktivera Discord Rich Presence",
"discordDescription": "Visa din launcher-aktivitet på Discord",
"game": "Spelalternativ",
"playerName": "Spelarnamn",
"playerNamePlaceholder": "Ange spelarnamn",
"playerNameHint": "Detta namn kommer att användas i spelet (1-16 tecken)",
"openGameLocation": "Öppna spelplats",
"openGameLocationDesc": "Öppna spelinstallationsmappen",
"account": "Spelare UUID-hantering",
"currentUUID": "Nuvarande UUID",
"uuidPlaceholder": "Laddar UUID...",
"copyUUID": "Kopiera UUID",
"regenerateUUID": "Återskapa UUID",
"uuidHint": "Din unika spelaridentifierare för detta användarnamn",
"manageUUIDs": "Hantera alla UUID:er",
"manageUUIDsDesc": "Visa och hantera alla spelare-UUID:er",
"language": "Språk",
"selectLanguage": "Välj språk",
"repairGame": "Reparera spel",
"reinstallGame": "Ominstallera spelfiler (bevarar data)",
"gpuPreference": "GPU-preferens",
"gpuHint": "Välj din föredragna GPU (Linux: påverkar DRI_PRIME)",
"gpuAuto": "Auto",
"gpuIntegrated": "Integrerad",
"gpuDedicated": "Dedikerad",
"logs": "SYSTEMLOGGAR",
"logsCopy": "Kopiera",
"logsRefresh": "Uppdatera",
"logsFolder": "Öppna mapp",
"logsLoading": "Laddar loggar...",
"closeLauncher": "Launcher-beteende",
"closeOnStart": "Stäng launcher vid spelstart",
"closeOnStartDescription": "Stäng automatiskt launcher efter att Hytale har startats",
"hwAccel": "Hårdvaruacceleration",
"hwAccelDescription": "Aktivera hårdvaruacceleration för launchern",
"gameBranch": "Spelgren",
"branchRelease": "Release",
"branchPreRelease": "Pre-Release",
"branchHint": "Växla mellan stabil release- och experimentell pre-release-version",
"branchWarning": "Att byta gren kommer att ladda ner och installera en annan spelversion",
"branchSwitching": "Byter till {branch}...",
"branchSwitched": "Bytte framgångsrikt till {branch}!",
"installRequired": "Installation krävs",
"branchInstallConfirm": "Spelet kommer att installeras för {branch}-grenen. Fortsätt?"
},
"uuid": {
"modalTitle": "UUID-hantering",
"currentUserUUID": "Nuvarande användar-UUID",
"allPlayerUUIDs": "Alla spelare-UUID:er",
"generateNew": "Generera ny UUID",
"loadingUUIDs": "Laddar UUID:er...",
"setCustomUUID": "Ange anpassad UUID",
"customPlaceholder": "Ange anpassad UUID (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
"setUUID": "Ange UUID",
"warning": "Varning: Att ange en anpassad UUID kommer att ändra din nuvarande spelaridentitet",
"copyTooltip": "Kopiera UUID",
"regenerateTooltip": "Generera ny UUID"
},
"profiles": {
"modalTitle": "Hantera profiler",
"newProfilePlaceholder": "Nytt profilnamn",
"createProfile": "Skapa profil"
},
"discord": {
"notificationText": "Gå med i vår Discord-gemenskap!",
"joinButton": "Gå med i Discord"
},
"common": {
"confirm": "Bekräfta",
"cancel": "Avbryt",
"save": "Spara",
"close": "Stäng",
"delete": "Ta bort",
"edit": "Redigera",
"loading": "Laddar...",
"apply": "Verkställ",
"install": "Installera"
},
"notifications": {
"gameDataNotFound": "Fel: Speldata hittades inte",
"gameUpdatedSuccess": "Spelet uppdaterades framgångsrikt! 🎉",
"updateFailed": "Uppdatering misslyckades: {error}",
"updateError": "Uppdateringsfel: {error}",
"discordEnabled": "Discord Rich Presence aktiverad",
"discordDisabled": "Discord Rich Presence inaktiverad",
"discordSaveFailed": "Misslyckades med att spara Discord-inställning",
"playerNameRequired": "Ange ett giltigt spelarnamn",
"playerNameSaved": "Spelarnamn sparat framgångsrikt",
"playerNameSaveFailed": "Misslyckades med att spara spelarnamn",
"uuidCopied": "UUID kopierad till urklipp!",
"uuidCopyFailed": "Misslyckades med att kopiera UUID",
"uuidRegenNotAvailable": "UUID-återgenerering ej tillgänglig",
"uuidRegenFailed": "Misslyckades med att återgenerera UUID",
"uuidGenerated": "Ny UUID genererad framgångsrikt!",
"uuidGeneratedShort": "Ny UUID genererad!",
"uuidGenerateFailed": "Misslyckades med att generera ny UUID",
"uuidRequired": "Ange en UUID",
"uuidInvalidFormat": "Ogiltigt UUID-format",
"uuidSetFailed": "Misslyckades med att ange anpassad UUID",
"uuidSetSuccess": "Anpassad UUID angiven framgångsrikt!",
"uuidDeleteFailed": "Misslyckades med att ta bort UUID",
"uuidDeleteSuccess": "UUID borttagen framgångsrikt!",
"modsDownloading": "Laddar ner {name}...",
"modsTogglingMod": "Växlar modd...",
"modsDeletingMod": "Tar bort modd...",
"modsLoadingMods": "Laddar moddar från CurseForge...",
"modsInstalledSuccess": "{name} installerad framgångsrikt! 🎉",
"modsDeletedSuccess": "{name} borttagen framgångsrikt",
"modsDownloadFailed": "Misslyckades med att ladda ner modd: {error}",
"modsToggleFailed": "Misslyckades med att växla modd: {error}",
"modsDeleteFailed": "Misslyckades med att ta bort modd: {error}",
"modsModNotFound": "Moddinformation hittades inte",
"hwAccelSaved": "Hårdvaruaccelerationsinställning sparad",
"hwAccelSaveFailed": "Misslyckades med att spara hårdvaruaccelerationsinställning"
},
"confirm": {
"defaultTitle": "Bekräfta åtgärd",
"regenerateUuidTitle": "Generera ny UUID",
"regenerateUuidMessage": "Är du säker på att du vill generera en ny UUID? Detta kommer att ändra din spelaridentitet.",
"regenerateUuidButton": "Generera",
"setCustomUuidTitle": "Ange anpassad UUID",
"setCustomUuidMessage": "Är du säker på att du vill ange denna anpassade UUID? Detta kommer att ändra din spelaridentitet.",
"setCustomUuidButton": "Ange UUID",
"deleteUuidTitle": "Ta bort UUID",
"deleteUuidMessage": "Är du säker på att du vill ta bort UUID:n för \"{username}\"? Denna åtgärd kan inte ångras.",
"deleteUuidButton": "Ta bort",
"uninstallGameTitle": "Avinstallera spel",
"uninstallGameMessage": "Är du säker på att du vill avinstallera Hytale? Alla spelfiler kommer att tas bort.",
"uninstallGameButton": "Avinstallera"
},
"progress": {
"initializing": "Initierar...",
"downloading": "Laddar ner...",
"installing": "Installerar...",
"extracting": "Extraherar...",
"verifying": "Verifierar...",
"switchingProfile": "Byter profil...",
"profileSwitched": "Profil bytt!",
"startingGame": "Startar spel...",
"launching": "STARTAR...",
"uninstallingGame": "Avinstallerar spel...",
"gameUninstalled": "Spel avinstallerat framgångsrikt!",
"uninstallFailed": "Avinstallation misslyckades: {error}",
"startingUpdate": "Startar obligatorisk speluppdatering...",
"installationComplete": "Installation slutförd framgångsrikt!",
"installationFailed": "Installation misslyckades: {error}",
"installingGameFiles": "Installerar spelfiler...",
"installComplete": "Installation slutförd!"
}
}

8
GUI/locales/tr-TR.json
View File

@@ -131,6 +131,8 @@
"closeLauncher": "Başlatıcı Davranışı",
"closeOnStart": "Oyun başlatıldığında Başlatıcıyı Kapat",
"closeOnStartDescription": "Hytale başlatıldıktan sonra başlatıcıyı otomatik olarak kapatın",
"hwAccel": "Donanım Hızlandırma",
"hwAccelDescription": "Başlatıcı için donanım hızlandırmasını etkinleştir",
"gameBranch": "Oyun Dalı",
"branchRelease": "Yayın",
"branchPreRelease": "Ön-Yayın",
@@ -207,7 +209,9 @@
"modsDownloadFailed": "Mod indirilemedi: {error}",
"modsToggleFailed": "Mod değiştirilemedi: {error}",
"modsDeleteFailed": "Mod silinemedi: {error}",
"modsModNotFound": "Mod bilgileri bulunamadı"
"modsModNotFound": "Mod bilgileri bulunamadı",
"hwAccelSaved": "Donanım hızlandırma ayarı kaydedildi",
"hwAccelSaveFailed": "Donanım hızlandırma ayarı kaydedilemedi"
},
"confirm": {
"defaultTitle": "Eylemi onayla",
@@ -243,4 +247,4 @@
"installingGameFiles": "Oyun dosyaları kuruluyor...",
"installComplete": "Kurulum tamamlandı!"
}
}
}

1260
GUI/style.css
View File

File diff suppressed because it is too large Load Diff

2
PKGBUILD
View File

@@ -10,6 +10,8 @@ url="https://github.com/amiayweb/Hytale-F2P"
license=('custom')
depends=('gtk3' 'nss' 'libxcrypt-compat')
makedepends=('npm')
provides=('Hytale-F2P-git' 'hytale-f2p-git')
conflicts=('Hytale-F2P-git' 'hytale-f2p-git')
source=("$url/archive/v$pkgver.tar.gz" "Hytale-F2P.desktop")
sha256sums=('SKIP' '46488fada4775d9976d7b7b62f8d1f1f8d9a9a9d8f8aa9af4f2e2153019f6a30')

14
PKGBUILD-git
View File

@@ -10,25 +10,25 @@ url="https://github.com/amiayweb/Hytale-F2P"
license=('custom')
depends=('gtk3' 'nss' 'libxcrypt-compat')
makedepends=('git' 'npm')
provides=('Hytale-F2P' 'hytale-f2p-git')
conflicts=('Hytale-F2P' 'hytale-f2p-git')
source=("git+$url.git" "$_pkgname.desktop")
sha256sums=('SKIP' '46488fada4775d9976d7b7b62f8d1f1f8d9a9a9d8f8aa9af4f2e2153019f6a30')
pkgver() {
cd "$srcdir/$_pkgname"
cd "$_pkgname"
git describe --tags --long | sed 's/^v//;s/-/.r/;s/-/./'
}
build() {
cd "$srcdir/$_pkgname"
cd "$_pkgname"
npm ci
npm run build:arch
}
package() {
cd "$srcdir/$_pkgname"
install -d "$pkgdir/opt/$_pkgname"
mkdir -p "$pkgdir/opt/$_pkgname"
cp -r "$_pkgname/dist/linux-unpacked/"* "$pkgdir/opt/$_pkgname"
install -Dm644 "$srcdir/$_pkgname.desktop" "$pkgdir/usr/share/applications/$_pkgname.desktop"
install -Dm644 GUI/icon.png "$pkgdir/usr/share/icons/hicolor/256x256/apps/$_pkgname.png"
install -Dm644 "$_pkgname.desktop" "$pkgdir/usr/share/applications/$_pkgname.desktop"
install -Dm644 "$_pkgname/GUI/icon.png" "$pkgdir/usr/share/icons/hicolor/256x256/apps/$_pkgname.png"
}

66
README.md
View File

@@ -4,9 +4,10 @@
<h1>🎮 Hytale F2P Launcher 🚀</h1>
<h2>💻 Cross-Platform Multiplayer 🖥️</h2>
<h3>Available for Windows 🪟, macOS 🍎, and Linux 🐧</h3>
<p><small>An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support (all OS supported)</small></p>
<p><small>An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support!</small></p>
</header>
![GitHub Downloads](https://img.shields.io/github/downloads/amiayweb/Hytale-F2P/total?style=for-the-badge)
![Version](https://img.shields.io/badge/Version-2.1.1-green?style=for-the-badge)
![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-orange?style=for-the-badge)
![License](https://img.shields.io/badge/License-Educational-blue?style=for-the-badge)
@@ -16,7 +17,7 @@
⭐ **If you find this project useful, please give it a STAR!** ⭐
### ⚠️ **READ [QUICK START](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-quick-start) before Downloading & Installing the Launcher!** ⚠️
### ⚠️ **READ [QUICK START](README.md#-quick-start) before Downloading & Installing the Launcher!** ⚠️
#### 🛑 **Found a problem? Join the Discord and Select #Open-A-Ticket!: https://discord.gg/gME8rUy3MB** 🛑
@@ -118,9 +119,9 @@
<tr>
<td><b>🖥️ OS</b></td>
<td colspan="3" align="center">
Windows 10/11 (64-bit; X64/ARM64) | Linux (x64/ARM64) | macOS (Apple Silicon only)
Windows 10/11 (64-bit X64) | Linux (x64) | macOS (ARM64/Apple Silicon)
<br />
<small><i>⚠️ Note: macOS Intel (x86) is not yet supported <sup><a href="#fn1" id="ref1">1</a></sup></i></small>
<small><i>⚠️ Note: ARM64 (Windows & Linux), macOS (x86/Intel) <b>are not supported!</b> ⚠️</i></small>
</td>
</tr>
<tr>
@@ -131,7 +132,7 @@
</tr>
<tr>
<td><b>🧠 RAM</b></td>
<td>8GB (dGPU)<sup><a href="#fn1" id="ref2">2</a></sup> /<br>12GB (iGPU)<sup><a href="#fn1" id="ref3">3</a></sup></td>
<td>8GB (dGPU) / 12GB (iGPU)<sup><a href="#fn1" id="ref1">1</a></sup></td>
<td>16 GB</td>
<td>32 GB</td>
</tr>
@@ -156,31 +157,28 @@
</tbody>
</table>
</div>
<p id="fn1"><sup>Note 1</sup> Hytale did not provide game files for macOS Intel, yet.</p>
<p id="fn2"><sup>Note 2</sup> Using Discrete/Dedicated GPU (dGPU) must have 8 GB RAM minimum.</p>
<p id="fn3"><sup>Note 3</sup> Using Integrated GPU (dGPU) must have 12 GB RAM minimum.</p>
<p id="fn1"><sup>Note 1</sup> Using Discrete/Dedicated GPU (dGPU) must have 8 GB RAM minimum, while using Integrated GPU (iGPU) must have 12 GB RAM.</p>
> [!WARNING]
> Our launcher has **not yet** supported Offline Mode (playing Hytale without internet).
> We will surely add the feature as soon as possible. Kindly wait for the update.
---
### 🪟 Windows Prequisites
* **
* **Java JDK 25:**
* [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows), **no** support for Windows ARM64 in both version 25 and 21.
* [Adoptium](https://adoptium.net/temurin/releases/?version=25), has Windows ARM64 support in version 21 only.
* [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows)
* [Adoptium](https://adoptium.net/temurin/releases/?version=25)
* [Microsoft](https://learn.microsoft.com/en-us/java/openjdk/download), has Windows ARM64 support in version 25.
* Download from any vendor if your OS is not Windows with ARM64 architecture.
* **Latest Visual Studio Redist:**
* Download via [Microsoft Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe)
* Or [All-in-One by Techpowerup](https://www.techpowerup.com/download/visual-c-redistributable-runtime-package-all-in-one/)
### 🐧 Linux Prequisites
> [!WARNING]
> Ubuntu-based Distro like ZorinOS or Pop!_OS or Linux Mint would encounter issues due to UbuntuLTS environment, [check this Discord post](https://discord.com/channels/1462260103951421493/1463662398501027973).
* Make sure you have already installed newest **GPU driver**, consult your distro docs or wiki.
* Install `libpng` package to avoid SDL3_Image error:
* Make sure you have already installed newest **GPU driver** especially proprietary NVIDIA, consult your distro docs or wiki.
* Also make sure that your GPU can be connected to EGL, try checking it first (again, consult your distro docs or wiki) before installing Hytale game via our launcher.
* Install `libpng` package to avoid `SDL3_Image` error:
* `libpng16-16 libpng-dev` for Ubuntu/Debian-based Distro
* `libpng libpng-devel` for Fedora/RHEL-based Distro
* `libpng` for Arch-based Distro
@@ -194,11 +192,12 @@
1. **Prerequisites:** Ensure you have installed all [**Windows Prerequisites**](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-windows-prequisites) listed above.
2. **Download:** Get the latest `Hytale-F2P-Launcher.exe` from the [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/) page.
3. **SmartScreen Note:** Since the executable is currently unsigned, Windows may show a "Windows protected your PC" popup.
* Click **More info**.
* Click **Run anyway**.
* Click **More info**, then click **Run anyway**.
4. **Launch:** Once installed, you can launch the app directly from your Desktop or the Start menu.
---
5. **Whitelist in Windows Firewall** [#192](https://github.com/amiayweb/Hytale-F2P/issues/192#issuecomment-3803042908)
* Open the Windows Start Menu and search for `Allow an app through Windows Firewall`
* Click "Change settings" (you may need Admin privileges) and Locate `HytaleClient.exe` in the list.
* Ensure both the Private and Public checkboxes are checked. Click OK to save.
### 🐧 Linux Installation
@@ -243,8 +242,6 @@
* **Desktop Entry:** After installing via `.rpm`, `.deb`, or `.pkg.tar.zst`, the launcher should automatically appear in your App Library/Grid.
* Missing libxcrypt.so.1: Install `libxcrypt-compat` using your package manager
---
### 🍎 macOS Installation
> [!NOTE]
@@ -272,9 +269,9 @@ The `.zip` version is useful for users who prefer a portable installation or nee
---
# How to Host a Server
# 📢 How to Host a Server
## Host your Singleplayer Server (Online-Play Feature)
## 🌐 Host your Singleplayer Server (Online-Play Feature)
> [!NOTE]
> You have to play the game to host the server. See Dedicated Server section below if you want to host it without you playing as the host.
@@ -283,23 +280,29 @@ The `.zip` version is useful for users who prefer a portable installation or nee
2. Pause the game (Esc) > select Online Play > Turn on `Allow Other Players to Join` > Set password if needed > Press `Save`.
3. Check the status `Connected via STUN` or `Connected via UPnP`.
## Dedicated Server
## 🖧 Host a Dedicated Server
> [!NOTE]
> If you have already `HytaleServer.jar` in `HytaleF2P/{release/pre-release}/package/game/latest/Server`, you can use it to host local dedicated server.
> If you already have the patched `HytaleServer.jar` in `HytaleF2P/{release/pre-release}/package/game/latest/Server`, you can use it to host local dedicated server.
> [!TIP]
> Use services like Playit.gg, Tailscale, Radmin VPN to share UDP connection if setting up router as an admin is not possible.
> [!WARNING]
> `Hytale-F2P-Server.rar` file is needed to set up a server on non-playing hardware (such as VPS/server hosting).
> `Hytale-F2P-Server.rar` file is needed to set up a server on non-playing hardware (such as VPS/server hosting). Linux ARM64 is supported for server only.
> [!IMPORTANT]
> See detailed information of setting up a server here: [SERVER.md](SERVER.md)
> See detailed information of setting up a server here: [SERVER.md](SERVER.md). Download the latest patched JAR, the patched RAR, or the SH/BAT scripts from channel `#open-public-server` in our Discord Server.
---
## 🛠️ Building from Source
## 🔧 Troubleshooting
See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed Troubleshooting guide.
---
## 🔨 Building from Source
See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
@@ -409,6 +412,7 @@ See [BUILD.md](docs/BUILD.md) for comprehensive build instructions.
- [**@Citeli-py**](https://github.com/Citeli-py) - *Issues fixer*
- [**@Rahul-Sahani04**](https://github.com/Rahul-Sahani04) - *Issues fixer*
- [**@xSamiVS**](https://github.com/xSamiVS) - *Language Translator*
- [**@BlackSystemCoder**](https://github.com/BlackSystemCoder) - *Language Translator*
---

139
SERVER.md
View File

@@ -1,34 +1,79 @@
# Hytale F2P Server Guide
# 🎮 Hytale F2P Server Guide
Play with friends online! This guide covers both easy in-game hosting and advanced dedicated server setup.
DOWNLOAD SERVER FILES HERE: https://discord.gg/MEyWUxt77m
### **DOWNLOAD SERVER FILES (JAR/RAR/SCRIPTS) HERE: https://discord.gg/MEyWUxt77m**
**Table of Contents**
* [A. Host your Singleplayer World](SERVER.md#1-host-your-singleplayer-world-to-your-friends-online-play-feature)
* [1. Using In-Game Invite Code / Online Play Feature]()
* [Common Issues (UPnP/NAT/STUN) on Online Play](SERVER.md#common-issues-upnpnatstun-on-online-play)
* [2. Using Playit.gg \[Recommended\]]()
* [3. Using Radmin VPN]()
* [B. Dedicated Server]
* [1. ]
---
### "Server" Term and Definiton
"HytaleServer.jar", which called as "Server", functions as the place of authentication of the client that supposed to go to Hytale Official Authentication System but we managed our way to redirect it on our service (sanasol.ws), handling approximately thousands of users to play this game for free to worldwide players.
Kindly support us via [our Buy Me a Coffee link](https://buymeacoffee.com/hf2p) if you think our launcher took a big part of developing this Hytale community for the love of the game itself.
**We will always advertise, always pushing, and always asking, to every users of this launcher to purchase the original game to help the official development of Hytale**.
### Server Directory Location
Here are the directory locations of Server folder if you have installed
- **Windows:** `%localappdata%\HytaleF2P\release\package\game\latest\Server`
- **macOS:** `~/Library/Application Support/HytaleF2P/release/package/game/latest/Server`
- **Linux:** `~/.hytalef2p/release/package/game/latest/Server`
> [!NOTE]
> This location only exists if the user installed the game using our launcher. The `Server` folder needed to auth the HytaleClient to play Hytale online
> (for now; we planned to add offline mode in later version of our launcher).
> [!IMPORTANT]
> Hosting a dedicated Hytale server will not need the exact similar tree. You can put it anywhere, as long as the directory has `Assets.zip` which
> can be acquired from our launcher via our `HytaleServer.rar` server file (which contains patched `HytaleServer.jar`, `Assets.zip`, and `run_server` scripts in `.sh & .bat`.
---
## Part 1: Playing with Friends (Online Play)
# Host
## 1 - Host your Singleplayer World to your friends (Online Play Feature)
The easiest way to play with friends - no manual server setup required!
*The game automatically handles networking using UPnP/STUN/NAT traversal.*
### How It Works
1. **Start the game** via F2P Launcher
2. **Click "Online Play"** in the main menu
3. **Share the invite code** with your friends
4. Friends enter your invite code to join
The game automatically handles networking using UPnP/STUN/NAT traversal.
### Network Requirements
For Online Play to work, you need:
**For Online Play to work, you need:**
- **UPnP enabled** on your router (most routers have this on by default)
- **Public IP address** from your ISP (not behind CGNAT)
### Common Issues
> [!TIP]
> Hoster need to make sure that the router can use UPnP: read router docs, wiki, or watch Youtube tutorials.
>
> If you encounter any problem, check Common Issues section below
#### "NAT Type: Carrier-Grade NAT (CGNAT)" Warning
1. Press **Worlds** on the Main Menu.
2. Select which world you want to play with your friend.
3. Once you get in the world, press **ESC**/Pause the game.
4. Press **Online Play** in the Pause Menu.
5. Set option "Allow Other Players to Join" from OFF to **ON**. You can set Password if you want.
6. Press **Save**, the Invite Code will appear.
7. Press **Copy to Clipboard** and **Share the Invite Code** to your friends!
8. Friends: Press **Servers** in the Main Menu > Press **Join via Code** > Paste the Code > Join.
> [!WARNING]
> If other players can't join the Hoster with error: `Failed to connect to any available address. The host may be offline or behind a strict firewall.`
>
> **AND ALSO** the Hoster "Online Play" menu shows `Connected to STUN - NAT Type: Restricted (No UPnP)`,
>
> this means the Online Play is **unavailable** on the Hoster machine, and it is neccessary to use services to host your world. **We recommend Playit.gg!**
### Common Issues (UPnP/NAT/STUN) on Online Play
<details><summary><b>1) "NAT Type: Carrier-Grade NAT (CGNAT)" Warning</b></summary>
If you see this message:
```
@@ -40,14 +85,13 @@ Warning: Your network configuration may prevent other players from connecting.
**What this means:** Your ISP doesn't give you a public IP address. Multiple customers share one public IP, which blocks incoming connections.
**Solutions:**
1. **Contact your ISP** - Request a public/static IP address (may cost extra)
2. **Use a VPN with port forwarding** - Services like Mullvad, PIA, or AirVPN offer this
3. **Use Radmin VPN or Playit.gg** - Create a virtual LAN with friends (see below)
3. **Use Playit.gg / Tailscale / Radmin VPN** - Create a virtual LAN with friends (see below)
4. **Have a friend with public IP host instead**
</details>
#### "UPnP Failed" or "Port Mapping Failed"
<details><summary><b>2) "UPnP Failed" or "Port Mapping Failed" Warning</b></summary>
**Check your router:**
1. Log into router admin panel (usually `192.168.1.1` or `192.168.0.1`)
2. Find UPnP settings (often under "Advanced" or "NAT")
@@ -56,23 +100,49 @@ Warning: Your network configuration may prevent other players from connecting.
**If UPnP isn't available:**
- Manually forward **port 5520 UDP** to your computer's local IP
- See "Port Forwarding" section below
#### "Strict NAT" or "Symmetric NAT"
- See "Port Forwarding" or "Workarounds or NAT/CGNAT" sections below
</details>
<details><summary><b>3) "Strict NAT" or "Symmetric NAT" Warning</b></summary>
Some routers have restrictive NAT that blocks peer connections.
**Try:**
1. Enable "NAT Passthrough" or "NAT Filtering: Open" in router settings
2. Put your device in router's DMZ (temporary test only)
3. Use Radmin VPN as workaround
3. Use Playit.gg / Tailscale / Radmin VPN as workaround
</details>
### Workarounds for NAT/CGNAT Issues
#### Option 1: playit.gg (Recommended)
#### Option 1: Playit.gg (Recommended) ✔️
Free tunneling service - only the host needs to install it:
1. Go to https://playit.gg/login and **Log In** with your existing account, **Create Account** if you don't have one
2. Press "Add a tunnel" > Select `UDP` > Tunnel description of `Hytale Server` > Port count `1` > and Local Port `5520`
3. Press **Start the tunnel** (or you can just run the Playit.gg.EXE if you already installed it on your machine) - You'll get a public address like `xx-xx.gl.at.ply.gg:5520`
4. Go to https://playit.gg/download : `Installer` (Windows) or `x86-64` (Linux) or follow `Debian Install Script` (Debian-based only)
* Windows: Install the `playit-windows.msi`
* Linux:
* Right-click file > Properties > Turn on 'Executable as a Program' | or just do `chmod +x playit-linux-amd64` on terminal
* Run by double-clicking the file or `./playit-linux-amd64` via terminal
5. Open Playit.gg > Copy (select the URL, then Right-Click | `Ctrl+Shift+C` for Linux) > Paste the prompted URL into your browser to link your created account
6. **WARNING: Do not close the terminal if you are still playing or hosting the server**
7.
8. Now you can use the public address that written in the playit.gg exe/you can check via browser [look at step 3]
9. Download the `run_server_with_tokens` script file (`.BAT` for Windows, `.SH` for Linux) from our Discord server > channel `#open-public-server`
10. Put the script file to the `Server` folder in `HytaleF2P` directory (`%localappdata%\HytaleF2P\release\package\game\latest\Server`)
11. Copy the `Assets.zip` from the `%localappdata%\HytaleF2P\release\package\game\latest\` folder to the `Server\` folder
12. double-click the .BAT file to host your server, wait until it shows like
```
===================================================
Hytale Server Booted! [Multiplayer, Fresh Universe]
===================================================
```
12. You connect to the server by go to `Servers` in your game client, and add server, type `localhost` in the address box, use any name for your server, `my server` for example.
13. Send the public address in step 3 to your friends, use `add server` also.
14. enjoy :smile:
1. **Download [playit.gg](https://playit.gg/)** and run it - Connect your account from the terminal (do not close it when playing on the server)
2. **Add a tunnel** - Select "UDP", tunnel description of "Hytale Server", port count `1`, and local port `5520`
3. **Start the tunnel** - You'll get a public address like `xx-xx.gl.at.ply.gg:5520`
@@ -98,13 +168,13 @@ It creates mesh VPN service that streamlines connecting devices and services sec
[Once installed, Tailwind starts and live inside your hidden icon section in Windows, Mac and Linux]
2. Create a **common tailscale** account which will shared among your friends to log in.
3. Ask your **host to login in to thier tailscale client first**, then the other members.
##### Host
1. Open your singleplayer world
2. Go to Online Play settings
3. Re-save your settings to generate a new share code
##### Friends
1. Ensure Tailscale is connected
2. Use the new share code to connect
* Host
* Open your singleplayer world
* Go to Online Play settings
* Re-save your settings to generate a new share code
* Friends
* Ensure Tailscale is connected
* Use the new share code to connect
[To test your connection, ping the host's ipv4 mentioned in tailwind]
---
@@ -457,3 +527,4 @@ JVM_XMX=8G \
- Hytale F2P Project
- [Hybrowse Docker Image](https://github.com/Hybrowse/hytale-server-docker)
- Auth Server: sanasol.ws

460
TROUBLESHOOTING.md Normal file
View File

@@ -0,0 +1,460 @@
# Hytale F2P Launcher - Troubleshooting Guide
This guide covers common issues and their solutions. If your issue isn't listed here, please check [existing issues](https://github.com/amiayweb/Hytale-F2P/issues) or join our [Discord](https://discord.gg/gME8rUy3MB).
---
## Table of Contents
- [Windows Issues](#windows-issues)
- [Linux Issues](#linux-issues)
- [macOS Issues](#macos-issues)
- [Connection & Server Issues](#connection--server-issues)
- [Authentication & Token Issues](#authentication--token-issues)
- [Avatar & Cosmetics Issues](#avatar--cosmetics-issues)
- [General Issues](#general-issues)
- [Known Limitations](#known-limitations)
---
## Windows Issues
### "Failed to connect to server" / Server won't boot
**Symptoms:** Singleplayer world fails to load, "Server failed to boot" error.
**Solution - Whitelist in Windows Firewall:**
1. Open **Windows Settings** > **Privacy & Security** > **Windows Security**
2. Click **Firewall & network protection** > **Allow an app through firewall**
3. Click **Change settings**
4. Find `HytaleClient.exe` and check both **Private** and **Public**
5. If not listed, click **Allow another app** and browse to:
```
%localappdata%\HytaleF2P\release\package\game\latest\Client\HytaleClient.exe
```
### Duplicate mod error
**Symptoms:** `java.lang.IllegalArgumentException: Tried to load duplicate plugin`
**Solution:**
1. Navigate to your mods folder:
```
%localappdata%\HytaleF2P\release\package\game\latest\Client\UserData\Mods
```
2. Remove any duplicate `.jar` files
3. Restart the launcher
### SmartScreen blocks the launcher
**Solution:**
1. Click **More info**
2. Click **Run anyway**
---
## Linux Issues
### GPU not detected / Using software rendering (llvmpipe)
**Symptoms:**
- Game uses integrated GPU instead of dedicated GPU
- Very low FPS / unplayable performance
- Play button not clickable
- Log shows `llvmpipe` instead of your GPU
**Solution for NVIDIA:**
```bash
__EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/10_nvidia.json ./HytaleF2P.AppImage
```
**Solution for AMD (hybrid GPU systems):**
```bash
DRI_PRIME=1 ./HytaleF2P.AppImage
```
**Permanent fix - Create a launcher script:**
```bash
#!/bin/bash
export __EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/10_nvidia.json
export DRI_PRIME=1
./HytaleF2P.AppImage
```
**Note:** On some desktop systems with AMD iGPU + dGPU, the GPU selector may be inverted (selecting iGPU actually uses dGPU). Use whichever option works.
### SDL3_image / libpng errors
**Symptoms:**
- `DllNotFoundException: Unable to load shared library 'SDL3_image'`
- `libpng` related errors
- Game crashes on startup
**Solution - Install dependencies:**
**Fedora / RHEL:**
```bash
sudo dnf install libpng libpng-devel
```
**Debian / Ubuntu:**
```bash
sudo apt install libpng16-16 libpng-dev libgdiplus libc6-dev
```
**Arch Linux:**
```bash
sudo pacman -S libpng
```
**Alternative - Replace corrupted library:**
```bash
cd ~/.hytalef2p/release/package/game/latest/Client/
mv libSDL3_image.so libSDL3_image.so.bak
wget https://github.com/user-attachments/files/24710966/libSDL3_image.zip
unzip libSDL3_image.zip
chmod 644 libSDL3_image.so
rm libSDL3_image.zip
```
### AppImage won't launch / FUSE error
**Solution:**
```bash
# Debian/Ubuntu
sudo apt install libfuse2
# Fedora
sudo dnf install fuse
# Arch
sudo pacman -S fuse2
```
### Missing libxcrypt.so.1
**Solution:**
```bash
# Fedora/RHEL
sudo dnf install libxcrypt-compat
# Arch
sudo pacman -S libxcrypt-compat
```
### Wayland display issues
**Symptoms:** Game doesn't launch, stuck at loading, or display glitches on Wayland.
**Solution - Force X11:**
```bash
GDK_BACKEND=x11 ./HytaleF2P.AppImage
```
**Alternative - Electron Wayland hint:**
```bash
ELECTRON_OZONE_PLATFORM_HINT=auto ./HytaleF2P.AppImage
```
### Steam Deck / Gamescope issues
**Solution 1 - Add custom launch options in Steam:**
```
ELECTRON_OZONE_PLATFORM_HINT=x11 %command%
```
**Solution 2 - Launch from Desktop Mode** instead of Game Mode.
**Solution 3 - Force X11:**
```bash
GDK_BACKEND=x11 ./HytaleF2P.AppImage
```
### Ubuntu LTS-based distros (Linux Mint, Zorin OS, Pop!_OS)
These distributions may have compatibility issues due to older system packages. This is a limitation of the Hytale game client, not the launcher.
**Workarounds:**
1. Install all dependencies listed above
2. Try the SDL3_image replacement
3. Consider using a more recent distribution or Flatpak/AppImage with bundled dependencies
---
## macOS Issues
### "Butler system error -86" (Apple Silicon)
**Symptoms:** `Butler execution failed: spawn Unknown system error -86` (EXC_BAD_CPU_TYPE)
**Cause:** Butler (the update tool) is x86_64 only.
**Solution - Install Rosetta 2:**
```bash
softwareupdate --install-rosetta
```
Then restart the launcher.
### Auto-update fails with code signature error
**Symptoms:**
```
Code signature at URL did not pass validation
domain: 'SQRLCodeSignatureErrorDomain'
```
**Solution - Manual update:**
1. Download the latest version manually from [Releases](https://github.com/amiayweb/Hytale-F2P/releases/latest)
2. Backup your data first (see [Backup Locations](#backup-locations))
3. Install the fresh download
### "Unidentified developer" warning
**Solution:**
1. Open **System Settings** > **Privacy & Security**
2. Scroll to **Security** section
3. Find the message about "Hytale F2P Launcher"
4. Click **Open Anyway**
5. Authenticate and click **Open**
### App won't open (quarantine)
**Solution:**
```bash
xattr -rd com.apple.quarantine /Applications/Hytale-F2P-Launcher.app
```
---
## Connection & Server Issues
### "Failed to connect to server" in Singleplayer
**Possible causes:**
1. Windows Firewall blocking (see [Windows section](#failed-to-connect-to-server--server-wont-boot))
2. Patched server JAR download failed
3. Regional network restrictions
**Solution - Check patched JAR:**
1. Look for `HytaleServer.jar` in:
- Windows: `%localappdata%\HytaleF2P\release\package\game\latest\Server\`
- Linux: `~/.hytalef2p/release/package/game/latest/Server/`
- macOS: `~/Library/Application Support/HytaleF2P/release/package/game/latest/Server/`
2. If missing or very small, the download may have failed
**Solution - Regional restrictions:**
Some countries (Russia, Turkey, Indonesia, etc.) may have issues accessing download servers.
- Try using a VPN for the initial download
- Once downloaded, the patched JAR is cached locally
### "Infinite Booting Server" / Server stuck loading
**Solution:**
1. Check if the patched JAR downloaded successfully (see above)
2. Ensure your GPU meets minimum requirements
3. Check launcher logs for specific errors
4. Try with a VPN if in a restricted region
### "Connection timed out from inactivity"
**This is expected behavior.** Sessions have a 10-hour TTL and will timeout after extended inactivity. Simply reconnect to continue playing.
---
## Authentication & Token Issues
### "Invalid identity token" / "Failed to start Hytale"
**Solution:**
1. **Restart the launcher** - This fetches fresh tokens
2. **Check system time** - JWT validation requires accurate system time
3. **Clear cached tokens:**
- Delete `config.json` from your HytaleF2P folder
- Restart the launcher
- Re-enter your username
**Locations:**
- Windows: `%localappdata%\HytaleF2P\config.json`
- Linux: `~/.hytalef2p/config.json`
- macOS: `~/Library/Application Support/HytaleF2P/config.json`
### Token refresh errors
If you see issuer mismatch errors in logs:
1. Delete `config.json` and `player_id.json`
2. Restart the launcher
3. This forces a fresh authentication
---
## Avatar & Cosmetics Issues
### Avatar/skin changes not saving
**This is a known F2P limitation:**
- F2P mode has no password protection for usernames
- Anyone can use any username
- Cosmetics are stored server-side by username
- If someone else uses your username, they can change your cosmetics
**Workaround:** Use a unique username that others are unlikely to choose.
### Character invisible / Customization crashes
**Solution:**
1. Use **Repair Game** in launcher Settings
2. Verify `Assets.zip` exists in your game folder
3. Clear cached assets:
- Windows: Delete `%localappdata%\HytaleF2P\release\package\game\latest\Client\UserData\CachedAssets\`
4. Restart the launcher
### Avatar creator shows "Offline Mode"
**Cause:** Cannot connect to auth server.
**Solution:**
1. Check your internet connection
2. Test connectivity: Open `https://auth.sanasol.ws/health` in browser (should show "OK")
3. Check if firewall is blocking the connection
4. Try disabling VPN (or enabling one if in restricted region)
---
## General Issues
### Mods not showing up
**Solution:**
1. Ensure mods are placed in the correct folder:
- Windows: `%localappdata%\HytaleF2P\release\package\game\latest\Client\UserData\Mods\`
- Linux: `~/.hytalef2p/release/package/game/latest/Client/UserData/Mods/`
- macOS: `~/Library/Application Support/HytaleF2P/release/package/game/latest/Client/UserData/Mods/`
2. Verify mod files are `.jar` format
3. Check launcher logs for mod loading errors
### Game updates delete configurations/mods
**This is a known issue being worked on.**
**Prevention - Always backup before updating:**
- Server configs and worlds
- Mods folder
- `config.json` and `player_id.json`
See [Backup Locations](#backup-locations) below.
### Play button not clickable
Usually caused by GPU detection failure. See [GPU not detected](#gpu-not-detected--using-software-rendering-llvmpipe).
**Alternative:**
1. Go to **Settings** > **Graphics**
2. Manually select your GPU
3. Restart the launcher
### Read timeout errors
**Cause:** Network connectivity issues.
**Solutions:**
1. Check your internet connection stability
2. Try using a VPN
3. Check firewall settings
4. Try at a different time (server load varies)
---
## Known Limitations
### Linux ARM64 not supported
Hytale does not provide ARM64 game client builds. The launcher downloads from official Hytale servers which only provide:
- Windows x64
- macOS (Universal/Intel)
- Linux x64
This is outside our control.
### F2P Username System
- No password protection for usernames
- Anyone can claim any username
- Cosmetics shared by username
- UUIDs generated based on username
A per-player password system is planned for future versions.
### Session Timeout
Game sessions have a 10-hour TTL. This is by design for security.
---
## Backup Locations
### Windows
```
%localappdata%\HytaleF2P\
├── config.json # Launcher settings
├── player_id.json # Player identity
└── release\package\game\latest\
├── Client\UserData\ # Saves, settings, mods
└── Server\
├── universe\ # World data
└── config.json # Server config
```
### Linux
```
~/.hytalef2p/
├── config.json
├── player_id.json
└── release/package/game/latest/
├── Client/UserData/
└── Server/
├── universe/
└── config.json
```
### macOS
```
~/Library/Application Support/HytaleF2P/
├── config.json
├── player_id.json
└── release/package/game/latest/
├── Client/UserData/
└── Server/
├── universe/
└── config.json
```
---
## Getting Help
If your issue isn't resolved by this guide:
1. **Check existing issues:** [GitHub Issues](https://github.com/amiayweb/Hytale-F2P/issues)
2. **Join Discord:** [discord.gg/gME8rUy3MB](https://discord.gg/gME8rUy3MB)
3. **Open a new issue** with:
- Your operating system and version
- Launcher version
- Full launcher logs from:
- Windows: `%localappdata%\HytaleF2P\logs\`
- Linux: `~/.hytalef2p/logs/`
- macOS: `~/Library/Application Support/HytaleF2P/logs/`
- Steps to reproduce the issue
---
## Logs Location
For bug reports, please include logs from:
| OS | Path |
|----|------|
| Windows | `%localappdata%\HytaleF2P\logs\` |
| Linux | `~/.hytalef2p/logs/` |
| macOS | `~/Library/Application Support/HytaleF2P/logs/` |

24
backend/core/config.js
View File

@@ -84,15 +84,6 @@ function loadUsername() {
return config.username || 'Player';
}
function saveChatUsername(chatUsername) {
saveConfig({ chatUsername: chatUsername || '' });
}
function loadChatUsername() {
const config = loadConfig();
return config.chatUsername || '';
}
function getUuidForUser(username) {
const { v4: uuidv4 } = require('uuid');
const config = loadConfig();
@@ -294,17 +285,6 @@ function resetCurrentUserUuid() {
return setUuidForUser(username, newUuid);
}
function saveChatColor(color) {
const config = loadConfig();
config.chatColor = color;
saveConfig(config);
}
function loadChatColor() {
const config = loadConfig();
return config.chatColor || '#3498db';
}
function saveGpuPreference(gpuPreference) {
saveConfig({ gpuPreference: gpuPreference || 'auto' });
}
@@ -343,10 +323,6 @@ module.exports = {
saveConfig,
saveUsername,
loadUsername,
saveChatUsername,
loadChatUsername,
saveChatColor,
loadChatColor,
getUuidForUser,
saveJavaPath,
loadJavaPath,

32
backend/core/paths.js
View File

@@ -14,6 +14,21 @@ function getAppDir() {
}
}
/**
* Get centralized UserData saves directory (NEW in 2.1.2)
* UserData is now stored separately from game installation
*/
function getHytaleSavesDir() {
const home = os.homedir();
if (process.platform === 'win32') {
return path.join(home, 'AppData', 'Local', 'HytaleSaves');
} else if (process.platform === 'darwin') {
return path.join(home, 'Library', 'Application Support', 'HytaleSaves');
} else {
return path.join(home, '.hytalesaves');
}
}
const DEFAULT_APP_DIR = getAppDir();
function getResolvedAppDir(customPath) {
@@ -218,20 +233,8 @@ async function getModsPath(customInstallPath = null) {
function getProfilesDir(customInstallPath = null) {
try {
// get UserData path
let installPath = customInstallPath;
if (!installPath) {
const configFile = path.join(DEFAULT_APP_DIR, 'config.json');
if (fs.existsSync(configFile)) {
const config = JSON.parse(fs.readFileSync(configFile, 'utf8'));
installPath = config.installPath || '';
}
}
if (!installPath) installPath = getAppDir();
const branch = loadVersionBranch();
const gameLatest = path.join(installPath, branch, 'package', 'game', 'latest');
const userDataPath = findUserDataPath(gameLatest);
// NEW 2.1.2: Use centralized UserData location
const userDataPath = getHytaleSavesDir();
const profilesDir = path.join(userDataPath, 'Profiles');
if (!fs.existsSync(profilesDir)) {
@@ -247,6 +250,7 @@ function getProfilesDir(customInstallPath = null) {
module.exports = {
getAppDir,
getHytaleSavesDir,
getResolvedAppDir,
expandHome,
APP_DIR,

7
backend/core/testConfig.js Normal file
View File

@@ -0,0 +1,7 @@
const FORCE_CLEAN_INSTALL_VERSION = false;
const CLEAN_INSTALL_TEST_VERSION = '4.pwr';
module.exports = {
FORCE_CLEAN_INSTALL_VERSION,
CLEAN_INSTALL_TEST_VERSION
};

15
backend/launcher.js
View File

@@ -5,10 +5,6 @@
const {
saveUsername,
loadUsername,
saveChatUsername,
loadChatUsername,
saveChatColor,
loadChatColor,
saveJavaPath,
loadJavaPath,
saveInstallPath,
@@ -20,10 +16,11 @@ const {
saveCloseLauncherOnStart,
loadCloseLauncherOnStart,
// Hardware Acceleration
saveLauncherHardwareAcceleration,
loadLauncherHardwareAcceleration,
loadConfig,
saveConfig,
saveModsToConfig,
loadModsFromConfig,
@@ -113,10 +110,6 @@ module.exports = {
// User configuration functions
saveUsername,
loadUsername,
saveChatUsername,
loadChatUsername,
saveChatColor,
loadChatColor,
getUuidForUser,
// Java configuration functions
@@ -144,6 +137,10 @@ module.exports = {
saveLauncherHardwareAcceleration,
loadLauncherHardwareAcceleration,
// Config functions
loadConfig,
saveConfig,
// GPU Preference functions
saveGpuPreference,
loadGpuPreference,

272
backend/managers/differentialUpdateManager.js Normal file
View File

@@ -0,0 +1,272 @@
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
};

74
backend/managers/gameLauncher.js
View File

@@ -10,8 +10,11 @@ const { setupWaylandEnvironment, setupGpuEnvironment } = require('../utils/platf
const { saveUsername, saveInstallPath, loadJavaPath, getUuidForUser, getAuthServerUrl, getAuthDomain, loadVersionBranch, loadVersionClient, saveVersionClient } = require('../core/config');
const { resolveJavaPath, getJavaExec, getBundledJavaPath, detectSystemJava, JAVA_EXECUTABLE } = require('./javaManager');
const { getLatestClientVersion } = require('../services/versionManager');
const { updateGameFiles } = require('./gameManager');
const { FORCE_CLEAN_INSTALL_VERSION, CLEAN_INSTALL_TEST_VERSION } = require('../core/testConfig');
const { ensureGameInstalled } = require('./differentialUpdateManager');
const { syncModsForCurrentProfile } = require('./modManager');
const { getUserDataPath } = require('../utils/userDataMigration');
const { syncServerList } = require('../utils/serverListSync');
// Client patcher for custom auth server (sanasol.ws)
let clientPatcher = null;
@@ -102,11 +105,21 @@ function generateLocalTokens(uuid, name) {
}
async function launchGame(playerName = 'Player', progressCallback, javaPathOverride, installPathOverride, gpuPreference = 'auto', branchOverride = null) {
// Synchronize server list on every game launch
try {
console.log('[Launcher] Synchronizing server list...');
await syncServerList();
} catch (syncError) {
console.warn('[Launcher] Server list sync failed, continuing launch:', syncError.message);
}
const branch = branchOverride || loadVersionBranch();
const customAppDir = getResolvedAppDir(installPathOverride);
const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
const userDataDir = path.join(customGameDir, 'Client', 'UserData');
// NEW 2.1.2: Use centralized UserData location
const userDataDir = getUserDataPath();
const gameLatest = customGameDir;
let clientPath = findClientPath(gameLatest);
@@ -282,6 +295,55 @@ exec "$REAL_JAVA" "\${ARGS[@]}"
const gpuEnv = setupGpuEnvironment(gpuPreference);
Object.assign(env, gpuEnv);
// Linux: Replace bundled libzstd.so with system version to fix glibc 2.41+ crash
// The bundled libzstd causes "free(): invalid pointer" on Steam Deck / Ubuntu LTS
if (process.platform === 'linux' && process.env.HYTALE_NO_LIBZSTD_FIX !== '1') {
const clientDir = path.dirname(clientPath);
const bundledLibzstd = path.join(clientDir, 'libzstd.so');
const backupLibzstd = path.join(clientDir, 'libzstd.so.bundled');
// Common system libzstd paths
const systemLibzstdPaths = [
'/usr/lib/libzstd.so.1', // Arch Linux, Steam Deck
'/usr/lib/x86_64-linux-gnu/libzstd.so.1', // Debian/Ubuntu
'/usr/lib64/libzstd.so.1' // Fedora/RHEL
];
let systemLibzstd = null;
for (const p of systemLibzstdPaths) {
if (fs.existsSync(p)) {
systemLibzstd = p;
break;
}
}
if (systemLibzstd && fs.existsSync(bundledLibzstd)) {
try {
const stats = fs.lstatSync(bundledLibzstd);
// Only replace if it's not already a symlink to system version
if (!stats.isSymbolicLink()) {
// Backup bundled version
if (!fs.existsSync(backupLibzstd)) {
fs.renameSync(bundledLibzstd, backupLibzstd);
console.log(`Linux: Backed up bundled libzstd.so`);
} else {
fs.unlinkSync(bundledLibzstd);
}
// Create symlink to system version
fs.symlinkSync(systemLibzstd, bundledLibzstd);
console.log(`Linux: Linked libzstd.so to system version (${systemLibzstd}) for glibc 2.41+ compatibility`);
} else {
const linkTarget = fs.readlinkSync(bundledLibzstd);
console.log(`Linux: libzstd.so already linked to ${linkTarget}`);
}
} catch (libzstdError) {
console.warn(`Linux: Could not replace libzstd.so: ${libzstdError.message}`);
}
}
}
try {
let spawnOptions = {
stdio: ['ignore', 'pipe', 'pipe'],
@@ -385,7 +447,13 @@ async function launchGameWithVersionCheck(playerName = 'Player', progressCallbac
const customCacheDir = path.join(customAppDir, 'cache');
try {
await updateGameFiles(latestVersion, progressCallback, customGameDir, customToolsDir, customCacheDir, branch);
let versionToInstall = latestVersion;
if (FORCE_CLEAN_INSTALL_VERSION && !installedVersion) {
versionToInstall = CLEAN_INSTALL_TEST_VERSION;
console.log(`TESTING MODE: Clean install detected, forcing version ${versionToInstall} instead of ${latestVersion}`);
}
await ensureGameInstalled(versionToInstall, branch, progressCallback, customGameDir, customCacheDir, customToolsDir);
console.log('Game updated successfully, patching will be forced on launch...');
if (progressCallback) {

164
backend/managers/gameManager.js
View File

@@ -5,13 +5,14 @@ const { getResolvedAppDir, findClientPath, findUserDataPath, findUserDataRecursi
const { getOS, getArch } = require('../utils/platformUtils');
const { downloadFile, retryDownload, retryStalledDownload, MAX_AUTOMATIC_STALL_RETRIES } = require('../utils/fileManager');
const { getLatestClientVersion, getInstalledClientVersion } = require('../services/versionManager');
const { FORCE_CLEAN_INSTALL_VERSION, CLEAN_INSTALL_TEST_VERSION } = require('../core/testConfig');
const { installButler } = require('./butlerManager');
const { downloadAndReplaceHomePageUI, downloadAndReplaceLogo } = require('./uiFileManager');
const { saveUsername, saveInstallPath, loadJavaPath, CONFIG_FILE, loadConfig, loadVersionBranch, saveVersionClient, loadVersionClient } = require('../core/config');
const { resolveJavaPath, detectSystemJava, downloadJRE, getJavaExec, getBundledJavaPath } = require('./javaManager');
const userDataBackup = require('../utils/userDataBackup');
const { getUserDataPath, migrateUserDataToCentralized } = require('../utils/userDataMigration');
async function downloadPWR(branch = 'release', fileName = '4.pwr', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
async function downloadPWR(branch = 'release', fileName = '7.pwr', progressCallback, cacheDir = CACHE_DIR, manualRetry = false) {
const osName = getOS();
const arch = getArch();
@@ -300,6 +301,16 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
fs.rmSync(stagingDir, { recursive: true, force: true });
}
// Delete PWR file from cache after successful installation
try {
if (fs.existsSync(pwrFile)) {
fs.unlinkSync(pwrFile);
console.log('[Butler] PWR file deleted from cache after successful installation:', pwrFile);
}
} catch (delErr) {
console.warn('[Butler] Failed to delete PWR file from cache:', delErr.message);
}
if (progressCallback) {
progressCallback('Installation complete', null, null, null, null);
}
@@ -308,31 +319,25 @@ async function applyPWR(pwrFile, progressCallback, gameDir = GAME_DIR, toolsDir
async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR, toolsDir = TOOLS_DIR, cacheDir = CACHE_DIR, branchOverride = null) {
let tempUpdateDir;
let backupPath = null;
const branch = branchOverride || loadVersionBranch();
const installPath = path.dirname(path.dirname(path.dirname(path.dirname(gameDir))));
// Vérifier si on a version_client et version_branch dans config.json
const config = loadConfig();
const hasVersionConfig = !!(config.version_client && config.version_branch);
const oldBranch = config.version_branch || 'release'; // L'ancienne branche pour le backup
console.log(`[UpdateGameFiles] hasVersionConfig: ${hasVersionConfig}`);
const oldBranch = config.version_branch || 'release';
console.log(`[UpdateGameFiles] Switching from ${oldBranch} to ${branch}`);
try {
if (progressCallback) {
progressCallback('Backing up user data...', 5, null, null, null);
}
// Backup UserData AVANT de télécharger/installer (critical for same-branch updates)
// NEW 2.1.2: Ensure UserData migration to centralized location
try {
console.log(`[UpdateGameFiles] Attempting to backup UserData from old branch: ${oldBranch}`);
backupPath = await userDataBackup.backupUserData(installPath, oldBranch, hasVersionConfig);
if (backupPath) {
console.log(`[UpdateGameFiles] ✓ UserData backed up from ${oldBranch}: ${backupPath}`);
console.log('[UpdateGameFiles] Ensuring UserData migration...');
const migrationResult = await migrateUserDataToCentralized();
if (migrationResult.migrated) {
console.log('[UpdateGameFiles] ✓ UserData migrated to centralized location');
} else if (migrationResult.alreadyMigrated) {
console.log('[UpdateGameFiles] ✓ UserData already in centralized location');
}
} catch (backupError) {
console.warn('[UpdateGameFiles] ✗ UserData backup failed:', backupError.message);
} catch (migrationError) {
console.warn('[UpdateGameFiles] UserData migration warning:', migrationError.message);
}
if (progressCallback) {
@@ -358,7 +363,15 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
}
await applyPWR(pwrFile, progressCallback, tempUpdateDir, toolsDir, branch, cacheDir);
// Delete PWR file from cache after successful update
try {
if (fs.existsSync(pwrFile)) {
fs.unlinkSync(pwrFile);
console.log('[UpdateGameFiles] PWR file deleted from cache after successful update:', pwrFile);
}
} catch (delErr) {
console.warn('[UpdateGameFiles] Failed to delete PWR file from cache:', delErr.message);
}
if (progressCallback) {
progressCallback('Replacing game files...', 80, null, null, null);
}
@@ -390,31 +403,9 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
const logoResult = await downloadAndReplaceLogo(gameDir, progressCallback);
console.log('Logo@2x.png update result after update:', logoResult);
// Ensure UserData directory exists
const userDataDir = path.join(gameDir, 'Client', 'UserData');
if (!fs.existsSync(userDataDir)) {
console.log(`[UpdateGameFiles] Creating UserData directory at: ${userDataDir}`);
fs.mkdirSync(userDataDir, { recursive: true });
}
if (progressCallback) {
progressCallback('Restoring user data...', 90, null, null, null);
}
// Restore UserData using new system
if (backupPath) {
try {
console.log(`[UpdateGameFiles] Restoring UserData from ${oldBranch} to ${branch}`);
console.log(`[UpdateGameFiles] Source backup: ${backupPath}`);
await userDataBackup.restoreUserData(backupPath, installPath, branch);
await userDataBackup.cleanupBackup(backupPath);
console.log(`[UpdateGameFiles] ✓ UserData migrated successfully from ${oldBranch} to ${branch}`);
} catch (restoreError) {
console.warn('[UpdateGameFiles] ✗ UserData restore failed:', restoreError.message);
}
} else {
console.log('[UpdateGameFiles] No backup to restore, empty UserData folder created');
}
// NEW 2.1.2: No longer create UserData in game installation
// UserData is now in centralized location (getUserDataPath())
console.log('[UpdateGameFiles] UserData is managed in centralized location');
console.log(`Game files updated successfully to version: ${newVersion}`);
@@ -434,15 +425,6 @@ async function updateGameFiles(newVersion, progressCallback, gameDir = GAME_DIR,
} catch (error) {
console.error('Error updating game files:', error);
if (backupPath) {
try {
await userDataBackup.cleanupBackup(backupPath);
console.log('UserData backup cleaned up after error');
} catch (cleanupError) {
console.warn('Could not clean up UserData backup:', cleanupError.message);
}
}
if (tempUpdateDir && fs.existsSync(tempUpdateDir)) {
fs.rmSync(tempUpdateDir, { recursive: true, force: true });
}
@@ -470,28 +452,18 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
const customToolsDir = path.join(customAppDir, 'butler');
const customGameDir = path.join(customAppDir, branch, 'package', 'game', 'latest');
const customJreDir = path.join(customAppDir, branch, 'package', 'jre', 'latest');
const userDataDir = path.join(customGameDir, 'Client', 'UserData');
// Vérifier si on a version_client et version_branch dans config.json
const config = loadConfig();
const hasVersionConfig = !!(config.version_client && config.version_branch);
console.log(`[InstallGame] Configuration detected - version_client: ${config.version_client}, version_branch: ${config.version_branch}`);
console.log(`[InstallGame] hasVersionConfig: ${hasVersionConfig}`);
// Backup UserData AVANT l'installation si nécessaire
let backupPath = null;
if (progressCallback) {
progressCallback('Checking for existing UserData...', 5, null, null, null);
}
// NEW 2.1.2: Ensure UserData migration to centralized location
try {
console.log(`[InstallGame] Attempting UserData backup (hasVersionConfig: ${hasVersionConfig})...`);
backupPath = await userDataBackup.backupUserData(customAppDir, branch, hasVersionConfig);
if (backupPath) {
console.log(`[InstallGame] ✓ UserData backed up to: ${backupPath}`);
console.log('[InstallGame] Ensuring UserData migration...');
const migrationResult = await migrateUserDataToCentralized();
if (migrationResult.migrated) {
console.log('[InstallGame] ✓ UserData migrated to centralized location');
} else if (migrationResult.alreadyMigrated) {
console.log('[InstallGame] ✓ UserData already in centralized location');
}
} catch (backupError) {
console.warn('[InstallGame] ✗ UserData backup failed:', backupError.message);
} catch (migrationError) {
console.warn('[InstallGame] UserData migration warning:', migrationError.message);
}
[customAppDir, customCacheDir, customToolsDir].forEach(dir => {
@@ -500,10 +472,6 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
}
});
if (!fs.existsSync(userDataDir)) {
fs.mkdirSync(userDataDir, { recursive: true });
}
saveUsername(playerName);
if (installPathOverride) {
saveInstallPath(installPathOverride);
@@ -561,31 +529,33 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
console.log(`Installing game files for branch: ${branch}...`);
const latestVersion = await getLatestClientVersion(branch);
const targetVersion = FORCE_CLEAN_INSTALL_VERSION ? CLEAN_INSTALL_TEST_VERSION : latestVersion;
if (FORCE_CLEAN_INSTALL_VERSION) {
console.log(`TESTING MODE: Forcing installation of ${targetVersion} instead of ${latestVersion}`);
}
let pwrFile;
try {
pwrFile = await downloadPWR(branch, latestVersion, progressCallback, customCacheDir);
pwrFile = await downloadPWR(branch, targetVersion, progressCallback, customCacheDir);
// If downloadPWR returns false, it means the file doesn't exist or is invalid
// We should retry the download with a manual retry flag
if (!pwrFile) {
console.log('[Install] PWR file not found or invalid, attempting retry...');
pwrFile = await retryPWRDownload(branch, latestVersion, progressCallback, customCacheDir);
pwrFile = await retryPWRDownload(branch, targetVersion, progressCallback, customCacheDir);
}
// Double-check we have a valid file path
if (!pwrFile || typeof pwrFile !== 'string') {
throw new Error(`PWR file download failed: received invalid path ${pwrFile}. Please retry download.`);
}
} catch (downloadError) {
console.error('[Install] PWR download failed:', downloadError.message);
throw downloadError; // Re-throw to be handled by the main installGame error handler
throw downloadError;
}
await applyPWR(pwrFile, progressCallback, customGameDir, customToolsDir, branch, customCacheDir);
// Save the installed version and branch to config
saveVersionClient(latestVersion);
saveVersionClient(targetVersion);
const { saveVersionBranch } = require('../core/config');
saveVersionBranch(branch);
@@ -595,29 +565,9 @@ async function installGame(playerName = 'Player', progressCallback, javaPathOver
const logoResult = await downloadAndReplaceLogo(customGameDir, progressCallback);
console.log('Logo@2x.png update result after installation:', logoResult);
// Ensure UserData directory exists
if (!fs.existsSync(userDataDir)) {
console.log(`[InstallGame] Creating UserData directory at: ${userDataDir}`);
fs.mkdirSync(userDataDir, { recursive: true });
}
// Restore UserData from backup if exists
if (backupPath) {
if (progressCallback) {
progressCallback('Restoring UserData...', 95, null, null, null);
}
try {
console.log(`[InstallGame] Restoring UserData from: ${backupPath}`);
await userDataBackup.restoreUserData(backupPath, customAppDir, branch);
await userDataBackup.cleanupBackup(backupPath);
console.log('[InstallGame] ✓ UserData restored successfully');
} catch (restoreError) {
console.warn('[InstallGame] ✗ UserData restore failed:', restoreError.message);
}
} else {
console.log('[InstallGame] No backup to restore, empty UserData folder created');
}
// NEW 2.1.2: No longer create UserData in game installation
// UserData is managed in centralized location (getUserDataPath())
console.log('[InstallGame] UserData is managed in centralized location');
if (progressCallback) {
progressCallback('Installation complete', 100, null, null, null);

130
backend/managers/modManager.js
View File

@@ -3,7 +3,7 @@ const path = require('path');
const crypto = require('crypto');
const axios = require('axios');
const { getOS } = require('../utils/platformUtils');
const { getModsPath, getProfilesDir } = require('../core/paths');
const { getModsPath, getProfilesDir, getHytaleSavesDir } = require('../core/paths');
const { saveModsToConfig, loadModsFromConfig } = require('../core/config');
const profileManager = require('./profileManager');
@@ -296,8 +296,9 @@ async function syncModsForCurrentProfile() {
console.log(`[ModManager] Syncing mods for profile: ${activeProfile.name} (${activeProfile.id})`);
// 1. Resolve Paths
// globalModsPath is the one the game uses (symlink target)
const globalModsPath = await getModsPath();
// centralModsPath is HytaleSaves\Mods (centralized location for active mods)
const hytaleSavesDir = getHytaleSavesDir();
const centralModsPath = path.join(hytaleSavesDir, 'Mods');
// profileModsPath is the real storage for this profile
const profileModsPath = getProfileModsPath(activeProfile.id);
const profileDisabledModsPath = path.join(path.dirname(profileModsPath), 'DisabledMods');
@@ -306,96 +307,51 @@ async function syncModsForCurrentProfile() {
fs.mkdirSync(profileDisabledModsPath, { recursive: true });
}
// 2. Symlink / Migration Logic
let needsLink = false;
let globalStats = null;
// 2. Copy-based Mod Sync (No symlinks - avoids permission issues)
// Ensure HytaleSaves\Mods directory exists
if (!fs.existsSync(centralModsPath)) {
fs.mkdirSync(centralModsPath, { recursive: true });
console.log(`[ModManager] Created centralized mods directory: ${centralModsPath}`);
}
// Check for old symlink and convert to real directory if needed (one-time migration)
try {
globalStats = fs.lstatSync(globalModsPath);
const centralStats = fs.lstatSync(centralModsPath);
if (centralStats.isSymbolicLink()) {
console.log('[ModManager] Removing old symlink, converting to copy-based system...');
fs.unlinkSync(centralModsPath);
fs.mkdirSync(centralModsPath, { recursive: true });
}
} catch (e) {
// Path doesn't exist
// Path doesn't exist, will be created above
}
if (globalStats) {
if (globalStats.isSymbolicLink()) {
const linkTarget = fs.readlinkSync(globalModsPath);
// Normalize paths for comparison
if (path.resolve(linkTarget) !== path.resolve(profileModsPath)) {
console.log(`[ModManager] Updating symlink from ${linkTarget} to ${profileModsPath}`);
fs.unlinkSync(globalModsPath);
needsLink = true;
}
} else if (globalStats.isDirectory()) {
// MIGRATION: It's a real directory. Move contents to profile.
console.log('[ModManager] Migrating global mods folder to profile folder...');
const files = fs.readdirSync(globalModsPath);
for (const file of files) {
const src = path.join(globalModsPath, file);
const dest = path.join(profileModsPath, file);
// Only move if dest doesn't exist to avoid overwriting
if (!fs.existsSync(dest)) {
fs.renameSync(src, dest);
}
}
// Also migrate DisabledMods if it exists globally
const globalDisabledPath = path.join(path.dirname(globalModsPath), 'DisabledMods');
if (fs.existsSync(globalDisabledPath) && fs.lstatSync(globalDisabledPath).isDirectory()) {
const dFiles = fs.readdirSync(globalDisabledPath);
for (const file of dFiles) {
const src = path.join(globalDisabledPath, file);
const dest = path.join(profileDisabledModsPath, file);
if (!fs.existsSync(dest)) {
fs.renameSync(src, dest);
}
}
// We can remove global DisabledMods now, as it's not used by game
try { fs.rmSync(globalDisabledPath, { recursive: true, force: true }); } catch(e) {}
}
// Remove the directory so we can link it
try {
let retries = 3;
while (retries > 0) {
try {
fs.rmSync(globalModsPath, { recursive: true, force: true });
break;
} catch (err) {
if ((err.code === 'EPERM' || err.code === 'EBUSY') && retries > 0) {
retries--;
await new Promise(resolve => setTimeout(resolve, 500));
} else {
throw err;
}
}
}
needsLink = true;
} catch (e) {
console.error('Failed to remove global mods dir:', e);
// Throw error to stop.
throw new Error('Failed to migrate mods directory. Please clear ' + globalModsPath);
}
}
} else {
needsLink = true;
}
if (needsLink) {
console.log(`[ModManager] Creating symlink: ${globalModsPath} -> ${profileModsPath}`);
// Copy enabled mods from profile to HytaleSaves\Mods (for game to use)
console.log(`[ModManager] Copying enabled mods from ${profileModsPath} to ${centralModsPath}`);
// First, clear central mods folder
const existingCentralMods = fs.existsSync(centralModsPath) ? fs.readdirSync(centralModsPath) : [];
for (const file of existingCentralMods) {
const filePath = path.join(centralModsPath, file);
try {
const symlinkType = getOS() === 'windows' ? 'junction' : 'dir';
fs.symlinkSync(profileModsPath, globalModsPath, symlinkType);
} catch (err) {
// If we can't create the symlink, try creating the directory first
console.error('[ModManager] Failed to create symlink. Falling back to direct folder mode.');
console.error(err.message);
// Fallback: create a real directory so the game still works
if (!fs.existsSync(globalModsPath)) {
fs.mkdirSync(globalModsPath, { recursive: true });
fs.unlinkSync(filePath);
} catch (e) {
console.warn(`Failed to remove ${file} from central mods:`, e.message);
}
}
// Copy enabled mods to HytaleSaves\Mods
const enabledModFiles = fs.existsSync(profileModsPath) ? fs.readdirSync(profileModsPath).filter(f => f.endsWith('.jar') || f.endsWith('.zip')) : [];
for (const file of enabledModFiles) {
const src = path.join(profileModsPath, file);
const dest = path.join(centralModsPath, file);
try {
fs.copyFileSync(src, dest);
console.log(`[ModManager] Copied ${file} to HytaleSaves\\Mods`);
} catch (e) {
console.error(`Failed to copy ${file}:`, e.message);
}
}
}
// 3. Auto-Repair (Download missing mods)
const profileModsSnapshot = activeProfile.mods || [];
@@ -460,7 +416,7 @@ async function syncModsForCurrentProfile() {
}
// 5. Enforce Enabled/Disabled State (Move files between Profile/Mods and Profile/DisabledMods)
// Note: Since Global/Mods IS Profile/Mods (via symlink), moving out of Profile/Mods disables it for the game.
// Note: Enabled mods are copied to HytaleSaves\Mods, disabled mods stay in Profile/DisabledMods
const disabledFiles = fs.existsSync(profileDisabledModsPath) ? fs.readdirSync(profileDisabledModsPath).filter(f => f.endsWith('.jar') || f.endsWith('.zip')) : [];
const allFiles = new Set([...enabledFiles, ...disabledFiles]);

146
backend/services/versionManager.js
View File

@@ -1,11 +1,17 @@
const axios = require('axios');
const crypto = require('crypto');
const fs = require('fs');
const { getOS, getArch } = require('../utils/platformUtils');
const BASE_PATCH_URL = 'https://game-patches.hytale.com/patches';
const MANIFEST_API = 'https://files.hytalef2p.com/api/patch_manifest';
async function getLatestClientVersion(branch = 'release') {
try {
console.log(`Fetching latest client version from API (branch: ${branch})...`);
const response = await axios.get('https://files.hytalef2p.com/api/version_client', {
params: { branch },
timeout: 5000,
timeout: 40000,
headers: {
'User-Agent': 'Hytale-F2P-Launcher'
}
@@ -16,16 +22,144 @@ async function getLatestClientVersion(branch = 'release') {
console.log(`Latest client version for ${branch}: ${version}`);
return version;
} else {
console.log('Warning: Invalid API response, falling back to default version');
return '4.pwr';
console.log('Warning: Invalid API response, falling back to latest known version (7.pwr)');
return '7.pwr';
}
} catch (error) {
console.error('Error fetching client version:', error.message);
console.log('Warning: API unavailable, falling back to default version');
return '4.pwr';
console.log('Warning: API unavailable, falling back to latest known version (7.pwr)');
return '7.pwr';
}
}
function buildArchiveUrl(buildNumber, branch = 'release') {
const os = getOS();
const arch = getArch();
return `${BASE_PATCH_URL}/${os}/${arch}/${branch}/0/${buildNumber}.pwr`;
}
async function checkArchiveExists(buildNumber, branch = 'release') {
const url = buildArchiveUrl(buildNumber, branch);
try {
const response = await axios.head(url, { timeout: 10000 });
return response.status === 200;
} catch (error) {
return false;
}
}
async function discoverAvailableVersions(latestKnown, branch = 'release', maxProbe = 50) {
const available = [];
const latest = parseInt(latestKnown.replace('.pwr', ''));
for (let i = latest; i >= Math.max(1, latest - maxProbe); i--) {
const exists = await checkArchiveExists(i, branch);
if (exists) {
available.push(`${i}.pwr`);
}
}
return available;
}
async function fetchPatchManifest(branch = 'release') {
try {
const os = getOS();
const arch = getArch();
const response = await axios.get(MANIFEST_API, {
params: { branch, os, arch },
timeout: 10000
});
return response.data.patches || {};
} catch (error) {
console.error('Failed to fetch patch manifest:', error.message);
return {};
}
}
async function extractVersionDetails(targetVersion, branch = 'release') {
const buildNumber = parseInt(targetVersion.replace('.pwr', ''));
const previousBuild = buildNumber - 1;
const manifest = await fetchPatchManifest(branch);
const patchInfo = manifest[buildNumber];
return {
version: targetVersion,
buildNumber: buildNumber,
buildName: `HYTALE-Build-${buildNumber}`,
fullUrl: patchInfo?.original_url || buildArchiveUrl(buildNumber, branch),
differentialUrl: patchInfo?.patch_url || null,
checksum: patchInfo?.patch_hash || null,
sourceVersion: patchInfo?.from ? `${patchInfo.from}.pwr` : (previousBuild > 0 ? `${previousBuild}.pwr` : null),
isDifferential: !!patchInfo?.proper_patch,
releaseNotes: patchInfo?.patch_note || null
};
}
function canUseDifferentialUpdate(currentVersion, targetDetails) {
if (!targetDetails) return false;
if (!targetDetails.differentialUrl) return false;
if (!targetDetails.isDifferential) return false;
if (!currentVersion) return false;
const currentBuild = parseInt(currentVersion.replace('.pwr', ''));
const expectedSource = parseInt(targetDetails.sourceVersion?.replace('.pwr', '') || '0');
return currentBuild === expectedSource;
}
function needsIntermediatePatches(currentVersion, targetVersion) {
if (!currentVersion) return [];
const current = parseInt(currentVersion.replace('.pwr', ''));
const target = parseInt(targetVersion.replace('.pwr', ''));
const intermediates = [];
for (let i = current + 1; i <= target; i++) {
intermediates.push(`${i}.pwr`);
}
return intermediates;
}
async function computeFileChecksum(filePath) {
return new Promise((resolve, reject) => {
const hash = crypto.createHash('sha256');
const stream = fs.createReadStream(filePath);
stream.on('data', data => hash.update(data));
stream.on('end', () => resolve(hash.digest('hex')));
stream.on('error', reject);
});
}
async function validateChecksum(filePath, expectedChecksum) {
if (!expectedChecksum) return true;
const actualChecksum = await computeFileChecksum(filePath);
return actualChecksum === expectedChecksum;
}
function getInstalledClientVersion() {
try {
const { loadVersionClient } = require('../core/config');
return loadVersionClient();
} catch (err) {
return null;
}
}
module.exports = {
getLatestClientVersion
getLatestClientVersion,
buildArchiveUrl,
checkArchiveExists,
discoverAvailableVersions,
extractVersionDetails,
canUseDifferentialUpdate,
needsIntermediatePatches,
computeFileChecksum,
validateChecksum,
getInstalledClientVersion
};

743
backend/utils/clientPatcher.js
View File

File diff suppressed because it is too large Load Diff

120
backend/utils/serverListSync.js Normal file
View File

@@ -0,0 +1,120 @@
const fs = require('fs');
const path = require('path');
const axios = require('axios');
const { v4: uuidv4 } = require('uuid');
const { getHytaleSavesDir } = require('../core/paths');
const SERVER_LIST_URL = 'https://assets.authbp.xyz/server.json';
function getLocalDateTime() {
return formatLocalDateTime(new Date());
}
function formatLocalDateTime(date) {
const year = date.getFullYear();
const month = String(date.getMonth() + 1).padStart(2, '0');
const day = String(date.getDate()).padStart(2, '0');
const hours = String(date.getHours()).padStart(2, '0');
const minutes = String(date.getMinutes()).padStart(2, '0');
const seconds = String(date.getSeconds()).padStart(2, '0');
const milliseconds = String(date.getMilliseconds()).padStart(3, '0');
const offsetMinutes = -date.getTimezoneOffset();
const offsetHours = Math.floor(Math.abs(offsetMinutes) / 60);
const offsetMins = Math.abs(offsetMinutes) % 60;
const offsetSign = offsetMinutes >= 0 ? '+' : '-';
const offset = `${offsetSign}${String(offsetHours).padStart(2, '0')}:${String(offsetMins).padStart(2, '0')}`;
return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}.${milliseconds}0000${offset}`;
}
async function syncServerList() {
try {
const hytaleSavesDir = getHytaleSavesDir();
const serverListPath = path.join(hytaleSavesDir, 'ServerList.json');
console.log('[ServerListSync] Fetching server list from', SERVER_LIST_URL);
let remoteData;
try {
const response = await axios.get(SERVER_LIST_URL, {
timeout: 40000,
headers: {
'User-Agent': 'Hytale-F2P-Launcher'
}
});
remoteData = response.data;
} catch (fetchError) {
console.warn('[ServerListSync] Failed to fetch remote server list:', fetchError.message);
remoteData = { SavedServers: [] };
}
let localData = { SavedServers: [] };
if (fs.existsSync(serverListPath)) {
try {
const localContent = fs.readFileSync(serverListPath, 'utf-8');
localData = JSON.parse(localContent);
console.log('[ServerListSync] Loaded existing local server list with', localData.SavedServers?.length || 0, 'servers');
} catch (parseError) {
console.warn('[ServerListSync] Failed to parse local server list, creating new one:', parseError.message);
localData = { SavedServers: [] };
}
} else {
console.log('[ServerListSync] Local server list does not exist, creating new one');
}
if (!localData.SavedServers) {
localData.SavedServers = [];
}
if (!remoteData.SavedServers) {
remoteData.SavedServers = [];
}
const existingServersByAddress = new Map();
const userServers = [];
for (const server of localData.SavedServers) {
existingServersByAddress.set(server.Address.toLowerCase(), server);
}
const remoteAddresses = new Set(remoteData.SavedServers.map(s => s.Address.toLowerCase()));
for (const server of localData.SavedServers) {
if (!remoteAddresses.has(server.Address.toLowerCase())) {
userServers.push(server);
}
}
const currentDate = getLocalDateTime();
const apiServers = [];
for (const remoteServer of remoteData.SavedServers) {
const serverToAdd = {
Id: uuidv4(),
Name: "@ " + remoteServer.Name,
Address: remoteServer.Address,
DateSaved: currentDate,
img_Banner: remoteServer.img_Banner || null // Copy banner if exists
};
apiServers.push(serverToAdd);
console.log('[ServerListSync] Added/Updated server with new ID:', remoteServer.Name);
}
localData.SavedServers = [...apiServers, ...userServers];
const addedCount = apiServers.length;
if (!fs.existsSync(hytaleSavesDir)) {
fs.mkdirSync(hytaleSavesDir, { recursive: true });
}
fs.writeFileSync(serverListPath, JSON.stringify(localData, null, 2), 'utf-8');
console.log('[ServerListSync] Server list synchronized:', addedCount, 'API servers added, total:', localData.SavedServers.length);
return { success: true, added: addedCount, total: localData.SavedServers.length };
} catch (error) {
console.error('[ServerListSync] Failed to synchronize server list:', error.message);
return { success: false, error: error.message };
}
}
module.exports = {
syncServerList
};

6
backend/utils/userDataBackup.js
View File

@@ -46,7 +46,8 @@ class UserDataBackup {
console.log(`[UserDataBackup] Copying from ${userDataPath} to ${backupPath}...`);
await fs.copy(userDataPath, backupPath, {
overwrite: true,
errorOnExist: false
errorOnExist: false,
dereference: true // Follow symlinks to avoid EPERM errors on Windows
});
console.log('[UserDataBackup] ✓ Backup completed successfully');
return backupPath;
@@ -82,7 +83,8 @@ class UserDataBackup {
await fs.copy(backupPath, userDataPath, {
overwrite: true,
errorOnExist: false
errorOnExist: false,
dereference: true // Follow symlinks to avoid EPERM errors on Windows
});
console.log('UserData restore completed successfully');

172
backend/utils/userDataMigration.js Normal file
View File

@@ -0,0 +1,172 @@
const fs = require('fs-extra');
const path = require('path');
const { getHytaleSavesDir, getResolvedAppDir } = require('../core/paths');
const { loadConfig, saveConfig } = require('../core/config');
/**
* NEW SYSTEM (2.1.2+): UserData Migration to Centralized Location
*
* UserData is now stored in a centralized location instead of inside game installation:
* - Windows: %LOCALAPPDATA%\HytaleSaves\
* - macOS: ~/Library/Application Support/HytaleSaves/
* - Linux: ~/.hytalesaves/
*
* This eliminates the need for backup/restore during updates.
*/
/**
* Check if migration to centralized UserData has been completed
*/
function isMigrationCompleted() {
const config = loadConfig();
return config.userDataMigrated === true;
}
/**
* Mark migration as completed
*/
function markMigrationCompleted() {
saveConfig({ userDataMigrated: true });
console.log('[UserDataMigration] Migration marked as completed in config');
}
/**
* Find old UserData location (pre-2.1.2)
* Searches in: installPath/branch/package/game/latest/Client/UserData
*/
function findOldUserDataPath() {
try {
const config = loadConfig();
const installPath = getResolvedAppDir();
const branch = config.version_branch || 'release';
console.log(`[UserDataMigration] Looking for old UserData...`);
console.log(`[UserDataMigration] Install path: ${installPath}`);
console.log(`[UserDataMigration] Branch: ${branch}`);
// Old location
const oldPath = path.join(installPath, branch, 'package', 'game', 'latest', 'Client', 'UserData');
console.log(`[UserDataMigration] Checking: ${oldPath}`);
console.log(`[UserDataMigration] Checking: ${oldPath}`);
if (fs.existsSync(oldPath)) {
console.log(`[UserDataMigration] ✓ Found old UserData at: ${oldPath}`);
return oldPath;
}
console.log(`[UserDataMigration] ✗ Not found at current branch location`);
// Try other branch if current doesn't exist
const otherBranch = branch === 'release' ? 'pre-release' : 'release';
const otherPath = path.join(installPath, otherBranch, 'package', 'game', 'latest', 'Client', 'UserData');
console.log(`[UserDataMigration] Checking other branch: ${otherPath}`);
console.log(`[UserDataMigration] Checking other branch: ${otherPath}`);
if (fs.existsSync(otherPath)) {
console.log(`[UserDataMigration] ✓ Found old UserData in other branch at: ${otherPath}`);
return otherPath;
}
console.log('[UserDataMigration] ✗ No old UserData found in any branch');
return null;
} catch (error) {
console.error('[UserDataMigration] Error finding old UserData:', error);
return null;
}
}
/**
* Migrate UserData from old location to new centralized location
* One-time operation when upgrading to 2.1.2
*/
async function migrateUserDataToCentralized() {
// Check if already migrated
if (isMigrationCompleted()) {
console.log('[UserDataMigration] Migration already completed, skipping');
return { success: true, alreadyMigrated: true };
}
console.log('[UserDataMigration] === Starting UserData Migration to Centralized Location ===');
const newUserDataPath = getHytaleSavesDir();
console.log(`[UserDataMigration] Target location: ${newUserDataPath}`);
// Ensure new directory exists
if (!fs.existsSync(newUserDataPath)) {
fs.mkdirSync(newUserDataPath, { recursive: true });
console.log('[UserDataMigration] Created new HytaleSaves directory');
}
// Find old UserData
const oldUserDataPath = findOldUserDataPath();
if (!oldUserDataPath) {
console.log('[UserDataMigration] No old UserData found - fresh install or already migrated');
// Don't mark as migrated - let it check again next time in case game gets installed later
return { success: true, freshInstall: true };
}
// Check if new location already has data (shouldn't happen, but safety check)
const existingFiles = fs.readdirSync(newUserDataPath);
if (existingFiles.length > 0) {
console.warn('[UserDataMigration] New location already contains files, marking as migrated to avoid re-attempts');
markMigrationCompleted();
return { success: true, skipped: true, reason: 'target_not_empty' };
}
try {
console.log(`[UserDataMigration] Copying from ${oldUserDataPath} to ${newUserDataPath}...`);
// Copy all UserData to new location
await fs.copy(oldUserDataPath, newUserDataPath, {
overwrite: false,
errorOnExist: false,
dereference: true // Follow symlinks to avoid EPERM errors on Windows
});
console.log('[UserDataMigration] ✓ UserData copied successfully');
// Mark migration as completed
markMigrationCompleted();
console.log('[UserDataMigration] === Migration Completed Successfully ===');
return {
success: true,
migrated: true,
from: oldUserDataPath,
to: newUserDataPath
};
} catch (error) {
console.error('[UserDataMigration] ✗ Migration failed:', error);
return {
success: false,
error: error.message,
from: oldUserDataPath,
to: newUserDataPath
};
}
}
/**
* Get the centralized UserData path (always use this in 2.1.2+)
* Ensures directory exists
*/
function getUserDataPath() {
const userDataPath = getHytaleSavesDir();
// Ensure directory exists
if (!fs.existsSync(userDataPath)) {
fs.mkdirSync(userDataPath, { recursive: true });
console.log(`[UserDataMigration] Created UserData directory: ${userDataPath}`);
}
return userDataPath;
}
module.exports = {
migrateUserDataToCentralized,
getUserDataPath,
isMigrationCompleted,
findOldUserDataPath
};

123
docs/STEAMDECK_CRASH_INVESTIGATION.md Normal file
View File

@@ -0,0 +1,123 @@
# Steam Deck / Ubuntu LTS Crash Investigation
## Status: SOLVED
**Last updated:** 2026-01-27
**Solution:** Replace bundled `libzstd.so` with system version.
---
## Problem Summary
The Hytale F2P launcher's client patcher causes crashes on Steam Deck and Ubuntu LTS with the error:
```
free(): invalid pointer
```
or
```
SIGSEGV (Segmentation fault)
```
The crash occurs after successful authentication, specifically right after "Finished handling RequiredAssets".
**Affected Systems:**
- Steam Deck (glibc 2.41)
- Ubuntu LTS
**Working Systems:**
- macOS
- Windows
- Older Arch Linux (glibc < 2.41)
---
## Root Cause
The **bundled `libzstd.so`** in the game client is incompatible with glibc 2.41's stricter heap validation. When the game decompresses assets using this library, it triggers heap corruption detected by glibc 2.41.
The crash occurs in `libzstd.so` during `free()` after "Finished handling RequiredAssets" (asset decompression).
---
## Solution
Replace the bundled `libzstd.so` with the system's `libzstd.so.1`.
### Automatic (Launcher)
The launcher automatically detects and replaces `libzstd.so` on Linux systems. No manual action needed.
### Manual
```bash
cd ~/.hytalef2p/release/package/game/latest/Client
# Backup bundled version
mv libzstd.so libzstd.so.bundled
# Link to system version
# Steam Deck / Arch Linux:
ln -s /usr/lib/libzstd.so.1 libzstd.so
# Debian / Ubuntu:
ln -s /usr/lib/x86_64-linux-gnu/libzstd.so.1 libzstd.so
# Fedora / RHEL:
ln -s /usr/lib64/libzstd.so.1 libzstd.so
```
### Restore Original
```bash
cd ~/.hytalef2p/release/package/game/latest/Client
rm libzstd.so
mv libzstd.so.bundled libzstd.so
```
---
## Why This Works
1. The bundled `libzstd.so` was likely compiled with different allocator settings or an older toolchain
2. glibc 2.41 has stricter heap validation that catches invalid memory operations
3. The system `libzstd.so.1` is compiled with the system's glibc and uses compatible memory allocation patterns
4. By using the system library, we avoid the incompatibility entirely
---
## Previous Investigation (for reference)
### What Was Tried Before Finding Solution
| Approach | Result |
|----------|--------|
| jemalloc allocator | Worked ~30% of time, not stable |
| GLIBC_TUNABLES | No effect |
| taskset (CPU pinning) | Single core too slow |
| nice/chrt (scheduling) | No effect |
| Various patching approaches | All crashed |
### Key Insight
The crash was in `libzstd.so`, not in our patched code. The patching just changed timing enough to expose the libzstd incompatibility more frequently.
---
## GDB Stack Trace (Historical)
```
#0 0x00007ffff7d3f5a4 in ?? () from /usr/lib/libc.so.6
#1 raise () from /usr/lib/libc.so.6
#2 abort () from /usr/lib/libc.so.6
#3-#4 ?? () from /usr/lib/libc.so.6
#5 free () from /usr/lib/libc.so.6
#6 ?? () from libzstd.so <-- CRASH POINT (bundled library)
#7-#24 HytaleClient code (asset decompression)
```
---
## Branch
`fix/steamdeck-libzstd`

65
docs/STEAMDECK_DEBUG_COMMANDS.md Normal file
View File

@@ -0,0 +1,65 @@
# Steam Deck / Linux Crash Fix
## SOLUTION: Use system libzstd
The crash is caused by the bundled `libzstd.so` being incompatible with glibc 2.41's stricter heap validation.
### Automatic Fix
The launcher automatically replaces `libzstd.so` with the system version. No manual action needed.
### Manual Fix
```bash
cd ~/.hytalef2p/release/package/game/latest/Client
# Backup and replace
mv libzstd.so libzstd.so.bundled
ln -s /usr/lib/libzstd.so.1 libzstd.so
```
### Restore Original
```bash
cd ~/.hytalef2p/release/package/game/latest/Client
rm libzstd.so
mv libzstd.so.bundled libzstd.so
```
---
## Debug Commands (for troubleshooting)
### Check libzstd Status
```bash
# Check if symlinked
ls -la ~/.hytalef2p/release/package/game/latest/Client/libzstd.so
# Find system libzstd
find /usr/lib -name "libzstd.so*"
```
### Binary Validation
```bash
file ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
ldd ~/.hytalef2p/release/package/game/latest/Client/HytaleClient
```
### Restore Client Binary
```bash
cd ~/.hytalef2p/release/package/game/latest/Client
cp HytaleClient.original HytaleClient
rm -f HytaleClient.patched_custom
```
---
## Environment Variables
| Variable | Description | Example |
|----------|-------------|---------|
| `HYTALE_AUTH_DOMAIN` | Custom auth domain | `auth.sanasol.ws` |
| `HYTALE_NO_LIBZSTD_FIX` | Disable libzstd replacement | `1` |

111
main.js
View File

@@ -3,8 +3,9 @@ require('dotenv').config({ path: path.join(__dirname, '.env') });
const { app, BrowserWindow, ipcMain, dialog, shell } = require('electron');
const { autoUpdater } = require('electron-updater');
const fs = require('fs');
const { launchGame, launchGameWithVersionCheck, installGame, saveUsername, loadUsername, saveChatUsername, loadChatUsername, saveChatColor, loadChatColor, saveJavaPath, loadJavaPath, saveInstallPath, loadInstallPath, saveDiscordRPC, loadDiscordRPC, saveLanguage, loadLanguage, saveCloseLauncherOnStart, loadCloseLauncherOnStart, saveLauncherHardwareAcceleration, loadLauncherHardwareAcceleration, isGameInstalled, uninstallGame, repairGame, getHytaleNews, handleFirstLaunchCheck, proposeGameUpdate, markAsLaunched } = require('./backend/launcher');
const { launchGame, launchGameWithVersionCheck, installGame, saveUsername, loadUsername, saveJavaPath, loadJavaPath, saveInstallPath, loadInstallPath, saveDiscordRPC, loadDiscordRPC, saveLanguage, loadLanguage, saveCloseLauncherOnStart, loadCloseLauncherOnStart, saveLauncherHardwareAcceleration, loadLauncherHardwareAcceleration, isGameInstalled, uninstallGame, repairGame, getHytaleNews, handleFirstLaunchCheck, proposeGameUpdate, markAsLaunched, loadConfig, saveConfig } = require('./backend/launcher');
const { retryPWRDownload } = require('./backend/managers/gameManager');
const { migrateUserDataToCentralized } = require('./backend/utils/userDataMigration');
// Handle Hardware Acceleration
try {
@@ -175,7 +176,8 @@ function createWindow() {
initDiscordRPC();
// Configure and initialize electron-updater
autoUpdater.autoDownload = false;
// Enable auto-download so updates start immediately when available
autoUpdater.autoDownload = true;
autoUpdater.autoInstallOnAppQuit = true;
autoUpdater.on('checking-for-update', () => {
@@ -200,6 +202,20 @@ function createWindow() {
autoUpdater.on('error', (err) => {
console.error('Error in auto-updater:', err);
// Handle macOS code signing errors - requires manual download
if (mainWindow && !mainWindow.isDestroyed()) {
const isMacSigningError = process.platform === 'darwin' &&
(err.code === 'ERR_UPDATER_INVALID_SIGNATURE' ||
err.message.includes('signature') ||
err.message.includes('code sign'));
mainWindow.webContents.send('update-error', {
message: err.message,
isMacSigningError: isMacSigningError,
requiresManualDownload: isMacSigningError || process.platform === 'darwin'
});
}
});
autoUpdater.on('download-progress', (progressObj) => {
@@ -217,7 +233,10 @@ function createWindow() {
console.log('Update downloaded:', info.version);
if (mainWindow && !mainWindow.isDestroyed()) {
mainWindow.webContents.send('update-downloaded', {
version: info.version
version: info.version,
platform: process.platform,
// macOS auto-install often fails on unsigned apps
autoInstallSupported: process.platform !== 'darwin'
});
}
});
@@ -298,6 +317,14 @@ app.whenReady().then(async () => {
// Initialize Profile Manager (runs migration if needed)
profileManager.init();
// Migrate UserData to centralized location (v2.1.2+)
console.log('[Startup] Checking UserData migration...');
try {
await migrateUserDataToCentralized();
} catch (error) {
console.error('[Startup] UserData migration failed:', error);
}
createSplashScreen();
setTimeout(async () => {
@@ -520,7 +547,7 @@ ipcMain.handle('install-game', async (event, playerName, javaPath, installPath,
console.log('[Main] Processing Butler error with retry context');
errorData.retryData = {
branch: error.branch || 'release',
fileName: error.fileName || '4.pwr',
fileName: error.fileName || '7.pwr',
cacheDir: error.cacheDir
};
errorData.canRetry = error.canRetry !== false;
@@ -540,7 +567,7 @@ ipcMain.handle('install-game', async (event, playerName, javaPath, installPath,
console.log('[Main] Processing generic error, creating default retry data');
errorData.retryData = {
branch: 'release',
fileName: '4.pwr'
fileName: '7.pwr'
};
// For generic errors, assume it's retryable unless specified
errorData.canRetry = error.canRetry !== false;
@@ -572,22 +599,6 @@ ipcMain.handle('save-username', (event, username) => {
ipcMain.handle('load-username', () => {
return loadUsername();
});
ipcMain.handle('save-chat-username', async (event, chatUsername) => {
saveChatUsername(chatUsername);
});
ipcMain.handle('load-chat-username', async () => {
return loadChatUsername();
});
ipcMain.handle('save-chat-color', (event, color) => {
saveChatColor(color);
return { success: true };
});
ipcMain.handle('load-chat-color', () => {
return loadChatColor();
});
ipcMain.handle('save-java-path', (event, javaPath) => {
saveJavaPath(javaPath);
@@ -645,6 +656,15 @@ ipcMain.handle('load-launcher-hw-accel', () => {
return loadLauncherHardwareAcceleration();
});
ipcMain.handle('load-config', () => {
return loadConfig();
});
ipcMain.handle('save-config', (event, configUpdate) => {
saveConfig(configUpdate);
return { success: true };
});
ipcMain.handle('select-install-path', async () => {
const result = await dialog.showOpenDialog(mainWindow, {
@@ -775,7 +795,7 @@ ipcMain.handle('retry-download', async (event, retryData) => {
console.log('[IPC] Invalid retry data, using PWR defaults');
retryData = {
branch: 'release',
fileName: '4.pwr'
fileName: '7.pwr'
};
}
@@ -809,7 +829,7 @@ ipcMain.handle('retry-download', async (event, retryData) => {
} :
{
branch: retryData?.branch || 'release',
fileName: retryData?.fileName || '4.pwr',
fileName: retryData?.fileName || '7.pwr',
cacheDir: retryData?.cacheDir
};
@@ -850,6 +870,17 @@ ipcMain.handle('open-external', async (event, url) => {
}
});
ipcMain.handle('open-download-page', async () => {
try {
// Open GitHub releases page for manual download
await shell.openExternal('https://github.com/amiayweb/Hytale-F2P/releases/latest');
return { success: true };
} catch (error) {
console.error('Failed to open download page:', error);
return { success: false, error: error.message };
}
});
ipcMain.handle('open-game-location', async () => {
try {
const { getResolvedAppDir, loadVersionBranch } = require('./backend/launcher');
@@ -1077,8 +1108,37 @@ ipcMain.handle('download-update', async () => {
}
});
ipcMain.handle('install-update', () => {
autoUpdater.quitAndInstall(false, true);
ipcMain.handle('install-update', async () => {
console.log('[AutoUpdater] Installing update...');
// On macOS, quitAndInstall often fails silently
// Use a more aggressive approach
if (process.platform === 'darwin') {
console.log('[AutoUpdater] macOS detected, using force quit approach');
// Give user feedback that something is happening
if (mainWindow && !mainWindow.isDestroyed()) {
mainWindow.webContents.send('update-installing');
}
// Small delay to show the "Installing..." state
await new Promise(resolve => setTimeout(resolve, 500));
try {
autoUpdater.quitAndInstall(false, true);
} catch (err) {
console.error('[AutoUpdater] quitAndInstall failed:', err);
// Force quit the app - the update should install on next launch
app.exit(0);
}
// If quitAndInstall didn't work, force exit after a delay
setTimeout(() => {
console.log('[AutoUpdater] Force exiting app...');
app.exit(0);
}, 2000);
} else {
autoUpdater.quitAndInstall(false, true);
}
});
ipcMain.handle('get-launcher-version', () => {
@@ -1312,3 +1372,4 @@ ipcMain.handle('profile-update', async (event, id, updates) => {
return { error: error.message };
}
});

867
package-lock.json generated
View File

File diff suppressed because it is too large Load Diff

53
package.json
View File

@@ -1,6 +1,6 @@
{
"name": "hytale-f2p-launcher",
"version": "2.1.1",
"version": "2.1.2",
"description": "A modern, cross-platform launcher for Hytale with automatic updates and multi-client support",
"homepage": "https://github.com/amiayweb/Hytale-F2P",
"main": "main.js",
@@ -55,7 +55,7 @@
"dotenv": "^17.2.3",
"electron-updater": "^6.7.3",
"fs-extra": "^11.3.3",
"tar": "^6.2.1",
"tar": "^7.5.7",
"uuid": "^9.0.1"
},
"overrides": {
@@ -77,59 +77,24 @@
".env"
],
"win": {
"target": [
{
"target": "nsis",
"arch": [
"x64",
"arm64"
]
}
],
"target": "nsis",
"icon": "build/icon.ico"
},
"linux": {
"target": [
{
"target": "AppImage",
"arch": [
"x64",
"arm64"
]
},
{
"target": "deb",
"arch": [
"x64",
"arm64"
]
},
{
"target": "rpm",
"arch": [
"x64",
"arm64"
]
}
"AppImage",
"deb",
"rpm"
],
"icon": "build/icon.png",
"category": "Game"
},
"mac": {
"target": [
{
"target": "dmg",
"arch": [
"universal"
]
},
{
"target": "zip",
"arch": [
"universal"
]
}
"dmg",
"zip"
],
"arch": ["universal"],
"icon": "build/icon.icns",
"category": "public.app-category.games"
},

19
preload.js
View File

@@ -9,10 +9,6 @@ contextBridge.exposeInMainWorld('electronAPI', {
getVersion: () => ipcRenderer.invoke('get-version'),
saveUsername: (username) => ipcRenderer.invoke('save-username', username),
loadUsername: () => ipcRenderer.invoke('load-username'),
saveChatUsername: (chatUsername) => ipcRenderer.invoke('save-chat-username', chatUsername),
loadChatUsername: () => ipcRenderer.invoke('load-chat-username'),
saveChatColor: (chatColor) => ipcRenderer.invoke('save-chat-color', chatColor),
loadChatColor: () => ipcRenderer.invoke('load-chat-color'),
saveJavaPath: (javaPath) => ipcRenderer.invoke('save-java-path', javaPath),
loadJavaPath: () => ipcRenderer.invoke('load-java-path'),
saveInstallPath: (installPath) => ipcRenderer.invoke('save-install-path', installPath),
@@ -23,8 +19,10 @@ contextBridge.exposeInMainWorld('electronAPI', {
loadLanguage: () => ipcRenderer.invoke('load-language'),
saveCloseLauncher: (enabled) => ipcRenderer.invoke('save-close-launcher', enabled),
loadCloseLauncher: () => ipcRenderer.invoke('load-close-launcher'),
loadConfig: () => ipcRenderer.invoke('load-config'),
saveConfig: (configUpdate) => ipcRenderer.invoke('save-config', configUpdate),
// Harwadre Acceleration
// Hardware Acceleration
saveLauncherHardwareAcceleration: (enabled) => ipcRenderer.invoke('save-launcher-hw-accel', enabled),
loadLauncherHardwareAcceleration: () => ipcRenderer.invoke('load-launcher-hw-accel'),
@@ -50,14 +48,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
selectModFiles: () => ipcRenderer.invoke('select-mod-files'),
copyModFile: (sourcePath, modsPath) => ipcRenderer.invoke('copy-mod-file', sourcePath, modsPath),
onProgressUpdate: (callback) => {
ipcRenderer.on('progress-update', (event, data) => {
// Ensure data includes retry state if available
if (data && typeof data === 'object') {
callback(data);
} else {
callback(data);
}
});
ipcRenderer.on('progress-update', (event, data) => callback(data));
},
onProgressComplete: (callback) => {
ipcRenderer.on('progress-complete', () => callback());
@@ -69,7 +60,6 @@ contextBridge.exposeInMainWorld('electronAPI', {
ipcRenderer.on('installation-end', () => callback());
},
getUserId: () => ipcRenderer.invoke('get-user-id'),
checkForUpdates: () => ipcRenderer.invoke('check-for-updates'),
openDownloadPage: () => ipcRenderer.invoke('open-download-page'),
getUpdateInfo: () => ipcRenderer.invoke('get-update-info'),
onUpdatePopup: (callback) => {
@@ -126,6 +116,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
checkForUpdates: () => ipcRenderer.invoke('check-for-updates'),
downloadUpdate: () => ipcRenderer.invoke('download-update'),
installUpdate: () => ipcRenderer.invoke('install-update'),
quitAndInstallUpdate: () => ipcRenderer.invoke('install-update'), // Alias for update.js compatibility
getLauncherVersion: () => ipcRenderer.invoke('get-launcher-version'),
onUpdateAvailable: (callback) => {
ipcRenderer.on('update-available', (event, data) => callback(data));