Haven
Haven 是一款适用于 Paper 的家插件。玩家可以保存地点,在可点击的列表中查找它们,并在之后传送回去。它默认即可使用,服务器管理员可以调整家数量上限、传送延迟、消息和音效。
功能
- 支持命名家,通过权限设置数量上限
- 按世界分组的家园列表,点击名称即可传送
- 可选的传送预热时间,若玩家移动方块或受到伤害则取消
- 可选的冷却时间,仅在成功传送后生效
- 替换已有家园前需要确认
- 家园名称自动补全
命令
| 命令 |
别名 |
描述 |
/sethome [name] |
|
在当前地点保存一个家。默认名称为 home |
/home [name] |
|
传送到指定家 |
/delhome <name> |
/removehome |
删除一个家 |
/homes |
/listhomes |
列出你的所有家 |
/haven reload |
|
重新加载配置与消息文件 |
权限
默认情况下,所有玩家均可使用上述命令。
| 权限节点 |
默认值 |
用途 |
haven.home |
Everyone |
使用 /home |
haven.sethome |
Everyone |
使用 /sethome |
haven.delhome |
Everyone |
使用 /delhome |
haven.homes |
Everyone |
使用 /homes |
haven.homes.<n> |
Not set |
设置家数量为 <n> |
haven.homes.unlimited |
Operators |
移除家数量限制 |
haven.bypass.warmup |
Operators |
跳过传送预热时间 |
haven.bypass.cooldown |
Operators |
跳过传送冷却时间 |
haven.admin.reload |
Operators |
使用 /haven reload |
例如,可为某个权限组授予 haven.homes.5,为另一个授予 haven.homes.10。如果玩家拥有多个家数量上限权限,则以最高者为准。降低家数量上限不会删除已有的家。
配置
使用 config.yml 设置家数量上限、传送延迟和音效。每个选项在文件中均有说明。你可以替换单个音效、使用资源包中的音效,或直接关闭音效。
Haven 的家相关提示和传送消息采用 MiniMessage 格式,可在 messages.yml 中编辑。运行 /haven reload 使两个文件的更改生效。
PlaceholderAPI
PlaceholderAPI 为可选依赖。以下占位符在玩家在线时可用:
| 占位符 |
值 |
%haven_homes_used% |
已保存的家数量 |
%haven_homes_max% |
家数量上限 |
%haven_homes_free% |
剩余的家槽位 |
%haven_homes_list% |
已保存的家名称列表 |
请使用与你 Paper 版本兼容的 PlaceholderAPI 构建版本。
要求
Haven 支持 Paper 1.18.2 至 26.3。对于 Paper 1.18 和 1.19,请使用 Java 17;对于 1.20 和 1.21,请使用 Java 21;对于 26.x,请使用 Java 25。
存储与指标
每个玩家的家数据分别存储在一个 YAML 文件中。手动编辑这些文件前请停止服务器。
Haven 使用 bStats 收集匿名使用统计信息。你可以在 plugins/bStats/config.yml 中禁用 bStats。
Haven
Haven is a homes plugin for Paper. Players can save locations, find them in a clickable list, and teleport back later. It works with the default settings, and server owners can adjust home limits, teleport timing, messages, and sounds.
Features
- Named homes with limits set through permissions
- A home list grouped by world. Click a name to teleport
- An optional teleport warmup that can cancel when a player changes block or takes damage
- An optional cooldown applied only after a successful teleport
- Confirmation before replacing an existing home
- Home name tab completion
Commands
| Command |
Alias |
Description |
/sethome [name] |
|
Save a home at your location. The default name is home |
/home [name] |
|
Teleport to a home |
/delhome <name> |
/removehome |
Delete a home |
/homes |
/listhomes |
List your homes |
/haven reload |
|
Reload the config and messages |
Permissions
The player commands are available to everyone by default.
| Permission |
Default |
Purpose |
haven.home |
Everyone |
Use /home |
haven.sethome |
Everyone |
Use /sethome |
haven.delhome |
Everyone |
Use /delhome |
haven.homes |
Everyone |
Use /homes |
haven.homes.<n> |
Not set |
Set a home limit of <n> |
haven.homes.unlimited |
Operators |
Remove the home limit |
haven.bypass.warmup |
Operators |
Skip the teleport warmup |
haven.bypass.cooldown |
Operators |
Skip the teleport cooldown |
haven.admin.reload |
Operators |
Use /haven reload |
For example, grant haven.homes.5 to one rank and haven.homes.10 to another. If a player has more than one limit permission, the highest limit applies. Lowering a limit does not delete existing homes.
Configuration
Use config.yml to set home limits, teleport timing, and sounds. Each option is explained in the file. You can replace individual sounds, use sounds from a resource pack, or turn sounds off.
Haven’s home and teleport messages use MiniMessage and can be edited in messages.yml. Run /haven reload to apply changes to both files.
PlaceholderAPI
PlaceholderAPI is optional. These placeholders work while the player is online:
| Placeholder |
Value |
%haven_homes_used% |
Number of saved homes |
%haven_homes_max% |
Home limit |
%haven_homes_free% |
Remaining home slots |
%haven_homes_list% |
Saved home names |
Use a PlaceholderAPI build compatible with your Paper version.
Requirements
Haven supports Paper 1.18.2 through 26.3. Use Java 17 for Paper 1.18 and 1.19, Java 21 for 1.20 and 1.21, and Java 25 for 26.x.
Storage and metrics
Homes are stored in one YAML file per player. Stop the server before editing these files by hand.
Haven uses bStats for anonymous usage statistics. You can disable bStats in plugins/bStats/config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