From 1f5195c6863b38ce9ecd1aa99730948d0784c923 Mon Sep 17 00:00:00 2001
From: Bivurnum <147376167+Bivurnum@users.noreply.github.com>
Date: Thu, 26 Jun 2025 15:55:43 -0500
Subject: [PATCH] update fnpc docs for createfollowernpc

---
 docs/tutorials/how_to_follower_npc.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/tutorials/how_to_follower_npc.md b/docs/tutorials/how_to_follower_npc.md
index e55e6d8149..0af297ce60 100644
--- a/docs/tutorials/how_to_follower_npc.md
+++ b/docs/tutorials/how_to_follower_npc.md
@@ -24,6 +24,11 @@ This would turn object number 3 on the current map into an NPC follower, give th
 
 The object ***MUST*** have an event flag or the NPC follower will not be created!
 
+## Create a Follower
+The `createfollowernpc` macro will create a new follower without needing to convert an existing NPC. It works similarly to `setfollowernpc`, but instead of providing an object id, you give it a GFX id. For example, if you wanted to create a follower with the May sprite, you could do something like this:  
+`createfollowernpc OBJ_EVENT_GFX_RIVAL_MAY_NORMAL, FNPC_ALL, EventScript_MayFollow`  
+The created follower NPC will initially be invisible until the player takes a step.
+
 ## Follower Flags
 These are required to tell the game what behavior you want the NPC follower to have. They are defined in [include/constants/follower_npc.h](https://github.com/rh-hideout/pokeemerald-expansion/blob/upcoming/include/constants/follower_npc.h). The second list of flags is the same as the first, but with shortened names to make them easier to type when scripting. The first 7 flags in the list are individual behaviors, whereas the remaining three are bundles of flags. For example, if you use `FNPC_SURF` in `setfollowernpc`, the NPC follower will be able to Surf behind the player. If you use `FNPC_ALL_WATER` instead, the NPC follower will be able to Dive and go up Waterfalls in addition to being able to Surf. Feel free to add your own custom bundles of flags to the file to meet your needs.