## 🧩 InstantStartup
**立即加入你的服务器 — 并让区块逐步加载。**
---
### 📜 描述
**InstantStartup** 是一款注重性能的 Minecraft 插件，它通过允许玩家**立即**连接，同时以平滑、可控的方式逐步加载他们周围的区块，从而显著改善玩家加入体验。
此插件特别适用于具有以下特性的大型服务器：
* 人口稠密的世界
* 预生成的地形
* 自定义加入系统
* 注重无缝玩家体验
---
### ✨ 特性
✅ 立即玩家登录 – 无需在加入时等待区块加载
✅ 逐步区块加载 (可配置的范围和速率)
✅ 保存玩家位置和跨会话的已加载区块
✅ 轻量级且异步安全队列系统
✅ 管理员通过 `/rel` 重新加载命令
✅ 跟踪每个玩家的已加载区块
✅ 支持服务器安全重启与持久数据
✅ 可配置的每滴最大区块数
---
### 🛠 命令
| 命令 | 权限 | 描述 |
| --------------------- | ---------------------- | ------------------------------------------ |
| `/rel plugins` | `instantstartup.admin` | 重新加载所有插件 (除了受保护的插件) |
| `/rel plugins ` | `instantstartup.admin` | 重新加载特定插件 |
| `/rel world ` | `instantstartup.admin` | 重新加载世界区块和保存位置 |
| `/rel players` | `instantstartup.admin` | 重新加载玩家区块数据 |
| `/rel data` | `instantstartup.admin` | 从磁盘重新加载玩家数据 |
| `/rel config` | `instantstartup.admin` | 重新加载配置 (如果适用) |
| `/rel status` | `instantstartup.admin` | 查看插件调试/状态信息 |
---
### 🧠 工作原理
* 加入时，仅加载**玩家所在的区块**。
* 然后，以**螺旋模式**逐步加载附近的区块。
* 玩家可以保持在线并自由移动，同时加载区块。
* 所有已加载的区块和玩家位置都存储在 YAML 文件中。
---
### 📂 文件存储
* 玩家数据保存在 `plugins/InstantStartup/playerdata.yml` 中
* 存储的数据包括：
* 上次已知位置
* 已加载区块
* 时间戳
---
### 🚫 已知限制
* 诸如 **EssentialsX**, **LuckPerms** 和 **ViaVersion** 之类的插件**不包括在重新加载范围内**，以防止服务器不稳定。
* 区块加载被安全地控制在服务器友好范围内，但您可以在代码中调整 `MAX_CHUNKS_PER_TICK` 值以进行更激进的加载。
---
### 💻 要求
* Minecraft: **1.21+**
* 服务器: **Paper / Purpur / Spigot**
* Java: **17+**
* 不需要配置 — 即可开箱使用！
---
### 🔧 即将推出
* 可配置的渲染距离
* 每位玩家的区块加载半径
* 指标支持
* 与其他世界管理工具的集成
---
### 📦 安装
1. 从 [版本标签](#) 下载 `.jar` 文件
2. 将其放入您的 `plugins/` 文件夹中
3. 启动或重新加载您的服务器
4. 玩家现在将立即加入 — 并逐步加载区块！
---
### 🧑💻 作者
由 [Eldersson](https://modrinth.com/user/Eldersson) 创建
GitHub: [Eldersson1](https://github.com/Eldersson1)
---