Personal Drone

5 Screenshots

20.6k
81
135.86 kB
April 16

About Personal Drone

This plugin adds personal helper drones to your server that can collect resources, buy items from vending machines, shoot from turrets and drop grenades at enemies, and the player will be able to fly on them!
You can create a huge variety of drones and give them as an item or using a command.

IMPORTANT!
By default drone's max control range is limited by 500. To increase it, you can use drone.maxcontrolrange command in the server console.
IMPORTANT!

At the moment, the bot can:

Attack enemies from turret
Attack enemies by dropping grenades from the bag
Buy items in vending machines
Collect resources for player
Be an inventory for player's loot
Be a vehicle for player

You can customize:

Controls
- Which button will assign tasks to the drone
- Which button will open the inventory
- Which button will be used to mount drone
- Button range
- Displaying 3D arrows above the target
- Arrow display duration
GUI
- Update rate
- Panel layer
- Panel position, also the second and third positions of the panel to use with other 'Personal' plugins
- Panel colors
- Shortcut buttons
Drones
- Item setup
  - Item name
  - Item skin
  - Can player pickup drone back
- Command setup
  - Can player spawn this drone using a command
  - Permission to spawn
  - Spawn cooldown
  - Short name to spawn this drone
  - Can player pickup drone back
- Drone movement
  - Altitude
  - Movement
  - YAW
- Obstacle detection
  - Forward obstacle detector
    - Distance to detect an obstacle
    - How many meters to fly up if obstacle is detected
  - Rear obstacle detector
    - Distance to detect an obstacle
    - How many meters to fly up if obstacle is detected
- Addons
  - Inventory
    - Add inventory to the drone?
    - Inventory capacity
    - Blacklist
  - Seat for player
    - Spawn invisible seat for player?
  - Turret
    - Add turret to drone?
    - Default weapon
  - Grenade throwing feature
    - Enable this option
    - Throw delay
    - Distance between drone and enemy to begin throwing
  - Purchase in vendings
    - Enable this option
    - Block buy in safezone vendings?
    - Block buy in non-safezone vendings?
    - Max distance to buy (currently limited to 200, working on solution)
  - Resources collect
    - Allow drone to loot crates and boxes
    - Allow drone to loot resources (wood, stones etc.)
    - Allow drone to loot owner's corpse (drone will collect items from corpse and deliver them back to player)
    - Rates for resources
    - Min distance to pickup
- Drone's marker
  - Simple marker
    - Enable simple marker
    - Radius
    - Alpha
    - Display name
    - Main color
    - Outline color
  - Special delivery drone marker
    - Enable this marker? (works only in 1-2 squares, otherwise it disappears)
- Death marker
  - Enable death marker
  - Display name
  - Radius
  - Outline color
  - Main color
  - Alpha
  - Duration
- Drone's max health
- Min fly height
- Kill drone if in water
- Disable collision damage

Video:

If you have enabled turret for drone, you need to install these plugins:
https://umod.org/plugins/drone-turrets
https://umod.org/plugins/better-turret-aim

Personal NPC and Personal Animal interfaces are fully compatible with Personal Drone

By default, the plugin has 2 localization files, for Russian and English

Commands:

Console commands:
- pdrone.item {STEAM_ID} {SKIN_ID} {AMOUNT} - gives the drone as an item if the corresponding one is found in the config
Chat commands:
- /pdrone - spawns an available drone or destroys an existing one
- /pdrone vending - asks the player to place a marker on the map so that the drone will fly to the nearest vending and buy an item there
- /pdrone follow - follow the owner

Configuration:

