Instant Startup

!(https://cdn.modrinth.com/data/slyVFseP/images/88ae9f861a8e1f1a185418f86837bb10ee659f7e.png)

## 🧩 InstantStartup

Join your server instantly — and let chunks load progressively.

### 📜 Description

InstantStartup is a performance-focused Minecraft plugin that drastically improves the player join experience by allowing players to connect immediately, while progressively loading chunks around them in a smooth, controlled way.

This plugin is especially useful for large servers with:

Heavily populated worlds Pre-generated terrain Custom join systems A focus on seamless player experience

### ✨ Features

✅ Instant player login – no more chunk load delays on join ✅ Progressive chunk loading (configurable range & rate) ✅ Saves player location and loaded chunks across sessions ✅ Lightweight and async-safe queue system ✅ Admin reload commands via `/rel` ✅ Tracks loaded chunks per-player ✅ Supports safe server restarts with persistent data ✅ Configurable max chunks per tick

### 🛠 Commands

| Command | Permission | Description | | --------------------- | ---------------------- | ------------------------------------------ | | `/rel plugins` | `instantstartup.admin` | Reload all plugins (except protected ones) | | `/rel plugins ` | `instantstartup.admin` | Reload specific plugin | | `/rel world ` | `instantstartup.admin` | Reload world chunks and save locations | | `/rel players` | `instantstartup.admin` | Reload player chunk data | | `/rel data` | `instantstartup.admin` | Reload player data from disk | | `/rel config` | `instantstartup.admin` | Reload the configuration (if applicable) | | `/rel status` | `instantstartup.admin` | View plugin debug/status info |

### 🧠 How It Works

On join, only the chunk the player is in is loaded. Then, nearby chunks are progressively loaded in a spiral pattern. Players stay online and can move around freely while chunks load. All loaded chunks and player locations are stored in a YAML file.

### 📂 File Storage

Player data is saved in `plugins/InstantStartup/playerdata.yml` Stored data includes:

Last known location Loaded chunks Timestamps

### 🚫 Known Limitations

Plugins like EssentialsX, LuckPerms, and ViaVersion are excluded from reload to prevent server instability. Chunk loading is kept safe and server-friendly, but you can tweak the `MAX_CHUNKS_PER_TICK` value in the code for more aggressive loading.

### 💻 Requirements

Minecraft: 1. 21+ Server: Paper / Purpur / Spigot Java: 17+ No configuration required — works out of the box!

### 🔧 Coming Soon

Configurable render distances Chunk load radius per player Metrics support * Integration with other world management tools

### 📦 Installation

1. Download the `.jar` from the (#) 2. Drop it into your `plugins/` folder 3. Start or reload your server 4. Players will now join instantly — and load chunks progressively!

### 🧑‍💻 Author

Created by (https://modrinth.com/user/Eldersson) GitHub: (https://github.com/Eldersson1)