Guests Control

插件

· 作者 ObKich

一个为服务器新访客提供限时访客模式的插件。

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

最新 1.0.5 · 26.3 · Bukkit / Paper

一键开服(送7天)

? Guests — 访客管理插件

控制谁真正能在你的服务器上游玩。
新加入的玩家会以只读访客身份进入,只有在管理员批准后才能成为完整成员——非常适合白名单社区、角色扮演服务器或任何需要手动审核的服务器。


✨ 功能

  • 自动分配访客身份 — 每位新玩家首次加入时会自动被设为访客
  • 完整的世界保护 — 访客无法破坏方块、放置方块、打开容器、攻击实体、拾取物品、使用红石或与世界中的任何事物交互
  • 可配置的访客游戏模式 — ADVENTURE(默认)或 SPECTATOR
  • 时限系统 — 访客会在达到可配置时间后(默认 1 小时)被踢出;剩余时间在断开连接后会保存
  • BossBar 倒计时 — 访客始终能看到剩余时间;随着时间流逝,颜色会从绿色变为黄色再变为红色
  • AFK 踢出 — 闲置的访客会在达到可配置超时时间后自动被移除
  • 重复提醒消息 — 定期提示访客如何申请完整访问权限
  • Discord 集成 — 访客可以运行 /guest request 直接向你的 Discord 服务器发送 Webhook 通知
  • PlaceholderAPI 支持 — %guests_status% 和 %guests_time_left%
  • 双语言支持 — 开箱即用支持英语 (en_us) 和俄语 (ru_ru),完全可配置
  • MiniMessage 格式化 — 所有消息均支持颜色、渐变、悬停文本和可点击链接
  • 离线玩家管理 — 即使玩家不在线,也可以批准或降级他们的身份
  • 持久化存储 — 所有玩家数据通过 playerlist.yml 在服务器重启后得以保留

?️ 命令

命令 描述 权限
/guests help 显示所有可用命令 guests.admin
/guests add player <name> 将访客批准为正式玩家 guests.admin
/guests add guest <name> 将玩家恢复为访客状态 guests.admin
/guests list players 列出所有已批准的玩家 guests.admin
/guests list guests 列出所有当前访客及其剩余时间 guests.admin
/guests info <name> 查看任意玩家的存储信息 guests.admin
/guests reload 重载配置文件和语言文件 guests.admin
/guest request 发送加入请求到 Discord guests.request

? 权限

权限 描述 默认值
guests.admin 完全访问所有 /guests 子命令 OP
guests.add 添加/提升玩家身份的权限 OP
guests.list 列出玩家的权限 OP
guests.info 查看玩家信息的权限 OP
guests.reload 重载插件的权限 OP
guests.request 使用 /guest request 的权限 所有人
guests.bypass 完全绕过所有访客限制 OP

? PlaceholderAPI

需要 PlaceholderAPI(软依赖 — 没有它插件也能正常工作)。

占位符 返回值
%guests_status% Guest 或 Player(本地化)
%guests_time_left% 剩余时间(例如 1h 29m 55s)或 ∞

⚙️ 配置

config.yml

# Language: en_us or ru_ru
lang: en_us

# Gamemode for guests: ADVENTURE or SPECTATOR
guest-gamemode: ADVENTURE

# Guest time limit
guest-time-limit:
  enabled: true
  seconds: 3600  # 1 hour

# Periodic reminder message
repeat-message:
  enabled: true
  interval-seconds: 120

# AFK kick for guests
afk-kick:
  enabled: false
  timeout-seconds: 300

# /guest request command
request-command:
  enabled: true
  cooldown-seconds: 300

# Discord webhook
discord:
  webhook-url: "https://discord.com/api/webhooks/..."
  role-id: ""   # Role ID to ping (optional)
  user-id: ""   # User ID to ping (optional)

? 语言文件

语言文件位于 plugins/Guests/language/ 目录下。
活动语言通过在 config.yml 中设置 lang: en_us(或 ru_ru)来指定。

所有消息均使用 MiniMessage 格式 —— 你可以在任何地方使用颜色、渐变、粗体、斜体、悬停事件和可点击链接。

示例(来自 en_us.yml):

welcome:
  title: "<gold><bold>Welcome!</bold></gold>"
  subtitle: "<yellow>You are currently in guest mode</yellow>"
  discord: "<aqua>➤ Join our Discord:</aqua> <click:open_url:'https://discord.gg/yourserver'><underlined>discord.gg/yourserver</underlined></click>"

