Logo
Vanguard
PluginMIT

Vanguard

A refined staff activity tracker for modern Paper/Spigot environments.

16
Downloads
1
Followers
2 months ago
Updated
📦
1
Versions
managementtechnologyutilitypaperpurpurspigot
Download Latestv1.0.2View on Modrinth

📖About Vanguard

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