@dimzxzzx07/mc-headless 2.2.0 → 2.2.2

package/README.md

@@ -5,7 +5,7 @@
 </div>
 
 <div align="center">
-    <img src="https://img.shields.io/badge/Version-2.2.0-2563eb?style=for-the-badge&logo=typescript" alt="Version">
+    <img src="https://img.shields.io/badge/Version-2.2.2-2563eb?style=for-the-badge&logo=typescript" alt="Version">
     <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=open-source-initiative" alt="License">
     <img src="https://img.shields.io/badge/Node-18%2B-339933?style=for-the-badge&logo=nodedotjs" alt="Node">
     <img src="https://img.shields.io/badge/Java-Portable-007396?style=for-the-badge&logo=openjdk" alt="Java Portable">
@@ -17,7 +17,7 @@
     <a href="https://t.me/Dimzxzzx07">
         <img src="https://img.shields.io/badge/Telegram-Dimzxzzx07-26A5E4?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram">
     </a>
-    <a href="https://github.com/Dimzxzzz">
+    <a href="https://github.com/Dimzxzzx07">
         <img src="https://img.shields.io/badge/GitHub-Dimzxzzx07-181717?style=for-the-badge&logo=github&logoColor=white" alt="GitHub">
     </a>
     <a href="https://www.npmjs.com/package/@dimzxzzx07/mc-headless">
