SmartAFK 是一款功能全面、高度可配置的 Minecraft Paper 1.21+ 服务器 Away From Keyboard (AFK) 管理插件。它能自动追踪玩家的不活跃状态,管理服务器资源,并在保持社区知情权的同时为闲置玩家提供强大的保护。
主要特性
- 自动化 AFK 追踪: 在设定的时间后自动将玩家标记为 AFK,并附带倒计时警告。
- 智能活动检测: 当玩家移动、聊天、使用命令或与世界互动时,立即移除其 AFK 状态。
- 视觉指示器: 通过自定义聊天前缀、Tab 列表和 nametags 中变灰的姓名以及实时的 Actionbar 计时器,清晰标识 AFK 玩家。
- 高级玩家保护: 可选择冻结、赋予无敌状态或将闲置玩家切换至旁观者模式,确保他们在离开期间安全无虞。
- 可定制的广播: 通过全局 AFK 通知、防垃圾信息冷却时间和供工作人员使用的静音模式,让服务器保持知情。
- 不活跃管理: 自动踢出长时间处于 AFK 状态的玩家,以释放服务器槽位。
功能说明
管理不活跃的玩家对于服务器性能和社区互动至关重要。SmartAFK 通过允许玩家使用 /afk 手动切换状态,或在玩家停止移动或互动超过设定时间(默认:5 分钟)时自动介入,优雅地处理这一问题。
一旦玩家进入 AFK 状态,插件会立即更新其在服务器中的视觉状态。他们的名字在聊天和 Tab 列表中会变灰,并应用 AFK 前缀。插件还内置了一个计时器,精确记录某人离开的时长,可以直接显示在他们的 actionbar 中或通过命令查看。只要玩家返回并执行任何操作(如移动或在聊天中输入),其 AFK 状态会立即被撤销,并发送一条回归广播。
保护与限制
SmartAFK 超越了简单的聊天标签,提供了一系列 Phase 5 保护功能来保障你的玩家和服务器安全。
服务器管理员可以配置插件以冻结 AFK 玩家的位置或授予他们临时无敌状态,确保他们在去拿杯水时不会被游荡的生物杀死。为了更严格地管理服务器,你可以将 AFK 玩家从 Tab 列表中隐藏,强制他们进入旁观者模式,禁止在主动战斗期间进入 AFK 状态,或设置硬性计时器以踢出长时间闲置的玩家。
命令与权限
| 命令 |
描述 |
权限 |
/afk |
切换自己的 AFK 状态 |
smartafk.afk |
/afk <player> |
强制设置其他玩家为 AFK |
smartafk.afk.others (默认: OP) |
/afk time [player] |
查看自己的 AFK 持续时间 |
smartafk.time |
/afk time <player> |
查看其他玩家的 AFK 持续时间 |
smartafk.time.others (默认: OP) |
/afk notify |
切换接收 AFK 广播通知 |
smartafk.notify |
/afk silent |
进入 AFK 而不触发公共广播 |
smartafk.silent (默认: OP) |
/afk reload |
重新加载配置文件 |
smartafk.reload (默认: OP) |
绕过权限:
smartafk.bypass.auto: 防止被自动标记为 AFK。
smartafk.bypass.kick: 防止被 AFK 计时器踢出。
smartafk.bypass.freeze: 防止在 AFK 时被冻结。
smartafk.bypass.invincible: 防止在 AFK 时获得无敌状态。
smartafk.cooldown.bypass: 忽略命令使用冷却时间。
安装与配置
SmartAFK 是一款专为 Paper 1.21+ 设计的服务端插件。只需将 JAR 文件放入 plugins 文件夹并重启服务器即可。
首次启动时,会生成 plugins/SmartAFK/config.yml 文件。该配置文件非常直观,分为逻辑清晰的各个部分(核心、自动 AFK、广播、计时器、移除触发器和保护),允许你调整每一个冷却时间、消息和保护设置,以完美契合服务器的需求。
? Support & Bug Reports
Found a bug or need help setting up the plugin?
Report issues directly on Discord.
SmartAFK is a comprehensive, highly configurable Away From Keyboard (AFK) management plugin for Minecraft Paper 1.21+ servers. It automatically tracks player inactivity, manages server resources, and keeps your community informed while offering robust protection for idle players.
Key Features
- Automated AFK Tracking: Automatically mark players as AFK after a configurable amount of time, complete with countdown warnings.
- Smart Activity Detection: Automatically removes AFK status the moment a player moves, chats, uses a command, or interacts with the world.
- Visual Indicators: Clearly identify AFK players with customizable chat prefixes, grayed-out names in the Tab list and nametags, and a live Actionbar timer.
- Advanced Player Protection: Optionally freeze, turn invincible, or switch idle players to spectator mode to keep them safe while stepping away.
- Customizable Broadcasts: Keep the server informed with global AFK notifications, anti-spam cooldowns, and a silent mode for staff.
- Inactivity Management: Automatically kick players who have been AFK for too long to free up server slots.
Functionality
Managing inactive players is essential for both server performance and community interaction. SmartAFK handles this gracefully by allowing players to manually toggle their status using /afk, or by automatically stepping in when a player stops moving or interacting for a set time (default: 5 minutes).
Once a player goes AFK, the plugin instantly updates their visual status across the server. Their name turns gray in chat and the Tab list, and an AFK prefix is applied. The plugin also features a built-in timer that tracks exactly how long someone has been away, which can be displayed directly in their actionbar or checked via command. As soon as the player returns and performs an action (like moving or typing in chat), their AFK status is immediately revoked and a return broadcast is sent.
Protection & Restrictions
SmartAFK goes beyond simple chat tags by offering a suite of Phase 5 protection features to secure your players and your server.
Server administrators can configure the plugin to freeze AFK players in place or grant them temporary invincibility, ensuring they aren't killed by wandering mobs while getting a glass of water. For stricter server management, you can hide AFK players from the Tab list, force them into Spectator mode, disable going AFK while in active combat, or set a hard timer to kick players who remain idle for too long.
Commands & Permissions
| Command |
Description |
Permission |
/afk |
Toggle your own AFK status |
smartafk.afk |
/afk <player> |
Force set another player AFK |
smartafk.afk.others (Default: OP) |
/afk time [player] |
View your own AFK duration |
smartafk.time |
/afk time <player> |
View another player's AFK duration |
smartafk.time.others (Default: OP) |
/afk notify |
Toggle receiving AFK broadcast notifications |
smartafk.notify |
/afk silent |
Go AFK without triggering a public broadcast |
smartafk.silent (Default: OP) |
/afk reload |
Reload the configuration file |
smartafk.reload (Default: OP) |
Bypass Permissions:
smartafk.bypass.auto: Prevent being automatically marked as AFK.
smartafk.bypass.kick: Prevent being kicked by the AFK timer.
smartafk.bypass.freeze: Prevent being frozen while AFK.
smartafk.bypass.invincible: Prevent receiving invincibility while AFK.
smartafk.cooldown.bypass: Ignore the command usage cooldown.
Installation & Configuration
SmartAFK is a server-side plugin designed for Paper 1.21+. Simply drop the JAR file into your plugins folder and restart your server.
Upon first boot, a plugins/SmartAFK/config.yml file will be generated. The configuration file is highly intuitive and divided into logical sections (Core, Auto-AFK, Broadcast, Timer, Removal triggers, and Protection), allowing you to tweak every cooldown, message, and protection setting to perfectly fit your server's needs.
? Support & Bug Reports
Found a bug or need help setting up the plugin?
Report issues directly on Discord.
评论 0
登录后参与评分
还没有评论,来抢沙发吧