NexusCheatRadar 1.2.0

 NexusCheatRadar

If you are updating from older versions please delete your old config file or make a copy of your working settings before updating 

**Keep your server clean. Catch cheaters before they ruin the wipe.**

NexusCheatRadar watches your players in the background and sends you Discord alerts when something looks wrong. No setup headaches — drop it in, set your webhooks, and let it work.

---

## What It Detects

- **ESP** — Flags players who keep looking at other players through walls and rocks

- **No-Recoil** — Catches scripted spray patterns that are too perfect to be human

- **Aimbot** — Detects unnatural snap-to-target aim movements

- **Speed Hack** — Alerts when someone is moving faster than the game allows

- **Strafe Hack** — Catches impossible sideways or backward movement speed

- **Wall Looting** — Detects players opening containers through solid walls

- **Item Spawning** — Flags sudden inventory spikes that don't match normal gameplay

- **Debug Camera** — Catches unauthorized use of spectate/freecam mode

- **Privilege Escalation** — Monitors for players running admin commands they shouldn't have

---

## Discord Alerts

Every detection sends a clean Discord embed with:

- Player name and Steam64 ID

- Quick links to Steam, ServerArmour, and BattleMetrics profiles

- Detection details (probability, distance, positions)

- Separate webhooks for each detection type so you can organize your channels

---

## Smart About Modded Servers

Built for real servers, not just vanilla:

- **Server multiplier support** — Won't false-flag on 5x or 10x gather rates

- **SkillTree compatible** — Adjusts speed and gather thresholds when SkillTree perks are active

- **Backpacks aware** — Doesn't flag item counts when players use their backpack

- **Teleport safe** — Automatically ignores position jumps from /home, /tp, and respawns

---

## Steam & ServerArmour Intel

When a player joins, NCR checks their background:

- Steam account age, VAC bans, game bans, profile visibility

- ServerArmour dirty flags, server bans, cheater bans

- Previous name history and past risk scores on your server

- All sent to Discord as a join intelligence report

---

## Admin Radar

Built-in world radar for admins:

- See players, sleepers, tool cupboards, stashes, bags, and corpses through walls

- Toggle each type on/off with a sidebar UI strip

- Color-coded with configurable nameplate sizes

- Facing arrows show which direction players are looking

---

## Risk Scoring

Every detection adds to a player's risk score. Scores decay over time so one-off incidents fade away. Configure auto-kick or auto-ban thresholds if you want automatic enforcement.

---

## Commands

| Command | What it does |

|---------|-------------|

| `/ncr` | Toggle admin radar on/off |

| `/ncr.strip` | Toggle the radar sidebar UI |

| `/ncr.lookup <name>` | Look up a player's history |

| `/ncr.history <name>` | View detailed NCR history |

| `/ncr.risk <name>` | Check a player's current risk scores |

| `/ncr.watch <steamid>` | Add a player to the watchlist |

| `/ncr.unwatch <steamid>` | Remove from watchlist |

| `/ncr.watchlist` | Show all watched players |

| `/ncr.reset <steamid>` | Clear a player's NCR history |

| `/ncr.test <type>` | Send a test alert to Discord |

---

## Permissions

- `nexuscheatradar.admin` — Required for all commands

---

## Quick Start

1. Drop `NexusCheatRadar.cs` into your `oxide/plugins` folder

2. Open the generated config and paste your Discord webhook URLs

3. That's it — detections start automatically

---

## Requirements

- Oxide/uMod or Carbon

- A Discord webhook URL (at minimum one for ESP alerts)

## Optional Integrations

- **ServerArmour** — Enhanced player intel on join (plugin or direct API)

- **SkillTree** — Automatic threshold adjustment for perk-modified players

- **Backpacks** — Suppresses false item spawn alerts during backpack use

## Support
When requesting support, please include:
- Your configuration file
- Relevant console output
- The detection type involved (ESP, No-Recoil, or Aimbot)

════════════════════════════════════════════════════════════
IMPORTANT NOTES (COMMON “IT DOESN’T WORK” ISSUES)
════════════════════════════════════════════════════════════

1) “My ESP alerts are not posting to Discord”
If you enable Unified Threat AND suppression, individual ESP/NoRecoil/Aimbot webhooks can be suppressed.
Config: "Risk Aggregation"
• Use Unified Threat Webhook Reports = true/false
• Suppress Individual Type Webhooks When Unified Is Enabled = true/false :contentReference[oaicite:12]{index=12}

If suppressed, you may ONLY see reports in the Threat webhook channel (and only if the overall risk meets your minimum). :contentReference[oaicite:13]{index=13}

2) “/ncr commands do nothing”
You are not a real server admin (IsAdmin/authlevel). These commands check admin status. :contentReference[oaicite:14]{index=14}

3) “ESP test works but live ESP doesn’t”
That means Discord is wired correctly. Live ESP requires the scoring gates (distance/FOV/hits/cooldowns) to be met.
Also check if Unified Threat suppression is enabled (see #1). :contentReference[oaicite:15]{index=15}

════════════════════════════════════════════════════════════
RECOMMENDED “FIRST-TIME SETUP” CHECKLIST
════════════════════════════════════════════════════════════
1) Set Discord Webhooks -> Enabled = true
2) Paste at least ESP Webhook + No-Recoil Webhook + Aimbot Webhook
3) oxide.reload NexusCheatRadar
4) Run: /ncr.test esp, /ncr.test norecoil, /ncr.test aimbot
5) Run: ncr  (turn on the radar)
6) avoid leaving detect sleepers on in the esp section as it can causes false positives 

tailor the configurations how you like but document what you change before changing it so you can always go back always check the config