要添加新语言,请在 language/ 文件夹中创建一个新文件(例如 de_de.yml),在配置中设置 lang: de_de,然后重载即可。


? 玩家存储

所有数据存储在 plugins/Guests/playerlist.yml 中:

players:
  Steve:
    uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    status: player
  Alex:
    uuid: yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
    status: guest
    remaining-time: 3450

该文件在服务器运行时每 60 秒自动更新一次,并在断开连接及执行 /guests reload 时始终更新。


? 快速设置

  1. 将 JAR 文件放入 plugins/ 文件夹并启动服务器。
  2. 打开 plugins/Guests/config.yml 并设置你喜欢的选项。
  3. (可选)在 discord.webhook-url 下粘贴你的 Discord Webhook URL。
  4. (可选)编辑 plugins/Guests/language/ 中的消息文件以匹配你的服务器品牌风格。
  5. 运行 /guests reload 以应用更改而无需重启服务器。
  6. 当玩家准备好被批准时,运行 /guests add player <name>。

就这样。从此以后,新加入的玩家将自动以访客身份进入。


?️ 兼容性

服务器软件 Paper, Purpur, Spigot 以及任何兼容 Paper 的分叉版本
Minecraft 版本 26.x; 1.21.x; 广泛兼容 1.20+
Java 版本 Java 21+
软依赖 PlaceholderAPI(可选)

? 备注

  • 拥有 guests.bypass 权限的玩家(默认为 OP)永远不会受到限制,即使其存储状态为 guest。这允许管理员自由地测试服务器。
  • /guest request 命令具有每个玩家的冷却时间(可配置),以防止 webhook 垃圾信息。
  • 剩余的 guest 时间仅在玩家在线时倒计时,并在他们断开连接时持久化保存。
  • 运行 /guests reload 可以安全地重启所有后台任务并重新加载语言文件,而无需重启服务器。

RU (описание на русском)

? Guests — Плагин управления гостями

Контролируйте, кто действительно играет на вашем сервере. Новые игроки присоединяются как гости с режимом только для чтения и могут стать полноценными участниками только после одобрения администратора — идеально подходит для серверов с вайтлистом, RP-серверов или любых серверов, где требуется ручная проверка игроков.

Если вы это читаете — заходите на мой ванила+ сервер OBK: play.obk6.fun! Плагин создавался именно для него!


✨ Возможности

  • Автоматическое назначение гостя — каждый новый игрок автоматически становится гостем при первом входе
  • Полная защита мира — гости не могут ломать блоки, ставить блоки, открывать контейнеры, атаковать сущности, подбирать предметы, использовать редстоун или взаимодействовать с чем-либо в мире
  • Настраиваемый режим игры для гостей — ADVENTURE (по умолчанию) или SPECTATOR
  • Система лимита времени — гости кикаются после настраиваемого времени (по умолчанию 1 час); оставшееся время сохраняется даже после выхода с сервера
  • BossBar-таймер — гости всегда видят оставшееся время; цвет меняется зелёный → жёлтый → красный по мере его уменьшения
  • AFK-кик — бездействующие гости автоматически удаляются после настраиваемого тайм-аута
  • Повторяющиеся напоминания — периодические сообщения, напоминающие гостям, как подать заявку на полный доступ
  • Интеграция с Discord — гости могут использовать /guest request, чтобы отправить webhook-уведомление прямо на ваш Discord-сервер
  • Поддержка PlaceholderAPI — %guests_status% и %guests_time_left%
  • Поддержка двух языков — английский (en_us) и русский (ru_ru) из коробки, полностью настраиваемые
  • Форматирование MiniMessage — все сообщения поддерживают цвета, градиенты, hover-текст и кликабельные ссылки
  • Управление офлайн-игроками — можно одобрять или понижать игроков даже если они не онлайн
  • Постоянное хранение данных — все данные игроков сохраняются после перезапуска сервера через playerlist.yml

?️ Команды

Команда Описание Разрешение
/guests help Показать все доступные команды guests.admin
/guests add player <name> Одобрить гостя и сделать его полноценным игроком guests.admin
/guests add guest <name> Вернуть игрока обратно в статус гостя guests.admin
/guests list players Показать список всех одобренных игроков guests.admin
/guests list guests Показать список всех текущих гостей с оставшимся временем guests.admin
/guests info <name> Посмотреть сохранённую информацию о любом игроке guests.admin
/guests reload Перезагрузить конфиг и языковые файлы guests.admin
/guest request Отправить запрос на вступление в Discord guests.request

