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