Instant Startup

🧩 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.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 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

---