ChorusHome
为 Paper 26.2 提供安全、快速且完全可自定义的家。
ChorusHome 让你的玩家拥有多个带名称的家,支持基于权限组的数量限制、公共家、点击列表以及安全的传送功能。所有消息均可编辑并支持十六进制颜色,能瞬间适配你的服务器风格。无依赖项,无需数据库,没有配置烦恼。
功能特性
- 每位玩家拥有多个带名称的家,并根据权限组设置限制(
chorushome.limit.<number>)
- 公共家:其他玩家可通过
/home <player>:<home> 访问
- 可点击的
/homes 列表,带有悬停提示框
- 传送延迟:动作栏倒计时,冷却时间,移动时取消,受到伤害时取消
- 安全传送:寻找附近的安全位置,避免将玩家传送到岩浆、虚空或墙壁中
- 所有消息均可在
messages.yml 中编辑,支持十六进制颜色(&#c084fc, #c084fc, 短格式 #ecc)、旧版 & 代码和 MiniMessage 渐变
- 可配置音效、禁用世界、名称长度和默认家名称
- 管理工具:列出、传送至或删除任何玩家(包括离线玩家)的家
- 所有命令均支持 Tab 补全
- 轻量级,无依赖项,安全的异步保存,自动备份
- 更新后会自动添加缺失的配置和消息键
命令
| 命令 |
描述 |
权限 |
/sethome [name] |
设置一个家(或移动现有家) |
chorushome.sethome |
/home [name] |
传送至一个家 |
chorushome.home |
/home <player>:<name> |
传送至公共家 |
chorushome.home.public |
/delhome <name> |
删除一个家 |
chorushome.delhome |
/homes |
列出你的家 |
chorushome.homes |
/renamehome <old> <new> |
重命名一个家 |
chorushome.rename |
/publichome <name> [on|off] |
将家设为公开或私有 |
chorushome.public |
/chorushome help |
显示帮助信息 |
无 |
/chorushome reload |
重载配置和消息 |
chorushome.admin.reload |
/chorushome list <player> |
列出某玩家的家 |
chorushome.admin.list |
/chorushome tp <player> <home> |
立即传送至任意家 |
chorushome.admin.teleport |
/chorushome delete <player> <home> |
删除某玩家的家 |
chorushome.admin.delete |
别名:/removehome, /rmhome, /listhomes, /homerename, /sharehome, /chome
权限
| 权限 |
默认值 |
描述 |
chorushome.sethome |
everyone |
使用 /sethome |
chorushome.home |
everyone |
使用 /home |
chorushome.home.public |
everyone |
访问其他玩家的公共家 |
chorushome.delhome |
everyone |
使用 /delhome |
chorushome.homes |
everyone |
使用 /homes |
chorushome.rename |
everyone |
使用 /renamehome |
chorushome.public |
everyone |
使用 /publichome |
chorushome.limit.<number> |
none |
家的数量限制,例如 chorushome.limit.10。取最高值生效 |
chorushome.limit.unlimited |
op |
无限数量的家 |
chorushome.bypass.cooldown |
op |
忽略传送冷却时间 |
chorushome.bypass.delay |
op |
忽略传送延迟 |
chorushome.bypass.limit |
op |
忽略家的数量限制 |
chorushome.bypass.world |
op |
在被禁用的世界中也可以使用家 |
chorushome.admin |
op |
所有管理命令 |
chorushome.* |
op |
全部权限 |
配置
settings:
default-home-name: home
max-name-length: 16
allow-overwrite: true
limits:
default: 3
disabled-worlds: []
teleport:
delay: 3
cooldown: 10
cancel-on-move: true
move-tolerance: 0.5
cancel-on-damage: true
safe-teleport:
enabled: true
radius: 3
teleport-anyway: false
sounds:
enabled: true
set-home: entity.experience_orb.pickup
teleport: entity.enderman.teleport
countdown: block.note_block.hat
cancel: block.note_block.bass
将 delay 或 cooldown 设置为 0 以禁用它们。将任何音效设置为空值以静音。家名称可以包含字母、数字、- 和 _。
消息与颜色
所有消息都位于 messages.yml 中。你可以使用:
- 十六进制颜色:
&#c084fc, #c084fc 或短格式 #ecc
- 旧版代码:
&l, &o, &r 以及经典的 &0-&f
- MiniMessage 标签,例如
<gradient:#a855f7:#f472b6>text</gradient>
- 占位符,写法如
{home}, {count}, {limit}, {seconds}, {player}, {world}, {x}, {y}, {z}, {old}, {new} 和 {prefix}
将消息设置为空字符串以隐藏它。使用 /chorushome reload 应用更改而无需重启服务器。
专为解决常见问题而设计
- 位于岩浆、墙壁或虚空中的家永远不会被使用:玩家会被移动到最近的安全位置
- 在传送前加载区块,防止玩家掉出世界
- 家名称不区分大小写,因此
Base 和 base 永远不会冲突
- 如果世界被重命名,家仍然有效;如果世界丢失,会给出明确的消息
- 数据以原子方式写入并带有备份文件,因此崩溃不会导致你的家数据丢失
- 传送延迟无法被滥用:移动、受到伤害、登出或重复命令都会取消或阻止热身过程
- 管理员可以管理离线玩家的家
安装
- 下载
ChorusHome-1.0.0.jar 并将其放入你的 plugins 文件夹。
- 启动服务器一次以生成
config.yml 和 messages.yml。
- 根据需要调整文件,然后运行
/chorushome reload。
要求
- Paper 26.2(或兼容分支)以及 Java 25
- 不支持 Folia
支持
发现 bug 或有建议?请在项目页面上提交 Issue,并附上你的服务器版本和控制台的相关部分。
由 Controll3r24 制作。
ChorusHome
Safe, fast and fully customizable homes for Paper 26.2.
ChorusHome gives your players multiple named homes with rank-based limits, public homes, clickable lists and safe teleportation. Every message is editable and supports hex colors, so it fits the look of your server in seconds. No dependencies, no database, no setup headaches.
Features
- Multiple named homes per player with limits per rank (
chorushome.limit.<number>)
- Public homes that other players can visit with
/home <player>:<home>
- Clickable
/homes list with hover tooltips
- Teleport delay with action bar countdown, cooldown, cancel on move and cancel on damage
- Safe teleport: finds a nearby safe spot instead of dropping players into lava, void or walls
- Every message is editable in
messages.yml, with hex colors (&#c084fc, #c084fc, short #ecc), legacy & codes and MiniMessage gradients
- Configurable sounds, disabled worlds, name length and default home name
- Admin tools to list, teleport to and delete homes of any player, even offline ones
- Tab completion for every command
- Lightweight, no dependencies, safe asynchronous saving with automatic backup
- Missing config and message keys are added automatically after updates
Commands
| Command |
Description |
Permission |
/sethome [name] |
Set a home (or move an existing one) |
chorushome.sethome |
/home [name] |
Teleport to a home |
chorushome.home |
/home <player>:<name> |
Teleport to a public home |
chorushome.home.public |
/delhome <name> |
Delete a home |
chorushome.delhome |
/homes |
List your homes |
chorushome.homes |
/renamehome <old> <new> |
Rename a home |
chorushome.rename |
/publichome <name> [on|off] |
Make a home public or private |
chorushome.public |
/chorushome help |
Show the help |
none |
/chorushome reload |
Reload config and messages |
chorushome.admin.reload |
/chorushome list <player> |
List the homes of a player |
chorushome.admin.list |
/chorushome tp <player> <home> |
Teleport to any home instantly |
chorushome.admin.teleport |
/chorushome delete <player> <home> |
Delete a home of a player |
chorushome.admin.delete |
Aliases: /removehome, /rmhome, /listhomes, /homerename, /sharehome, /chome
Permissions
| Permission |
Default |
Description |
chorushome.sethome |
everyone |
Use /sethome |
chorushome.home |
everyone |
Use /home |
chorushome.home.public |
everyone |
Visit public homes of other players |
chorushome.delhome |
everyone |
Use /delhome |
chorushome.homes |
everyone |
Use /homes |
chorushome.rename |
everyone |
Use /renamehome |
chorushome.public |
everyone |
Use /publichome |
chorushome.limit.<number> |
none |
Home limit, for example chorushome.limit.10. The highest value wins |
chorushome.limit.unlimited |
op |
No home limit |
chorushome.bypass.cooldown |
op |
Ignore the teleport cooldown |
chorushome.bypass.delay |
op |
Ignore the teleport delay |
chorushome.bypass.limit |
op |
Ignore the home limit |
chorushome.bypass.world |
op |
Use homes in disabled worlds |
chorushome.admin |
op |
All admin commands |
chorushome.* |
op |
Everything |
Configuration
settings:
default-home-name: home
max-name-length: 16
allow-overwrite: true
limits:
default: 3
disabled-worlds: []
teleport:
delay: 3
cooldown: 10
cancel-on-move: true
move-tolerance: 0.5
cancel-on-damage: true
safe-teleport:
enabled: true
radius: 3
teleport-anyway: false
sounds:
enabled: true
set-home: entity.experience_orb.pickup
teleport: entity.enderman.teleport
countdown: block.note_block.hat
cancel: block.note_block.bass
Set delay or cooldown to 0 to disable them. Set any sound to an empty value to mute it. Home names can contain letters, numbers, - and _.
Messages and colors
Every message lives in messages.yml. You can use:
- Hex colors:
&#c084fc, #c084fc or the short form #ecc
- Legacy codes:
&l, &o, &r and the classic &0-&f
- MiniMessage tags such as
<gradient:#a855f7:#f472b6>text</gradient>
- Placeholders written as
{home}, {count}, {limit}, {seconds}, {player}, {world}, {x}, {y}, {z}, {old}, {new} and {prefix}
Set a message to an empty string to hide it. Use /chorushome reload to apply changes without restarting.
Built to avoid the usual problems
- Homes inside lava, walls or the void are never used: players are moved to the closest safe spot
- Chunks are loaded before teleporting, so players never fall through the world
- Home names are case-insensitive, so
Base and base can never clash
- Homes keep working if a world is renamed, and give a clear message if a world is missing
- Data is written atomically with a backup file, so a crash cannot wipe your homes
- Teleport delay cannot be abused: moving, taking damage, logging out or double commands cancel or block the warm-up
- Admins can manage homes of offline players
Installation
- Download
ChorusHome-1.0.0.jar and put it in your plugins folder.
- Start the server once to generate
config.yml and messages.yml.
- Adjust the files to your liking and run
/chorushome reload.
Requirements
- Paper 26.2 (or a compatible fork) and Java 25
- Folia is not supported
Support
Found a bug or have a suggestion? Open an issue on the project page and include your server version and the relevant part of the console.
Made by Controll3r24.
评论 0
登录后参与评分
还没有评论,来抢沙发吧