Instant Startup

🧩 InstantStartup

Join your server instantly — and let chunks load progressively.

---

📜 Description

immediately 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 <name>` | `instantstartup.admin` | Reload specific plugin | | `/rel world <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 spiral pattern 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 excluded from reload, excluded from reload, and excluded from reload 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: 17+ * Server: 17+ * 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 Versions tab 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 Eldersson GitHub: Eldersson1

---