@dimzxzzx07/mc-headless 1.6.0 → 1.7.0

package/README.md

@@ -5,11 +5,12 @@
 </div>
 
 <div align="center">
-    <img src="https://img.shields.io/badge/Version-1.0.0-2563eb?style=for-the-badge&logo=typescript" alt="Version">
-    <img src="https://img.shields.io/badge/License-UNLICENSED-dc2626?style=for-the-badge&logo=licenses" alt="License">
+    <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/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/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">
 </div>
 
 <div align="center">
@@ -29,9 +30,10 @@
 
 ---
 
- Table of Contents
+Table of Contents
 
 · Overview
+· What's New in 1.7.0
 · Features
 · Why MC-Headless?
 · Installation
@@ -50,7 +52,9 @@
 · Commands
 · Player Management
 · Cross-Play (Geyser)
+· ViaVersion Support
 · Termux Setup
+· Performance Tuning
 · Troubleshooting
 · Contributing
 · License
@@ -65,6 +69,20 @@ Built specifically for developers, sysadmins, and Minecraft enthusiasts who want
 
 ---
 
+What's New in 1.7.0
+
+Version 1.7.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
+
+---
+
 Features
 
 Category Features
@@ -76,6 +94,7 @@ 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
 
@@ -87,7 +106,7 @@ Before (Manual Setup)
 
 ```bash
 # Download server jar
-wget https://api.papermc.io/v2/projects/paper/versions/1.20.1/builds/196/downloads/paper-1.20.1-196.jar
+wget https://api.papermc.io/v2/projects/paper/versions/1.21.11/builds/69/downloads/paper-1.21.11-69.jar
 
 # Accept EULA
 echo "eula=true" > eula.txt
@@ -97,7 +116,10 @@ echo "server-port=25565" > server.properties
 echo "max-players=20" >> server.properties
 
 # Run server with complex Java flags
-java -Xms1G -Xmx4G -XX:+UseG1GC -jar paper-1.20.1-196.jar nogui
+java -Xms2G -Xmx4G -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/
 
 # Monitor manually
 tail -f logs/latest.log
@@ -105,13 +127,13 @@ tail -f logs/latest.log
 
 After (MC-Headless)
 
-```typescript
+```javascript
 const server = new MinecraftServer({
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
-  memory: { init: '1G', max: '4G' },
+  memory: { init: '2G', max: '4G' },
   network: { port: 25565 },
-  world: { maxPlayers: 20 }
+  enableViaVersion: true
 });
 
 server.on('ready', () => console.log('Server ready!'));
@@ -149,34 +171,30 @@ Quick Start
 
 Basic Java Server
 
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
+```javascript
+const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
   platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
   memory: {
-    init: '1G',
+    init: '2G',
     max: '4G'
   }
 });
 
 server.on('ready', (info) => {
-  console.log(`
-MC Headless - Powered By Dimzxzzx07
-  Address: ${info.ip}:${info.port}
-  Version: ${info.version} ${info.type}
-  Players: 0/${info.maxPlayers}
-  `);
+  console.log(`Server is ready on port ${info.port}`);
+  console.log(`Version: ${info.version} ${info.type}`);
 });
 
 server.on('player-join', (player) => {
-  console.log(`Player joined: ${player.name}`);
+  console.log(`${player.name} joined the game`);
 });
 
 server.on('player-leave', (name) => {
-  console.log(`Player left: ${name}`);
+  console.log(`${name} left the game`);
 });
 
 server.start().catch(console.error);
@@ -184,12 +202,12 @@ server.start().catch(console.error);
 
 Basic Bedrock Server
 
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
+```javascript
+const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
   platform: 'bedrock',
-  version: '1.20.1',
+  version: '1.21.11',
   network: {
     port: 19132,
     motd: 'Bedrock Server'
@@ -199,20 +217,32 @@ const server = new MinecraftServer({
 server.start();
 ```
 
-Cross-Play Server (Java + Bedrock)
+Cross-Play Server with ViaVersion
 
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
+```javascript
+const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
   platform: 'all',
-  version: '1.20.1',
+  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');
 });
 
 server.start();
@@ -224,58 +254,64 @@ Configuration Guide
 
 Complete Configuration Example
 
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
+```javascript
+const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
   // Platform Selection
