一款专为现代 Paper/Spigot 服务器环境打造的精炼员工活动追踪器。
Vanguard
由 NathanFCS Studio 开发 — 成立于 2026 年
Vanguard 是一款轻量级、自包含的员工活动追踪器,旨在为重视清晰度、结构化以及可靠数据而非不必要复杂性的服务器团队提供服务。
从员工加入的那一刻起,系统便会自动对其进行追踪。无需执行值班命令,也无需在每次会话中手动设置。只需提供干净且持久化的数据。
核心系统
会话追踪
活跃时间会自动记录,并在登出、重启和重新连接后保持持久化。每个会话独立处理,并累加到终身总时长中。
AFK(闲置)管理
员工可以通过 /afk 暂停追踪。当发生移动、聊天活动或命令使用时,追踪将自动恢复——无需手动恢复。
监管日志记录
针对有效目标执行的监管命令会被计数并归因于负责的员工。未指定目标的命令将被忽略。
管理员重置
所有重置操作都需要在 10 秒窗口内完成两步确认。这适用于单个重置和全名单重置,以防止意外数据丢失。
要求
- Paper 或 Spigot 1.21+
- Java 21+
- 无额外依赖项
安装
- 将
Vanguard-1.0.2.jar 放入你的 plugins/ 文件夹
- 重启服务器
- 根据需要分配权限
- 完成
命令
员工
权限:vanguard.staff
| 命令 |
描述 |
/vanguard help |
显示命令参考 |
/vanguard stats [player] |
查看活动数据 |
/vanguard top |
查看员工排行榜 |
/afk |
切换追踪暂停状态 |
管理
权限:vanguard.admin
| 命令 |
描述 |
/vanguard reset <player> |
清除一个被追踪的配置文件 |
/vanguard reset all |
清除所有被追踪的配置文件 |
别名:/vg 映射到 /vanguard
统计参考
Vanguard — NathanFCS
▸ Status ACTIVE
▸ Active Time 3h 24m
▸ Session 42m 10s
▸ Actions 7
| 字段 |
描述 |
| Status |
当前状态:ACTIVE(活跃)、AFK(闲置)、IDLE(空闲)或 OFFLINE(离线) |
| Active Time |
跨所有会话的累计追踪总时长 |
| Session |
当前活跃会话经过的时间 |
| Actions |
针对有效目标执行的监管命令数量 |
重置协议
重置命令受到两步确认系统的保护。
/vg reset NathanFCS — 启动确认窗口
/vg reset NathanFCS — 在 10 秒内执行重置
/vg reset all — 启动确认窗口
/vg reset all — 在 10 秒内执行重置
过期的确认窗口需要重新启动该序列。
更新日志
v1.0.2
- 带有两步确认的重置系统
- /vanguard reset <player>
- /vanguard reset all
- 修复了无目标命令的动作计数
- 优化了 AFK 动作栏展示
v1.0.1
- 修正了活跃状态逻辑
- 改进了 AFK 自动恢复处理
- 版本感知的控制台和帮助输出
v1.0.0
- 初始发布
- 自动员工追踪
- AFK 系统
- 监管动作日志记录
- 排行榜
- /vanguard stats 和 /vanguard top
计划中
- 每周排行榜重置
- Discord Webhook 集成
- 按世界追踪
- 详细动作日志
许可证
根据 MIT License 发布。
源代码公开并可审查。
官方资源
此处仅列出官方链接,以确保在所有已发布资源中的真实性和一致性。
| 平台 |
链接 |
| GitHub Repository |
|
| GitHub Profile |
|
| SpigotMC |
|
| Modrinth Profile |
|
| Discord |
支持
如需设置协助、错误报告或功能请求:
- 加入官方 Discord 服务器
- 使用 SpigotMC 或 Modrinth 上的讨论区
- 在 GitHub 上打开 Issue
A refined staff activity tracker built for modern Paper/Spigot server environments.
Vanguard
by NathanFCS Studio — Established 2026
Vanguard is a lightweight, self-contained staff activity tracker designed for server teams that value clarity, structure, and reliable data over unnecessary complexity.
Staff are tracked automatically from the moment they join. No duty commands. No manual setup per session. Just clean, persistent data.
Core Systems
Session Tracking
Active time is recorded automatically and persists across logouts, restarts, and reconnections. Each session is handled independently and contributes to a cumulative lifetime total.
AFK Management
Staff may pause tracking with /afk. Tracking resumes automatically on movement, chat activity, or command usage — no manual resume required.
Moderation Logging
Moderation commands executed against a valid target are counted and attributed to the responsible staff member. Commands issued without a target are ignored.
Administrative Reset
All reset operations require a two-step confirmation within a 10-second window. This applies to both individual and full-roster resets, preventing accidental data loss.
Requirements
- Paper or Spigot 1.21+
- Java 21+
- No additional dependencies
Installation
- Place
Vanguard-1.0.2.jar in your plugins/ folder
- Restart the server
- Assign permissions as needed
- Done
Commands
Staff
Permission: vanguard.staff
| Command |
Description |
/vanguard help |
Display command reference |
/vanguard stats [player] |
View activity data |
/vanguard top |
View staff leaderboard |
/afk |
Toggle tracking pause |
Administration
Permission: vanguard.admin
| Command |
Description |
/vanguard reset <player> |
Clear one tracked profile |
/vanguard reset all |
Clear all tracked profiles |
Alias: /vg maps to /vanguard
Stats Reference
Vanguard — NathanFCS
▸ Status ACTIVE
▸ Active Time 3h 24m
▸ Session 42m 10s
▸ Actions 7
| Field |
Description |
| Status |
Current state: ACTIVE, AFK, IDLE, or OFFLINE |
| Active Time |
Total cumulative tracked time across all sessions |
| Session |
Elapsed time in the current active session |
| Actions |
Moderation commands executed with a valid target |
Reset Protocol
Reset commands are safeguarded by a two-step confirmation system.
/vg reset NathanFCS — initiates confirmation window
/vg reset NathanFCS — executes reset within 10 seconds
/vg reset all — initiates confirmation window
/vg reset all — executes reset within 10 seconds
Confirmation windows that expire require the sequence to be restarted.
Changelog
v1.0.2
- reset system with two-step confirmation
- /vanguard reset <player>
- /vanguard reset all
- fixed action count for commands without targets
- refined AFK action bar presentation
v1.0.1
- corrected active status logic
- improved AFK auto-resume handling
- version-aware console and help output
v1.0.0
- initial release
- automatic staff tracking
- AFK system
- moderation action logging
- leaderboard
- /vanguard stats and /vanguard top
Planned
- Weekly leaderboard reset
- Discord webhook integration
- Per-world tracking
- Detailed action log
License
Released under the MIT License.
Source is available and open for review.
Official Resources
Only official links are listed here to ensure authenticity and consistency across all published resources.
| Platform |
Link |
| GitHub Repository |
|
| GitHub Profile |
|
| SpigotMC |
|
| Modrinth Profile |
|
| Discord |
Support
For setup assistance, bug reports, or feature requests:
- Join the official Discord server
- Use the discussion section on SpigotMC or Modrinth
- Open an issue on GitHub
Maintained by NathanFCS Studio — Releases • Support • Product Development
评论 0
登录后参与评分
还没有评论,来抢沙发吧