@dimzxzzx07/mc-headless 1.8.0 → 1.9.0

package/README.md

@@ -1,16 +1,16 @@
-@dimzxzzx07/mc-headless
+# @dimzxzzx07/mc-headless
 
 <div align="center">
     <img src="https://i.imgur.com/LIQuuPL.jpeg" width="800" alt="Minecraft Headless Server">
 </div>
 
 <div align="center">
-    <img src="https://img.shields.io/badge/Version-1.7.0-2563eb?style=for-the-badge&logo=typescript" alt="Version">
+    <img src="https://img.shields.io/badge/Version-1.9.0-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-17%2B-007396?style=for-the-badge&logo=openjdk" alt="Java">
+    <img src="https://img.shields.io/badge/Java-Portable-007396?style=for-the-badge&logo=openjdk" alt="Java Portable">
     <img src="https://img.shields.io/badge/Termux-Friendly-00A98F?style=for-the-badge&logo=termux" alt="Termux">
-    <img src="https://img.shields.io/badge/Stable-1.7.0-brightgreen?style=for-the-badge" alt="Stable">
+    <img src="https://img.shields.io/badge/Stable-1.9.0-brightgreen?style=for-the-badge" alt="Stable">
 </div>
 
 <div align="center">
@@ -30,84 +30,98 @@
 
 ---
 
