ROAMS

depends on

GitHub - k1lly0u/Oxide.Ext.RustEdit: Oxide extension to allow further customisation in Rust maps

About ROAMS

What's Roams?

ROAMS creates an arena on your selected island where the player can teleport to with the /roams command when it's available. Server owners can customize timers, durations, arena-useable weapons, placeable items, walls, etc from the config beforehand. It gives your players the best roaming experience and explore their skills on roams.
Server owners can create their own roam islands with different obstacles and terrain on each wipe or have multiple roam islands on the map and randomize between them.
There are 2 winning methods individuals and clans which can be configured in the config
Priority teleports to teammates on roam
Configurable rewards after the roam ends
Winner's stats and discord notifications
Extra rewards - all player-killed loots on the Roam loots are automatically placed in a box after the roam ends,
AUTOMATIC ARENA SETUP ON NEW WIPE

Commands

/roam_setup create <AnyName(NoSpace)> - Creates a arena with 50 radius on your position
/roam_setup edit <ArenaName> - Selects a arena to edit
/roam_setup radius <Number> - Updates the radius of the selected Arena
/roam_setup location - Updates the location or position of the selected Arena
/roam_setup delete <ArenaName> - Removes the arena
/roam_setup list - Shows the list of the available Roam Arenas
/roam_setup setupauto - Setup auto arena from the config
/roamstart <ArenaName> - Starts the arena
/roamend - Force stop the event

Permissions

Roams.admin - Require to create or update Roam Arena
Roams.join - Requires to join a Roam Arena

Configurations

Quote