@@ -55,7 +55,7 @@
 ## Table of Contents
 
 - [What is MC-Headless?](#what-is-mc-headless)
-- [What's New in 2.2.0](#whats-new-in-220)
+- [What's New in 2.2.2](#whats-new-in-222)
 - [Features](#features)
 - [Why MC-Headless?](#why-mc-headless)
 - [Installation](#installation)
@@ -111,19 +111,21 @@ Built specifically for developers, sysadmins, and Minecraft enthusiasts who want
 
 ---
 
-## What's New in 2.2.0
+## What's New in 2.2.2
 
-### Version 2.2.0 - March 2026
+### Version 2.2.2 - March 2026
 
-- **Pterodactyl Optimized** - Full compatibility with Pterodactyl panel
-- **No curl/wget required** - Pure Node.js downloader works everywhere
-- **Better error handling** - Clear messages for disk space issues
-- **Smaller Java downloads** - Uses JRE instead of full JDK (saves 150MB)
-- **Automatic disk space check** - Warns before downloading
-- **Improved platform detection** - Works on all Linux distros
-- **Fallback URLs** - Multiple mirrors for Java downloads
-- **Corrupted file detection** - Auto-retry on bad downloads
-- **Memory limit awareness** - Respects cgroup limits in containers
+- **Smart Java Storage** - Automatically detects Pterodactyl environment and stores Java in `/home/container/.java` instead of RAM-heavy `/tmp`
+- **Multi-Architecture Support** - Full support for x64, ARM64 (Oracle Cloud Ampere), and ARM (Raspberry Pi)
+- **Streaming Download + Extract** - Downloads and extracts Java simultaneously, saving disk space and time
+- **Partial Download Recovery** - Automatically cleans up corrupted partial downloads and retries
+- **Content-Length Verification** - Ensures downloaded files match expected size (within 95% tolerance)
+- **Rotating User-Agents** - Bypasses rate limiting with 4 different user-agent strings
+- **Smart Retry Logic** - Retries on rate limits (429), server errors (500+), and network timeouts
+- **30-Day Auto-Update** - Automatically checks and updates Java if older than 30 days
+- **Low RAM Warning** - Alerts users when storing Java in `/tmp` on systems with less than 3GB RAM
+- **Robust Redirect Handling** - Follows up to 3 redirects with proper error handling
+- **Stalled Download Detection** - Cancels and retries if no data received for 30 seconds
 
 ---
 
@@ -133,17 +135,20 @@ Built specifically for developers, sysadmins, and Minecraft enthusiasts who want
 |----------|----------|
 | **Server Types** | Paper, Purpur, Vanilla, Spigot, Forge, Fabric |
 | **Platforms** | Java Edition, Bedrock Edition, Cross-play (Geyser) |
+| **Architecture Support** | x64, ARM64, ARM (Raspberry Pi, Oracle Cloud) |
 | **Auto Setup** | Automatic Java detection, EULA acceptance, server.properties generation |
-| **Portable Java** | Download JRE to current directory, no system installation required |
+| **Portable Java** | Download JRE to `/home/container/.java` (Pterodactyl) or `/tmp/.mc-headless` |
+| **Smart Storage** | Detects Pterodactyl, warns on low RAM for /tmp usage |
+| **Streaming Download** | Download and extract simultaneously, no temporary files |
 | **Cgroups Stats** | CPU/Memory stats like Pterodactyl (30s interval) |
-| **Downloader** | Pure Node.js downloader (no curl/wget needed) |
+| **Downloader** | Pure Node.js with rotating user-agents, retry logic, stalled detection |
 | **Memory Management** | Custom memory allocation, Aikar's flags optimization |
 | **Backup System** | Automatic scheduled backups, manual backup triggers |
 | **Monitoring** | Real-time CPU/memory usage, player tracking, server events |
 | **Cross-play** | Built-in Geyser & Floodgate support for Bedrock clients |
 | **ViaVersion** | Built-in ViaVersion, ViaBackwards, ViaRewind support |
 | **SkinRestorer** | Auto-download and install SkinRestorer plugin |
-| **Pterodactyl Ready** | Optimized for panel hosting |
+| **Pterodactyl Ready** | Optimized for panel hosting with environment variable support |
 | **Termux Friendly** | Optimized for Android/Termux environments |
 | **Headless Ready** | No GUI required, perfect for servers and automation |
 | **Silent Mode** | Direct log piping for minimal CPU usage |
@@ -181,7 +186,7 @@ wget https://github.com/SkinsRestorer/SkinsRestorerX/releases/latest/download/Sk
 tail -f logs/latest.log
 ```
 
-After (MC-Headless v2.2.0)
+After (MC-Headless v2.2.2)
 
 ```javascript
 const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
@@ -223,7 +228,7 @@ RAM 2 GB 4 GB or more
 Storage 2 GB 10 GB
 OS Linux, macOS, Windows, Termux Linux (production)
 
-Note: Java is auto-downloaded as portable JRE (no system installation needed)
+Note: Java is auto-downloaded as portable JRE (no system installation needed). On Pterodactyl, Java is stored in /home/container/.java to save RAM.
 
 ---
 
@@ -341,7 +346,7 @@ async function startServer() {
   server.on("ready", (info) => {
     console.clear();
     console.log(`\n==========================================`);
-    console.log(`Minecraft Server - v2.2.0`);
+    console.log(`Minecraft Server - v2.2.2`);
     console.log(` IP: ${publicIp}:${info.port}`);
     console.log(` Version: ${info.version}`);
     console.log(` Memory: ${info.memory.used}/${info.memory.max} MB`);
@@ -470,7 +475,7 @@ autoAcceptEula boolean true Automatically accept Minecraft EULA
 Java Options
 
 Option Type Default Description
-usePortableJava boolean true Download portable JRE to current directory
+usePortableJava boolean true Download portable JRE to /home/container/.java (Pterodactyl) or /tmp/.mc-headless
 javaVersion string 'auto' '17', '21', or 'auto'
 
 Memory Options
@@ -1070,12 +1075,13 @@ const server = new MinecraftServer({
 });
 ```
 
-· Downloads JRE (not full JDK) ~50MB
-· Extracts to .java/jre-{version}/ in current directory
-· Auto-cleanup after 24 hours
-· No system installation required
-· Sets JAVA_HOME and PATH automatically
-· Adds MALLOC_ARENA_MAX=2 for memory efficiency
+· Smart Storage: Automatically detects Pterodactyl environment and stores Java in /home/container/.java (disk) instead of /tmp (RAM)
+· Low RAM Warning: Alerts if storing Java in /tmp on systems with less than 3GB RAM
+· Multi-Architecture: Supports x64, ARM64 (Oracle Cloud), and ARM (Raspberry Pi)
+· Streaming Download: Downloads and extracts simultaneously, saving disk space
+· Auto-Update: Checks and updates Java if older than 30 days
+· Robust Download: Rotating user-agents, retry logic, stalled detection, size verification
+· No System Installation: Java runs from local folder, no root required
 
 Java Version Requirements
 
@@ -1170,9 +1176,18 @@ EOF
 node index.js
 ```
 
-Pterodactyl Egg Configuration
+Pterodactyl Environment Variables
+
+MC-Headless automatically detects Pterodactyl and respects these environment variables:
 
-If you want to create a custom Pterodactyl egg:
+Variable Description Default
+SERVER_PORT Server port 25565
+SERVER_MEMORY_INIT Initial memory 2G
+SERVER_MEMORY_MAX Max memory 4G
+SERVER_MOTD Message of the day "Minecraft Server"
+SERVER_IP Bind IP 0.0.0.0
+
+Pterodactyl Egg Configuration
 
 ```json
 {
@@ -1261,11 +1276,13 @@ Common Issues
 Issue Cause Solution
 Java not found Java not installed Enable usePortableJava: true
 ENOSPC: no space left Disk full Free disk space, reduce memory
-Download failed: 302 URL redirect Using Node.js downloader (fixed in v2.2.0)
+Download failed: 302 URL redirect Automatic in v2.2.2
 Port already in use Another server running Change port number
 Plugin corrupt Bad download Delete plugin and restart
 High CPU usage Too many chunks Reduce viewDistance to 4
 Out of memory RAM too low Reduce max memory or add RAM
+Java verification failed Corrupt download Automatic retry in v2.2.2
+Download stalled Slow connection Automatic retry in v2.2.2
 
 Disk Space Issues
 
@@ -1389,7 +1406,7 @@ SOFTWARE.
     <a href="https://t.me/Dimzxzzx07">
         <img src="https://img.shields.io/badge/Telegram-Contact-26A5E4?style=for-the-badge&logo=telegram" alt="Telegram">
     </a>
-    <a href="https://github.com/Dimzxzzz">
+    <a href="https://github.com/Dimzxzzx07">
         <img src="https://img.shields.io/badge/GitHub-Follow-181717?style=for-the-badge&logo=github" alt="GitHub">
     </a>
     <br>

package/dist/core/JavaChecker.d.ts

@@ -4,16 +4,22 @@ export interface JavaInfo {
     type: 'system' | 'portable';
 }
 export declare class JavaChecker {
-    private static logger;
     private static readonly JAVA_DIR;
     private static readonly JAVA_URLS;
+    private static getOptimalJavaDirectory;
+    private static getArch;
     static getRequiredJavaVersion(serverVersion: string): '17' | '21';
     static checkJava(): Promise<boolean>;
     static getSystemJavaPath(): string | null;
     static getSystemJavaVersion(): string | null;
-    private static downloadWithNode;
+    private static shouldUpdateJava;
+    private static downloadAndExtractWithStream;
     static getOrDownloadPortableJava(version: '17' | '21'): Promise<JavaInfo>;
     static ensureJava(serverVersion: string, usePortable?: boolean): Promise<JavaInfo>;
     static cleanupOldJava(): void;
+    static getJavaInfo(): {
+        dir: string;
+        arch: string;
+    };
 }
 //# sourceMappingURL=JavaChecker.d.ts.map

package/dist/core/JavaChecker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JavaChecker.d.ts","sourceRoot":"","sources":["../../src/core/JavaChecker.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAGrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAS/B;WAEY,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;WAUpD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;WAenC,iBAAiB,IAAI,MAAM,GAAG,IAAI;WASlC,oBAAoB,IAAI,MAAM,GAAG,IAAI;mBAc9B,gBAAgB;WAoFjB,yBAAyB,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;WAqElE,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;WAyBvF,cAAc,IAAI,IAAI;CAkBvC"}
+{"version":3,"file":"JavaChecker.d.ts","sourceRoot":"","sources":["../../src/core/JavaChecker.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CAC/B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAEzE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CA+B/B;IAEF,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAmBtC,OAAO,CAAC,MAAM,CAAC,OAAO;WAOR,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;WAUpD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;WAYnC,iBAAiB,IAAI,MAAM,GAAG,IAAI;WASlC,oBAAoB,IAAI,MAAM,GAAG,IAAI;IA2BnD,OAAO,CAAC,MAAM,CAAC,gBAAgB;mBAUV,4BAA4B;WAoI7B,yBAAyB,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;WAgElE,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;WAoBvF,cAAc,IAAI,IAAI;WAwBtB,WAAW,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAM7D"}