? SetHome 插件 — Paper 1.21.1
适用于 Paper 1.21.1 的完整 SetHome 插件,具备 LuckPerms 集成、冷却系统、带取消功能的传送延迟以及完全可自定义的标题。
✅ 功能
- 无限家园(按 LuckPerms 组限制)
- 基于组的冷却时间(完全可配置)
- 传送延迟(玩家移动时自动取消)
- 完全可自定义的标题与副标题(支持十六进制颜色
&#RRGGBB)
- 自动保存(家园数据以 YAML 格式保存)
- Tab 补全 对所有命令启用
- 管理员命令(重载、列表、删除)
? 安装
- 将
.jar 文件放入服务器的 plugins/ 目录。
- 确保服务器已安装 LuckPerms。
- 启动服务器 ——
plugins/SetHome/ 文件夹将自动生成。
- 根据需要修改
config.yml。
- 运行
/homeadmin reload 即可应用配置更改,无需重启服务器。
? 命令
| 命令 |
描述 |
/sethome <name> |
在当前位置设置一个家园 |
/home <name> |
传送到某个家园 |
/delhome <name> |
删除一个家园 |
/listhomes |
列出你的所有家园 |
/homeadmin reload |
重载配置文件 |
/homeadmin list <player> |
查看特定玩家的家园 |
/homeadmin delete <player> <home> |
删除特定玩家的某个家园 |
? 权限
| 权限节点 |
描述 |
默认值 |
sethome.use |
授予基本命令的使用权限 |
true |
sethome.admin |
授予管理员命令的使用权限 |
op |
sethome.bypass.cooldown |
绕过传送冷却时间 |
op |
sethome.bypass.limit |
绕过家园数量限制 |
op |
⚙️ LuckPerms 配置
组限制 (group-homes)
group-homes:
default: 3
vip: 6
vip+: 10
staff: 20
admin: -1 # -1 = unlimited
组冷却时间 (group-cooldowns,单位为秒)
group-cooldowns:
default: 10
vip: 5
vip+: 3
staff: 0
admin: 0
注意: 如果玩家属于多个组,则具有最高限制(或最低冷却时间)的组优先生效。
? 标题自定义
标题支持:
- 旧版颜色代码,如
&a、&b、&l 等
- 十六进制颜色代码,如
&#RRGGBB
config.yml 中的示例:
titles:
teleport-success:
enabled: true
title: '�FF7F&l✔ Arrived'
subtitle: '&7Welcome to &a{home}&7!'
fade-in: 10
stay: 40
fade-out: 20
可用占位符
| 占位符 |
适用位置 |
{home} |
所有标题 |
{seconds} |
teleport-delay |
?️ 编译
前置条件:Java 21、Maven
mvn clean package
编译后的 jar 文件位于 target/SetHome-1.0.0.jar。
? 项目结构
SetHome/
├── src/main/java/fr/sethome/
│ ├── SetHomePlugin.java # 主类
│ ├── commands/
│ │ ├── SetHomeCommand.java
│ │ ├── HomeCommand.java # 传送 + 冷却 + 延迟
│ │ ├── DelHomeCommand.java
│ │ ├── ListHomesCommand.java
│ │ ├── HomeAdminCommand.java
│ │ └── SetHomeTabCompleter.java
│ ├── listeners/
│ │ └── PlayerMoveListener.java # 移动时取消
│ ├── managers/
│ │ ├── ConfigManager.java # 配置加载 + LP 组
│ │ ├── HomeManager.java # 家 CRUD 操作 + YAML 保存
│ │ └── CooldownManager.java # 冷却 + 待处理任务
│ └── utils/
│ └── TitleUtil.java # Adventure API 标题发送
└── src/main/resources/
├── plugin.yml
├── config.yml
└── homes.yml
? SetHome Plugin — Paper 1.21.1
Complete SetHome plugin for Paper 1.21.1 featuring LuckPerms integration, cooldown system,
teleport delays with cancellation, and fully customizable titles.
✅ Features
- Unlimited Homes (restricted per LuckPerms group)
- Group-based Cooldowns (fully configurable)
- Teleport Delay (cancels automatically if the player moves)
- Fully Customizable Titles & Subtitles (supports hex colors
&#RRGGBB)
- Automated Saving (homes saved in YAML format)
- Tab-completion enabled for all commands
- Admin Commands (reload, list, delete)
? Installation
- Drop the
.jar file into your plugins/ directory.
- Ensure LuckPerms is installed on the server.
- Start the server — the
plugins/SetHome/ folder will generate automatically.
- Modify
config.yml according to your needs.
- Run
/homeadmin reload to apply configuration changes without restarting.
? Commands
| Command |
Description |
/sethome <name> |
Create a home at your current position |
/home <name> |
Teleport to a home |
/delhome <name> |
Delete a home |
/listhomes |
List your homes |
/homeadmin reload |
Reload the configuration |
/homeadmin list <player> |
View a specific player's homes |
/homeadmin delete <player> <home> |
Delete a specific player's home |
? Permissions
| Permission |
Description |
Default |
sethome.use |
Grants access to basic commands |
true |
sethome.admin |
Grants access to admin commands |
op |
sethome.bypass.cooldown |
Bypasses teleport cooldowns |
op |
sethome.bypass.limit |
Bypasses home limits |
op |
⚙️ LuckPerms Configuration
Group Limits (group-homes)
group-homes:
default: 3
vip: 6
vip+: 10
staff: 20
admin: -1 # -1 = unlimited
Group Cooldowns (group-cooldowns, in seconds)
group-cooldowns:
default: 10
vip: 5
vip+: 3
staff: 0
admin: 0
Note: If a player belongs to multiple groups, the group with the highest limit (or the lowest cooldown) takes priority.
? Title Customization
Titles support:
- Legacy color codes like
&a, &b, &l, etc.
- Hex color codes like
&#RRGGBB
Example in config.yml:
titles:
teleport-success:
enabled: true
title: '�FF7F&l✔ Arrived'
subtitle: '&7Welcome to &a{home}&7!'
fade-in: 10
stay: 40
fade-out: 20
Available Placeholders
| Placeholder |
Available in |
{home} |
All titles |
{seconds} |
teleport-delay |
?️ Compilation
Prerequisites: Java 21, Maven
mvn clean package
The compiled jar file can be found in target/SetHome-1.0.0.jar.
? Project Structure
SetHome/
├── src/main/java/fr/sethome/
│ ├── SetHomePlugin.java # Main class
│ ├── commands/
│ │ ├── SetHomeCommand.java
│ │ ├── HomeCommand.java # Teleportation + cooldown + delay
│ │ ├── DelHomeCommand.java
│ │ ├── ListHomesCommand.java
│ │ ├── HomeAdminCommand.java
│ │ └── SetHomeTabCompleter.java
│ ├── listeners/
│ │ └── PlayerMoveListener.java # Cancellation on movement
│ ├── managers/
│ │ ├── ConfigManager.java # Config loading + LP groups
│ │ ├── HomeManager.java # Home CRUD operations + YAML saving
│ │ └── CooldownManager.java # Cooldown + pending tasks
│ └── utils/
│ └── TitleUtil.java # Adventure API title sending
└── src/main/resources/
├── plugin.yml
├── config.yml
└── homes.yml
评论 0
登录后参与评分
还没有评论,来抢沙发吧