SethomeLuck

插件

· 作者 Xaturox_offi

使用 LuckPerms 添加 sethome 功能,你就可以为你的服务器打造一个完美的插件,并完全掌控该插件。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

? SetHome 插件 — Paper 1.21.1

适用于 Paper 1.21.1 的完整 SetHome 插件,具备 LuckPerms 集成、冷却系统、带取消功能的传送延迟以及完全可自定义的标题。


✅ 功能

  • 无限家园(按 LuckPerms 组限制)
  • 基于组的冷却时间(完全可配置)
  • 传送延迟(玩家移动时自动取消)
  • 完全可自定义的标题与副标题(支持十六进制颜色 &#RRGGBB)
  • 自动保存(家园数据以 YAML 格式保存)
  • Tab 补全 对所有命令启用
  • 管理员命令(重载、列表、删除)

? 安装

  1. 将 .jar 文件放入服务器的 plugins/ 目录。
  2. 确保服务器已安装 LuckPerms。
  3. 启动服务器 —— plugins/SetHome/ 文件夹将自动生成。
  4. 根据需要修改 config.yml。
  5. 运行 /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: '&#00FF7F&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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源