NpcRaiders 1.9.7

Call in a squad of raider NPCs to hit your own base — a safe, self‑contained "raid yourself" event for solo players, small groups, or anyone who wants that raid‑night adrenaline without waiting on a real offline raider.

NpcRaiders lets any player start a fully scripted raid event against their own authorized base. Once the event begins, a wave of armed NPC raiders spawns near the target and pushes toward the player's tool cupboard — fighting through walls, doors, and turrets — until they breach the TC, run out of time, or get wiped out.

The event is sandboxed: only players authorized on the targeted cupboard can damage the raider NPCs, and the NPCs will only ever attack the players inside that event. Nobody outside the event can interfere, and the raiders can't wander off and bother the rest of the server. It's PvE-safe raid content that plugs straight into your existing loot, economy, and reward plugins.

Everything about a raid — how many NPCs spawn, how many waves, how tough they are, what they drop, what it costs to call one in, and what you win for surviving — is configurable per raid "type," so you can sell multiple raid tiers (Easy / Hard / Nightmare, for example) through permissions or a shop plugin.

Key Features

• Self-raid events — players call NPCs in on their own authed base; nobody else can be targeted.
• Locked-down combat — only players authorized on the target TC can hurt the raiders, and the raiders can only hurt them back. No griefing, no stray damage to bystanders.
• Wave-based assault — configurable number of NPCs per wave, number of waves, and delay between waves, so events can scale from a quick skirmish to a full siege.
• Multiple raid types/tiers — build unlimited raid presets (difficulty, NPC count, health, kits, loot, rewards) and gate each one behind its own permission.
• Kits integration — equip raider NPCs with clothing and weapons using the Kits plugin, so their loadout matches the raid tier.
• Flexible loot — drop AlphaLoot profiles, custom loot-profile files (build one straight from your own inventory with /raidme loot add), or nothing at all.
• Pay-to-raid economy — charge players an item (default Scrap), Economics balance, or ServerRewards points to start an event; permission-based cost bypass for admins/VIPs.
• Win rewards — reward successful defenders with an item, Economics funds, ServerRewards points, or a kit.
• VIP cooldown tiers — give specific permission groups their own shorter cooldowns and TC-auth cooldowns instead of the server default.
• Queueing — if the server is already at the max concurrent raid limit, new events queue up and notify the player when it's their turn.
• SimplePVE/ TruePVE / LifeSupport aware — plays nicely with TruePVE exception mapping and LifeSupport's revive handling during an active event.

Video Showcase

Permissions

• npcraiders.use - Use the /raidme chat command to view and start raids.
• npcraiders.admin - Access admin commands (reload, clear, loot).
• npcraiders.nocooldown - Skip the standard raid and TC-auth cooldowns.
• npcraiders.nocost - Start raids without being charged.

Chat Command

• /raidmeShows the raid help menu — available raid types, cost, and NPC/wave counts you have access to.
• /raidme buyShows raid cost/help for every raid type.
• /raidme buy <type>Starts a raid event of the given type at your currently authorized TC.
• /raidme statsOpens your personal stats UI (games played, wins, losses, kills, deaths).
• /raidme terrainAdmin/debug tool — lists the terrain colliders at your current position, for building the block list.
• /raidme loot add <profile>Creates (or adds to) a loot profile using every item currently in your inventory.
• /raidme loot clear <profile>Clears a loot profile's items.
• /raidme reload all (admin)Force-cancels every currently running raid event.
• /raidme reload player <name> (admin)Force-cancels one player's raid event.
• /raidme clear - (admin)Wipes stored cooldowns and player data.
• /raidme - Will show raid help menu.
• /raidme buy - Will show raid buy help menu and costs.
• /raidme buy <type> - To start raid of the type.
• /raidme reload player <playerName> - Will cancel there raid event.
• /raidme reload all - Will cancel all events.
• /raidme terrain - Get Terrain name your standing on.
• /raidme loot - Generate a loot profile with all the items in your inventory