-Table of Contents
-
-· Overview
-· What's New in 1.7.0
-· Features
-· Why MC-Headless?
-· Installation
-· Quick Start
-· Configuration Guide
-· API Reference
-· Usage Examples
-· Server Types
-· Platform Options
-· Memory Management
-· Network Settings
-· World Configuration
-· Folder Structure
-· Backup System
-· Event System
-· Commands
-· Player Management
-· Cross-Play (Geyser)
-· ViaVersion Support
-· Termux Setup
-· Performance Tuning
-· Troubleshooting
-· Contributing
-· License
+## Table of Contents
+
+- [Overview](#overview)
+- [What's New in 1.9.0](#whats-new-in-190)
+- [Features](#features)
+- [Why MC-Headless?](#why-mc-headless)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Configuration Guide](#configuration-guide)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Server Types](#server-types)
+- [Platform Options](#platform-options)
+- [Memory Management](#memory-management)
+- [Network Settings](#network-settings)
+- [World Configuration](#world-configuration)
+- [Folder Structure](#folder-structure)
+- [Backup System](#backup-system)
+- [Event System](#event-system)
+- [Commands](#commands)
+- [Player Management](#player-management)
+- [Cross-Play (Geyser)](#cross-play-geyser)
+- [ViaVersion Support](#viaversion-support)
+- [SkinRestorer Support](#skinrestorer-support)
+- [Portable Java](#portable-java)
+- [Performance Tuning](#performance-tuning)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
 
 ---
 
-Overview
+## Overview
 
-MC-Headless is a powerful Node.js library that simplifies running Minecraft servers (Java, Bedrock, or Cross-play) with a clean, promise-based API. No more dealing with complex Java commands, server.properties files, or manual downloads - just simple JavaScript methods.
+**MC-Headless** is a powerful Node.js library that simplifies running Minecraft servers (Java, Bedrock, or Cross-play) with a clean, promise-based API. No more dealing with complex Java commands, server.properties files, or manual downloads - just simple JavaScript methods.
 
 Built specifically for developers, sysadmins, and Minecraft enthusiasts who want to automate server management, run headless servers on VPS/Termux, or integrate Minecraft servers into their applications.
 
 ---
 
-What's New in 1.7.0
+## What's New in 1.9.0
 
-Version 1.7.0 - March 2026
+### Version 1.9.0 - March 2026
 
-· Stable ViaVersion Integration - Fixed download URLs for ViaVersion 5.7.2, ViaBackwards 5.7.2, and ViaRewind 4.0.15
-· Improved Error Handling - Better validation and retry logic for plugin downloads
-· File Corruption Prevention - Automatic detection and cleanup of corrupt JAR files
-· ZIP Header Verification - Ensures downloaded plugins are valid before loading
-· Performance Optimizations - Reduced CPU usage with optimized view distance defaults
-· Better Memory Management - Aikar's flags now properly configured for all server types
-· Enhanced Logging - More detailed logs for debugging
+- **Portable Java** - Auto-download JRE to `/tmp` (no system installation required)
+- **Smart Java Detection** - Uses `which java` to check existing installation
+- **Auto-cleanup** - Removes old Java files after 24 hours
+- **Cgroups Support** - Reads CPU/Memory stats directly from kernel (like Pterodactyl)
+- **Silent Mode** - Direct pipe for logs, no Node.js processing overhead
+- **30-second Stats** - Resource monitoring every 30 seconds (not real-time)
+- **MALLOC_ARENA_MAX=2** - Environment optimization for memory efficiency
+- **SkinRestorer Plugin** - Auto-download and install SkinRestorer
+- **System RAM Detection** - Auto-recommend memory based on available RAM
+- **Better Error Handling** - Improved error messages and recovery
 
 ---
 
-Features
-
-Category Features
-Server Types Paper, Purpur, Vanilla, Spigot, Forge, Fabric
-Platforms Java Edition, Bedrock Edition, Cross-play (Geyser)
-Auto Setup Automatic Java detection, EULA acceptance, server.properties generation
-Downloader Automatic download of server jars from official sources
-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
-Termux Friendly Optimized for Android/Termux environments
-Headless Ready No GUI required, perfect for servers and automation
+## Features
+
+| Category | Features |
+|----------|----------|
+| **Server Types** | Paper, Purpur, Vanilla, Spigot, Forge, Fabric |
+| **Platforms** | Java Edition, Bedrock Edition, Cross-play (Geyser) |
+| **Auto Setup** | Automatic Java detection, EULA acceptance, server.properties generation |
+| **Portable Java** | Download JRE to `/tmp`, no system installation required |
+| **Cgroups Stats** | CPU/Memory stats like Pterodactyl (30s interval) |
+| **Downloader** | Automatic download of server jars from official sources |
+| **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 |
+| **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 |
 
 ---
 
-Why MC-Headless?
-
-Before (Manual Setup)
+## Why MC-Headless?
 
+### Before (Manual Setup)
 ```bash
 # Download server jar
 wget https://api.papermc.io/v2/projects/paper/versions/1.21.11/builds/69/downloads/paper-1.21.11-69.jar
 
+# Check if Java installed
+which java || echo "Java not found"
+
+# Install Java manually if needed
+sudo apt install openjdk-17-jre-headless
+
 # Accept EULA
 echo "eula=true" > eula.txt
 
@@ -116,24 +130,26 @@ echo "server-port=25565" > server.properties
 echo "max-players=20" >> server.properties
 
 # Run server with complex Java flags
-java -Xms2G -Xmx4G -XX:+UseG1GC -jar paper-1.21.11-69.jar nogui
+java -Xms4G -Xmx12G -XX:+UseG1GC -jar paper-1.21.11-69.jar nogui
 
 # Download plugins manually
 wget https://github.com/ViaVersion/ViaVersion/releases/download/5.7.2/ViaVersion-5.7.2.jar -P plugins/
+wget https://github.com/SkinsRestorer/SkinsRestorerX/releases/latest/download/SkinsRestorer.jar -P plugins/
 
 # Monitor manually
 tail -f logs/latest.log
 ```
 
-After (MC-Headless)
+After (MC-Headless v1.9.0)
 
 ```javascript
 const server = new MinecraftServer({
   version: '1.21.11',
   type: 'paper',
-  memory: { init: '2G', max: '4G' },
-  network: { port: 25565 },
-  enableViaVersion: true
+  usePortableJava: true,
+  memory: { init: '4G', max: '12G' },
+  enableViaVersion: true,
+  enableSkinRestorer: true
 });
 
 server.on('ready', () => console.log('Server ready!'));
@@ -160,92 +176,156 @@ Requirements
 
 Requirement Minimum Recommended
 Node.js 18.0.0 20.0.0 or higher
-Java 17 17 or 21
 RAM 2 GB 4 GB or more
 Storage 1 GB 5 GB
 OS Linux, macOS, Windows, Termux Linux (production)
 
+Note: Java is auto-downloaded as portable JRE (no system installation needed)
+
 ---
 
 Quick Start
 
-Basic Java Server
+Basic Java Server with Portable Java
 
 ```javascript
 const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
+const os = require('os');
+
+async function startServer() {
+  // Auto-detect system RAM
+  const totalRam = Math.floor(os.totalmem() / 1024 / 1024 / 1024);
+  const recommendedMax = Math.min(12, Math.max(2, Math.floor(totalRam * 0.7)));
+
+  console.log(`System RAM: ${totalRam}GB, Recommended: ${recommendedMax}GB`);
+
+  const server = new MinecraftServer({
+    platform: 'java',
+    version: '1.21.11',
+    type: 'paper',
+    usePortableJava: true,
+    memory: {
+      init: '4G',
+      max: `${recommendedMax}G`,
+      useAikarsFlags: true
+    }
+  });
+
+  server.on('ready', (info) => {
+    console.log(`Server ready on port ${info.port}`);
+    console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
+    console.log(`CPU: ${info.cpu}%`);
+  });
+
+  await server.start();
+}
 
-const server = new MinecraftServer({
-  platform: 'java',
-  version: '1.21.11',
-  type: 'paper',
-  memory: {
-    init: '2G',
-    max: '4G'
-  }
-});
-
-server.on('ready', (info) => {
-  console.log(`Server is ready on port ${info.port}`);
-  console.log(`Version: ${info.version} ${info.type}`);
-});
-
-server.on('player-join', (player) => {
-  console.log(`${player.name} joined the game`);
-});
-
-server.on('player-leave', (name) => {
-  console.log(`${name} left the game`);
-});
-
-server.start().catch(console.error);
+startServer();
 ```
 
-Basic Bedrock Server
+Complete Server with All Features
 
 ```javascript
 const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
-
-const server = new MinecraftServer({
-  platform: 'bedrock',
-  version: '1.21.11',
-  network: {
-    port: 19132,
-    motd: 'Bedrock Server'
+const axios = require('axios');
+const os = require('os');
+
+async function startServer() {
+  // Get public IP
+  let publicIp = "127.0.0.1";
+  try {
+    const res = await axios.get('https://api.ipify.org?format=json');
+    publicIp = res.data.ip;
+  } catch (err) {
+    console.log("Using default IP");
   }
-});
-
-server.start();
-```
-
-Cross-Play Server with ViaVersion
 
-```javascript
-const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
-
-const server = new MinecraftServer({
-  platform: 'all',
-  version: '1.21.11',
-  type: 'paper',
-  memory: {
-    init: '2G',
-    max: '4G'
-  },
-  network: {
-    port: 25565,
-    bedrockPort: 19132,
-    motd: 'Cross-Play Server'
-  },
-  enableViaVersion: true,
-  enableViaBackwards: true,
-  enableViaRewind: true
-});
-
-server.on('ready', () => {
-  console.log('Server ready with ViaVersion support!');
-  console.log('Players from 1.7.x to 1.21.x can join');
-});
+  // Auto-detect RAM
+  const totalRam = Math.floor(os.totalmem() / 1024 / 1024 / 1024);
+  const recommendedMax = Math.min(12, Math.max(2, Math.floor(totalRam * 0.7)));
+
+  const server = new MinecraftServer({
+    platform: "all",
+    version: "1.21.11",
+    type: "paper",
+    autoAcceptEula: true,
+    
+    // Java options
+    usePortableJava: true,
+    javaVersion: "auto",
+    
+    memory: {
+      init: "4G",
+      max: "12G",
+      useAikarsFlags: true
+    },
+    
+    network: {
+      ip: "0.0.0.0",
+      port: 25565,
+      bedrockPort: 19132,
+      motd: "Minecraft 1.21.11 Server",
+      onlineMode: false
+    },
+
+    world: {
+      difficulty: "normal",
+      maxPlayers: 20,
+      levelName: "world",
+      viewDistance: 6,
+      simulationDistance: 4
+    },
+    
+    // Plugins
+    enableViaVersion: true,
+    enableViaBackwards: true,
+    enableViaRewind: true,
+    enableSkinRestorer: true,
+    
+    // Monitoring
+    memoryMonitor: {
+      enabled: true,
+      threshold: 85,
+      interval: 30000,
+      action: 'warn'
+    },
+    
+    // Performance
+    silentMode: true,
+    statsInterval: 30000
+  });
+
+  server.on("ready", (info) => {
+    console.clear();
+    console.log(`\n==========================================`);
+    console.log(`Minecraft Server - v1.9.0`);
+    console.log(` IP: ${publicIp}:${info.port}`);
+    console.log(` Version: ${info.version}`);
+    console.log(` Memory: ${info.memory.used}/${info.memory.max} MB`);
+    console.log(` CPU: ${info.cpu || 0}%`);
+    console.log(` Players: ${info.players}/${info.maxPlayers}`);
+    console.log(`==========================================\n`);
+  });
+
+  server.on("player-join", (player) => {
+    console.log(`${player.name} joined`);
+    server.sendCommand(`tellraw ${player.name} {"text":"Welcome!","color":"aqua"}`);
+  });
+
+  server.on("player-leave", (name) => {
+    console.log(`${name} left`);
+  });
+
+  server.on("resource", (info) => {
+    if (info.memory.used > info.memory.max * 0.8) {
+      console.log(`high memory: ${info.memory.used}/${info.memory.max} MB`);
+    }
+  });
+
+  await server.start();
+}
 
-server.start();
+startServer();
 ```
 
 ---
@@ -264,10 +344,14 @@ const server = new MinecraftServer({
   type: 'paper',
   autoAcceptEula: true,
 
+  // Java Options
+  usePortableJava: true,
+  javaVersion: 'auto',
+
   // Resource Management
   memory: {
-    init: '2G',
-    max: '4G',
+    init: '4G',
+    max: '12G',
     useAikarsFlags: true
   },
 
@@ -287,7 +371,7 @@ const server = new MinecraftServer({
     gamemode: 'survival',
     seed: 'my-secret-seed',
     maxPlayers: 20,
-    viewDistance: 8,
+    viewDistance: 6,
     simulationDistance: 4,
     levelName: 'world'
   },
@@ -300,6 +384,12 @@ const server = new MinecraftServer({
     world: './world'
   },
 
+  // Plugins
+  enableViaVersion: true,
+  enableViaBackwards: true,
+  enableViaRewind: true,
+  enableSkinRestorer: true,
+
   // Server Behavior
   autoRestart: true,
   backup: {
@@ -308,10 +398,17 @@ const server = new MinecraftServer({
     path: './backups'
   },
 
-  // ViaVersion Support
-  enableViaVersion: true,
-  enableViaBackwards: true,
-  enableViaRewind: true
+  // Monitoring
+  memoryMonitor: {
+    enabled: true,
+    threshold: 85,
+    interval: 30000,
+    action: 'warn'
+  },
+
+  // Performance
+  silentMode: true,
+  statsInterval: 30000
 });
 
 await server.start();
@@ -327,11 +424,17 @@ version string '1.21.11' Minecraft version
 type string 'paper' paper, purpur, vanilla, spigot, forge, fabric
 autoAcceptEula boolean true Automatically accept Minecraft EULA
 
+Java Options
+
+Option Type Default Description
+usePortableJava boolean true Download portable JRE to /tmp
+javaVersion string 'auto' '17', '21', or 'auto'
+
 Memory Options
 
 Option Type Default Description
-memory.init string '1G' Initial heap size
-memory.max string '2G' Maximum heap size
+memory.init string '2G' Initial heap size
+memory.max string '4G' Maximum heap size
 memory.useAikarsFlags boolean true Use Aikar's optimized GC flags
 
 Network Options
@@ -351,31 +454,23 @@ world.hardcore boolean false Enable hardcore mode
 world.gamemode string 'survival' survival, creative, adventure, spectator
 world.seed string undefined World generation seed
 world.maxPlayers number 20 Maximum player count
-world.viewDistance number 8 Chunk view distance
+world.viewDistance number 6 Chunk view distance
 world.simulationDistance number 4 Simulation distance
 world.levelName string 'world' World folder name
 
-Folder Options
-
-Option Type Default Description
-folders.addons string './addons' Bedrock addons folder
-folders.mods string './mods' Forge/Fabric mods folder
-folders.plugins string './plugins' Paper/Spigot plugins folder
-folders.world string './world' World data folder
-
-Backup Options
-
-Option Type Default Description
-backup.enabled boolean false Enable automatic backups
-backup.interval string '24h' Backup interval
-backup.path string './backups' Backup storage path
-
-ViaVersion Options
+Plugin Options
 
 Option Type Default Description
 enableViaVersion boolean false Enable ViaVersion plugin
 enableViaBackwards boolean false Enable ViaBackwards plugin
 enableViaRewind boolean false Enable ViaRewind plugin
+enableSkinRestorer boolean false Enable SkinRestorer plugin
+
+Performance Options
+
+Option Type Default Description
+silentMode boolean true Direct pipe logs (no Node.js processing)
+statsInterval number 30000 Stats update interval in ms
 
 ---
 
@@ -422,589 +517,145 @@ interface ServerInfo {
     used: number;
     max: number;
   };
+  cpu: number;
   status: 'starting' | 'running' | 'stopping' | 'stopped' | 'crashed';
 }
 ```
 
-Player Interface
-
-```javascript
-interface Player {
-  name: string;
-  uuid: string;
-  ip: string;
-  ping: number;
-  connectedAt: Date;
-}
-```
-
 ---
 
 Usage Examples
 
-Advanced Server Configuration
+Server with Auto RAM Detection
 
 ```javascript
 const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
+const os = require('os');
+
+const totalRam = Math.floor(os.totalmem() / 1024 / 1024 / 1024);
+const maxRam = Math.min(12, Math.floor(totalRam * 0.7));
 
 const server = new MinecraftServer({
-  platform: 'java',
   version: '1.21.11',
   type: 'paper',
-  
+  usePortableJava: true,
   memory: {
-    init: '2G',
-    max: '8G',
-    useAikarsFlags: true
-  },
-  
-  network: {
-    port: 25565,
-    ip: '0.0.0.0',
-    onlineMode: true,
-    motd: 'Premium Minecraft Server'
-  },
-  
-  world: {
-    difficulty: 'hard',
-    gamemode: 'survival',
-    maxPlayers: 50,
-    viewDistance: 8,
-    simulationDistance: 4,
-    levelName: 'survival_world'
-  },
-  
-  folders: {
-    plugins: './plugins',
-    world: './survival_world'
-  },
-  
-  autoRestart: true,
-  backup: {
-    enabled: true,
-    interval: '12h',
-    path: './backups'
-  },
-  
-  enableViaVersion: true,
-  enableViaBackwards: true,
-  enableViaRewind: true
-});
-
-server.on('ready', async (info) => {
-  console.log(`Server PID: ${info.pid}`);
-  console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
-  console.log('ViaVersion active - all versions welcome!');
+    init: `${Math.floor(maxRam * 0.3)}G`,
+    max: `${maxRam}G`
+  }
 });
 
-server.on('resource', (info) => {
-  if (info.memory.used > info.memory.max * 0.9) {
-    console.log('High memory usage detected');
-  }
+server.on('ready', (info) => {
+  console.log(`Server running with ${info.memory.max} MB max`);
 });
 
 server.start();
 ```
 
-Multiple Servers Manager
+Multiple Servers with Different Versions
 
 ```javascript
 const { ServerManager } = require('@dimzxzzx07/mc-headless');
 
 const manager = new ServerManager();
 
-// Create survival server
-const survival = manager.createServer('survival', {
+// Create servers
+manager.createServer('lobby', {
   version: '1.21.11',
   type: 'paper',
   network: { port: 25565 }
 });
 
-// Create creative server
-const creative = manager.createServer('creative', {
+manager.createServer('survival', {
   version: '1.21.11',
   type: 'paper',
   network: { port: 25566 },
-  world: { gamemode: 'creative' }
-});
-
-// Start all servers
-await manager.startServer('survival');
-await manager.startServer('creative');
-
-// Broadcast to all servers
-await manager.broadcastCommand('say Server is running!');
-```
-
-Server Control with Commands
-
-```javascript
-server.on('ready', () => {
-  // Send various commands
-  server.sendCommand('say Welcome to the server!');
-  server.sendCommand('time set day');
-  server.sendCommand('weather clear');
-  server.sendCommand('difficulty normal');
-  
-  // OP a player
-  server.sendCommand('op Dimzxzzx07');
-  
-  // Save world
-  server.sendCommand('save-all');
-});
-
-// Get server stats periodically
-setInterval(async () => {
-  const info = await server.getInfo();
-  console.log(`Players: ${info.players}/${info.maxPlayers}`);
-  console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
-}, 60000);
-```
-
----
-
-Server Types
-
-Paper (Recommended for Performance)
-
-```javascript
-const server = new MinecraftServer({
-  type: 'paper',
-  version: '1.21.11',
-  memory: { useAikarsFlags: true }
-});
-```
-
-Vanilla (Official Mojang)
-
-```javascript
-const server = new MinecraftServer({
-  type: 'vanilla',
-  version: '1.21.11'
-});
-```
-
-Forge (Modded)
-
-```javascript
-const server = new MinecraftServer({
-  type: 'forge',
-  version: '1.21.11',
-  folders: { mods: './mods' }
-});
-```
-
-Fabric (Lightweight Modding)
-
-```javascript
-const server = new MinecraftServer({
-  type: 'fabric',
-  version: '1.21.11',
-  folders: { mods: './mods' }
-});
-```
-
----
-
-Platform Options
-
-Java Edition Only
-
-```javascript
-const server = new MinecraftServer({
-  platform: 'java',
-  version: '1.21.11',
-  type: 'paper',
-  network: { port: 25565 }
-});
-```
-
-Bedrock Edition Only
-
-```javascript
-const server = new MinecraftServer({
-  platform: 'bedrock',
-  version: '1.21.11',
-  network: { port: 19132 },
-  folders: { addons: './addons' }
+  world: { levelName: 'survival' }
 });
-```
-
-Cross-Play (Java + Bedrock)
 
-```javascript
-const server = new MinecraftServer({
-  platform: 'all',
+manager.createServer('creative', {
   version: '1.21.11',
   type: 'paper',
-  network: {
-    port: 25565,
-    bedrockPort: 19132
-  }
-});
-```
-
----
-
-Memory Management
-
-Basic Memory Configuration
-
-```javascript
-memory: {
-  init: '2G',
-  max: '4G',
-  useAikarsFlags: false
-}
-```
-
-Aikar's Flags (Optimized)
-
-```javascript
-memory: {
-  init: '2G',
-  max: '8G',
-  useAikarsFlags: true
-}
-```
-
-Memory Recommendations
-
-Players RAM Init Max
-1-10 2 GB 1G 2G
-10-20 4 GB 2G 4G
-20-50 8 GB 4G 8G
-50-100 16 GB 8G 16G
-
----
-
-Network Settings
-
-Basic Network
-
-```javascript
-network: {
-  port: 25565,
-  ip: '0.0.0.0',
-  onlineMode: false,
-  motd: 'My Server'
-}
-```
-
-Cross-Play Network
-
-```javascript
-network: {
-  port: 25565,
-  bedrockPort: 19132,
-  ip: '0.0.0.0',
-  onlineMode: false,
-  motd: 'Cross-Play Server'
-}
-```
-
----
-
-World Configuration
-
-Basic World
-
-```javascript
-world: {
-  difficulty: 'normal',
-  gamemode: 'survival',
-  maxPlayers: 20,
-  viewDistance: 8,
-  simulationDistance: 4,
-  levelName: 'world'
-}
-```
-
-Hardcore Mode
-
-```javascript
-world: {
-  difficulty: 'hard',
-  hardcore: true,
-  gamemode: 'survival',
-  maxPlayers: 10,
-  viewDistance: 6
-}
-```
-
-Custom Seed
-
-```javascript
-world: {
-  seed: 'my-amazing-seed-12345',
-  levelName: 'custom_world'
-}
-```
-
----
-
-Folder Structure
-
-```
-server/
-├── plugins/          # Paper/Spigot plugins
-├── mods/             # Forge/Fabric mods
-├── addons/           # Bedrock addons
-├── world/            # World data
-├── logs/             # Server logs
-└── backups/          # Backup files
-```
-
----
-
-Backup System
-
-Enable Automatic Backups
-
-```javascript
-backup: {
-  enabled: true,
-  interval: '24h',
-  path: './backups'
-}
-```
-
-Manual Backup
-
-```javascript
-// Full backup
-const fullPath = await server.backup('full');
-
-// World only backup
-const worldPath = await server.backup('world');
-
-// Plugins only backup
-const pluginsPath = await server.backup('plugins');
-```
-
----
-
-Event System
-
-Server Events
-
-```javascript
-server.on('ready', (info) => {
-  console.log('Server ready at', info.port);
-});
-
-server.on('stop', ({ code }) => {
-  console.log('Server stopped with code', code);
-});
-
-server.on('resource', (info) => {
-  console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
-});
-```
-
-Player Events
-
-```javascript
-server.on('player-join', (player) => {
-  console.log(`${player.name} joined from ${player.ip}`);
-  server.sendCommand(`say Welcome ${player.name}!`);
-});
-
-server.on('player-leave', (name) => {
-  console.log(`${name} left the game`);
-});
-```
-
----
-
-Commands
-
-Built-in Commands
-
-```javascript
-// Send any Minecraft command
-server.sendCommand('say Hello world');
-server.sendCommand('time set day');
-server.sendCommand('weather clear');
-server.sendCommand('difficulty hard');
-server.sendCommand('gamemode creative @a');
-```
-
-Console Commands
-
-```javascript
-// Stop server
-server.sendCommand('stop');
-
-// Save world
-server.sendCommand('save-all');
-
-// List players
-server.sendCommand('list');
-
-// Ban player
-server.sendCommand('ban Notch');
-```
-
----
-
-Player Management
-
-Get Player List
-
-```javascript
-const players = server.getPlayers();
-players.forEach(player => {
-  console.log(`${player.name} - Ping: ${player.ping}ms`);
+  network: { port: 25567 },
+  world: { gamemode: 'creative' }
 });
-```
 
-Player Count
+// Start all
+await manager.startAll();
 
-```javascript
-const info = await server.getInfo();
-console.log(`Players online: ${info.players}/${info.maxPlayers}`);
+// Broadcast command
+await manager.broadcastCommand('say Server is running!');
 ```
 
 ---
 
-Cross-Play (Geyser)
+Portable Java
 
-Automatic Setup
+How It Works
 
 ```javascript
 const server = new MinecraftServer({
-  platform: 'all',
-  version: '1.21.11',
-  type: 'paper',
-  network: {
-    port: 25565,
-    bedrockPort: 19132
-  }
+  usePortableJava: true,  // Download JRE to /tmp
+  javaVersion: '17'        // or '21', 'auto'
 });
 ```
 
+· Downloads JRE (not full JDK) ~50MB
+· Extracts to /tmp/.mc-headless-java/
+· Auto-cleanup after 24 hours
+· No system installation required
+· Sets JAVA_HOME and PATH automatically
+· Adds MALLOC_ARENA_MAX=2 for memory efficiency
+
 ---
 
-ViaVersion Support
+SkinRestorer Support
 
-Enable All ViaVersion Plugins
+Enable SkinRestorer
 
 ```javascript
 const server = new MinecraftServer({
-  version: '1.21.11',
-  type: 'paper',
-  enableViaVersion: true,
-  enableViaBackwards: true,
-  enableViaRewind: true
+  enableSkinRestorer: true  // Auto-download and install
 });
 ```
 
-What Each Plugin Does
-
-Plugin Function
-ViaVersion Allows newer clients to connect to older servers
-ViaBackwards Allows older clients to connect to newer servers
-ViaRewind Adds support for 1.7.x - 1.8.x clients
-
-With ViaVersion enabled, your server can accept connections from Minecraft versions 1.7.x through 1.21.x.
-
----
-
-Termux Setup
-
-Install in Termux
-
-```bash
-# Update packages
-pkg update && pkg upgrade
-
-# Install Node.js
-pkg install nodejs
-
-# Install Java
-pkg install openjdk-17
-
-# Install mc-headless
-npm install -g @dimzxzzx07/mc-headless
-
-# Create server
-mkdir minecraft-server
-cd minecraft-server
-npm init -y
-npm install @dimzxzzx07/mc-headless
-
-# Create server script
-cat > server.js << 'EOF'
-const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
-
-const server = new MinecraftServer({
-  platform: 'java',
-  version: '1.21.11',
-  type: 'paper',
-  memory: {
-    init: '512M',
-    max: '2G'
-  }
-});
-
-server.start();
-EOF
-
-# Run server
-node server.js
-```
+· Auto-downloads latest SkinRestorer
+· Fixes player skins for offline mode
+· Works with Geyser (Bedrock players)
+· No manual plugin installation needed
 
 ---
 
 Performance Tuning
 
-Optimized Configuration for Low CPU
+Optimized Configuration
 
 ```javascript
 const server = new MinecraftServer({
   version: '1.21.11',
   type: 'paper',
+  usePortableJava: true,
   memory: {
-    init: '1G',
-    max: '3G',
+    init: '4G',
+    max: '12G',
     useAikarsFlags: true
   },
   world: {
-    maxPlayers: 20,
     viewDistance: 6,
-    simulationDistance: 4
-  }
+    simulationDistance: 4,
+    maxPlayers: 20
+  },
+  silentMode: true,
+  statsInterval: 30000
 });
 ```
 
-Paper Configuration (paper-global.yml)
+Environment Optimizations
 
-```yaml
-chunk-loading:
-  global-max-chunk-load-rate: 100
-  global-max-chunk-send-rate: 50
-
-entities:
-  spawn-limits:
-    monster: 15
-    creature: 10
-    ambient: 5
-
-player-auto-save: 6000
-```
-
-Bukkit Configuration (bukkit.yml)
-
-```yaml
-settings:
-  spawn-limits:
-    monsters: 30
-    animals: 10
-  ticks-per:
-    monster-spawns: 200
-    animal-spawns: 400
-```
+Variable Value Effect
+MALLOC_ARENA_MAX 2 Prevents memory fragmentation
+_JAVA_OPTIONS -Xmx... Global Java memory limit
+JAVA_HOME (auto) Points to portable Java
 
 ---
 
@@ -1013,57 +664,20 @@ Troubleshooting
 Common Issues
 
 Issue Cause Solution
-Java not found Java not installed Run pkg install openjdk-17 in Termux
-Port already in use Another server running Change port or kill other process
-Out of memory Insufficient RAM Reduce max memory or add more RAM
-Connection refused Firewall blocking Check firewall settings
+Java not found No system Java Enable usePortableJava: true
+High memory usage Too many chunks Reduce viewDistance
+High CPU usage Stats interval too low Increase statsInterval to 60000
 Plugin corrupt Bad download Delete plugin and restart
-High CPU usage Too many chunks loaded Reduce view distance
-
-Debug Mode
-
-```javascript
-// Enable debug logging
-const server = new MinecraftServer({
-  // ... config
-  debug: true
-});
-```
+Port in use Another server Change port number
 
-Logs Location
+Check Logs
 
 ```bash
-# Server logs
-tail -f logs/latest.log
+# Server logs are piped directly
+# Just look at console output
 
-# MC-Headless logs
-tail -f logs/mc-headless.log
-```
-
----
-
-Project Structure
-
-```
-mc-headless/
-├── src/
-│   ├── core/
-│   │   ├── MinecraftServer.ts
-│   │   ├── ConfigHandler.ts
-│   │   └── JavaChecker.ts
-│   ├── engines/
-│   │   ├── PaperEngine.ts
-│   │   ├── VanillaEngine.ts
-│   │   └── ...
-│   ├── platforms/
-│   │   ├── GeyserBridge.ts
-│   │   └── ViaVersion.ts
-│   └── utils/
-│       ├── Logger.ts
-│       └── FileUtils.ts
-├── tests/
-├── examples/
-└── README.md
+# Or check cgroup stats
+cat /sys/fs/cgroup/memory/memory.usage_in_bytes
 ```
 
 ---