From e43897f81659a38a4c0505cdb6c97f341d5a0d77 Mon Sep 17 00:00:00 2001 From: Fazri Gading Date: Sat, 24 Jan 2026 03:21:25 +0800 Subject: [PATCH] Draft Enhancement & Documentation for README.md Needs some work on few TODO. Contributors PR are welcome. --- README.md | 191 ++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 157 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index 5138864..025d616 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# 🎮 Hytale F2P Launcher | Multiplayer Support [Windows, MacOS, Linux] +# 🎮 Hytale F2P Launcher | Cross-Platform Multiplayer Support 🪟 🍎 🐧
@@ -6,14 +6,16 @@ ![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey?style=for-the-badge) ![License](https://img.shields.io/badge/License-Educational-blue?style=for-the-badge) -**A modern, cross-platform launcher for Hytale with automatic updates and multiplayer support (all OS supported)** +**An unofficial cross-platform launcher for Hytale with automatic updates and multiplayer support (all OS supported)** [![GitHub stars](https://img.shields.io/github/stars/amiayweb/Hytale-F2P?style=social)](https://github.com/amiayweb/Hytale-F2P/stargazers) [![GitHub forks](https://img.shields.io/github/forks/amiayweb/Hytale-F2P?style=social)](https://github.com/amiayweb/Hytale-F2P/network/members) -⭐ **If you find this project useful, please give it a star!** ⭐ +⭐ **If you find this project useful, please give it a STAR!** ⭐ -🛑 **Found a problem? Join the Discord: https://discord.gg/gME8rUy3MB** 🛑 +🛑 **Found a problem? Join the Discord and Select #Open-A-Ticket!: https://discord.gg/gME8rUy3MB** 🛑 + +⚠️ **READ [QUICK START](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-quick-start) before Downloading & Installing the Launcher!** ⚠️
@@ -21,12 +23,23 @@ ## 📸 Screenshots
- -![Hytale F2P Launcher](https://i.imgur.com/9iDuzST.png) -![Hytale F2P Mods](https://i.imgur.com/NaareIS.png) -![Hytale F2P News](https://i.imgur.com/n1nEqRS.png) -![Hytale F2P Chat](https://i.imgur.com/Y4hL3sx.png) - +

Hytale F2P Launcher

+ Hytale F2P Launcher +
+
+ View Mods Preview + Hytale F2P Mods +
+
+
+ View Latest News + Hytale F2P News +
+
+
+ View Social & Chat + Hytale F2P Chat +
--- @@ -49,24 +62,130 @@ --- -## 🚀 Quick Start +# 🚀 Quick Start -### 📥 Installation +## 🖥️ System Requirements -#### Windows -1. Download the latest `Hytale-F2P.exe` from [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases) -2. Run the installer -3. Launch from desktop or start menu +### 🎮 Hytale Hardware Requirements -#### Linux -See [BUILD.md](BUILD.md) for detailed build instructions or [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases) section. +Hytale is designed to be accessible while scaling for high-end performance. Below are the [official system requirements for the Early Access](https://hytale.com/news/2025/12/hytale-hardware-requirements) release. -#### macOS -See [BUILD.md](BUILD.md) for detailed build instructions or [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases) section. +
-#### 🖥️ How to play online on F2P? -See [SERVER.md](SERVER.md) - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Component🥉 Minimum (1080p @ 30 FPS)🥈 Recommended (1080p @ 60 FPS)🥇 Best (1440p @ 60 FPS)
🖥️ OS + Windows 10/11 (64-bit; X64/ARM64) | Linux (x64/ARM64) | macOS (Apple Silicon only) +
+ ⚠️ Note: macOS Intel (x86) is not yet supported +
⚙️ CPUIntel i5-7500 / Ryzen 3 1200 / Apple M1Intel i5-10400 / Ryzen 5 3600 / Apple M2Intel i7-10700K / Ryzen 9 3800X / Apple M3
🧠 RAM8GB (Dedicated) / 12GB (iGPU)16 GB32 GB
🎮 GPUGTX 900 / RX 400 / UHD 620GTX 1060 / RX 580 / Iris XeRTX 30 Series / RX 7000 Series
💾 Storage20 GB (SATA SSD)20 GB (NVMe SSD)50 GB+ (NVMe SSD)
🌐 Network2 Mbit/s8 Mbit/s10+ Mbit/s
+ +
+ +### 🪟 Windows Prequisites +* **Java JDK 25:** Download via [Adoptium](https://adoptium.net/temurin/releases/?version=25) or [Oracle](https://www.oracle.com/java/technologies/downloads/#jdk25-windows) +* **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/) +* **ENABLE MULTIPLAYER:** // TODO MULTIPLAYER GUIDE; FIREWALL GUIDE AND SUCH + +### 🐧 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). + +* 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 + +--- + +## 📥 Installation + +### 🪟 Windows +1. Make sure you have installed all [**Windows Prequisites**](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-windows-prequisites) above. +2. Download the latest `Hytale-F2P-Launcher.exe` from [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/). +3. Run the EXE. +4. Launch from Desktop or Start menu. + +### 🐧 Linux +1. Make sure you have installed all [**Linux Prequisites**](https://github.com/amiayweb/Hytale-F2P/tree/main?tab=readme-ov-file#-linux-prequisites) above. +2. Download the latest `Hytale-F2P-Launcher.AppImage` or any specific-packages in accordance with your distro from [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/). +3. Give permission to the file (`chmod +x `). +4. Run the file by double-clicking, or via Terminal (`./`), or find it via Desktop/App Library. + +### 🍎 macOS +1. Download .DMG file from the from [**Releases**](https://github.com/amiayweb/Hytale-F2P/releases/latest/). +2. Run the file. +3. If says "Apple could not verify ...", go to System Settings > Privacy & Security > Scroll to bottom, find "Hytale F2P Launcher" > press Open Anyway. +4. Alterative: You can also use the .zip. // TODO: NEEDS MORE INFORMATION + +--- + +# Server + +## 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. + +1. Open your Singleplayer World +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 + +> [!NOTE] +> Only Hytale-F2P-Server.rar file is needed to set it up on non-playing hardware (such as VPS/server hosting). +> Only HytaleServer.jar needed to use your "Server" folder made by the launcher to host local dedicated server. +> Use services like Playit.gg, Tailscale, Radmin VPN to share UDP connection if setting up router is not possible. + +> [!IMPORTANT] +> See detailed information of setting up a server here: [SERVER.md](SERVER.md) + +// TODO: Server.md would be used as a detailed information to avoid confuses) --- @@ -76,6 +195,8 @@ See [BUILD.md](BUILD.md) for comprehensive build instructions. --- +// TODO: this part needs to be written in dev notes + ## 📌 Versioning Policy **⚠️ Important: Semantic Versioning Required** @@ -96,6 +217,7 @@ This project follows **strict semantic versioning** with **numerical versions on --- ## 📋 Changelog +// TODO: CHANGELOG SHOULD BE IN `CHANGELOG.MD` ### 🆕 v2.0.2b *(Minor Update: Performance & Utilities)* - 🌎 **Language Translation** — A big welcome for Spanish 🇪🇸 and Portuguese (Brazil) 🇧🇷 players! **Language setting can be found in the bottom part of Settings pane.** @@ -107,7 +229,7 @@ This project follows **strict semantic versioning** with **numerical versions on ### 🆕 v2.0.2a *(Minor Update)* - 🧑‍🚀 **Profiles System** — Added proper profile management: create, switch, and delete profiles. Each profile now has its own **isolated mod list**. - 🔒 **Mod Isolation** — Fixed ModManager so mods are **strictly scoped to the active profile**. Browsing and installing now only affects the selected profile. -- 🚨 **Critical Path Fix** — Resolved a macOS bug where mods were being saved to a Windows path (`~/AppData/Local`) instead of `~/Library/Application Support`. Mods now save to the **correct location** and load properly in-game. +- 🚨 **Critical Path Fix** — Resolved a macOS bug where mods were being saved to a Windows path (`~/AppData/Local`) instead of `~/Library/Application Support`. - 🛡️ **Stability Improvements** — Added an **auto-sync step before every launch** to ensure the physical mods folder always matches the active profile. - 🎨 **UI Enhancements** — Added a **profile selector dropdown** and a **profile management modal**. @@ -170,17 +292,18 @@ This project follows **strict semantic versioning** with **numerical versions on ### 🏆 Project Creator -- [**@amiayweb**](https://github.com/amiayweb) - *Lead Developer & Project Creator* +- [**@amiayweb**](https://github.com/amiayweb) - *Lead Developer & Project Creator | Windows* - [**@Relyz1993**](https://github.com/Relyz1993) - *Server Helper & Second Developer & Project Creator* ### 🌟 Contributors -- [**@sanasol**](https://github.com/sanasol) - *Main Issues fixer | Multiplayer Patcher* -- [**@Terromur**](https://github.com/Terromur) - *Main Issues fixer | Beta tester* -- [**@fazrigading**](https://github.com/fazrigading) - *Main Issues fixer | Beta tester* -- [**@ericiskoolbeans**](https://github.com/ericiskoolbeans) - *Beta Tester* -- [**@chasem-dev**](https://github.com/chasem-dev) - *Issues fixer* -- [**@crimera**](https://github.com/crimera) - *Issues fixer* -- [**@Citeli-py**](https://github.com/Citeli-py) - *Issues fixer* +- [**@sanasol**](https://github.com/sanasol) - *Main Issues Fixer | Multiplayer Patcher | Beta Tester | macOS* +- [**@Terromur**](https://github.com/Terromur) - *Main Issues Fixer | Beta Tester | Windows & Linux* +- [**@fazrigading**](https://github.com/fazrigading) - *Main Issues Fixer | Beta Tester | Build Release Manager | Fedora* +- [**@ericiskoolbeans**](https://github.com/ericiskoolbeans) - *Beta Tester | OS* +- [**@chasem-dev**](https://github.com/chasem-dev) - *Issues Fixer | macOS* +- [**@crimera**](https://github.com/crimera) - *Issues Fixer | OS* +- [**@Citeli-py**](https://github.com/Citeli-py) - *Issues Fixer | OS* +- [**@Rahul-Sahani04**](https://github.com/Rahul-Sahani04) - *Issues Fixer | Beta Tester| Windows* --- @@ -224,7 +347,7 @@ This launcher is created for **educational purposes only**. 🛑 **Takedown Policy** - If Hypixel Studios or Hytale requests removal, this project will be taken down immediately. -❤️ **Support Official** - Please support the official game by purchasing it when available. +❤️ **Support Official** - Please support the official game by **purchasing** it legally when available. --- @@ -232,7 +355,7 @@ This launcher is created for **educational purposes only**. **⭐ Star this project if you found it helpful! ⭐** -*Made with ❤️ by [@amiayweb](https://github.com/amiayweb) and the amazing community* +*Made with ❤️ by [@amiayweb](https://github.com/amiayweb) and the legendary contributors with amazing community* [![Star History Chart](https://api.star-history.com/svg?repos=amiayweb/Hytale-F2P&type=date&legend=top-left)](https://www.star-history.com/#amiayweb/Hytale-F2P&type=date&legend=top-left)