🧩 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 <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 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.ymlStored 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_TICKvalue 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
- Download the
.jarfrom the Versions tab - Drop it into your
plugins/folder - Start or reload your server
- Players will now join instantly — and load chunks progressively!
🧑💻 Author
Created by Eldersson GitHub: Eldersson1
