WelcomeTitle 进服欢迎标题插件 - 首次进服欢迎互动 / 权限组专属提示 / Vault金币奖励

@***

插件简介
WelcomeTitle 是一个轻量级进服欢迎插件，玩家进入服务器时可以自动显示个人 Title 标题，也可以向全服玩家展示登录 Title。插件支持区分首次进服和再次进服，还可以根据权限组给管理员、VIP 等玩家显示专属欢迎内容。

首次进服的新玩家还可以触发聊天栏欢迎互动：其他玩家点击欢迎按钮后，会自动发送随机欢迎语，并且在安装 Vault 和经济插件的情况下获得随机金币奖励。

主要功能
1. 玩家进服自动显示个人 Title 和 Subtitle。
2. 支持首次进服、再次进服显示不同文案。
3. 支持全服登录 Title，所有在线玩家都能看到某玩家进入服务器。
4. 支持权限组专属欢迎，例如管理员、VIP 可以显示不同标题。
5. 支持首次进服欢迎互动，聊天栏显示可点击欢迎按钮。
6. 支持随机欢迎语。
7. 支持 Vault 经济奖励，没有经济插件时也能正常欢迎，只是不发放金币。
8. 支持颜色代码，例如 &a、&b、&e、&l。
9. 支持变量占位符，方便自定义显示内容。
10. 支持热重载配置。

命令与权限

1. /welcometitle reload

复制代码

重载插件配置。

1. welcometitle.reload

复制代码

允许使用重载命令，默认 OP 拥有。

1. welcometitle.group.admin

复制代码

管理员进服标题和全服登录消息权限，默认 OP 拥有。

1. welcometitle.group.vip

复制代码

VIP 进服标题和全服登录消息权限，默认不授予，需要自行通过权限插件分配。

支持变量

1. {player}

复制代码

进入服务器的新玩家或当前玩家名称

1. {sender}

复制代码

点击欢迎按钮的玩家名称

1. {message}

复制代码

随机欢迎词

1. {joins}

复制代码

玩家累计进入服务器次数

1. {online}

复制代码

当前在线人数

1. {max_players}

复制代码

服务器最大人数

1. {money}

复制代码

本次随机奖励金额

1. {money_range}

复制代码

奖励金额范围

默认配置示例

1. delay-ticks: 20
   
2. 
   
3. timing:
   
4.   fade-in: 10
   
5.   stay: 70
   
6.   fade-out: 20
   
7. 
   
8. first-join:
   
9.   title: '&a欢迎来到服务器'
   
10.   subtitle: '&f{player}，祝你第一次冒险玩得开心！'
    
11. 
    
12. returning:
    
13.   title: '&b欢迎回来'
    
14.   subtitle: '&f{player}，这是你第 &e{joins} &f次进入服务器'
    
15. 
    
16. global-join-title:
    
17.   enabled: true
    
18.   delay-ticks: 0
    
19.   include-joining-player: true
    
20.   first-join:
    
21.     title: '&6新玩家加入'
    
22.     subtitle: '&f欢迎 &e{player} &f来到服务器'
    
23.   returning:
    
24.     title: '&b玩家进入服务器'
    
25.     subtitle: '&f欢迎 &e{player} &f回到服务器'

复制代码

首次进服欢迎互动
新玩家首次进入服务器时，聊天栏会发送欢迎提示和可点击按钮。玩家点击后会自动发送随机欢迎语，例如：

1. &a欢迎新玩家 &f{player} &a加入服务器！
   
2. &b欢迎 &f{player} &b来到这里，一起玩得开心！
   
3. &e新朋友 &f{player} &e来啦，欢迎欢迎！
   
4. &d欢迎 &f{player} &d开启新的冒险！

复制代码

如果服务器安装了 Vault 和经济插件，点击欢迎的玩家可以获得随机金币奖励。默认奖励范围为 50 到 150 金币，可在配置文件中修改。

权限组欢迎示例
插件默认提供 admin 和 vip 两组示例：

1. permission-messages:
   
2.   enabled: true
   
3.   groups:
   
4.     admin:
   
5.       permission: 'welcometitle.group.admin'
   
6.       title: '&c管理员上线'
   
7.       subtitle: '&f{player} &7正在守护服务器'
   
8.       broadcast:
   
9.         enabled: true
   
10.         title: '&c管理员进入服务器'
    
11.         subtitle: '&f管理员 &c{player} &f已上线'
    
12.     vip:
    
13.       permission: 'welcometitle.group.vip'
    
14.       title: '&6VIP 欢迎回来'
    
15.       subtitle: '&f尊贵的 &6{player} &f回到了服务器'
    
16.       broadcast:
    
17.         enabled: true
    
18.         title: '&6VIP 玩家进入'
    
19.         subtitle: '&f欢迎 &6{player} &f回到服务器'

复制代码

安装方法
1. 下载附件中的 [进服欢迎]WelcomeTitle.jar。
2. 放入服务端 plugins 文件夹。
3. 重启服务器。
4. 启动后会自动生成 config.yml。
5. 按需修改配置后，使用 /welcometitle reload 重载配置。

可选依赖
Vault + 任意 Vault 兼容经济插件。

说明：Vault 不是必装依赖。没有 Vault 或经济插件时，欢迎互动仍然可以使用，只是金币奖励不会发放。

文件信息
文件名：[进服欢迎]WelcomeTitle.jar
文件大小：12487 字节
SHA256：812C596A0B2D26C0209FE251EA873EC4F46D9FF6A5EA44A5642859A5D899D215

注意事项
1. 插件 plugin.yml 标注 api-version 为 1.21，建议在 1.21.x Bukkit 系服务端使用。
2. 如果需要金币奖励，请安装 Vault 和经济插件。
3. 权限组优先级按配置文件 groups 从上到下匹配，玩家同时拥有多个权限时，只使用第一个命中的组。
4. 修改配置时请注意 YAML 缩进。