1 files changed, 59 insertions, 0 deletions

@@ -30,6 +30,12 @@ SpriteLayer = {
   ABOVE = 1
 }
 
+BehaviourType = {
+  NONE = 0,
+  WANDER = 1,
+  PATH = 2
+}
+
 CutsceneOptions = {
   DO_NOT_CHANGE_ANIMATION = 1 -- Prevents player party animation being set to "frozen" at the start of a cutscene or "still" at the end
 }
@@ -426,6 +432,13 @@ function WaitForSpritePath(spriteName)
   end
 end
 
+--- Turns off the sprite's behaviour.
+function DisableBehaviour(spriteName)
+  local spriteId = getSpriteByAlias(spriteName)
+  local sprite = getSprite(spriteId)
+  sprite.behaviourType = BehaviourType.NONE
+end
+
 --- Fades out the currently playing music.
 -- This does not block. If you want it to block, call Delay for the same amount
 -- of time.
@@ -456,3 +469,49 @@ function EnablePlayerControl()
   local playerSprite = getSprite(playerId)
   playerSprite.controllable = true
 end
+
+--- Makes the specified sprite face toward the †arget sprite.
+-- This version of the function uses the closest cardinal direction.
+-- @param spriteName the name of the sprite to change the direction of
+-- @param targetName the name of the sprite to face toward
+function FaceTowardSpriteCardinally(spriteName, targetName)
+  local spriteId = getSpriteByAlias(spriteName)
+  local targetId = getSpriteByAlias(targetName)
+  local sprite = getSprite(spriteId)
+  local target = getSprite(targetId)
+  local diff = vec2i.new(target.loc:x() - sprite.loc:x(), target.loc:y() - sprite.loc:y())
+  local dir = cardinalDirectionFacingPoint(diff)
+
+  SetDirection(spriteName, dir)
+end
+
+--- Detaches the sprite's followers and erases their following trails.
+function BreakUpParty(spriteName)
+  local spriteId = getSpriteByAlias(spriteName)
+  character():breakUpParty(spriteId)
+end
+
+--- Makes the specified sprite solid.
+-- This means that other sprites will be blocked if they collide with this one.
+function MakeSpriteSolid(spriteName)
+  local spriteId = getSpriteByAlias(spriteName)
+  local sprite = getSprite(spriteId)
+  sprite.solid = true
+end
+
+--- Makes the specified sprite not solid.
+-- This means that other sprites will not be blocked if they collide with this
+-- one.
+function MakeSpriteNotSolid(spriteName)
+  local spriteId = getSpriteByAlias(spriteName)
+  local sprite = getSprite(spriteId)
+  sprite.solid = false
+end
+
+--- Sets the sprite's movement speed.
+-- As a reference: 1 is slow (good for NPCs), 2 is Lucas's default walking speed
+function SetMovementSpeed(spriteName, speed)
+  local spriteId = getSpriteByAlias(spriteName)
+  local sprite = getSprite(spriteId)
+  sprite.movementSpeed = speed
+end