? Разрешения

Разрешение Описание По умолчанию
guests.admin Полный доступ ко всем подкомандам /guests OP
guests.add Разрешение добавлять/повышать игроков OP
guests.list Разрешение просматривать список игроков OP
guests.info Разрешение просматривать информацию об игроке OP
guests.reload Разрешение перезагружать плагин OP
guests.request Разрешение использовать /guest request Все
guests.bypass Полностью обходить все ограничения гостей OP

? PlaceholderAPI

Требуется PlaceholderAPI (мягкая зависимость — плагин работает и без него).

Плейсхолдер Возвращает
%guests_status% Guest или Player (локализовано)
%guests_time_left% Оставшееся время (например 1h 29m 55s) или ∞

⚙️ Конфигурация

config.yml

# Язык: en_us или ru_ru
lang: en_us

# Режим игры для гостей: ADVENTURE или SPECTATOR
guest-gamemode: ADVENTURE

# Лимит времени для гостей
guest-time-limit:
  enabled: true
  seconds: 3600  # 1 час

# Периодическое сообщение-напоминание
repeat-message:
  enabled: true
  interval-seconds: 120

# AFK-кик для гостей
afk-kick:
  enabled: false
  timeout-seconds: 300

# Команда /guest request
request-command:
  enabled: true
  cooldown-seconds: 300

# Discord webhook
discord:
  webhook-url: "https://discord.com/api/webhooks/..."
  role-id: ""   # ID роли для пинга (необязательно)
  user-id: ""   # ID пользователя для пинга (необязательно)

? Языковые файлы

Языковые файлы находятся в plugins/Guests/language/. Активный язык задаётся через lang: en_us (или ru_ru) в config.yml.

Все сообщения используют формат MiniMessage — вы можете использовать цвета, градиенты, жирный текст, курсив, hover-события и кликабельные ссылки где угодно.

Пример (из en_us.yml):

welcome:
  title: "<gold><bold>Добро пожаловать!</bold></gold>"
  subtitle: "<yellow>Сейчас вы находитесь в режиме гостя</yellow>"
  discord: "<aqua>➤ Присоединяйтесь к нашему Discord:</aqua> <click:open_url:'https://discord.gg/yourserver'><underlined>discord.gg/yourserver</underlined></click>"

要添加新语言,请在 language/ 文件夹中创建新文件(例如 de_de.yml),在配置文件中指定 lang: de_de 并执行重载。


? 玩家数据存储

所有数据保存在 plugins/Guests/playerlist.yml 中:

players:
  Steve:
    uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    status: player
  Alex:
    uuid: yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
    status: guest
    remaining-time: 3450

该文件在服务器运行期间每 60 秒自动更新一次,同时在玩家退出或执行 /guests reload 时也会立即更新。


? 快速安装

  1. 将 JAR 文件放入 plugins/ 文件夹并启动服务器。
  2. 打开 plugins/Guests/config.yml 并根据需要调整参数。
  3. (可选)将您的 Discord Webhook URL 填入 discord.webhook-url。
  4. (可选)编辑 plugins/Guests/language/ 中的消息文件,使其符合您服务器的风格。
  5. 执行 /guests reload 以应用更改而无需重启服务器。
  6. 当玩家准备好被批准时,执行 /guests add player <name>。

完成。从此刻起,新玩家将自动以访客身份进入服务器。


?️ 兼容性

服务器软件 Paper, Purpur, Spigot 及任何与 Paper 兼容的分支
Minecraft 版本 26.x; 1.21.x(已测试);通常兼容 1.20+
Java 版本 Java 21+
软依赖 PlaceholderAPI(可选)

? 注意事项

  • 拥有 guests.bypass 权限的玩家(默认为 OP)永远不会受到限制,即使其保存的状态为 guest。这允许管理员自由测试服务器。
  • /guest request 命令具有每个玩家的冷却时间(可配置),以防止 Webhook 通知被刷屏。
  • 剩余访客时间仅在玩家在线时减少,并在玩家退出时保存。
  • 执行 /guests reload 会安全地重新启动所有后台任务并重新加载语言文件,而无需重启服务器。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源