Skip to content

About

WhiteSpawn – advanced Rust spawn system with a protected safe zone, auto‑opening doors, weapon/tool holstering, metabolism freeze, logout position restore, and full admin controls.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

WhiteSpawn

English | Русский

Version Status Rust Oxide Language License

WhiteSpawn is an ultra-fast, feature-rich Rust plugin for Oxide/uMod that provides a comprehensive safe spawn zone system with teleportation timers, hostility checks, automatic respawns, decay prevention, door automation, empty corpse cleanup, and powerless electrical devices support.


Overview

WhiteSpawn provides server administrators with a complete, highly optimized spawn solution:

  • One-click teleport to a configurable safe spawn point (/spawn)
  • Configurable countdown timer with hostile status cancellation
  • Safe zone sphere around spawn (complete invulnerability, structure protection, decay prevention)
  • Auto-teleport on first join (welcome message) and after death (respawn message)
  • Built-in /respawn command with configurable cooldown
  • Permission-based bypasses for timers, spawn enforcement, and full administrator access
  • Weapon/tool holstering inside the zone
  • Metabolism freeze (calories/hydration max, poison/radiation/bleeding cleared)
  • Looting protection (players cannot loot each other; own corpse looting permitted)
  • Building & deployable placement blocking
  • Door automation (doors open upon player approach in the zone and close when clear)
  • Powerless electrical devices support (heaters, turrets, searchlights powered automatically)
  • Automatic empty/starter corpse cleanup to keep the spawn area tidy
  • Reconnect logout position restore (optional)
  • Full chat localization (English and Russian) with SteamID avatar support

Features

  • Spawn Teleport: /spawn teleports players to spawn after a configurable delay (default 5s). Cancelled if player becomes hostile.
  • Admin Target Teleport: /spawn <player> instantly teleports target to spawn (admin only).
  • Safe Zone Protection: Damage to players, structures, and deployables in the zone is blocked. Admins can bypass restrictions.
  • Decay Prevention: Structures inside the safe zone never decay when PreventBuildingDecay is enabled.
  • Powerless Devices: Heaters, searchlights, auto-turrets, ceiling lights, and fog machines operate without wires/electricity in the safe zone.
  • Automatic Corpse Cleanup: Empty corpses or starter corpses (rock, torch) are cleaned up automatically.
  • Door Automation: Doors open automatically when players walk near them in the safe zone and close when clear.
  • Metabolism Freeze: Hunger, thirst, radiation, poison, and bleeding are frozen/cleared inside the safe zone.
  • Weapon Holstering: Weapons and tools are automatically holstered when held in the zone.
  • High Performance: Physics queries use zero-allocation static non-alloc buffers (Physics.OverlapSphereNonAlloc), fast squared distance checks, and throttled timers.

Commands

Command Description Permission
/spawn Teleport to the safe spawn point None (if enabled)
/spawn <name/steamid> Teleport target player to safe spawn point whitespawn.admin
/respawn Suicide and respawn at safe spawn point None (if enabled)
/setspawn Set spawn point and look angle at current position whitespawn.admin
/ws radius <number> Set safe zone radius in meters whitespawn.admin
/ws status Show current plugin status summary None
/ws config Display all configuration options None
/ws set <option> <value> Modify any configuration setting in real-time whitespawn.admin
/ws get <option> Retrieve value of a configuration setting whitespawn.admin
/ws reload Reload configuration and data files whitespawn.admin
/ws help Display list of available commands None

Permissions

Permission Description
whitespawn.admin Full administrator access: manage spawn, configure settings, bypass all safe zone restrictions
whitespawn.bypasstimer Removes the countdown delay on /spawn (instant teleportation)
whitespawn.bypassspawn Prevents forced teleport on first join and after death (player spawns normally)

Configuration

Default configuration file (oxide/config/WhiteSpawn.json):

{
  "Settings": {
    "Enabled": true,
    "SpawnTimer": 5.0,
    "Radius": 10.0,
    "WelcomeMessageEnabled": true,
    "RespawnMessageEnabled": true,
    "RespawnCommandEnabled": true,
    "FindOutpostFirst": true,
    "BlockWeaponsAndTools": true,
    "FreezeMetabolismInZone": true,
    "ChatNotificationsEnabled": true,
    "BlockLootingInZone": true,
    "BlockBuildingInZone": true,
    "AutoOpenDoorsInZone": true,
    "DoorOpenRadius": 2.5,
    "DoorOpenInterval": 0.75,
    "DoorCloseDelay": 3.0,
    "RestoreLogoutPositionOnReconnect": false,
    "RespawnOnlyByCommand": true,
    "PreventBuildingDecay": true,
    "PowerlessDevicesEnabled": false,
    "RespawnCooldown": 60.0,
    "RemoveEmptyCorpses": true,
    "StandardItems": [
      "rock",
      "torch"
    ]
  }
}

Installation

  1. Download WhiteSpawn.cs and place it in your server's oxide/plugins directory.
  2. The plugin will automatically compile and generate default configuration and data files.
  3. Grant permissions as needed (e.g. oxide.grant group admin whitespawn.admin).
  4. Set a custom spawn point using /setspawn or let the plugin auto-detect Outpost / Bandit Town.

Localization

Built-in languages:

  • English (lang/en/WhiteSpawn.json)
  • Russian (lang/ru/WhiteSpawn.json)

All messages can be customized via Oxide's language system.


License

Released under the Apache 2.0 License.

About

WhiteSpawn – advanced Rust spawn system with a protected safe zone, auto‑opening doors, weapon/tool holstering, metabolism freeze, logout position restore, and full admin controls.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages