Bot System

From Vintage Story Wiki
Revision as of 19:40, 16 July 2020 by Tyron (talk | contribs) (Created page with "Vintage Story comes with some rudimentary interface to control creatures and humanoids through commands, which is mostly aimed for recordings. Here's how to use it: 1. Spawn...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Vintage Story comes with some rudimentary interface to control creatures and humanoids through commands, which is mostly aimed for recordings. Here's how to use it:

1. Spawn in a bot. Only some creatures are supported, here's a list:

  • /entity spawn playerbot
  • /entity spawn animalbot-wolf-male
  • /entity spawn animalbot-hyena-male
  • /entity spawn animalbot-hyena-female
  • /entity spawn animalbot-hyena-pup
  • /entity spawn animalbot-chicken-hen
  • /entity spawn animalbot-chicken-rooster
  • /entity spawn animalbot-chicken-baby
  • /entity spawn animalbot-sheep-bighorn-male
  • /entity spawn animalbot-sheep-bighorn-female
  • /entity spawn animalbot-sheep-bighorn-lamb
  • /entity spawn animalbot-locust-corrupt
  • /entity spawn animalbot-hare-female-lightgrey
  • /entity spawn animalbot-piglet
  • /entity spawn animalbot-drifter-normal
  • /entity spawn animalbot-drifter-corrupt
  • /entity spawn animalbot-drifter-nightmare

2. Right click the creature to select it. You can now tell it to execute commands or define a list of commands to execute in a loop

3. Type one of either commands to execute a command right away Legend: flexiblepos means either x y z coordinates as defined in the coordinate hud, absolute coordinates through =x =y =z or coordinates relative to the player with ~x ~y ~z, you can also do ~ ~ ~ do use exactly the players position.

  • /npc exec tp flexiblepos teleport to given position
  • /npc exec lookat rad look in given direction in radians (0..2PI)
  • /npc exec goto flexiblepos animcode speed [animspeed] walk to given position with given animation, given speed (normal walking speed is about 0.02) and given animation speed (default 1)
  • /npc exec playanim animcode players given animation. Valid ones for animals, if supported by the respective animal: hurt, die, eat, walk, cry, shamble, lowshamble, sleep, sit, listen, hide, idletwitch, drill

4. If you want to bot to run or remember a list of commands replace "exec" with "enq" to enqueue commands:

  • /npc enq [tp|lookat|goto|playanim] (see args above)
  • /npc start to start command list
  • /npc stop to stop
  • /npc loop to make the bot endlessly loop through his list of commands
  • /npc clear will clear the command list
  • /npc list show list of queued commands
  • /npc remove [index] remove command of given index as shown in /npc list
  • /npc upd allows you do modify some commands