家
一个轻量级的家系统,支持可配置的传送、存储、权限和管理功能。
命令
| 命令 |
描述 |
/sethome [name] |
设置一个家。如果未提供名称,则默认为 home。 |
/home [name] |
传送至某个家。如果不指定名称,则传送到 home 或玩家唯一的家。 |
/delhome [name] |
删除一个家。 |
/homes |
显示可点击的家名称列表。点击名称即可传送。 |
/renamehome <old> <new> |
重命名一个家。 |
/homeadmin set|delete|list|tp|reload |
管理其他玩家家的管理员命令。 |
传送
- 引导时间: 玩家需要静止站立 5 秒。操作栏会显示倒计时。移动到另一个方块或受到伤害会取消传送;这两种取消条件均可在配置中禁用。
- 冷却时间: 默认 30 秒,从成功传送后开始计算。
- 引导时间、冷却时间、音效和粒子效果均可配置。
存储
在配置中选择使用 yaml(homes.yml)或 sqlite(homes.db)。切换存储方式需重启服务器后生效。
冷却时间仅存储在内存中,重启服务器后会重置。
家数量限制
默认限制为 default-max-homes: 3。将其设置为 -1 可实现无限数量的家。
玩家和组可以使用 homes.limit.<number>(例如 homes.limit.10)。适用最高的限制优先级最高。授予 homes.limit.unlimited 权限可实现无限数量的家。
权限
玩家权限
| 权限 |
描述 |
homes.set |
设置家 |
homes.home |
传送至家 |
homes.delete |
删除家 |
homes.list |
列出家 |
homes.rename |
重命名家 |
所有玩家权限默认授予。
管理员权限
| 权限 |
描述 |
homes.admin.set |
为其他玩家设置家 |
homes.admin.delete |
删除其他玩家的家 |
homes.admin.list |
列出其他玩家的家 |
homes.admin.teleport |
传送至其他玩家的家 |
homes.admin.reload |
重载插件 |
拥有 homes.admin 权限即授予所有管理员权限。默认情况下,管理员权限仅授予操作员。
绕过权限
homes.bypass.cooldown — 绕过传送冷却时间。
homes.bypass.warmup — 绕过传送引导时间。
homes.bypass.world — 绕过世界限制。
homes.* 授予所有权限。
其他功能
- 支持家名称验证,可配置最大长度和正则表达式。
- 可配置禁止使用
/sethome 的世界。
- 可选择允许覆盖已有的家。
- 支持家名称和玩家名称的 Tab 补全。
- 所有消息均在
config.yml 中使用 MiniMessage 格式进行英文配置。使用 <prefix> 插入前缀。将消息留空以禁用该提示。
- 管理员只能管理已知名称(已缓存的玩家)的离线玩家所属的家。
Homes
A lightweight home system with configurable teleportation, storage, permissions, and administration.
Commands
| Command |
Description |
/sethome [name] |
Set a home. If no name is provided, the home is named home. |
/home [name] |
Teleport to a home. Without a name, teleports to home or to the player's only home. |
/delhome [name] |
Delete a home. |
/homes |
Display a list of clickable home names. Click a name to teleport. |
/renamehome <old> <new> |
Rename a home. |
/homeadmin set|delete|list|tp|reload |
Admin commands for managing other players' homes. |
Teleportation
- Warmup: Players must stand still for 5 seconds. A countdown is displayed in the action bar. Moving to another block or taking damage cancels the teleport; both cancellation conditions can be disabled in the config.
- Cooldown: 30 seconds by default, starting after a successful teleport.
- Warmup, cooldown, sounds, and particles are configurable.
Storage
Choose between yaml (homes.yml) and sqlite (homes.db) in the config. Switching storage takes effect after a server restart.
Cooldowns are stored in memory only and reset when the server restarts.
Home Limit
The default limit is default-max-homes: 3. Set it to -1 for unlimited homes.
Players and groups can use homes.limit.<number> (for example, homes.limit.10). The highest applicable limit takes precedence. Grant homes.limit.unlimited for unlimited homes.
Permissions
Player permissions
| Permission |
Description |
homes.set |
Set homes |
homes.home |
Teleport to homes |
homes.delete |
Delete homes |
homes.list |
List homes |
homes.rename |
Rename homes |
All player permissions are granted by default.
Admin permissions
| Permission |
Description |
homes.admin.set |
Set homes for other players |
homes.admin.delete |
Delete other players' homes |
homes.admin.list |
List other players' homes |
homes.admin.teleport |
Teleport to other players' homes |
homes.admin.reload |
Reload the plugin |
The homes.admin permission grants all admin permissions. By default, admin permissions are granted to operators only.
Bypass permissions
homes.bypass.cooldown — Bypass the teleport cooldown.
homes.bypass.warmup — Bypass the teleport warmup.
homes.bypass.world — Bypass world restrictions.
homes.* grants all permissions.
Additional Features
- Home name validation with configurable maximum length and regex.
- Configurable worlds where
/sethome is disabled.
- Option to allow overwriting an existing home.
- Tab completion for home names and player names.
- All messages are configurable in English in
config.yml using MiniMessage format. Use <prefix> to insert the prefix. Leave a message empty to disable it.
- Admins can manage homes belonging to offline players only if the server already knows their name (cached player).
评论 0
登录后参与评分
还没有评论,来抢沙发吧