SpawnManager
轻量级、现代化的 Minecraft 服务器出生点管理方案。
SpawnManager 添加了一个可配置的共享出生点,且不会试图取代 Essentials。它无需数据库、无需 API 密钥,也无需额外的服务端辅助插件。
✨ 功能特性
/spawn, /setspawn, /delspawn
/spawn help, /spawn reload, /spawn set, 以及 /spawn delete
- 可配置的传送倒计时
- 通过聊天栏、动作栏、标题或完全禁用来显示倒计时
- 可选的在倒计时期间取消移动
- 可选的在倒计时期间取消伤害
- 可配置的传送冷却时间
- 基于权限的冷却和延迟绕过
- 可选的首次加入或每次加入时自动传送
- 可选的重生传送
- 可选的虚空救援
- 可选的安全位置搜索
- 可配置的传送音效和粒子效果
- 支持 MiniMessage 格式的消息
- 保存出生点旋转角度数据
- 出生点数据存储在
spawn-data.yml 中
- 无需数据库
- 无需外部依赖
不支持 Folia。 倒计时使用标准的 Bukkit 调度器,SpawnManager 不声称兼容 Folia。
? 安装
- 下载与你的 Minecraft 版本匹配的 SpawnManager JAR 文件。
- 将
.jar 文件放入服务器的 plugins 文件夹中。
- 启动或重启服务器。
- 站在你想要设置为出生点的位置。
- 运行
/setspawn。
就是这样。
SpawnManager 会在服务器启动时自动创建其配置文件。
无需数据库、API 密钥或额外插件。MiniMessage 支持已内置于插件中。
? 命令
| 命令 |
描述 |
/spawn |
传送到已配置的出生点 |
/spawn help |
显示 SpawnManager 命令帮助 |
/spawn reload |
重新加载 SpawnManager 的配置 |
/spawn set |
在当前所在位置设置出生点 |
/setspawn |
在当前所在位置设置出生点 |
/spawn delete |
删除已配置的出生点 |
/delspawn |
删除已配置的出生点 |
/spawnmanager reload |
重新加载 SpawnManager 的配置 |
如果启用了出生点删除确认,请使用:
/spawn delete confirm
或
/delspawn confirm
确认将在 15 秒后过期。
? 权限
| 权限 |
默认值 |
描述 |
spawnmanager.spawn |
Everyone |
使用 /spawn |
spawnmanager.help |
Everyone |
查看帮助菜单 |
spawnmanager.setspawn |
Operators |
设置出生点 |
spawnmanager.delspawn |
Operators |
删除出生点 |
spawnmanager.reload |
Operators |
重新加载配置 |
spawnmanager.bypass.cooldown |
Operators |
绕过传送冷却时间 |
spawnmanager.bypass.delay |
Operators |
绕过传送倒计时 |
⚙️ 配置
首次启动服务器后,SpawnManager 会创建:
plugins/SpawnManager/config.yml
以及:
plugins/SpawnManager/spawn-data.yml
传送 (Teleport)
teleport:
delay: 3
cooldown: 10
cancel-on-move: true
movement-threshold: 0.2
cancel-on-damage: true
safe: false
safe-search-radius: 3
delay — 传送倒计时(秒)
cooldown — 玩家再次使用 /spawn 前需等待的时间
cancel-on-move — 玩家移动时取消倒计时
movement-threshold — 允许移动多少距离才会被取消
cancel-on-damage — 玩家受到伤害时取消倒计时
safe — 尝试在出生点附近寻找安全的传送位置
safe-search-radius — 搜索安全位置的范围半径
倒计时 (Countdown)
countdown:
type: actionbar
可用选项:
chat
actionbar
title
none
加入传送 (Join Teleport)
join:
mode: disabled
可用选项:
disabled — 无自动加入传送
first-join — 玩家在首次加入时传送到出生点
every-join — 玩家每次加入时都传送到出生点
重生 (Respawn)
respawn:
teleport: false
override-bed: false
teleport — 玩家死亡后传送到已配置的出生点
override-bed — 已配置的出生点是否覆盖玩家的床/重生点位置
虚空救援 (Void Rescue)
void:
enabled: false
y-level: 0
启用后,掉落到低于配置 Y 级别的玩家将被传送回已配置的出生点。
消息 (Messages)
所有面向玩家的消息均可在 config.yml 中配置,并支持 MiniMessage 格式。
这允许你自定义颜色、渐变、样式以及其他支持的 MiniMessage 格式。
? 出生点数据
已配置的出生点保存在:
plugins/SpawnManager/spawn-data.yml
该文件存储:
- 世界 (World)
- X 坐标
- Y 坐标
- Z 坐标
- 偏航角 (Yaw)
- 俯仰角 (Pitch)
实际生成的出生点位置仅在运行 /setspawn 时更改。
如果启用了安全传送,SpawnManager 会在已保存的出生点周围搜索安全位置,而不会更改实际保存的出生点坐标。
? 兼容性
SpawnManager 为不同的 Minecraft 版本提供单独的构建包。
| Minecraft |
下载 |
平台 |
Java |
| 1.21–1.21.11 |
SpawnManager-1.21.x.jar |
Paper / Bukkit API |
Java 21 |
| 26.1 |
SpawnManager-26.1.jar |
Paper |
Java 25 |
| 26.2 |
SpawnManager-26.2.jar |
Paper |
Java 25 |
| 26.3 |
SpawnManager-26.3.jar |
Paper |
Java 25 |
重要提示
请下载与你的 Minecraft 服务器版本匹配的构建包。
请勿在 1.21.x 服务器上使用 26.x 构建版本,也不要在 26.x 服务器上使用 1.21.x 构建版本。
1.21.x 构建版本使用 Java 21。
26.x 构建版本使用 Java 25。
Spigot 和 Purpur 可能可以正常工作,因为 SpawnManager 使用了面向 Bukkit 的 API,但尚未进行完整的集成测试。
不支持 Folia。
?️ 故障排除
出生点缺失
站在你希望设置的出生点位置,并运行:
/setspawn
出生点世界不再存在
SpawnManager 会在服务器控制台中向你发出警告。
加载/恢复丢失的世界,或使用以下命令设置新的出生点:
/setspawn
/spawn 无法工作
请检查:
- 玩家拥有
spawnmanager.spawn 权限
- 已配置出生点
- 玩家当前未处于冷却时间中
- 没有其他传送倒计时正在活动
倒计时显示不正确
请检查 config.yml 中的以下设置:
countdown:
type: actionbar
有效值为:
chat
actionbar
title
none
配置更改未生效
请使用:
/spawn reload
或:
/spawnmanager reload
你也可以重启服务器。
SpawnManager 的重载命令不会执行 Bukkit 的全局 /reload。
传送被取消
如果启用了移动取消:
cancel-on-move: true
在倒计时期间移动将取消传送。
如果启用了伤害取消:
cancel-on-damage: true
受到伤害也将取消传送。
❓ 需要帮助?
如果遇到任何问题,请提供以下信息:
- Minecraft 版本
- 服务器软件及版本
- SpawnManager 版本
- 相关的控制台错误日志
- 如果问题是与配置相关,请提供你的
config.yml
请在报告问题之前确保你使用的是与你 Minecraft 版本匹配的 SpawnManager 构建版本。
SpawnManager — 简单实用的出生点管理,无冗余功能。
SpawnManager
Lightweight, modern spawn management for Minecraft servers.
SpawnManager adds a configurable shared spawn without trying to become an Essentials replacement. It requires no database, no API key, and no additional server-side companion plugin.
✨ Features
/spawn, /setspawn, /delspawn
/spawn help, /spawn reload, /spawn set, and /spawn delete
- Configurable teleport countdown
- Countdown display via chat, action bar, title, or completely disabled
- Optional movement cancellation during countdown
- Optional damage cancellation during countdown
- Configurable teleport cooldown
- Permission-based cooldown and delay bypasses
- Optional first-join or every-join teleport
- Optional respawn teleport
- Optional void rescue
- Optional safe-location search
- Configurable teleport sounds and particles
- MiniMessage-formatted messages
- Spawn rotation is saved
- Spawn data is stored in
spawn-data.yml
- No database required
- No external dependencies required
Folia is not supported. The countdown uses the standard Bukkit scheduler, and SpawnManager does not claim Folia compatibility.
? Installation
- Download the SpawnManager JAR matching your Minecraft version.
- Put the
.jar file into your server's plugins folder.
- Start or restart your server.
- Stand at the location where you want the spawn.
- Run
/setspawn.
That's it.
SpawnManager automatically creates its configuration files when the server starts.
No database, API key, or additional plugin is required. MiniMessage support is already included in the plugin.
? Commands
| Command |
Description |
/spawn |
Teleport to the configured spawn |
/spawn help |
Show SpawnManager command help |
/spawn reload |
Reload SpawnManager's configuration |
/spawn set |
Set the spawn at your current location |
/setspawn |
Set the spawn at your current location |
/spawn delete |
Delete the configured spawn |
/delspawn |
Delete the configured spawn |
/spawnmanager reload |
Reload SpawnManager's configuration |
If spawn deletion confirmation is enabled, use:
/spawn delete confirm
or
/delspawn confirm
The confirmation expires after 15 seconds.
? Permissions
| Permission |
Default |
Description |
spawnmanager.spawn |
Everyone |
Use /spawn |
spawnmanager.help |
Everyone |
View the help menu |
spawnmanager.setspawn |
Operators |
Set the spawn |
spawnmanager.delspawn |
Operators |
Delete the spawn |
spawnmanager.reload |
Operators |
Reload the configuration |
spawnmanager.bypass.cooldown |
Operators |
Bypass the teleport cooldown |
spawnmanager.bypass.delay |
Operators |
Bypass the teleport countdown |
⚙️ Configuration
After the first server start, SpawnManager creates:
plugins/SpawnManager/config.yml
and:
plugins/SpawnManager/spawn-data.yml
Teleport
teleport:
delay: 3
cooldown: 10
cancel-on-move: true
movement-threshold: 0.2
cancel-on-damage: true
safe: false
safe-search-radius: 3
delay — Teleport countdown in seconds
cooldown — Time before the player can use /spawn again
cancel-on-move — Cancels the countdown when the player moves
movement-threshold — How much movement is allowed before cancellation
cancel-on-damage — Cancels the countdown when the player takes damage
safe — Attempts to find a safe teleport location near the spawn
safe-search-radius — Search radius for a safe location
Countdown
countdown:
type: actionbar
Available options:
chat
actionbar
title
none
Join Teleport
join:
mode: disabled
Available options:
disabled — No automatic join teleport
first-join — Teleport players to spawn on their first join
every-join — Teleport players to spawn every time they join
Respawn
respawn:
teleport: false
override-bed: false
teleport — Teleport players to the configured spawn after death
override-bed — Whether the configured spawn should override a player's bed/respawn location
Void Rescue
void:
enabled: false
y-level: 0
When enabled, players falling below the configured Y level can be teleported back to the configured spawn.
Messages
All player-facing messages can be configured in config.yml and support MiniMessage formatting.
This allows you to customize colors, gradients, styling, and other supported MiniMessage formatting.
? Spawn Data
The configured spawn is saved in:
plugins/SpawnManager/spawn-data.yml
The file stores:
- World
- X coordinate
- Y coordinate
- Z coordinate
- Yaw
- Pitch
The exact spawn location is only changed when /setspawn is used.
If safe teleport is enabled, SpawnManager searches for a safe location around the saved spawn without changing the actual saved spawn coordinates.
? Compatibility
SpawnManager provides separate builds for different Minecraft versions.
| Minecraft |
Download |
Platform |
Java |
| 1.21–1.21.11 |
SpawnManager-1.21.x.jar |
Paper / Bukkit API |
Java 21 |
| 26.1 |
SpawnManager-26.1.jar |
Paper |
Java 25 |
| 26.2 |
SpawnManager-26.2.jar |
Paper |
Java 25 |
| 26.3 |
SpawnManager-26.3.jar |
Paper |
Java 25 |
Important
Download the build that matches your Minecraft server version.
Do not use a 26.x build on a 1.21.x server, and do not use the 1.21.x build on a 26.x server.
The 1.21.x build uses Java 21.
The 26.x builds use Java 25.
Spigot and Purpur may work because SpawnManager uses Bukkit-facing APIs, but they have not been fully integration-tested.
Folia is not supported.
?️ Troubleshooting
Spawn is missing
Stand at your desired spawn location and run:
/setspawn
The spawn world no longer exists
SpawnManager will warn you in the server console.
Load/restore the missing world or set a new spawn with:
/setspawn
/spawn does not work
Check:
- The player has
spawnmanager.spawn
- A spawn has been configured
- The player is not currently on cooldown
- Another teleport countdown is not already active
The countdown does not appear correctly
Check the following setting in config.yml:
countdown:
type: actionbar
Valid values are:
chat
actionbar
title
none
Configuration changes are not applied
Use:
/spawn reload
or:
/spawnmanager reload
You can also restart the server.
SpawnManager's reload command does not run Bukkit's global /reload.
Teleport gets cancelled
If movement cancellation is enabled:
cancel-on-move: true
moving during the countdown will cancel the teleport.
If damage cancellation is enabled:
cancel-on-damage: true
taking damage will also cancel the teleport.
❓ Need Help?
If you encounter an issue, please include:
- Minecraft version
- Server software and version
- SpawnManager version
- Relevant console errors
- Your
config.yml if the issue is configuration-related
Please make sure you are using the correct SpawnManager build for your Minecraft version before reporting an issue.
SpawnManager — simple spawn management without the bloat.
评论 0
登录后参与评分
还没有评论,来抢沙发吧