Skip to main content

Movement Quests

Creating Movement and Location Quests​

In this guide, we will walk you through the process of creating movement and location quests for your Battle Pass.

Quest Types​

There are several different types of quests you can create for the Battle Pass:

  • Location quests: These quests require the player to find a specific location on the map.

  • Movement quests: These quests require the player to travel a certain distance on foot, by vehicle, or by swimming.

  • Custom quests: These quests can be anything you can imagine, such as completing a task, defeating enemies, or gathering resources.

Creating Location Quests​

To create a location quest, you will need to define the location on the map that the player needs to find. The name of the quest must start with find_ followed by the location name. Here is an example for a registered location quest:

{name = "find_vinewood_sign",label = "Visit the Vinewood Sign", description = "Take a trip to the iconic Vinewood Sign and snap a photo with it", xp = 1500, premium = false, untilAvailable = 0, showProgress = false}

Add the location of the quest to the places table in your script's configuration:

places = {
['vinewood_sign'] = {radius = 300.0, coords = { 683.33, 1289.76, 326.22 }},
},
  • radius: The radius of the location in meters.

  • coords: An array of the coordinates of the location on the map.

Creating Movement Quests​

To create a movement quest, you will need to define the type of movement required (run, swim, or drive), the distance that the player needs to travel, and the vehicle class or name (if applicable). Here is an example for a movement quest:

{name = "drive_500_bmx", label = "BMX Explorer", description = "Take a BMX bike for a spin and ride it for 500 meters", xp = 1500, premium = false, untilAvailable = 0, showProgress = true}

It is important to name the quest right, the naming format has to be: action_distance_vehicle

  • action: Type of movement: drive, run or swim

  • distance: The distance that the player needs to travel

  • vehicle: (optional) vehicle class or name to drive with

Vehicle Classes
  1. compacts
  2. sedans
  3. suvs
  4. coupes
  5. muscle
  6. sport-classic
  7. sport
  8. super
  9. motorcycles
  10. off-road
  11. industrial
  12. utility
  13. vans
  14. cycles
  15. boats
  16. helicopters
  17. planes
  18. service
  19. emergency
  20. military
  21. commercial
  22. trains