Zombie Swarm PRO — Complete Installation and Configuration Guide
Requirements
Before installing the plugin, make sure you have:
• A working Rust server
• The uMod framework (Oxide)
• FTP access or a control panel (Pterodactyl, etc.)
• Administrator privileges on the server
________________________________________
Step-by-Step Installation
1. Upload the plugin
1. Go to the folder:
/serverfiles/oxide/plugins/
2. Upload the file:
ZombieSwarmPro.cs
________________________________________
2. Restart or reload
You can do either:
Option A (recommended):
oxide.reload ZombieSwarmPro
Option B:
Restart the server
________________________________________
3. Verify installation
In the console:
oxide.plugins
You should see:
ZombieSwarmPro
________________________________________
Permissions
The plugin Use:
zombieswarmpro.admin
Grant permissions:
oxide.grant group admin zombieswarmpro.admin
Or to a user:
oxide.grant user STEAMID zombieswarmpro.admin
________________________________________
Plugin Commands
Main Command:
/swarm
Subcommands:
Command Function
/swarm clear Removes all hordes
/swarm reload Reloads configuration
/swarm status Displays current status
/swarm entity scarecrow Changes zombie type
/swarm entity npc_human Creates human-type zombies
/swarm entity random Creates random mix
________________________________________
Complete Configuration
File:
/oxide/config/ZombieSwarmPro.json
________________________________________
General Configuration
Parameter Description
Zombies Per Horde Number per horde
Max Global Maximum global number of zombies
Hordes Per Player Number of hordes per player
Damage to Structures Damage to Basics
Recommended:
• PvE: 4–6
• Hardcore: 8–12
________________________________________
Night System
Parameter Description
Start Hour Start time (18 = night)
End Hour End time (8 = day)
✔ Hordes ONLY appear in this range
________________________________________
AI and Behavior
Parameter Description
DetectionRange Distance to detect players
AttackDistance Attack distance
ZombieAggression Aggression level (1.0–2.0)
Very important:
• 1.0 = normal
• 2.0 = extremely aggressive
________________________________________
Movement and Speed
Parameter Description
ZombieSpeed Speed (0.1–1.0)
SlotRadius Formation spacing
Tip:
• 0.5 = balanced
• 0.8 = difficult
• 1.0 = Very hardcore
________________________________________
Spawn System
Parameter Description
Spawn Min Distance Minimum distance
Spawn Max Distance Maximum distance
✔ Prevents spawning on top of the player
________________________________________
Patrol System
Parameter Description
PatrolRandom Random behavior
RunProbability Probability of running
StopProbability Probability of stopping
PatrolRadius Patrol radius
________________________________________
Combat Reaction
Parameter Description
Attack When Shot They attack when you shoot
ShotAlertDuration Alert duration
This activates "aggressive horde" mode
________________________________________
NPC Types
Option Description
scarecrow Classic zombies
npc_human Infected humans
random Mix
________________________________________
NPC Equipment Humans
Parameter Options
NPCHumanClothing military, raider, worker, etc.
NPCHumanWeapon machete, hatchet, etc.
EnableNPCHumanArmor true/false
________________________________________
Visual Effects
Parameter Description
EnableGlowingEyes Glowing eyes
EnableZombieSound Sounds
________________________________________
Cleanup
Parameter Description
ClearCorpsesOnDay Cleans corpses
DropLootWhenCleared Drops loot or not
________________________________________
Automatic Message
Parameter Description
EnableSupportMessage Automatic message
SupportMessageInterval Interval (min)
Important Notes (Troubleshooting)
1. NavMesh: Zombies require your map to have a generated NavMesh (standard on official maps). If you are using a custom map and the zombies are not moving, make sure the map has a baked NavMesh.
2. Safe Zones: By default, zombies ignore players inside Safe Zones to prevent abuse in Bandit Camp or Outpost.
3. Performance: The plugin is optimized. If you have a server with limited resources, keep the Max Global Zombies below 100.
________________________________________
Support
If you find any bugs or need an extra feature, please open a ticket on my Codefling profile or contact me via the support URL that appears in the console when you load the plugin.
This plugin will receive continuous improvements, including additional features and performance enhancements.
________________________________________