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 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

```text 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.

```text /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

```text 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*