Achievements
Award players for in-game feats — kill streaks, headshots, long-range kills, exploration, and survival milestones.
What it does
The Achievements module gives players goals to work towards on your server. When a player meets the criteria for an achievement — getting their 100th kill, surviving for 10 hours, or exploring a specific location — Vigil detects it automatically and posts a congratulations message to Discord.
Achievements are persistent and tracked per player. Progress survives server restarts and wipes (progress data is stored in Vigil, not on the game server).
Achievement types
Combat achievements
| Type | Example | Description |
|---|---|---|
| Kill count | "First Blood" | Reach a total number of kills |
| Kill spree | "On a Roll" | Get a set number of kills in a single session without dying |
| Headshots | "Sniper" | Accumulate a total number of headshot kills |
| Long range kill | "Eagle Eye" | Get a kill beyond a configurable distance |
Survival achievements
| Type | Example | Description |
|---|---|---|
| Playtime | "Veteran" | Accumulate a total number of hours played |
| Survivor | "Untouchable" | Stay alive for a continuous session beyond a set duration |
Exploration achievements
| Type | Example | Description |
|---|---|---|
| Explorer | "Cartographer" | Visit a set of marked locations on the map |
Movement achievements
| Type | Example | Description |
|---|---|---|
| Distance travelled | "Road Warrior" | Cover a total distance on foot |
| Vehicle distance | "Wheelman" | Cover a total distance in vehicles |
Other
| Type | Example | Description |
|---|---|---|
| Unconscious time | "Tough as Nails" | Accumulate time spent unconscious |
Economy integration
Each achievement can award a coin reward when unlocked (requires Economy to be active). Set the reward to 0 if you don't use the economy module.
Discord notifications
When a player unlocks an achievement, Vigil posts a message to your configured Discord channel with:
- The player's gamertag
- The achievement name and description
- The reward (if any)
Configuration options
Enable unlock announcements
Toggle whether Discord posts are sent when achievements are unlocked. Progress is always tracked regardless.
Per-achievement settings
Each achievement has:
- Name — displayed in Discord and on player profiles
- Description — shown in the unlock notification
- Target — the threshold to reach (e.g. 100 kills, 10 hours)
- Reward — coins awarded on unlock
- Enabled — toggle individual achievements
Friendly fire
Combat achievements do not count kills against players in the same faction. If your server uses Factions, teammates killing each other won't contribute to kill-based achievements.
Suggested Discord channel
#achievements — a dedicated channel that your community can see and feel rewarded by.