Welcome - 迎新奖励

💡欢迎插件

本插件允许玩家使用 /welcome 命令欢迎新加入的玩家，并获取可配置的奖励。它支持两种欢迎模式：基于时间的窗口或基于人数的限制，让服务器的新人欢迎环节变得更有趣和可控。

🎮核心功能

• 两种欢迎模式：
• 时间模式：新玩家加入后，其他玩家可在设定的时间窗口内进行欢迎。
• 人数模式：只有前几位玩家可以欢迎新玩家，人数上限可配置。

• 分级奖励系统：
• 可根据欢迎顺序（如第1、2、3名）为玩家提供不同的奖励。
• 支持为超出预设奖励层级的玩家重复发放最后一档奖励。

• 轻量且无依赖：
• 无需数据库，不存储玩家数据。
• 基础功能无需任何前置插件。

• 完全可配置：
• 所有消息、奖励和规则均可通过配置文件自定义。
• 支持使用占位符 %player% 和 %newplayer%。

🔧命令与权限

主要命令

• /welcome
• 欢迎服务器上最新的玩家。
• 根据玩家的欢迎顺序发放对应奖励。
• 如果欢迎窗口已过、玩家已欢迎过或没有新玩家，则会显示提示信息且无奖励。
• 所需权限：welcome.use

• /welcome reload
• 重新加载插件配置文件，无需重启服务器。
• 所需权限：welcome.reload

其他提示消息

• not-player：控制台尝试执行 /welcome 时显示。
• no-permission：玩家没有 welcome.use 权限时显示。
• already-welcome：欢迎窗口过期或玩家已欢迎过时显示。

✨安装指南

• 下载 WELCOME.jar 文件。
• 将其放入服务器的 /plugins 文件夹。
• 重启服务器或使用插件加载器（如 PlugMan）。
• 根据需求编辑生成的 config.yml 文件。
• 安装完成，开始使用！

⭐配置说明

配置文件 (config.yml) 允许你深度定制插件行为。以下是一个配置示例及说明：

# 欢迎模式，设为 "time"（时间）或 "count"（人数）
welcome-mode: "time"
# 时间模式下的欢迎窗口时长（秒）
welcome-time-limit-seconds: 300
# 人数模式下的最大欢迎人数
max-welcomes: 3

# 是否启用分级奖励
tiered-rewards: true
# 当欢迎人数超过配置的奖励层级时，是否重复最后一档奖励
repeat-last-tier: true
# 当 repeat-last-tier 为 false 且无奖励可领时显示的消息
no-reward-message: "&7Thanks for welcoming %newplayer%, but all rewards have already been claimed."

# 玩家执行欢迎时发送的公共消息
message: "&7Welcome, &f%newplayer%&7, to the server!"

# 奖励层级配置
# 可使用占位符：%player%（欢迎者），%newplayer%（被欢迎的新玩家）
rewards:
  1:
    message: "&aYou were the first to welcome %newplayer%! Here's a reward!"
    commands:
      - "eco give %player% 500"
  2:
    message: "&bYou were the second to welcome %newplayer%! You get a smaller bonus!"
    commands:
      - "eco give %player% 350"
  3:
    message: "&eThanks for welcoming %newplayer%! You’ve earned a reward of $250!"
    commands:
      - "eco give %player% 250"

占位符说明

• %newplayer%：被欢迎的新玩家用户名。
• %player%：执行 /welcome 命令的玩家用户名。
• 这些占位符仅在其指定的配置字段（如消息和命令字符串）中生效。

❓常见问题与提示

关于奖励

• 奖励如何发放？
• 奖励通过执行配置中设定的控制台命令来发放（如给予游戏币、物品或权限）。
• 需要其他插件来发放奖励吗？
• 基础功能不需要。但如果你想发放经济奖励（如 eco give）、物品或权限，则需要安装相应的插件（如 EssentialsX, Vault, LuckPerms）来支持这些命令。

关于功能

• 数据存储在哪里？
• 本插件是轻量级的，不存储任何玩家数据。所有状态仅在服务器运行时于内存中管理。
• 可以自定义欢迎消息吗？
• 可以，完全支持。你可以在配置文件中修改 message 字段以及每个奖励层级的 message。

反馈与支持

• 如果你希望添加新功能或有任何问题、评论，欢迎联系开发者。
• 别忘了在插件页面留下你的评价！如果遇到任何问题，请在评价前先联系开发者解决。
• 开发者还有其他插件（如 Trash），也欢迎查看。