{
  "Control setup": {
    "Which button will assign tasks to the drone, attack/fly to point, etc. (MIDDLE_MOUSE, SECOND_MOUSE, E, RELOAD, SPRINT)": "MIDDLE_MOUSE",
    "Button to open inventory if it exists (MIDDLE_MOUSE, SECOND_MOUSE, E, RELOAD, SPRINT)": "RELOAD",
    "Button to mount drone if this option enabled (MIDDLE_MOUSE, SECOND_MOUSE, E, RELOAD, SPRINT)": "E",
    "Range of action of the assignment button": 25.0,
    "Display 3D arrows over a target/point?": true,
    "Arrow display duration": 2
  },
  "GUI setup": {
    "How many seconds to update the GUI?": 6,
    "Panel layer (Hud, Overlay, Overall, Hud.Menu, Under)": "Overlay",
    "Panel position": {
      "type": "RectTransform",
      "anchormin": "1 1",
      "anchormax": "1 1",
      "offsetmin": "-170 -104",
      "offsetmax": "-10 -10"
    },
    "Second position of the panel (used if the player has a personal bot/animal)": {
      "type": "RectTransform",
      "anchormin": "1 1",
      "anchormax": "1 1",
      "offsetmin": "-335 -104",
      "offsetmax": "-175 -10"
    },
    "Third position of the panel (used if the player has a personal bot and a personal animal)": {
      "type": "RectTransform",
      "anchormin": "1 1",
      "anchormax": "1 1",
      "offsetmin": "-500 -104",
      "offsetmax": "-340 -10"
    },
    "1 panel color": "#7f8c8d",
    "2 panel color": "#bdc3c7",
    "Health bar color": "#2ecc71",
    "Shortcut buttons": [
      {
        "Text on button": "Land Drone",
        "Executable chat commands": [
          "pdrone land"
        ]
      }
    ]
  },
  "Drones Settings": [
    {
      "Drone item": {
        "Item name": "Personal Drone",
        "Item skin": 2824523761,
        "Can pickup?": true
      },
      "Command spawn": {
        "Can player spawn this drone using a chat command? (/pdrone {name})": true,
        "Permission to spawn": "personaldrone.drone1",
        "Spawn cooldown": 3600.0,
        "Name of this drone preset to spawn": "drone1",
        "Can player pickup this drone after spawn?": false
      },
      "Drone Movement": {
        "Altitude acceleration": 30.0,
        "Movement acceleration": 30.0,
        "YAW acceleration": 5.0
      },
      "Obstacle Detectors": {
        "Forward obstacle detector": {
          "Obstacle detect distance": 5.0,
          "How many meters to fly up if an obstacle is detected": 5.0
        },
        "Backward obstacle detector": {
          "Obstacle detect distance": 5.0,
          "How many meters to fly up if an obstacle is detected": 5.0
        }
      },
      "Addons": {
        "Inventory Addon": {
          "Add inventory to drone?": true,
          "Inventory capacity": 12,
          "Black list of items that cannot be put into the inventory of the bot": [
            "rocket.launcher"
          ]
        },
        "Seat Addon": {
          "Add invisible seat for drone's owner?": true
        },
        "Turret Addon": {
          "Add turret to drone? (more settings in DroneTurrets plugin's config)": true,
          "Default weapon shortname (not necessary)": ""
        },
        "Grenade thrower Addon (requires inventory)": {
          "Enable feature to throw grenades to the target? (player will be need to put the grenades to drone inventory)": true,
          "Throw cooldown": 1.0,
          "Distance between target and drone to start throwing": 5.0
        },
        "Purchase in Vending Addon (requires inventory)": {
          "Purchase in vending enable? (requires inventory)": true,
          "Block buy in safezone vendings?": false,
          "Block buy in non-safezone vendings?": false,
          "Max distance to buy (currently limited to 200f, looking forward for solution)": 200.0
        },
        "Loot Collect Addon (requires inventory)": {
          "Can drone loot crates?": true,
          "Can drone pickup collectibles? (sulfur, metal, wood etc.)": true,
          "Collectibles pickup rate (shortname:rate)": {},
          "Min distance to pickup": 5.0
        }
      },
      "Death marker": {
        "Show marker on drone's death position?": true,
        "Display name on map": "Drone's death marker",
        "Marker radius": 0.35,
        "Outline color (hex)": "00FFFFFF",
        "Main color (hex)": "00FFFF",
        "Alpha": 0.5,
        "Duration": 20
      },
      "Drone max. health": 1000.0,
      "Minimum fly height": 10.0,
      "Kill in water?": false,
      "Disable collision damage": true
    }
  ]
}