-  platform: 'all',                    // 'java', 'bedrock', 'all'
-  version: '1.20.1',                   // Minecraft version
-  type: 'paper',                       // paper, purpur, vanilla, spigot, forge, fabric
-  autoAcceptEula: true,                 // Auto-accept Minecraft EULA
+  platform: 'all',
+  version: '1.21.11',
+  type: 'paper',
+  autoAcceptEula: true,
 
   // Resource Management
   memory: {
-    init: '1G',                         // Initial memory allocation
-    max: '4G',                           // Maximum memory allocation
-    useAikarsFlags: true                  // Use Aikar's optimized GC flags
+    init: '2G',
+    max: '4G',
+    useAikarsFlags: true
   },
 
   // Network Settings
   network: {
-    port: 25565,                          // Java edition port
-    bedrockPort: 19132,                    // Bedrock edition port (for 'all' platform)
-    ip: '0.0.0.0',                         // Bind IP address
-    onlineMode: false,                      // Enable/disable authentication
-    motd: 'Minecraft Server'                 // Server message of the day
+    port: 25565,
+    bedrockPort: 19132,
+    ip: '0.0.0.0',
+    onlineMode: false,
+    motd: 'Minecraft Server'
   },
 
   // World & Difficulty Settings
   world: {
-    difficulty: 'normal',                    // peaceful, easy, normal, hard
-    hardcore: false,                          // Enable hardcore mode
-    gamemode: 'survival',                      // survival, creative, adventure, spectator
-    seed: 'my-secret-seed',                     // World seed (optional)
-    maxPlayers: 20,                              // Maximum player count
-    viewDistance: 10,                             // Chunk view distance
-    levelName: 'world'                              // World folder name
+    difficulty: 'normal',
+    hardcore: false,
+    gamemode: 'survival',
+    seed: 'my-secret-seed',
+    maxPlayers: 20,
+    viewDistance: 8,
+    simulationDistance: 4,
+    levelName: 'world'
   },
 
   // Folder Management
   folders: {
-    addons: './addons',        // Bedrock addons folder
-    mods: './mods',            // Forge/Fabric mods folder
-    plugins: './plugins',      // Paper/Spigot plugins folder
-    world: './world'           // World data folder
+    addons: './addons',
+    mods: './mods',
+    plugins: './plugins',
+    world: './world'
   },
 
   // Server Behavior
-  autoRestart: true,            // Auto-restart on crash
+  autoRestart: true,
   backup: {
-    enabled: true,               // Enable automatic backups
-    interval: '24h',              // Backup interval (24h, 12h, 6h, 1h, 30m)
-    path: './backups'              // Backup storage path
-  }
+    enabled: true,
+    interval: '24h',
+    path: './backups'
+  },
+
+  // ViaVersion Support
+  enableViaVersion: true,
+  enableViaBackwards: true,
+  enableViaRewind: true
 });
 
 await server.start();
@@ -287,15 +323,15 @@ Platform Options
 
 Option Type Default Description
 platform string 'java' 'java', 'bedrock', or 'all'
-version string '1.20.1' Minecraft version (e.g., '1.20.1', '1.19.4')
-type string 'paper' Server type: paper, purpur, vanilla, spigot, forge, fabric
+version string '1.21.11' Minecraft version
+type string 'paper' paper, purpur, vanilla, spigot, forge, fabric
 autoAcceptEula boolean true Automatically accept Minecraft EULA
 
 Memory Options
 
 Option Type Default Description
-memory.init string '1G' Initial heap size (e.g., '512M', '1G', '2G')
-memory.max string '4G' Maximum heap size (e.g., '2G', '4G', '8G')
+memory.init string '1G' Initial heap size
+memory.max string '2G' Maximum heap size
 memory.useAikarsFlags boolean true Use Aikar's optimized GC flags
 
 Network Options
