@dimzxzzx07/mc-headless 2.2.2 → 2.2.3

package/README.md

@@ -5,7 +5,7 @@
 </div>
 
 <div align="center">
-    <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/Version-2.2.3-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">
@@ -55,11 +55,14 @@
 ## Table of Contents
 
 - [What is MC-Headless?](#what-is-mc-headless)
-- [What's New in 2.2.2](#whats-new-in-222)
+- [What's New in 2.2.3](#whats-new-in-223)
 - [Features](#features)
 - [Why MC-Headless?](#why-mc-headless)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Server Startup Flow Diagram](#server-startup-flow-diagram)
+- [Pterodactyl Setup (No Egg Required)](#pterodactyl-setup-no-egg-required)
+- [How to Connect from Minecraft](#how-to-connect-from-minecraft)
 - [Configuration Guide](#configuration-guide)
 - [API Reference](#api-reference)
 - [Usage Examples](#usage-examples)
@@ -68,6 +71,8 @@
 - [Memory Management](#memory-management)
 - [Network Settings](#network-settings)
 - [World Configuration](#world-configuration)
+- [Plugins & Boosters](#plugins--boosters)
+- [RAM Disk & Symlink System](#ram-disk--symlink-system)
 - [Folder Structure](#folder-structure)
 - [Backup System](#backup-system)
 - [Event System](#event-system)
@@ -78,7 +83,6 @@
 - [SkinRestorer Support](#skinrestorer-support)
 - [Portable Java](#portable-java)
 - [Performance Tuning](#performance-tuning)
-- [Pterodactyl Setup](#pterodactyl-setup)
 - [Termux Setup](#termux-setup)
 - [Troubleshooting](#troubleshooting)
 - [Contributing](#contributing)
@@ -111,21 +115,42 @@ Built specifically for developers, sysadmins, and Minecraft enthusiasts who want
 
 ---
 
-## What's New in 2.2.2
-
-### Version 2.2.2 - March 2026
-
-- **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
+## What's New in 2.2.3
+
+### Version 2.2.3 - March 2026
+
+- **Plugin Manager System** - Auto-download and install popular plugins:
+  - ProtocolLib
+  - TCPShield
+  - Spigot-Optimizers
+  - Spark (profiler)
+  - ViewDistanceTweaks
+  - FarmControl
+  - EntityDetection
+- **RAM Disk Technology** - Run worlds, plugins, and addons in RAM for lightning-fast performance
+- **Symlink Master Storage** - Secure master folder with symbolic links for data protection
+- **Auto RAM Backup** - Automatically backup RAM data to disk every 5 minutes
+- **RAM Restore on Crash** - Automatically restore data from master storage after crash
+- **Network Optimization Suite**:
+  - TCP_NODELAY enabled by default
+  - Adjustable compression threshold (64-512)
+  - Velocity proxy support
+  - BungeeCord mode
+- **Java Arguments Optimization**:
+  - `-XX:+UseG1GC -XX:MaxGCPauseMillis=50`
+  - `-XX:+UseStringDeduplication`
+  - `-Djava.net.preferIPv4Stack=true`
+  - `-Djava.net.tcpFastOpen=true`
+  - `-Djava.net.tcp.nodelay=true`
+  - `-Dio.netty.recycler.maxCapacity.default=0`
+  - `-Dio.netty.leakDetectionLevel=disabled`
+- **Pterodactyl Port Sharing** - Geyser can run on same port as Java when only one port available
+- **Auto UDP Detection** - Warns if Bedrock port needs UDP configuration
+- **Stream Finished Guarantee** - Ensures downloads complete properly with stream.finished
+- **1-Second Download Delay** - Prevents plugin corruption during simultaneous downloads
+- **Auto-cleanup Paper Remapped** - Automatically removes corrupt `.paper-remapped` folders
+- **Memory Safety** - Uses 90% of cgroup limit to prevent OOM killer
+- **Smart Restart** - Only restarts when no players online
 
 ---
 
@@ -135,7 +160,11 @@ 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) |
+| **Plugins** | ProtocolLib, TCPShield, Spark, ViewDistanceTweaks, FarmControl, EntityDetection |
+| **RAM Disk** | World/plugins/addons in RAM, auto backup to disk, restore after crash |
+| **Symlink Master** | Secure master storage with symbolic links |
 | **Architecture Support** | x64, ARM64, ARM (Raspberry Pi, Oracle Cloud) |
+| **Pterodactyl Integration** | Auto-detect, port sharing, environment variables, 90% memory safety |
 | **Auto Setup** | Automatic Java detection, EULA acceptance, server.properties generation |
 | **Portable Java** | Download JRE to `/home/container/.java` (Pterodactyl) or `/tmp/.mc-headless` |
 | **Smart Storage** | Detects Pterodactyl, warns on low RAM for /tmp usage |
@@ -148,7 +177,6 @@ Built specifically for developers, sysadmins, and Minecraft enthusiasts who want
 | **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 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 |
@@ -186,7 +214,7 @@ wget https://github.com/SkinsRestorer/SkinsRestorerX/releases/latest/download/Sk
 tail -f logs/latest.log
 ```
 
-After (MC-Headless v2.2.2)
+After (MC-Headless v2.2.3)
 
 ```javascript
 const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
@@ -197,7 +225,15 @@ const server = new MinecraftServer({
   usePortableJava: true,
   memory: { init: '4G', max: '12G' },
   enableViaVersion: true,
-  enableSkinRestorer: true
+  enableSkinRestorer: true,
+  enableProtocolLib: true,
+  enableSpark: true,
+  ramdisk: {
+    enabled: true,
+    world: true,
+    plugins: true,
+    backupInterval: 300000
+  }
 });
 
 server.on('ready', () => console.log('Server ready!'));
@@ -241,7 +277,6 @@ 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)));
 
@@ -279,7 +314,6 @@ 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');
@@ -288,17 +322,12 @@ async function startServer() {
     console.log("Using default IP");
   }
 
-  // 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",
     
@@ -324,13 +353,45 @@ async function startServer() {
       simulationDistance: 4
     },
     
-    // Plugins
+    // New plugins in 2.2.3
     enableViaVersion: true,
     enableViaBackwards: true,
     enableViaRewind: true,
     enableSkinRestorer: true,
+    enableProtocolLib: true,
+    enableTCPShield: true,
+    enableSpigotOptimizers: true,
+    enableSpark: true,
+    enableViewDistanceTweaks: true,
+    enableFarmControl: true,
+    enableEntityDetection: true,
+    
+    // RAM Disk (NEW)
+    ramdisk: {
+      enabled: true,
+      world: true,
+      plugins: true,
+      addons: true,
+      backupInterval: 300000,
+      masterStorage: '/home/minecraft-master'
+    },
+    
+    // Symlink Master (NEW)
+    symlinkMaster: '/home/minecraft-master',
+    
+    // Network Optimization (NEW)
+    networkOptimization: {
+      tcpFastOpen: true,
+      tcpNoDelay: true,
+      preferIPv4: true,
+      compressionThreshold: 64,
+      bungeeMode: false,
+      velocity: {
+        enabled: false,
+        secret: ''
+      }
+    },
     
-    // Monitoring
     memoryMonitor: {
       enabled: true,
       threshold: 85,
@@ -338,21 +399,24 @@ async function startServer() {
       action: 'warn'
     },
     
-    // Performance
     silentMode: true,
     statsInterval: 30000
   });
 
   server.on("ready", (info) => {
     console.clear();
-    console.log(`\n==========================================`);
-    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`);
-    console.log(` CPU: ${info.cpu || 0}%`);
-    console.log(` Players: ${info.players}/${info.maxPlayers}`);
-    console.log(`==========================================\n`);
+    console.log(`
+==========================================
+Minecraft Server - v2.2.3
+ IP: ${publicIp}:${info.port}
+ Version: ${info.version}
+ Memory: ${info.memory.used}/${info.memory.max} MB
+ CPU: ${info.cpu}%
+ Players: ${info.players}/${info.maxPlayers}
+ RAM Disk: Active
+ Plugins: 7 boosters installed
+==========================================
+    `);
   });
 
   server.on("player-join", (player) => {
@@ -364,46 +428,367 @@ async function startServer() {
     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();
+}
+
+startServer();
+```
+
+---
+
+Server Startup Flow Diagram
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                     SERVER STARTUP FLOW                         │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────┐
+│  detectEnvironment │
+│  • Pterodactyl?    │
+│  • Set ports       │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│  setupSymlinkMaster │
+│  • Create /home/    │
+│    minecraft-master │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│   restoreFromMaster  │
+│  • Check RAM disk    │
+│  • Copy from master  │
+│    if RAM empty      │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│    setupRamdisk     │
+│  • Create symlinks  │
+│  • Schedule backups │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│   ensureJava       │
+│  • Check system    │
+│  • Download JRE    │
+│    if needed       │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│   download server  │
+│  • Paper/Vanilla   │
+│    etc.            │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│   setup geyser     │
+│  • If platform all │
+│  • Configure ports │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│  install plugins   │
+│  • ProtocolLib     │
+│  • TCPShield       │
+│  • Spark           │
+│  • ViewDistance    │
+│  • FarmControl     │
+│  • EntityDetection │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│   setup viaversion │
+│  • ViaVersion      │
+│  • ViaBackwards    │
+│  • ViaRewind       │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│    launch server   │
+│  • Build Java args │
+│  • Set environment │
+│  • Spawn process   │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│    monitor logs    │
+│  • Wait for "Done" │
+│  • Track players   │
+└────────┬─────────┘
+         ↓
+┌─────────────────┐
+│   server ready     │
+│  • Emit 'ready'    │
+│  • Start monitoring│
+└─────────────────┘
+
+┌─────────────────────────────────────────────────────────────────┐
+│                    BACKGROUND PROCESSES                          │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│  RAM Disk Backup │    │  Log Cleanup    │    │ Memory Monitor  │
+│  Every 5 min     │    │  Every 3 hours  │    │ Every 30 sec    │
+│  RAM → Master    │    │  Delete old     │    │ Check usage     │
+│                  │    │  logs           │    │ Warn if high    │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+```
+
+---
+
+Pterodactyl Setup (No Egg Required)
+
+Step 1: Create Server Files
+
+Create the following files in your Pterodactyl server directory (/home/container):
+
+index.js
+
+```javascript
+const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
+
+async function startServer() {
+  const server = new MinecraftServer({
+    platform: "all",
+    version: "1.21.11",
+    type: "paper",
+    autoAcceptEula: true,
+    usePortableJava: false,
+    
+    memory: {
+      init: process.env.SERVER_MEMORY_INIT || "2G",
+      max: process.env.SERVER_MEMORY_MAX || "4G",
+      useAikarsFlags: true
+    },
+    
+    network: {
+      ip: "0.0.0.0",
+      port: parseInt(process.env.SERVER_PORT || "25565"),
+      bedrockPort: process.env.BEDROCK_PORT ? parseInt(process.env.BEDROCK_PORT) : undefined,
+      motd: process.env.SERVER_MOTD || "Minecraft Server",
+      onlineMode: false
+    },
+
+    world: {
+      difficulty: "normal",
+      maxPlayers: 20,
+      levelName: "world",
+      viewDistance: 6,
+      simulationDistance: 4
+    },
+    
+    // Enable all plugins
+    enableViaVersion: true,
+    enableViaBackwards: true,
+    enableViaRewind: true,
+    enableSkinRestorer: true,
+    enableProtocolLib: true,
+    enableTCPShield: true,
+    enableSpigotOptimizers: true,
+    enableSpark: true,
+    enableViewDistanceTweaks: true,
+    enableFarmControl: true,
+    enableEntityDetection: true,
+    
+    // RAM Disk for Pterodactyl
+    ramdisk: {
+      enabled: true,
+      world: true,
+      plugins: true,
+      backupInterval: 300000,
+      masterStorage: '/home/minecraft-master'
+    },
+    
+    networkOptimization: {
+      tcpFastOpen: true,
+      tcpNoDelay: true,
+      compressionThreshold: 64
     }
   });
 
+  server.on("ready", (info) => {
+    console.log(`
+==========================================
+Minecraft Server - Pterodactyl
+IP: ${info.ip}:${info.port}
+Version: ${info.version}
+Memory: ${info.memory.used}/${info.memory.max} MB
+CPU: ${info.cpu}%
+Players: ${info.players}/${info.maxPlayers}
+RAM Disk: Active
+==========================================
+    `);
+  });
+
   await server.start();
 }
 
-startServer();
+startServer().catch(console.error);
+```
+
+package.json
+
+```json
+{
+  "name": "minecraft-server",
+  "version": "1.0.0",
+  "dependencies": {
+    "@dimzxzzx07/mc-headless": "^2.2.3"
+  }
+}
+```
+
+start.sh
+
+```bash
+#!/bin/bash
+echo "=========================================="
+echo "MC-Headless Server - Pterodactyl v2.2.3"
+echo "=========================================="
+echo "Java Port: ${SERVER_PORT:-25565}"
+if [ -n "$BEDROCK_PORT" ]; then
+  echo "Bedrock Port: $BEDROCK_PORT (UDP)"
+else
+  echo "Bedrock Port: Sharing Java port (UDP must be enabled)"
+fi
+echo "Memory: ${SERVER_MEMORY_INIT:-2G} - ${SERVER_MEMORY_MAX:-4G}"
+echo "Plugins: ProtocolLib, TCPShield, Spark, etc."
+echo "RAM Disk: Active"
+echo "=========================================="
+
+# Clean up corrupt Paper cache
+if [ -d "plugins" ]; then
+  find plugins -type d -name ".paper-remapped*" -exec rm -rf {} + 2>/dev/null || true
+fi
+
+node index.js
+```
+
+Step 2: Upload Files via SFTP
+
+```bash
+# Connect to your server via SFTP and upload:
+/home/container/
+├── index.js
+├── package.json
+├── start.sh
+└── node_modules/ (will be created by npm install)
+```
+
+Step 3: Install Dependencies
+
+```bash
+cd /home/container
+npm install
+chmod +x start.sh
 ```
 
+Step 4: Configure Pterodactyl Panel
+
+Startup Command:
+
+```
+bash start.sh
+```
+
+Docker Image:
+
+```
+node:20-slim
+```
+
+Environment Variables:
+
+Variable Description Example
+SERVER_PORT Java edition port (TCP) 25565
+BEDROCK_PORT Bedrock edition port (UDP) 19132
+SERVER_MEMORY_INIT Initial memory 2G
+SERVER_MEMORY_MAX Max memory 4G
+SERVER_MOTD Message of the day My Server
+
+Pterodactyl Memory Safety
+
+The module automatically:
+
+· Detects cgroup memory limits
+· Uses only 90% of available memory to prevent OOM killer
+· Adjusts -Xmx accordingly
+· Logs the adjusted memory value
+
+Port Configuration Options
+
+Option A: Separate Ports (Recommended)
+
+· Add port 25565 (TCP) for Java
+· Add port 19132 (UDP) for Bedrock
+· Set both environment variables
+
+Option B: Single Port (Port Sharing)
+
+· Set only SERVER_PORT
+· Ensure port is configured for BOTH TCP and UDP in panel
+· Geyser will automatically share the same port
+· Warning appears if UDP not enabled
+
+---
+
+How to Connect from Minecraft
+
+Java Edition Connection
+
+1. Open Minecraft Java Edition
+2. Click "Multiplayer" → "Add Server"
+3. Server Address: your-server-ip:25565 (or your configured port)
+4. Click "Done" and join
+
+Bedrock Edition Connection
+
+If you have separate Bedrock port (19132 UDP):
+
+1. Open Minecraft Bedrock Edition
+2. Click "Play" → "Servers" → "Add Server"
+3. Server Address: your-server-ip
+4. Port: 19132
+5. Click "Save" and join
+
+If using port sharing (same port as Java):
+
+1. Open Minecraft Bedrock Edition
+2. Click "Play" → "Servers" → "Add Server"
+3. Server Address: your-server-ip
+4. Port: 25565 (or your configured port)
+5. IMPORTANT: Port must have UDP enabled in Pterodactyl panel
+6. Click "Save" and join
+
+Cross-Play (Java + Bedrock together)
+
+With Geyser and Floodgate enabled, both Java and Bedrock players can join the same server simultaneously. Bedrock players will see Java players and vice versa.
+
 ---
 
 Configuration Guide
 
-Complete Configuration Example
+Complete Configuration Example with New Features
 
 ```javascript
 const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
-  // Platform Selection
   platform: 'all',
   version: '1.21.11',
   type: 'paper',
   autoAcceptEula: true,
 
-  // Java Options
   usePortableJava: true,
   javaVersion: 'auto',
 
-  // Resource Management
   memory: {
     init: '4G',
     max: '12G',
     useAikarsFlags: true
   },
 
-  // Network Settings
   network: {
     port: 25565,
     bedrockPort: 19132,
@@ -412,7 +797,6 @@ const server = new MinecraftServer({
     motd: 'Minecraft Server'
   },
 
-  // World & Difficulty Settings
   world: {
     difficulty: 'normal',
     hardcore: false,
@@ -424,7 +808,6 @@ const server = new MinecraftServer({
     levelName: 'world'
   },
 
-  // Folder Management
   folders: {
     addons: './addons',
     mods: './mods',
@@ -432,13 +815,45 @@ const server = new MinecraftServer({
     world: './world'
   },
 
-  // Plugins
+  // Plugins (NEW in 2.2.3)
   enableViaVersion: true,
   enableViaBackwards: true,
   enableViaRewind: true,
   enableSkinRestorer: true,
+  enableProtocolLib: true,
+  enableTCPShield: true,
+  enableSpigotOptimizers: true,
+  enableSpark: true,
+  enableViewDistanceTweaks: true,
+  enableFarmControl: true,
+  enableEntityDetection: true,
+
+  // RAM Disk (NEW)
+  ramdisk: {
+    enabled: true,
+    world: true,
+    plugins: true,
+    addons: true,
+    backupInterval: 300000,
+    masterStorage: '/home/minecraft-master'
+  },
+
+  // Symlink Master (NEW)
+  symlinkMaster: '/home/minecraft-master',
+
+  // Network Optimization (NEW)
+  networkOptimization: {
+    tcpFastOpen: true,
+    tcpNoDelay: true,
+    preferIPv4: true,
+    compressionThreshold: 64,
+    bungeeMode: false,
+    velocity: {
+      enabled: false,
+      secret: ''
+    }
+  },
 
-  // Server Behavior
   autoRestart: true,
   backup: {
     enabled: true,
@@ -446,7 +861,6 @@ const server = new MinecraftServer({
     path: './backups'
   },
 
-  // Monitoring
   memoryMonitor: {
     enabled: true,
     threshold: 85,
@@ -454,7 +868,6 @@ const server = new MinecraftServer({
     action: 'warn'
   },
 
-  // Performance
   silentMode: true,
   statsInterval: 30000
 });
@@ -462,70 +875,44 @@ const server = new MinecraftServer({
 await server.start();
 ```
 
-Configuration Options Reference
+New Configuration Options in 2.2.3
 
-Platform Options
-
-Option Type Default Description
-platform string 'java' 'java', 'bedrock', or 'all'
-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 /home/container/.java (Pterodactyl) or /tmp/.mc-headless
-javaVersion string 'auto' '17', '21', or 'auto'
-
-Memory Options
-
-Option Type Default Description
-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
-
-Option Type Default Description
-network.port number 25565 Java edition server port
-network.bedrockPort number 19132 Bedrock edition server port
-network.ip string '0.0.0.0' Bind IP address
-network.onlineMode boolean false Enable Mojang authentication
-network.motd string 'Minecraft Server' Message of the day
-
-World Options
+Plugin Options
 
 Option Type Default Description
-world.difficulty string 'normal' peaceful, easy, normal, hard
-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 6 Chunk view distance
-world.simulationDistance number 4 Simulation distance
-world.levelName string 'world' World folder name
+enableProtocolLib boolean false ProtocolLib for packet manipulation
+enableTCPShield boolean false TCPShield DDoS protection
+enableSpigotOptimizers boolean false Performance optimization plugin
+enableSpark boolean false Spark profiler for performance monitoring
+enableViewDistanceTweaks boolean false Dynamic view distance adjustment
+enableFarmControl boolean false Farm entity limit control
+enableEntityDetection boolean false Entity tracking optimization
 
-Plugin Options
+RAM Disk 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
+ramdisk.enabled boolean false Enable RAM disk for worlds/plugins
+ramdisk.world boolean false Store world in RAM
+ramdisk.plugins boolean false Store plugins in RAM
+ramdisk.addons boolean false Store addons in RAM
+ramdisk.backupInterval number 300000 Backup interval in ms (5 minutes default)
+ramdisk.masterStorage string '/home/minecraft-master' Master storage path for backups
 
-Performance Options
+Symlink Master Options
 
 Option Type Default Description
-silentMode boolean true Direct pipe logs (no Node.js processing)
-statsInterval number 30000 Stats update interval in ms
+symlinkMaster string undefined Master directory for symbolic links
 
-Owner Options
+Network Optimization Options
 
 Option Type Default Description
-owners array [] List of owner usernames
-ownerCommands.prefix string '!' Command prefix for owners
-ownerCommands.enabled boolean true Enable owner commands
+networkOptimization.tcpFastOpen boolean true Enable TCP Fast Open
+networkOptimization.tcpNoDelay boolean true Enable TCP_NODELAY
+networkOptimization.preferIPv4 boolean true Prefer IPv4 stack
+networkOptimization.compressionThreshold number 64 Network compression threshold
+networkOptimization.bungeeMode boolean false Enable BungeeCord mode
+networkOptimization.velocity.enabled boolean false Enable Velocity proxy support
+networkOptimization.velocity.secret string '' Velocity forwarding secret
 
 ---
 
@@ -537,7 +924,6 @@ MinecraftServer Class
 class MinecraftServer extends EventEmitter {
   constructor(config: Partial<MinecraftConfig>);
   
-  // Methods
   async start(): Promise<ServerInfo>;
   async stop(): Promise<void>;
   sendCommand(command: string): void;
@@ -545,7 +931,6 @@ class MinecraftServer extends EventEmitter {
   getPlayers(): Player[];
   async backup(type?: 'full' | 'world' | 'plugins'): Promise<string>;
   
-  // Events
   on(event: 'ready', listener: (info: ServerInfo) => void): this;
   on(event: 'stop', listener: (data: { code: number }) => void): this;
   on(event: 'player-join', listener: (player: Player) => void): this;
@@ -568,536 +953,121 @@ interface ServerInfo {
   players: number;
   maxPlayers: number;
   uptime: number;
-  memory: {
-    used: number;
-    max: number;
-  };
+  memory: { 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
-
-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({
-  version: '1.21.11',
-  type: 'paper',
-  usePortableJava: true,
-  memory: {
-    init: `${Math.floor(maxRam * 0.3)}G`,
-    max: `${maxRam}G`
-  }
-});
-
-server.on('ready', (info) => {
-  console.log(`Server running with ${info.memory.max} MB max`);
-});
-
-server.start();
-```
-
-Multiple Servers with Different Versions
-
-```javascript
-const { ServerManager } = require('@dimzxzzx07/mc-headless');
-
-const manager = new ServerManager();
-
-// Create servers
-manager.createServer('lobby', {
-  version: '1.21.11',
-  type: 'paper',
-  network: { port: 25565 }
-});
-
-manager.createServer('survival', {
-  version: '1.21.11',
-  type: 'paper',
-  network: { port: 25566 },
-  world: { levelName: 'survival' }
-});
-
-manager.createServer('creative', {
-  version: '1.21.11',
-  type: 'paper',
-  network: { port: 25567 },
-  world: { gamemode: 'creative' }
-});
-
-// Start all
-await manager.startAll();
-
-// Broadcast command
-await manager.broadcastCommand('say Server is running!');
-```
-
-Server with Owner Commands
-
-```javascript
-const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
-
-const server = new MinecraftServer({
-  version: '1.21.11',
-  type: 'paper',
-  owners: ['dimzxind', 'admin1', 'tesuser'],
-  ownerCommands: {
-    prefix: '!',
-    enabled: true
-  }
-});
-
-server.on('player-join', (player) => {
-  if (['dimzxind', 'admin1', 'tesuser'].includes(player.name)) {
-    server.sendCommand(`tellraw ${player.name} {"text":"Welcome Owner! Use !help for commands","color":"gold"}`);
-  }
-});
-
-server.start();
-```
-
-Owner Commands Available
-
-Command Description Example
-!gamemode <mode> [player] Change gamemode !gamemode creative
-!gm <mode> [player] Shortcut for gamemode !gm survival
-!tp <player> [x y z] Teleport !tp player2
-!give <player> <item> [amount] Give items !give player2 diamond 64
-!time <set\|add> <value> Change time !time set day
-!weather <clear\|rain\|thunder> Change weather !weather clear
-!kill [player] Kill player !kill player2
-!ban <player> [reason] Ban player !ban hacker
-!kick <player> [reason] Kick player !kick spammer
-!op <player> Give operator !op friend
-!deop <player> Remove operator !deop friend
-!reload Reload server !reload
-!save Save world !save
-!list List players !list
-!help Show owner commands !help
-
 ---
 
-Server Types
+Plugins & Boosters
 
-Paper (Recommended for Performance)
+Available Plugins in v2.2.3
 
-```javascript
-const server = new MinecraftServer({
-  type: 'paper',
-  version: '1.21.11',
-  memory: { useAikarsFlags: true }
-});
-```
+Plugin Function Enable Option
+ProtocolLib Packet manipulation library enableProtocolLib: true
+TCPShield DDoS protection and proxy enableTCPShield: true
+Spigot-Optimizers Performance optimizations enableSpigotOptimizers: true
+Spark Performance profiling enableSpark: true
+ViewDistanceTweaks Dynamic view distance enableViewDistanceTweaks: true
+FarmControl Farm entity limits enableFarmControl: true
+EntityDetection Entity tracking optimization enableEntityDetection: true
+ViaVersion Cross-version support enableViaVersion: true
+ViaBackwards Backwards compatibility enableViaBackwards: true
+ViaRewind 1.7-1.8 support enableViaRewind: true
+SkinRestorer Player skin fixing enableSkinRestorer: true
 
-Vanilla (Official Mojang)
+Plugin Auto-Download
 
-```javascript
-const server = new MinecraftServer({
-  type: 'vanilla',
-  version: '1.21.11'
-});
-```
-
-Forge (Modded)
+All plugins are automatically downloaded from official sources with:
 
-```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' }
-});
-```
+· Stream finished guarantee
+· 1-second delay between downloads
+· Size verification (>100KB)
+· ZIP header validation
+· Auto-retry on failure
 
 ---
 
-Platform Options
-
-Java Edition Only
+RAM Disk & Symlink System
 
-```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' }
-});
-```
+How RAM Disk Works
 
-Cross-Play (Java + Bedrock)
+When enabled, worlds/plugins/addons are stored in RAM (/dev/shm/minecraft) for lightning-fast access:
 
 ```javascript
-const server = new MinecraftServer({
-  platform: 'all',
-  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: 6,
-  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
-└── .java/            # Portable Java (if enabled)
-```
-
----
-
-Backup System
-
-Enable Automatic Backups
-
-```javascript
-backup: {
+ramdisk: {
   enabled: true,
-  interval: '24h',
-  path: './backups'
+  world: true,      // World in RAM
+  plugins: true,    // Plugins in RAM
+  addons: true,     // Addons in RAM
+  backupInterval: 300000, // Backup every 5 minutes
+  masterStorage: '/home/minecraft-master' // Master storage
 }
 ```
 
-Manual Backup
-
-```javascript
-// Full backup
-const fullPath = await server.backup('full');
-
-// World only backup
-const worldPath = await server.backup('world');
+Crash Recovery Flow
 
-// 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`);
-});
-```
-
-Player Count
-
-```javascript
-const info = await server.getInfo();
-console.log(`Players online: ${info.players}/${info.maxPlayers}`);
-```
-
----
-
-Cross-Play (Geyser)
-
-Automatic Setup
-
-```javascript
-const server = new MinecraftServer({
-  platform: 'all',
-  version: '1.21.11',
-  type: 'paper',
-  network: {
-    port: 25565,
-    bedrockPort: 19132
-  }
-});
+┌─────────────────────────────────────────────────────────┐
+│                  CRASH RECOVERY FLOW                     │
+└─────────────────────────────────────────────────────────┘
+
+1. Server crashes or VPS reboots
+         ↓
+2. RAM disk data lost (/dev/shm cleared)
+         ↓
+3. Server restarts
+         ↓
+4. restoreFromMaster() runs
+         ↓
+5. Checks if RAM disk is empty
+         ↓
+6. Copies from master storage to RAM
+         ↓
+7. World/plugins restored exactly as before
+         ↓
+8. Server starts with latest data
 ```
 
----
+Benefits
 
-ViaVersion Support
+· 10-50x faster world loading
+· Zero lag during chunk generation
+· Instant plugin loading
+· Automatic backup to disk every 5 minutes
+· Crash recovery - Data restored from master storage
+· Data safety - RAM data regularly saved to disk
 
-Enable All ViaVersion Plugins
+Symlink Master System
 
 ```javascript
-const server = new MinecraftServer({
-  version: '1.21.11',
-  type: 'paper',
-  enableViaVersion: true,
-  enableViaBackwards: true,
-  enableViaRewind: true
-});
+symlinkMaster: '/home/minecraft-master'
 ```
 
-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.
+Creates a secure master folder structure:
 
----
-
-SkinRestorer Support
-
-Enable SkinRestorer
-
-```javascript
-const server = new MinecraftServer({
-  enableSkinRestorer: true
-});
 ```
-
-· Auto-downloads latest SkinRestorer
-· Fixes player skins for offline mode
-· Works with Geyser (Bedrock players)
-
----
-
-Portable Java
-
-How It Works
-
-```javascript
-const server = new MinecraftServer({
-  usePortableJava: true,  // Download JRE to .java folder
-  javaVersion: 'auto'      // Auto-detect required version
-});
+/home/minecraft-master/
+├── worlds/
+├── plugins/
+├── addons/
+└── mods/
 ```
 
-· 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
+Server folders become symbolic links pointing to master folders, providing:
 
-Minecraft Version Java Version
-1.21.x Java 21
-1.20.x Java 17
-1.19.x Java 17
-1.18.x Java 17
-1.17.x Java 16
-1.16.x Java 8
+· Data safety - Master data survives server resets
+· Easy backups - Backup only master folder
+· Multiple servers - Share plugins across instances
+· Quick restore - Just recreate symlinks
 
 ---
 
 Performance Tuning
 
-Optimized Configuration
+Optimized Configuration with New Features
 
 ```javascript
 const server = new MinecraftServer({
@@ -1114,211 +1084,124 @@ const server = new MinecraftServer({
     simulationDistance: 4,
     maxPlayers: 20
   },
+  
+  // Enable performance plugins
+  enableSpigotOptimizers: true,
+  enableSpark: true,
+  enableViewDistanceTweaks: true,
+  enableFarmControl: true,
+  enableEntityDetection: true,
+  
+  // RAM Disk for speed
+  ramdisk: {
+    enabled: true,
+    world: true,
+    plugins: true,
+    backupInterval: 300000
+  },
+  
+  // Network optimizations
+  networkOptimization: {
+    tcpFastOpen: true,
+    tcpNoDelay: true,
+    compressionThreshold: 64
+  },
+  
   silentMode: true,
   statsInterval: 30000
 });
 ```
 
-Environment Optimizations
-
-Variable Value Effect
-MALLOC_ARENA_MAX 2 Prevents memory fragmentation
-_JAVA_OPTIONS -Xmx... Global Java memory limit
-JAVA_HOME (auto) Points to portable Java
-
----
-
-Pterodactyl Setup
-
-Installation on Pterodactyl
+Java Arguments Added in 2.2.3
 
 ```bash
-# Connect to your Pterodactyl server via SSH
-ssh user@your-server.com
-
-# Create directory for your server
-mkdir minecraft-server
-cd minecraft-server
-
-# Install Node.js (if not available)
-curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
-apt install -y nodejs
-
-# Install mc-headless
-npm init -y
-npm install @dimzxzzx07/mc-headless
-
-# Create server script
-cat > index.js << 'EOF'
-const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
-
-const server = new MinecraftServer({
-  version: '1.21.11',
-  type: 'paper',
-  usePortableJava: true,
-  memory: {
-    init: '2G',
-    max: '4G'
-  },
-  network: {
-    port: 25565
-  }
-});
-
-server.on('ready', (info) => {
-  console.log(`Server ready on port ${info.port}`);
-});
-
-server.start();
-EOF
-
-# Run server
-node index.js
+# Base memory and GC
+-Xms4G -Xmx12G
+-XX:+UseG1GC
+-XX:MaxGCPauseMillis=50
+-XX:+UseStringDeduplication
+-XX:G1MixedGCLiveThresholdPercent=90
+
+# Network optimizations
+-Djava.net.preferIPv4Stack=true
+-Djava.net.tcpFastOpen=true
+-Djava.net.tcp.nodelay=true
+-Dnetwork-compression-threshold=64
+
+# Netty optimizations
+-Dio.netty.recycler.maxCapacity.default=0
+-Dio.netty.leakDetectionLevel=disabled
+
+# Terminal settings (Pterodactyl)
+-Dterminal.jline=false
+-Dterminal.ansi=true
 ```
 
-Pterodactyl Environment Variables
-
-MC-Headless automatically detects Pterodactyl and respects these environment variables:
-
-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
+Pterodactyl Memory Safety
 
-```json
-{
-  "name": "MC-Headless",
-  "description": "Minecraft Headless Server Manager",
-  "docker_images": {
-    "node:20": "node:20"
-  },
-  "startup": "node /home/container/index.js",
-  "environment": {
-    "SERVER_VERSION": "1.21.11",
-    "SERVER_TYPE": "paper",
-    "MEMORY_INIT": "2G",
-    "MEMORY_MAX": "4G"
-  }
+```javascript
+// Automatically applied in Pterodactyl
+if (isPterodactyl && cgroupMemory > 0) {
+  const safeMem = Math.floor(cgroupMemory * 0.9);
+  memMax = Math.min(memMax, safeMem);
+  // Uses 90% of cgroup limit to prevent OOM killer
 }
 ```
 
 ---
 
-Termux Setup
-
-Install in Termux
-
-```bash
-# Update packages
-pkg update && pkg upgrade
-
-# Install Node.js
-pkg install nodejs
-
-# Install mc-headless
-npm install -g @dimzxzzx07/mc-headless
+Troubleshooting
 
-# Create server directory
-mkdir minecraft-server
-cd minecraft-server
+Common Issues in 2.2.3
 
-# Create server script
-cat > server.js << 'EOF'
-const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
+Issue Cause Solution
+plugins/.paper-remapped error Corrupt plugin cache Auto-fixed in v2.2.3
+Bedrock cannot connect UDP not enabled Ensure port has UDP enabled
+RAM disk not working /dev/shm not available Check system RAM disk support
+Plugins not downloading Network issues Auto-retry in v2.2.3
+High memory usage RAM disk + worlds Reduce viewDistance or disable RAM disk
+Java update available Older Java Auto-downloads latest
+Server OOM killed Memory too high Module auto-reduces to 90% of limit
 
-const server = new MinecraftServer({
-  platform: 'java',
-  version: '1.21.11',
-  type: 'paper',
-  usePortableJava: true,
-  memory: {
-    init: '512M',
-    max: '2G'
-  }
-});
+RAM Disk Issues
 
-server.start();
-EOF
+```bash
+# Check if RAM disk is mounted
+df -h /dev/shm
 
-# Run server
-node server.js
-```
+# Check RAM disk usage
+du -sh /dev/shm/minecraft
 
-Termux Optimizations
+# Manual backup
+cp -r /dev/shm/minecraft/* /home/minecraft-master/
 
-```javascript
-const server = new MinecraftServer({
-  version: '1.21.11',
-  type: 'paper',
-  usePortableJava: true,
-  memory: {
-    init: '512M',
-    max: '2G'
-  },
-  world: {
-    viewDistance: 4,
-    simulationDistance: 3,
-    maxPlayers: 10
-  }
-});
+# Restore from master
+cp -r /home/minecraft-master/* /dev/shm/minecraft/
 ```
 
----
-
-Troubleshooting
-
-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 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
+Plugin Verification
 
 ```bash
-# Check disk usage
-df -h
-
-# Clean up old Java files
-rm -rf .java/jre-*
+# List installed plugins
+ls -la plugins/
 
-# Clean npm cache
-npm cache clean --force
+# Check plugin sizes (should be >100KB)
+du -sh plugins/*.jar
 
-# Remove old backups
-rm -rf backups/*
+# Check for corrupt plugins
+find plugins -name "*.jar" -size -100k -delete
 ```
 
-Debug Mode
+Pterodactyl Memory Logs
 
-```javascript
-const server = new MinecraftServer({
-  silentMode: false,  // Disable silent mode to see all logs
-  statsInterval: 5000 // Update stats every 5 seconds
-});
-```
+Look for this line in startup logs:
 
-Logs Location
-
-```bash
-# Server logs are piped directly to console
-# Check console output for errors
-
-# Java portable logs
-ls -la .java/
+```
+Adjusted memory to 3686MB (90% of cgroup limit)
 ```
 
+This confirms the module is protecting your server from OOM killer.
+
 ---
 
 Contributing
@@ -1326,7 +1209,7 @@ Contributing
 Development Setup
 
 ```bash
-git clone https://github.com/Dimzxzzx07/mc-headless.git
+git clone https://github.com/Dimzxzzx07/Minecraft-Server-Integration-Node.js.git
 cd mc-headless
 npm install
 npm run build
@@ -1351,7 +1234,8 @@ mc-headless/
 │   ├── platforms/
 │   │   ├── GeyserBridge.ts
 │   │   ├── ViaVersion.ts
-│   │   └── SkinRestorer.ts
+│   │   ├── SkinRestorer.ts
+│   │   └── PluginManager.ts
 │   └── utils/
 │       ├── Logger.ts
 │       ├── FileUtils.ts
@@ -1361,14 +1245,6 @@ mc-headless/
 └── README.md
 ```
 
-Pull Request Process
-
-1. Fork the repository
-2. Create feature branch
-3. Commit changes
-4. Push to branch
-5. Open pull request
-
 ---
 
 License