{
  "Roam enable automatic event holding [true/false]": false,
  "Minimum time between events [sec]": 3600,
  "Maximum time between events [sec]": 7200,
  "Players require to start automatic event": 1,
  "Roam automatic event schedule random from list": [
    "RoamArena1",
    "RoamArena2"
  ],
  "Event notification timer [sec]": 300,
  "Event total timer [sec]": 1800,
  "Event teleport timer [sec]": 5,
  "Event destory loots and crates timer [sec]": 300,
  "Event select winner [Individual = 0/Clan = 1]": 0,
  "Blocked items in the Roam": [
    "grenade.beancan",
    "grenade.f1",
    "rock",
    "rocket.launcher",
    "ammo.rocket.basic",
    "ammo.rocket.smoke",
    "ammo.rocket.hv",
    "ammo.rocket.seeker",
    "ammo.rocket.fire",
    "explosive.satchel",
    "explosive.timed",
    "ammo.grenadelauncher.smoke",
    "ammo.grenadelauncher.buckshot",
    "ammo.grenadelauncher.he",
    "grenade.flashbang",
    "grenade.molotov",
    "multiplegrenadelauncher",
    "grenade.smoke"
  ],
  "Enable remove entitys before event": true,
  "Remove Entitys from the list when Event Start": [
    "wall",
    "sleepingbag",
    "beachtowel",
    "barricade",
    "ladder",
    "floor",
    "foundation",
    "frame",
    "gates.external.high.stone",
    "gates.external.high.wood",
    "wall.external.high.stone",
    "wall.external.high.wood",
    "barricade.concrete",
    "barricade.cover.wood",
    "barricade.metal",
    "barricade.sandbags",
    "barricade.stone",
    "icewall",
    "wall.external.high.ice",
    "minicopter",
    "hackablelockedcrate",
    "barricade.cover.wood_double",
    "sleepingbag_leather_deployed"
  ],
  "Blocked Commands in the Roam": [
    "kit",
    "home",
    "outpost",
    "tpr",
    "tpa"
  ],
  "Allowed items in the Roam": [
    "gates.external.high.stone",
    "gates.external.high.wood",
    "wall.external.high.stone",
    "wall.external.high.wood",
    "barricade.concrete",
    "barricade.cover.wood",
    "barricade.cover.wood_double",
    "barricade.metal",
    "barricade.sandbags",
    "barricade.stone",
    "icewall",
    "wall.external.high.ice",
    "barricade.cover.wood_double",
    "sleepingbag_leather_deployed"
  ],
  "Sphere Dome Setting": {
    "Roam create sphere bubble": true,
    "Roam sphere prefab": "assets/bundled/prefabs/modding/events/twitch/br_sphere_green.prefab",
    "Roam sphere amount": 1
  },
  "Map Marker Setting": {
    "Enable Map Marker": true,
    "Display Name": "Roam Event",
    "Marker Radius": 0.5,
    "Marker Transparency": 0.5,
    "Marker Color": "#9CFF1E"
  },
  "Individual Winner Message": [
    "<color=#FFD700>Roam Results:</color>",
    "",
    "Match Winner: <color=#FFD700>{Winner_Name}</color>",
    "",
    "Winner's Performance:",
    "- Kills: <color=#FFD700>{Kills}</color>",
    "- Deaths: <color=#FFD700>{Deaths}</color>",
    "- KDR: <color=#FFD700>{KDR}</color>",
    "- Total Damage: <color=#FFD700>{Damages}</color>",
    "- HeadShots: <color=#FFD700>{Headshots}</color>",
    "- Shooting Accuracy: <color=#FFD700>{Accuracy}%</color>",
    "- HeadShot Accuracy: <color=#FFD700>{HeadshotAccuracy}%</color>",
    "",
    "<color=#FFD700>Aggregate Totals:</color>",
    "- Total Kills: <color=#FFD700>{TotalKills}</color>",
    "- Total Damage: <color=#FFD700>{TotalDamages}</color>",
    "- Number of Participants: <color=#FFD700>{Participents}</color>"
  ],
  "Clan Winner Message": [
    "<color=#FFD700>Roam Results:</color>",
    "",
    "Winning Clan: <color=#FFFF00>{WinningClanName}</color>",
    "",
    "{PlayerStats}",
    "",
    "<color=#FFD700>Clan Totals:</color> Kills: {ClanTotalKills}, Deaths: {ClanTotalDeaths}, KDR: {ClanTotalKDR}",
    "Damage: {ClanTotalDamage}, Headshots: {ClanTotalHeadshots}",
    "",
    "<color=#FFD700>Aggregate Totals:</color>",
    "- Total Kills: <color=#FFD700>{TotalKills}</color>",
    "- Total Damage: <color=#FFD700>{TotalDamages}</color>",
    "- Number of Participants: <color=#FFD700>{Participents}</color>"
  ],
  "Reward Setting": {
    "Enable Rewards": true,
    "Spawn Hackable crate at event end": true,
    "Hackable crate spawn amount": 2,
    "Spawn Minicopter at event end": true,
    "Minicopter spawn amount": 2,
    "Spawn Elite Crate at event end": true,
    "Elite Crate spawn amount": 4
  },
  "Discord Setting": {
    "Enable discord webhook message": false,
    "Webhook URL": "",
    "Discord Individual Winner Message": [
      "**ROAM EVENT**",
      "",
      "**Details**",
      "- Total Kills: `{TotalKills}`",
      "- Total Deaths: `{TotalDeaths}`",
      "- Total Players: `{Participents}`",
      "",
      "**Winner**",
      "",
      "-  **{WinnerName}**",
      "-  Kills: `{Kills}`   Deaths: `{Deaths}`  KDR: `{KDR}`",
      "-  Headshots: `{Headshots}`  Damages: `{Damages}`  Accuracy: `{Accuracy}`"
    ],
    "Discord Clan Winner Message": [
      "**ROAM EVENT**",
      "",
      "**Details**",
      "- Total Kills: `{TotalKills}`",
      "- Total Deaths: `{TotalDeaths}`",
      "- Total Teams: `{TotalTeams}`",
      "- Total Players: `{Participents}`",
      "",
      "**Winners**",
      "",
      "-  **{WinnerClanName}**",
      "-  Kills: `{ClanKills}`   Deaths: `{ClanDeaths}`",
      "-  Headshots: `{ClanHeadshots}`  Damages: `{ClanDamages}`",
      "",
      "**Members**",
      "- {MembersStats}"
    ]
  },
  "Auto Roam Arena Setup": {
    "Start Maze Arena Setup": false,
    "Auto Arena Setup": {
      "RoamArena1": {
        "Roam Center Item": "skull_fire_pit",
        "Roam Radius": 50.0
      }
    }
  },
  "Version": {
    "Major": 1,
    "Minor": 0,
    "Patch": 0
  }
}

{
  "Title": "<color=#9CFF1E>ROAMS</color>: ",
  "NoPerm": "You do not have permission to join this event.",
  "NoEventRunning": "The Roams event is not currently running. Stay tuned for the next one!",
  "TeleportCancelled": "Teleportation has been cancelled.",
  "AlreadyIn": "You are already in the event!",
  "NoClan": "You must be in a clan to participate in the Roams event!",
  "TeleportingTime": "Teleporting in <color=#FFD700>{0}</color> seconds...",
  "BannedItems": "You cannot enter this event with restricted items! The following have been removed from your inventory: <color=#DC143C>{0}</color>.",
  "NotifyTimer": "The Roams event begins in <color=#FFD700>{0}</color> seconds. Get ready!",
  "NotifyStart": "The Roams event has started! Join now using <color=#9CFF1E>/roams</color>!",
  "NoUpgrade": "You are not allowed to upgrade structures in this area!",
  "NoBuild": "You are not allowed to build in this area!",
  "NoCMD": "You can't excute this command in this area!",
  "RoamEnding": "The Roams event ending in <color=#FFD700>{0}</color>",
  "RoamEndingSoon": "The Roams event is ending..."
}