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

1. Place Vanguard-1.0.2.jar in your plugins/ folder
2. Restart the server
3. Assign permissions as needed
4. 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	https://github.com/NTHFCS/Vanguard
GitHub Profile	https://github.com/OwenCloude
SpigotMC	https://www.spigotmc.org/resources/vanguard.134464/
Modrinth Profile	https://modrinth.com/user/NTHFCS
Discord	https://discord.gg/V8dpGdsMeT

---

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