@@ -315,7 +351,8 @@ 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 10 Chunk view distance
+world.viewDistance number 8 Chunk view distance
+world.simulationDistance number 4 Simulation distance
 world.levelName string 'world' World folder name
 
 Folder Options
@@ -330,16 +367,23 @@ Backup Options
 
 Option Type Default Description
 backup.enabled boolean false Enable automatic backups
-backup.interval string '24h' Backup interval (24h, 12h, 6h, 1h, 30m)
+backup.interval string '24h' Backup interval
 backup.path string './backups' Backup storage path
 
+ViaVersion Options
+
+Option Type Default Description
+enableViaVersion boolean false Enable ViaVersion plugin
+enableViaBackwards boolean false Enable ViaBackwards plugin
+enableViaRewind boolean false Enable ViaRewind plugin
+
 ---
 
 API Reference
 
 MinecraftServer Class
 
-```typescript
+```javascript
 class MinecraftServer extends EventEmitter {
   constructor(config: Partial<MinecraftConfig>);
   
@@ -362,21 +406,21 @@ class MinecraftServer extends EventEmitter {
 
 ServerInfo Interface
 
-```typescript
+```javascript
 interface ServerInfo {
-  pid: number;                    // Process ID
-  ip: string;                      // Server IP
-  port: number;                     // Server port
-  bedrockPort?: number;              // Bedrock port (if enabled)
-  version: string;                   // Minecraft version
-  type: ServerType;                   // Server type
-  platform: Platform;                  // Platform (java/bedrock/all)
-  players: number;                      // Current players
-  maxPlayers: number;                    // Max players
-  uptime: number;                         // Uptime in seconds
+  pid: number;
+  ip: string;
+  port: number;
+  bedrockPort?: number;
+  version: string;
+  type: string;
+  platform: string;
+  players: number;
+  maxPlayers: number;
+  uptime: number;
   memory: {
-    used: number;                          // Used memory in MB
-    max: number;                            // Max memory in MB
+    used: number;
+    max: number;
   };
   status: 'starting' | 'running' | 'stopping' | 'stopped' | 'crashed';
 }
@@ -384,13 +428,13 @@ interface ServerInfo {
 
 Player Interface
 
-```typescript
+```javascript
 interface Player {
-  name: string;          // Player username
-  uuid: string;          // Player UUID
-  ip: string;            // Player IP address
-  ping: number;          // Player ping in ms
-  connectedAt: Date;     // Connection time
+  name: string;
+  uuid: string;
+  ip: string;
+  ping: number;
+  connectedAt: Date;
 }
 ```
 
@@ -400,12 +444,12 @@ Usage Examples
 
 Advanced Server Configuration
 
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
+```javascript
+const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
   platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
   
   memory: {
@@ -418,16 +462,15 @@ const server = new MinecraftServer({
     port: 25565,
     ip: '0.0.0.0',
     onlineMode: true,
-    motd: '§6Premium §cMinecraft §aServer'
+    motd: 'Premium Minecraft Server'
   },
   
   world: {
     difficulty: 'hard',
-    hardcore: false,
     gamemode: 'survival',
-    seed: 'my-epic-seed-123',
     maxPlayers: 50,
-    viewDistance: 12,
+    viewDistance: 8,
+    simulationDistance: 4,
     levelName: 'survival_world'
   },
   
@@ -441,25 +484,22 @@ const server = new MinecraftServer({
     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`);
-  
-  // Schedule daily restart
-  setInterval(() => {
-    console.log('Scheduled restart...');
-    server.sendCommand('say Server restarting in 1 minute');
-    setTimeout(() => server.stop(), 60000);
-  }, 24 * 60 * 60 * 1000);
+  console.log('ViaVersion active - all versions welcome!');
 });
 
 server.on('resource', (info) => {
   if (info.memory.used > info.memory.max * 0.9) {
-    console.log('High memory usage, warning players...');
-    server.sendCommand('say Memory usage is high, please restart soon');
+    console.log('High memory usage detected');
   }
 });
 
@@ -468,131 +508,57 @@ server.start();
 
 Multiple Servers Manager
 
-```typescript
-import { ServerManager } from '@dimzxzzx07/mc-headless';
+```javascript
+const { ServerManager } = require('@dimzxzzx07/mc-headless');
 
 const manager = new ServerManager();
 
 // Create survival server
 const survival = manager.createServer('survival', {
-  platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
-  network: { port: 25565 },
-  world: { levelName: 'survival' }
+  network: { port: 25565 }
 });
 
 // Create creative server
 const creative = manager.createServer('creative', {
-  platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
   network: { port: 25566 },
-  world: { 
-    gamemode: 'creative',
-    levelName: 'creative'
-  }
-});
-
-// Create Bedrock server
-const bedrock = manager.createServer('bedrock', {
-  platform: 'bedrock',
-  version: '1.20.1',
-  network: { port: 19132 }
+  world: { gamemode: 'creative' }
 });
 
 // Start all servers
 await manager.startServer('survival');
 await manager.startServer('creative');
-await manager.startServer('bedrock');
 
 // Broadcast to all servers
 await manager.broadcastCommand('say Server is running!');
-
-// Backup all servers
-await manager.backupAll('world');
-
-// Stop all servers on exit
-process.on('SIGINT', async () => {
-  await manager.stopAll();
-  process.exit();
-});
 ```
 
 Server Control with Commands
 
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
-
-const server = new MinecraftServer({
-  version: '1.20.1',
-  type: 'paper'
-});
-
-await server.start();
-
-// Send various commands
-server.sendCommand('say Welcome to the server!');
-server.sendCommand('time set day');
-server.sendCommand('weather clear');
-server.sendCommand('difficulty normal');
-server.sendCommand('gamemode survival @a');
-
-// OP a player
-server.sendCommand('op Notch');
-
-// Give items
-server.sendCommand('give @a minecraft:diamond 1');
-
-// Teleport
-server.sendCommand('tp Dimzxzzx07 100 64 100');
-
-// Set world spawn
-server.sendCommand('setworldspawn 0 64 0');
-
-// Save world
-server.sendCommand('save-all');
-
-// List players
-server.sendCommand('list');
-
-// Get server stats
-const info = await server.getInfo();
-console.log(`Uptime: ${info.uptime}s`);
-console.log(`Players: ${info.players}/${info.maxPlayers}`);
-console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
-```
-
-Automatic Backup System
-
-```typescript
-import { MinecraftServer } from '@dimzxzzx07/mc-headless';
-
-const server = new MinecraftServer({
-  version: '1.20.1',
-  type: 'paper',
-  backup: {
-    enabled: true,
-    interval: '6h',
-    path: './backups'
-  }
-});
-
+```javascript
 server.on('ready', () => {
-  console.log('Backup system active: every 6 hours');
+  // 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');
 });
 
-// Manual backup
+// Get server stats periodically
 setInterval(async () => {
-  console.log('Creating manual backup...');
-  const backupPath = await server.backup('full');
-  console.log(`Backup saved to: ${backupPath}`);
-  
-  // Check backup size
-  const fs = require('fs-extra');
-  const stats = await fs.stat(backupPath);
-  console.log(`Backup size: ${stats.size / 1024 / 1024} MB`);
-}, 24 * 60 * 60 * 1000); // Daily backup
+  const info = await server.getInfo();
+  console.log(`Players: ${info.players}/${info.maxPlayers}`);
+  console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
+}, 60000);
 ```
 
 ---
@@ -601,65 +567,40 @@ Server Types
 
 Paper (Recommended for Performance)
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   type: 'paper',
-  version: '1.20.1',
-  memory: {
-    useAikarsFlags: true  // Optimized for Paper
-  }
-});
-```
-
-Purpur (Most Features)
-
-```typescript
-const server = new MinecraftServer({
-  type: 'purpur',
-  version: '1.20.1'
-  // Purpur has additional configuration options
+  version: '1.21.11',
+  memory: { useAikarsFlags: true }
 });
 ```
 
 Vanilla (Official Mojang)
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   type: 'vanilla',
-  version: '1.20.1'
-});
-```
-
-Spigot (Bukkit Compatible)
-
-```typescript
-const server = new MinecraftServer({
-  type: 'spigot',
-  version: '1.20.1'
+  version: '1.21.11'
 });
 ```
 
 Forge (Modded)
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   type: 'forge',
-  version: '1.20.1',
-  folders: {
-    mods: './mods'  // Place your mods here
-  }
+  version: '1.21.11',
+  folders: { mods: './mods' }
 });
 ```
 
 Fabric (Lightweight Modding)
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   type: 'fabric',
-  version: '1.20.1',
-  folders: {
-    mods: './mods'  // Place your Fabric mods here
-  }
+  version: '1.21.11',
+  folders: { mods: './mods' }
 });
 ```
 
@@ -669,45 +610,38 @@ Platform Options
 
 Java Edition Only
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
-  network: {
-    port: 25565  // Java port only
-  }
+  network: { port: 25565 }
 });
 ```
 
 Bedrock Edition Only
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   platform: 'bedrock',
-  version: '1.20.1',
-  network: {
-    port: 19132  // Bedrock port
-  },
-  folders: {
-    addons: './addons'  // Bedrock addons
-  }
+  version: '1.21.11',
+  network: { port: 19132 },
+  folders: { addons: './addons' }
 });
 ```
 
 Cross-Play (Java + Bedrock)
 
-```typescript
+```javascript
 const server = new MinecraftServer({
   platform: 'all',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
   network: {
-    port: 25565,      // Java port
-    bedrockPort: 19132 // Bedrock port
+    port: 25565,
+    bedrockPort: 19132
   }
 });
-// Automatically installs Geyser & Floodgate
 ```
 
 ---
@@ -716,30 +650,24 @@ Memory Management
 
 Basic Memory Configuration
 
-```typescript
+```javascript
 memory: {
-  init: '1G',    // Initial heap size
-  max: '4G',     // Maximum heap size
+  init: '2G',
+  max: '4G',
   useAikarsFlags: false
 }
 ```
 
 Aikar's Flags (Optimized)
 
-```typescript
+```javascript
 memory: {
   init: '2G',
   max: '8G',
-  useAikarsFlags: true  // Enables optimized GC flags
+  useAikarsFlags: true
 }
 ```
 
-Memory Units
-
-Unit Value
-M Megabytes (e.g., '512M')
-G Gigabytes (e.g., '2G')
-
 Memory Recommendations
 
 Players RAM Init Max
@@ -754,7 +682,7 @@ Network Settings
 
 Basic Network
 
-```typescript
+```javascript
 network: {
   port: 25565,
   ip: '0.0.0.0',
@@ -763,76 +691,50 @@ network: {
 }
 ```
 
-Public Server with Authentication
-
-```typescript
-network: {
-  port: 25565,
-  ip: '0.0.0.0',
-  onlineMode: true,  // Requires Mojang authentication
-  motd: '§6Official §cMinecraft §aServer'
-}
-```
-
 Cross-Play Network
 
-```typescript
+```javascript
 network: {
-  port: 25565,        // Java port
-  bedrockPort: 19132, // Bedrock port
+  port: 25565,
+  bedrockPort: 19132,
   ip: '0.0.0.0',
-  onlineMode: false,  // Geyser handles auth
-  motd: '§bCross-Play §fServer'
+  onlineMode: false,
+  motd: 'Cross-Play Server'
 }
 ```
 
-Port Forwarding Guide
-
-1. Local Network: Use 192.168.x.x IP
-2. Public Server: Use 0.0.0.0 and configure router
-3. Cloud/VPS: Use public IP or domain
-
 ---
 
 World Configuration
 
 Basic World
 
-```typescript
+```javascript
 world: {
   difficulty: 'normal',
   gamemode: 'survival',
   maxPlayers: 20,
-  viewDistance: 10,
+  viewDistance: 8,
+  simulationDistance: 4,
   levelName: 'world'
 }
 ```
 
 Hardcore Mode
 
-```typescript
+```javascript
 world: {
   difficulty: 'hard',
-  hardcore: true,      // Players get banned on death
+  hardcore: true,
   gamemode: 'survival',
-  maxPlayers: 10
-}
-```
-
-Creative Server
-
-```typescript
-world: {
-  difficulty: 'peaceful',
-  gamemode: 'creative',
-  maxPlayers: 50,
-  viewDistance: 16
+  maxPlayers: 10,
+  viewDistance: 6
 }
 ```
 
 Custom Seed
 
-```typescript
+```javascript
 world: {
   seed: 'my-amazing-seed-12345',
   levelName: 'custom_world'
@@ -843,65 +745,34 @@ world: {
 
 Folder Structure
 
-Java Server Folders
-
 ```
 server/
 ├── plugins/          # Paper/Spigot plugins
 ├── mods/             # Forge/Fabric mods
+├── addons/           # Bedrock addons
 ├── world/            # World data
 ├── logs/             # Server logs
 └── backups/          # Backup files
 ```
 
-Bedrock Server Folders
-
-```
-server/
-├── addons/           # Bedrock behavior packs
-├── world/            # World data
-├── logs/             # Server logs
-└── backups/          # Backup files
-```
-
-Custom Folder Configuration
-
-```typescript
-folders: {
-  addons: './custom_addons',
-  mods: './custom_mods',
-  plugins: './custom_plugins',
-  world: './custom_world'
-}
-```
-
 ---
 
 Backup System
 
 Enable Automatic Backups
 
-```typescript
+```javascript
 backup: {
   enabled: true,
-  interval: '24h',  // Daily backup
+  interval: '24h',
   path: './backups'
 }
 ```
 
-Backup Intervals
-
-Interval Cron Equivalent Description
-'24h' 0 */24 * * *  Every 24 hours
-'12h' 0 */12 * * *  Every 12 hours
-'6h' 0 */6 * * *  Every 6 hours
-'1h' 0 * * * * Every hour
-'30m' */30 * * * * Every 30 minutes
-
 Manual Backup
 
-```typescript
-// Full backup (entire server)
+```javascript
+// Full backup
 const fullPath = await server.backup('full');
 
 // World only backup
@@ -917,7 +788,7 @@ Event System
 
 Server Events
 
-```typescript
+```javascript
 server.on('ready', (info) => {
   console.log('Server ready at', info.port);
 });
@@ -927,13 +798,13 @@ server.on('stop', ({ code }) => {
 });
 
 server.on('resource', (info) => {
-  console.log(`CPU/Memory: ${info.memory.used}/${info.memory.max} MB`);
+  console.log(`Memory: ${info.memory.used}/${info.memory.max} MB`);
 });
 ```
 
 Player Events
 
-```typescript
+```javascript
 server.on('player-join', (player) => {
   console.log(`${player.name} joined from ${player.ip}`);
   server.sendCommand(`say Welcome ${player.name}!`);
@@ -950,7 +821,7 @@ Commands
 
 Built-in Commands
 
-```typescript
+```javascript
 // Send any Minecraft command
 server.sendCommand('say Hello world');
 server.sendCommand('time set day');
@@ -961,7 +832,7 @@ server.sendCommand('gamemode creative @a');
 
 Console Commands
 
-```typescript
+```javascript
 // Stop server
 server.sendCommand('stop');
 
@@ -973,9 +844,6 @@ server.sendCommand('list');
 
 // Ban player
 server.sendCommand('ban Notch');
-
-// Whitelist
-server.sendCommand('whitelist add Dimzxzzx07');
 ```
 
 ---
@@ -984,22 +852,16 @@ Player Management
 
 Get Player List
 
-```typescript
+```javascript
 const players = server.getPlayers();
 players.forEach(player => {
-  console.log(`
-    Name: ${player.name}
-    UUID: ${player.uuid}
-    IP: ${player.ip}
-    Ping: ${player.ping}ms
-    Connected: ${player.connectedAt}
-  `);
+  console.log(`${player.name} - Ping: ${player.ping}ms`);
 });
 ```
 
 Player Count
 
-```typescript
+```javascript
 const info = await server.getInfo();
 console.log(`Players online: ${info.players}/${info.maxPlayers}`);
 ```
@@ -1010,10 +872,10 @@ Cross-Play (Geyser)
 
 Automatic Setup
 
-```typescript
+```javascript
 const server = new MinecraftServer({
-  platform: 'all',  // Enables Geyser & Floodgate
-  version: '1.20.1',
+  platform: 'all',
+  version: '1.21.11',
   type: 'paper',
   network: {
     port: 25565,
@@ -1022,17 +884,31 @@ const server = new MinecraftServer({
 });
 ```
 
-Manual Geyser Configuration
+---
+
+ViaVersion Support
 
-```typescript
-import { GeyserBridge } from '@dimzxzzx07/mc-headless';
+Enable All ViaVersion Plugins
 
-const geyser = new GeyserBridge();
-await geyser.setup({
-  folders: { plugins: './plugins' }
+```javascript
+const server = new MinecraftServer({
+  version: '1.21.11',
+  type: 'paper',
+  enableViaVersion: true,
+  enableViaBackwards: true,
+  enableViaRewind: true
 });
 ```
 
+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
@@ -1052,9 +928,11 @@ pkg install openjdk-17
 # Install mc-headless
 npm install -g @dimzxzzx07/mc-headless
 
-# Create server directory
+# Create server
 mkdir minecraft-server
 cd minecraft-server
+npm init -y
+npm install @dimzxzzx07/mc-headless
 
 # Create server script
 cat > server.js << 'EOF'
@@ -1062,7 +940,7 @@ const { MinecraftServer } = require('@dimzxzzx07/mc-headless');
 
 const server = new MinecraftServer({
   platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
   memory: {
     init: '512M',
@@ -1070,10 +948,6 @@ const server = new MinecraftServer({
   }
 });
 
-server.on('ready', (info) => {
-  console.log(`Server running on port ${info.port}`);
-});
-
 server.start();
 EOF
 
@@ -1081,21 +955,57 @@ EOF
 node server.js
 ```
 
-Termux Optimizations
+---
+
+Performance Tuning
 
-```typescript
+Optimized Configuration for Low CPU
+
+```javascript
 const server = new MinecraftServer({
-  platform: 'java',
-  version: '1.20.1',
+  version: '1.21.11',
   type: 'paper',
   memory: {
-    init: '512M',    // Lower memory for Termux
-    max: '2G',
-    useAikarsFlags: false  // Disable heavy GC flags
+    init: '1G',
+    max: '3G',
+    useAikarsFlags: true
+  },
+  world: {
+    maxPlayers: 20,
+    viewDistance: 6,
+    simulationDistance: 4
   }
 });
 ```
 
+Paper Configuration (paper-global.yml)
+
+```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
+```
+
 ---
 
 Troubleshooting
@@ -1107,18 +1017,16 @@ 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
-EULA not accepted autoAcceptEula: false Set to true or accept manually
-Server crash on start Wrong Java version Install Java 17
+Plugin corrupt Bad download Delete plugin and restart
+High CPU usage Too many chunks loaded Reduce view distance
 
 Debug Mode
 
-```typescript
+```javascript
+// Enable debug logging
 const server = new MinecraftServer({
   // ... config
-});
-
-server.on('resource', (info) => {
-  console.log('Debug:', info);
+  debug: true
 });
 ```
 
@@ -1134,7 +1042,6 @@ tail -f logs/mc-headless.log
 
 ---
 
-
 Project Structure
 
 ```
@@ -1150,7 +1057,7 @@ mc-headless/
 │   │   └── ...
 │   ├── platforms/
 │   │   ├── GeyserBridge.ts
-│   │   └── ...
+│   │   └── ViaVersion.ts
 │   └── utils/
 │       ├── Logger.ts
 │       └── FileUtils.ts
@@ -1158,13 +1065,32 @@ mc-headless/
 ├── examples/
 └── README.md
 ```
+
 ---
 
 License
 
-UNLICENSED - Proprietary software. All rights reserved.
+MIT License
+
+Copyright (c) 2026 Dimzxzzx07
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-This software and its source code are the exclusive property of Dimzxzzx07. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited without express written permission.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
 ---