builtin quest

Built-in Functions Documentation (Quest)

This document describes functions available to quest type objects.

• model
• step
• progress
• inc_progress
• inc_step
• complete
• completed
• completed_progress
• completed_step

---

model

model()

• Description:
  Returns the quest model for the current step.
• Parameters:
  • None
• Return Value:
  • fb.model.quest: The quest model object for the current step
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      local model = quest:model()
      -- Access model properties
  end

---

step

step()

• Description:
  Returns the current step number of the quest.
• Parameters:
  • None
• Return Value:
  • integer: Current step number (1-based)
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      local current_step = quest:step()
      me:message("Current step: " .. current_step)
  end

---

progress

progress()

• Description:
  Returns the current progress value of the quest.
• Parameters:
  • None
• Return Value:
  • integer: Current progress value
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      local progress = quest:progress()
      me:message("Progress: " .. progress)
  end

---

inc_progress

inc_progress(value:integer)

• Description:
  Increases the quest progress by the specified value.
• Parameters:
  • value:integer (optional): Amount to increase progress (default: 1)
• Return Value:
  • boolean: true if successful, false otherwise
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      local success = quest:inc_progress(5)
      if success then
          me:message("Progress increased by 5")
      end
  end

---

inc_step

inc_step(value:integer)

• Description:
  Increases the quest step by the specified value.
• Parameters:
  • value:integer (optional): Amount to increase step (default: 1)
• Return Value:
  • boolean: true if successful, false otherwise
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      local success = quest:inc_step(1)
      if success then
          me:message("Advanced to next step")
      end
  end

---

complete

complete()

• Description:
  Completes the quest.
• Parameters:
  • None
• Return Value:
  • boolean: true if successful, false otherwise
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      local success = quest:complete()
      if success then
          me:message("Quest completed!")
      end
  end

---

completed

completed()

• Description:
  Checks if the quest is completed.
• Parameters:
  • None
• Return Value:
  • boolean: true if quest is completed, false otherwise
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      if quest:completed() then
          me:message("Quest is already completed")
      end
  end

---

completed_progress

completed_progress()

• Description:
  Checks if the current step progress is completed.
• Parameters:
  • None
• Return Value:
  • boolean: true if current step progress is completed, false otherwise
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      if quest:completed_progress() then
          me:message("Current step progress is complete")
      end
  end

---

completed_step

completed_step()

• Description:
  Checks if all quest steps are completed.
• Parameters:
  • None
• Return Value:
  • boolean: true if all steps are completed, false otherwise
• Example:

  -- This is a real usage example from game scripts
  local quest = me:quest(1001)
  if quest then
      if quest:completed_step() then
          me:message("All quest steps are completed")
      end
  end