When you create a loot profile you will need to edit its datafile and set the min and max amount of items to give.. There you can change other min/max for item ammounts default is 1 to Amount when created

Console Command

• npcraiders buy <type> <optional playerID> - Lets an external plugin or command (e.g. a shop or GUI) trigger a raid purchase for a player server-side.

Configuration

Quote

{
  "Random settings": {
    "Chat command": "raidme",
    "The Maxum amount of raid events that can go on at once": 6,
    "Cooldown before you can call in another raid": 3600,
    "Cooldown after authorising on a tc be for you can start a raid": 86400,
    "The maxum amount of time a rocket will fly before exploding": 4.0,
    "Limit the damage to players building": false,
    "Npc spawn damage delay": 2.0,
    "Log raidme buy chat command": false,
    "Use GameTip messages": true,
    "Use chat messages": true
  },
  "All Raid Types": {
    "Raid types must be in lowercase": {
      "easy": {
        "The Permission": "npcraiders.easy",
        "Total npcs per wave": 3,
        "How many extra waves": 2,
        "Seconds untell next wave": 120,
        "Npc fires Mlrs at base": false,
        "Mlrs waves and amounts": { "1": 6 },
        "Total event time in seconds": 1800,
        "Block event players from repairing": false,
        "Npc drop loot on death": true,
        "AlphaLoot profile names For Npc Loot": [],
        "Npc drop loot config names": [],
        "Spawn health of the npc": 200,
        "Rocket damage scale": 1.0,
        "Player damage scale from npc": 1.0,
        "Auto turret damage scale to npc": 1.0,
        "External Tc Scan Range": 150,
        "Explosive item shortnames": [ "explosive.satchel", "explosive.timed" ],
        "Names to give the npcs": [ "Cobalt Scientist" ],
        "Spawn kits for the npcs": [ "raider_easy_kit" ],
        "NPC aimConeScale default 2.0": 2.0
      }
    }
  },
  "Raid Buy Options": {
    "BuyOptions": {
      "easy": { "BuyType": "-932201673", "BuyAmmount": 500 }
    }
  },
  "Raid Reward Options": {
    "RewardOptions": {
      "easy": { "enabled": true, "rewardAll": false, "RewardType": "economics", "RewardAmmount": 250 }
    }
  },
  "Raid Vip Options": {
    "VipOptions": {
      "npcraiders.vip1": { "cooldownSeconds": 1800, "TcAuthCooldown": 21600 }
    }
  },
  "Block raid in colider": {
    "Blocked": [ "iceberg", "ice_berg", "ice_sheet", "icesheet", "prevent moving", "cliff" ]
  }
}

Language

Quote

