🌟 Introduction

To be honest, I've tried almost every AFK plugin out there, but something always felt missing. Either they were too simplistic, overly bloated, or most importantly — too cold. AFK was just AFK. A player steps away from the screen, and the server tags them as AFK. That's it. Nothing more.

Then one night, while coding into the early hours, I looked up and saw the stars outside my window. Suddenly, inspiration struck: Why can't AFK be poetic too?

And so, LengAFK was born.

🎯 Core Features

✨ Poetic AFK Messages When players enter AFK mode, instead of a blunt "You are now AFK," they're greeted with a random, immersive subtitle:

§cDid you know that stars appear to twinkle because of atmospheric turbulence?

§cRight now, another planet is moving away from us at the speed of light.

§cBy the time distant starlight reaches your eyes, it has already traveled for thousands of years.

And when they return:

§aWelcome back, traveler!

§aThe universe feels warmer with your return.

§aTime begins to flow again...

These little details add a touch of warmth to your server.

👁️ Blindness Effect — Immersive AFK Players automatically receive a blindness effect when AFK, darkening their screen to suggest their "character is resting/daydreaming." This not only enhances immersion but also lets others instantly identify AFK players (avoiding disturbance to those who are away).

📋 Deep TAB Integration Full support for TAB plugin v3/v4 — AFK players automatically get an [AFK] prefix before their name, and their original prefixes/suffixes are perfectly restored upon return. The TAB player list becomes crystal clear.

No TAB plugin? No problem — it gracefully falls back to modifying the default player list name, ensuring compatibility.

🚀 Performance Optimized — Server Friendly

• Reduced packet sending while AFK (configurable)
• Limited chunk loading radius during AFK (default: only loads the player's current chunk, significantly reducing unnecessary calculations)
• Lightweight detection: coordinates + look angle, 3 minutes of inactivity triggers AFK

🔌 Comprehensive API

Provides a complete API interface, allowing other plugins to easily:

• Get player AFK status
• Manually set AFK state
• Listen for AFK state change events

// Example: Another plugin accessing LengAFKAPI
LengAFKAPI api = Bukkit.getServicesManager().load(LengAFKAPI.class);
boolean isAFK = api.isAFK(player);

⚙️ Flexible Configuration

# AFK detection time (seconds)
afk-time: 180

# TAB integration settings
tab-integration:
  enabled: true
  afk-prefix: "&7[AFK] "
  name-color: "&7"

# Performance optimization
performance:
  reduce-packets: true
  afk-view-distance: 2
  chunk-load-radius: 1

# Visual effects
effects:
  blindness:
    enabled: true
    amplifier: 0
    duration: 9999

# Message configuration (fully customizable!)
messages:
  afk-subtitles:
    - "§cDid you know that stars appear to twinkle because of atmospheric turbulence?"
    - "§cRight now, another planet is moving away from us at the speed of light."
    # ... Add your own sentences!

Every message, effect, and timer is configurable — perfectly adaptable to your server's style.

📖 How to Use Command: /afk or /away (toggle AFK manually)

Permission: lengafk.afk (granted to all players by default)

Auto-detection: 3 minutes of inactivity (coordinates + look angle) triggers automatic AFK

💡 Perfect For RPG/Survival Servers: Players get the blindness effect while AFK, adding realism

Minigame Servers: Quickly identify inactive players for easier management

Any server that wants to feel more welcoming and warm

💬 Final Words LengAFK might not be the most feature-packed AFK plugin out there, but it's certainly the one with the most heart. My hope is that when players AFK on your server, they're not met with cold, robotic messages, but with a line that might just make them smile.

If you have any suggestions or bug reports, feel free to reach out! And of course, you're welcome to fork and customize it to create your own version.

May your server shine as brightly as the stars. ✨

——————————————————————

🌟 引言

说实话，市面上的 AFK 插件我几乎都用过，但总觉得缺少点什么。要么功能太简陋，要么过度臃肿，最重要的是——太冰冷了。挂机就只是挂机，玩家离开屏幕前，服务器就把他标记成 AFK，仅此而已。 直到有一天，我在深夜 coding 时抬头看见窗外的星空，突然有了灵感：为什么不让 AFK 也充满诗意呢？ 于是 LengAFK 诞生了。

🎯 核心特色

✨ 诗意的 AFK 提示 当玩家进入 AFK 状态时，不再是生硬的“你已挂机”，而是随机显示一句充满意境的副标题：

§c你知道繁星会眨眼，是因为大气在流动吗？

§c此刻，有另一颗星球正以光速远离我们。

§c遥远的星光抵达你眼眸时，它已旅行了上万年。

当玩家回来时：

§a欢迎回来，旅行者！

§a宇宙因你的回归而温暖。

§a时间重新开始流动...

这些小细节，让服务器多了一份温度。

👁️ 失明效果 — 沉浸式 AFK

玩家 AFK 时会自动获得失明效果，屏幕变黑，暗示“角色正在休息/发呆”。这不仅增加了沉浸感，还能让其他玩家一眼认出 AFK 的玩家（避免打扰挂机的人）。

📋 TAB 深度集成

支持 TAB 插件 v3/v4，AFK 玩家名前自动添加 [AFK] 前缀，并在退出后完美还原原来的前缀/后缀。TAB 玩家列表一目了然。 如果没有 TAB 插件，也会自动回退到原版玩家列表名修改，保证兼容性。

🚀 性能优化 — 对服务器友好

AFK 时降低数据包发送（可配置） AFK 时限制区块加载半径（默认只加载玩家所在区块，大幅降低无用计算） 轻量级检测：坐标+视角双重检测，3 分钟无变化判定 AFK

完善的 API

提供了完整的 API 接口，其他插件可以轻松获取玩家 AFK 状态、手动设置 AFK、监听 AFK 状态变化事件。

// 示例：其他插件获取 LengAFKAPI
LengAFKAPI api = Bukkit.getServicesManager().load(LengAFKAPI.class);
boolean isAFK = api.isAFK(player);

⚙️ 配置灵活

# AFK检测时间（秒）
afk-time: 180

# TAB集成设置
tab-integration:
  enabled: true
  afk-prefix: "&7[AFK] "
  name-color: "&7"

# 性能优化
performance:
  reduce-packets: true
  afk-view-distance: 2
  chunk-load-radius: 1

# 视觉效果
effects:
  blindness:
    enabled: true
    amplifier: 0
    duration: 9999

# 消息配置（支持自定义！）
messages:
  afk-subtitles:
    - "§c你知道繁星会眨眼，是因为大气在流动吗？"
    - "§c此刻，有另一颗星球正以光速远离我们。"
    # ... 你可以添加自己的句子！

所有消息、效果、时间都可配置，完全贴合你的服务器风格。

使用方式

命令：/afk 或 /away（手动切换 AFK） 权限：lengafk.afk（默认所有玩家拥有） 自动检测：坐标+视角 3 分钟无变化自动 AFK

#💡 适用场景 RPG/生存服务器：玩家挂机时获得失明效果，更真实 小游戏服务器：快速识别挂机的玩家，方便管理 任何希望服务器更有温度的服务器

💬 写在最后

LengAFK 可能不是功能最强大的 AFK 插件，但它一定是最有温度的。我希望当玩家在你的服务器挂机时，看到的不是冰冷的提示，而是一句能让他会心一笑的句子。 如果你有任何建议或 bug 反馈，欢迎留言告诉我！也欢迎 Fork 修改，打造属于你自己的版本。 愿你的服务器，也能如繁星般温暖。✨