{
  "blocked": "<color=orange>You need to be in a building area!</color>",
  "start": "<color=orange>Your event is starting!</color>",
  "nextWave": "<color=orange>The next wave of raiders are coming.</color>",
  "eventOver": "<color=orange>Your event is now over!</color>",
  "eventOverWin": "<color=orange>Your just won the event!</color>",
  "waiting": "<color=orange>Your event will start shortly!</color>",
  "noHurt": "You can not hurt the event npc!   ",
  "max": "<color=orange>The maximum amount of event's are running. There is {0} ahead of you.</color>",
  "noTypeRaid": "<color=orange>There is no raid type named {0}</color>",
  "cooldown": "<color=orange>You are in cooldown for {0} seconds!</color>",
  "cooldownAuth": "<color=orange>You are in cooldown for Cupboard Authorize {0} seconds!</color>",
  "ThereAlready": "<color=orange>You are already wating on the event.</color>",
  "InEvent": "<color=orange>Someone authed on the TC just started a raid event.</color>",
  "noPerm": "<color=orange>You do not have permission to use this raid type!</color>",
  "noPermUse": "<color=orange>You do not have permission to execute this command!</color>",
  "noMoney": "<color=orange>You need {0} {1} to start this event!</color>",
  "MultiplePlayers": "<color=orange>Found to many matches {0}!</color>",
  "destroyEvent": "<color=orange>Event for {0} destroyed!</color>",
  "destroyEventNotFound": "<color=orange>Event for {0} was not found!</color>",
  "MoneyIssued": "<color=orange>{1} you just recived ${0} for winning the event.</color>",
  "Blockedhere": "<color=orange>The Admin has blocked raids on this terrain type.</color>",
  "Blockedhere2": "<color=orange>The Admin has blocked raids on this terrain type {0}.</color>",
  "BlockedhereWater": "<color=orange>You can not start the event underground.</color>",
  "BlockedhereWaterDeep": "<color=orange>You can not start the event in this water depth.</color>",
  "RewardedItem": "<color=orange>You just won the event and got {0} {1}</color>",
  "waitingNext": "<color=orange>There is currently {0} events running you are next in line!</color>",
  "waitingLine": "<color=orange>There is currently {0} events running and {1} ahead of you. You will be notified before your event starts.</color>",
  "waitingToStart": "<color=orange>Your event will start in 60 seconds.</color>",
  "TcNotFound": "<color=orange>Your event tc was not found, Event canceled!</color>",
  "NoLoot": "<color=orange>You can not loot this event corpse!</color>",
  "UIHeader": "<color=orange>NPC RAIDERS STATS</color>",
  "UI1": "<color=orange>Total events played</color><color=white>:</color>",
  "UI2": "<color=orange>Total events won</color><color=white>:</color>",
  "UI3": "<color=orange>Total events lost</color><color=white>:</color>",
  "UI4": "<color=orange>Total npc's killed</color><color=white>:</color>",
  "ArivalTimeNext": "<color=orange>Wave {1}/{0} will start in</color><color=white>:</color><color=yellow>{2}</color>",
  "NoRepair": "You can not repair while in this event!",
  "EventEndINTime": "<color=orange>You're event will end in {0}</color>",
  "ChatHeader": "<size=22><color=green>NpcRaiders</color></size> <color=#ffffff>by Razor</color>",
  "Reward": "Reward <color=orange>$",
  "RewardMessage": "Reward",
  "Mode": "Mode",
  "NPCs": "NPCs",
  "Waves": "Waves",
  "Buy": "buy",
  "RaidType": "Raid Type",
  "Cost": "Cost:",
  "Nothing": "Nothing you can buy here!",
  "buyMsg": "- Shows the costs of each buyable raiding type.",
  "buyMsg1": "- Start an NPC Raiding event on your base that you have TC Auth on.",
  "buyMsg2": "You do not have any buy permisions!",
  "Randomkit": "Random kit"
}

FAQ

• Do players raid other players, or only themselves?
  Only their own base. A player can only start an event while authorized on the target TC, so this is entirely self-contained PvE-style content — not a way to raid other players.
• Can I sell different difficulty levels?
  Yes — create as many raid types as you want in the config, each with its own permission, NPC count, waves, loot, cost, and reward. Sell access to each tier separately or bundle them into a rank.
• What plugins does this depend on?
  None are required to run the plugin. Kits (for equipping/rewarding NPC loadouts and kit rewards), AlphaLoot (for NPC corpse loot profiles), ServerRewards and Economics (for buy costs/rewards), and TruePVE/SimplePVE/LifeSupport (for smoother PvE-server behavior) are all optional integrations — the plugin works without them, but connects automatically if they're installed.
• Can players avoid paying or waiting on cooldown?
  Yes, through permissions — npcraiders.nocost skips the charge and npcraiders.nocooldown skips both cooldown timers. Useful for staff testing or as a VIP perk.
• Will this let people abuse re-authing on TCs to farm rewards?
  There's a dedicated TC-auth cooldown separate from the normal raid cooldown, specifically to stop players from re-authorizing on a cupboard just to immediately farm another event.