Difference between revisions of "Follower tutorial"

#include "utility_h"
#include "wrappers_h"
#include "plt_bc_create_party"   //make sure you include your own plot, not mine
 
void main()
{
    event ev = GetCurrentEvent();
    int nEventType = GetEventType(ev);
    switch(nEventType)
    {
        case EVENT_TYPE_PARTYMEMBER_ADDED:
        {
            object oFollower = GetEventObject(ev, 0);
            SetLocalInt(oFollower, CREATURE_REWARD_FLAGS, 0);
            WR_SetFollowerState(oFollower, FOLLOWER_STATE_ACTIVE);
 
            AddCommand(oFollower, CommandJumpToLocation(GetLocation(GetHero())));   //Ensures follower appears at PC's location.
 
            if (GetTag(oFollower) == "bc_party_miera") {               //You must explicitly test for your follower's tag.
                WR_SetPlotFlag(PLT_BC_CREATE_PARTY, PARTY_MIERA_IN_PARTY, TRUE);     //Make sure you use your own flags!
            }
 
            break;
        }  
 
        case EVENT_TYPE_PARTYMEMBER_DROPPED:                    
        {
              object oFollower = GetEventObject(ev, 0); 
 
              if (GetTag(oFollower) == "bc_party_miera") { 
                WR_SetPlotFlag(PLT_BC_CREATE_PARTY, PARTY_MIERA_IN_PARTY, FALSE);     //As above, but set false.
              }
 
        }
 
    }
}

#include "sys_chargen_h"
#include "wrappers_h"
#include "utility_h"
#include "sys_rewards_h"
#include "approval_h"
#include "sys_autolevelup_h"
 
/*  Jye Nicolson 5-Jan-2010
This function set duplicates the full functionality chain of UT_HireFollower, with the following exceptions:
 
-  Followers can gain XP
-  Autolevel status can be set (default off)
-    Followers can be set to any starting state (default Available) and  will  still be properly initalised and added to the party pool
-  Autolevel tables for non-core followers can be explicitly set.
-  Class and Specialisation can be chosen via script
-  Followers without specialisations are granted a spec point by default.
 
It should only ever be called once each for characters you intend to be full followers.
Much of the protective code handling summoned creatures etc. in player_core is not present here.
 
Calling the function:
 
Simple:
 
hireCustomFollower(oFollower, CLASS_WARRIOR);
 
Change the class to CLASS_WIZARD or CLASS_ROGUE as appropriate.  
This will hire your follower and make them available.  
They will auto level up with a default package, and receive a free spec point.
 
Best Practice:
 
hireCustomFollower(oFollower, CLASS_WARRIOR, PLT_YOUR_PARTY_PLOT, YOUR_FOLLOWER_JOINED_FLAG, ABILITY_TALENT_HIDDEN_CHAMPION);
 
Where   the plot and flag are those for your module (remember to create the   plot and include it on the calling script), and ABILITY_TALENT_HIDDEN   etc is the desired spec.
 
You should also have a custom ALTable set up.  
 
See   wiki for details, and remember to edit it in to   GetCustomFollowerALTable below or pass it directly as an argument to   hireCustomFollower.
 
Full argument list:
 
void hireCustomFollower (
        object oFollower,   //Pass your follower object, mandatory
 
        int nForceClass,    //Pass a Class constant here, usually CLASS_ROGUE, CLASS_WARRIOR, CLASS_WIZARD.  Mandatory due to a bug.
 
        string   sPlot = "",   //It's recommended you have a plot flag to be set when   the follower joins.  Pass the plot constant here.  Remember to #include   in calling script
 
        int nPlotFlag = "",  //And then pass the flag constant.  Will be set to TRUE if available.
 
        int   nForceSpec = 0,  //This is the ID of the Specialisation you want.   Note  they are NOT classes, but abilities.  The full list is:
                             //ABILITY_SPELL_HIDDEN_ARCANE_WARRIOR,   ABILITY_SPELL_HIDDEN_BLOODMAGE, ABILITY_SPELL_HIDDEN_SHAPESHIFTER,   ABILITY_SPELL_HIDDEN_SPIRIT_HEALER
                             //ABILITY_SPELL_HIDDEN_BARD, ABILITY_TALENT_HIDDEN_ASSASSIN, ABILITY_TALENT_HIDDEN_DUELIST, ABILITY_TALENT_HIDDEN_RANGER
                             //ABILITY_TALENT_HIDDEN_BERSERKER, ABILITY_TALENT_HIDDEN_CHAMPION, ABILITY_TALENT_HIDDEN_REAVER, ABILITY_TALENT_HIDDEN_TEMPLAR
                             //I recommended forcing a spec, particularly if your ALTable includes abilities from one.
 
        int   nALTable = 0,    //This is the ID of an ALTable from 2DA_base.GDA or   your module's m2DA_base_*.GDA  I recommended the latter, but you can   edit that into GetCustomFollowerALTable below rather than passing it.
 
        int   bInvokePicker = FALSE,  //Sets whether the party picker should be   opened on hiring.  I think it's cleaner to call the picker outside this   script, particularly if you have multiple hires at once.
 
        int nInitialState = FOLLOWER_STATE_AVAILABLE,  //This sets whether the follower joins the active party or not.  Options are:
                                                       //FOLLOWER_STATE_ACTIVE (put them in the active party)
                                                       //FOLLOWER_STATE_LOCKEDACTIVE (force them into the active party and keep them there, remember to change this later.
                                                       //FOLLOWER_STATE_AVAILABLE (make them available on the party picker (if you've set it up for them), but not in the active party)
                                                       //Plus some others you're unlikely to need at this time.  Defaults to AVAILABLE because having 4+ active followers is screwy.
 
        string   sCurrPlot = "",  //If you set FOLLOWER_STATE_ACTIVE or   FOLLOWER_STATE_LOCKEDACTIVE, the script will check to see if you passed   this.
                                //It   is recommended that you have a plot flag set for a given follower  being  in the active party, this makes conversation interjection etc.  much  easier.
 
        int nCurrPlotFlag = 0,  //This flag will be set if FOLLOWER_STATE_ACTIVE or FOLLOWER_STATE_LOCKEDACTIVE are true
                                //AND sCurrPlot has a value AND nCurrPlotFlag is > 0.  
                                //ie if you added someone to the active party and have a plot flag to cope with it.
 
        int   nAutolevel = 0,     //Sets the Autolevel flag on the character sheet.   0  is off, 1 is on, 2 forces it on and removes it so the player can't  turn  it off.
 
 
        bFreeSpecPoint = TRUE,  //This grants a specialisation point to the follower if they do not have a specialisation.  
                                //It's important to set this false for classes that do not have specs, such as CLASS_DOG.
 
        int   nTargetLevel = 0,   //If you want a specific level, set this.    Generally not worthwhile unless you set it higher than the player,  since  they'll just get XP from the party picker anyway.
 
        int   nMinLevel = 0       //Set this if there's a specific level you don't   want the follower to go below.  Probably only useful if the PC might be   very low level but not necessarily so. 
 
        )
*/       
/* GetCustomFollowerALTable()  
This function is where you put your custom table assignments.
 
You   should explicitly test for the tag of your follower (not mine!) and   assign a value to nTable from your m2DA extension to M2DA_base 
 
See wiki for details on how to do this, or ignore it to get the default Warrior/Rogue/Wizard AL tables.
 
NOTE: you MUST explicitly set a table for non-Warrior/Rogue/Wizards, eg dogs.  Use TABLE_AL_DOG for a default Mabari.
*/
 
int GetCustomFollowerALTable(object oFollower)
{
    int nTable = _GetTableToUseForAL(oFollower);
    string sTag = GetTag(oFollower);
 
    if(sTag  == "bc_party_miera") 
    {               
        nTable = 50143;   
    }   
    else if(sTag == "bc_party_jysavin") 
    {
        nTable = 50144;   
    }
    else if(sTag == "bc_party_geldual") 
    {
        nTable = 50145;   
    }
    else  if(sTag == "bc_party_braghon") 
    {
        nTable = 50146;   
    }
 
    return nTable;    
}   
 
// This just cleans up the main function a little
int GetCustomFollowerTargetLevel(object oFollower, object oHero, int nPackage, int nMinLevel = 0) 
{
    int nPlayerLevel = GetLevel(oHero);
    int nTargetLevel = 0;
 
    if(nPlayerLevel >= 13 || nPlayerLevel == 1 || !_UT_GetIsPlotFollower(oFollower)) 
    {
        nTargetLevel = nPlayerLevel;
    }
    else 
    {
        nTargetLevel = nPlayerLevel + 1;
    }
 
    // If nMinLevel is not specified, checks package 2DA for a value
    if(nMinLevel == 0) 
    {
        nMinLevel = GetM2DAInt(TABLE_PACKAGES, "MinLevel", nPackage);
    }
 
    if(nMinLevel > 0 && nMinLevel > nTargetLevel) 
    {
        nTargetLevel = nMinLevel;
    }
 
    return nTargetLevel;
}   
 
// Moving this black box out :)  I don't really understand it, but it should function if you have tactics set up in a package.
 
void InitCustomFollowerTactics(object oFollower, int nPackage) 
{
         int nTableID = GetM2DAInt(TABLE_PACKAGES, "FollowerTacticsTable", nPackage);
         if (nTableID != -1)
            {
             int nRows = GetM2DARows(nTableID);
             int nMaxTactics = GetNumTactics(oFollower);
 
             int nTacticsEntry = 1;
             int i;
             for (i = 1; i <= nRows && nTacticsEntry <= nMaxTactics; ++i)
                {
                        int bAddEntry = FALSE;
                        int nTargetType = GetM2DAInt(nTableID, "TargetType", i);
                        int nCondition = GetM2DAInt(nTableID, "Condition", i);
                        int nCommandType = GetM2DAInt(nTableID, "Command", i);
                        int nCommandParam = GetM2DAInt(nTableID, "SubCommand", i);
 
                        int nUseType = GetM2DAInt(TABLE_COMMAND_TYPES, "UseType", nCommandType);
                        if (nUseType == 0)
                        {
                            bAddEntry = TRUE;
                        }
                        else
                        {
                            bAddEntry = HasAbility(oFollower, nCommandParam);
                        }
 
                        if (bAddEntry)
                        {
                            SetTacticEntry(oFollower, nTacticsEntry, TRUE, nTargetType, nCondition, nCommandType, nCommandParam);
                            ++nTacticsEntry;
                        }
                    }
                }
}  
 
/* InitCustomFollowerSpec:
 
This function tries to set the forced Specialisation.  If there is none, it checks the package for one.  
 
If there isn't either of those, it grants a free spec point if bFreeSpecPoint is true.
 
*/
 
void InitCustomFollowerSpec(object oFollower, int nPackage, int nForceSpec, int bFreeSpecPoint) {
    // Find specialization, and optionally add a spec point if none is found.
 
        if (nForceSpec == 0) {
 
        int nSpecAbility = GetM2DAInt(TABLE_PACKAGES, "switch1_class", nPackage); // followers can have only 1 advanced class
         if(nSpecAbility > 0)
         {
          AddAbility(oFollower, nSpecAbility);
         } else {
             if (bFreeSpecPoint) {
                 SetCreatureProperty(oFollower, 38, 1.00);
             }
         }                    
 
        } else {
 
             AddAbility(oFollower, nForceSpec);
 
        }
}
 
/* hireCustomFollower()  (See doco at top of page)
 
I strongly suggest you reorder the parameters if you're adding many followers with advanced options.
 
Feel free to leave them alone if you only want to set class, plot, spec or don't mind long declarations.
 
Note nForceClass is currently compulsory due to flakiness with GetCreatureCoreClass()
*/
 
void hireCustomFollower(object oFollower, int nForceClass, string sPlot = "", int nPlotFlag = 0, int nForceSpec = 0, 
int nALTable = 0, int bInvokePicker = FALSE, int nInitialState = FOLLOWER_STATE_AVAILABLE, string sCurrPlot = "", 
int nCurrPlotFlag = 0, int nAutolevel = 0, int bFreeSpecPoint = TRUE, int nTargetLevel = 0, int nMinLevel = 0) 
{
 
        object oHero = GetHero();
 
        /* #################  BEGIN BASIC FOLLOWER JOIN BLOCK   ###################
 
        This loosely replicates WR_SetFollowerState.
 
 
        */    
 
        if (nForceClass == 0) {
            nForceClass = GetCreatureCoreClass(oFollower);           //This is not working.  Hence nForceClass mandatory.
        }
 
 
        SetGroupId(oFollower, GetGroupId(oHero));      //Puts the follower in the pc's Group.
        SetEventScript(oFollower, RESOURCE_SCRIPT_PLAYER_CORE);  //This makes them act like a player.
        SetFollowerState(oFollower, nInitialState);  //This sets whether they are available, in the active party etc.
 
        /* #################  END BASIC FOLLOWER JOIN BLOCK ##################### */
 
 
 
        /* #################  BEGIN PLAYER_CORE EVENT_TYPE_PARTY_MEMBER_HIRED EMULATION #################
         This   replicates the EVENT_TYPE_PARTY_MEMBER_HIRED handler from player_core,   stripped down for simplicity and allowing our custom options.
 
 
        */
 
        Chargen_EnableTacticsPresets(oFollower);    //I assume this is important.
 
        SetLocalInt(oFollower, FOLLOWER_SCALED, 1);  //This should prevent the follower being rescaled by player_core or what have you
 
        int nPackage = GetPackage(oFollower);  //Gets the package, which will be used to find a number of 2DA IDs.
        int nPackageClass = GetM2DAInt(TABLE_PACKAGES, "StartingClass", nPackage);  //I don't think this is used, even by player_core
 
 
        // set behavior according to package
        int nBehavior = GetM2DAInt(TABLE_PACKAGES, "FollowerBehavior", nPackage);
 
        if(nBehavior >= 0) {
            SetAIBehavior(oFollower, nBehavior);
        }
 
        Chargen_InitializeCharacter(oFollower);      //We initialise the follower and choose race/class.
 
        Chargen_SelectRace(oFollower,GetCreatureRacialType(oFollower));
        Chargen_SelectCoreClass(oFollower,nForceClass);        
 
 
         if (nTargetLevel == 0) {   //This block picks a target level if not specified
 
              nTargetLevel = GetCustomFollowerTargetLevel(oFollower, oHero, nPackage, nMinLevel);
         }
 
         int nXp = RW_GetXPNeededForLevel(Max(nTargetLevel, 1));      //Here is where the XP is calculated and rewarded
         RewardXP(oFollower, nXp, FALSE, FALSE);
 
         // -------------------------------------------------------------
         // add hidden approval talents - (JN: I don't know how to set these yet, but when I figure it out this should make it work)
         // -------------------------------------------------------------
         int nIndex = Approval_GetFollowerIndex(oFollower);
         Approval_AddFollowerBonusAbility(nIndex, 0);
 
          //Handle Specialisation
          InitCustomFollowerSpec(oFollower, nPackage, nForceSpec, bFreeSpecPoint);
 
         // -------------------------------------------------------------
         // This spends all available attribute and stat points on the
         // creature according to the levelup table.  (JN:  this replicates AL_DoAutoLevelUp but with our choice of table)
         // -------------------------------------------------------------
 
         if (nALTable == 0) {
            nALTable = GetCustomFollowerALTable(oFollower);
         }
 
         AL_SpendAttributePoints(oFollower, nALTable, FALSE);
         AL_SpendSkillPoints(oFollower, nALTable, TRUE);
         AL_SpendSpecializationPoints(oFollower, nALTable);
         AL_SpendTalentSpellPoints(oFollower, nALTable, TRUE);
 
        // -------------------------------------------------------------------------
        // Update various UIs
        // -------------------------------------------------------------------------
        Chargen_SetNumTactics(oFollower);
        SetCanLevelUp(oFollower,Chargen_HasPointsToSpend(oFollower));
 
        // load tactics
         InitCustomFollowerTactics(oFollower, nPackage);
 
         /* #################  END PLAYER_CORE EVENT_TYPE_PARTY_MEMBER_HIRED EMULATION ################# */     
 
 
         SetAutoLevelUp(oFollower, nAutolevel);         //This is the autolevel flag on the character sheet.
 
         //Set plot flags
 
         if (!((sPlot == "") || (nPlotFlag == 0))) {           //Joined Party
            WR_SetPlotFlag(sPlot, nPlotFlag, TRUE);   
         }
 
         if ((nInitialState == FOLLOWER_STATE_ACTIVE) || (nInitialState == FOLLOWER_STATE_LOCKEDACTIVE)) {
            if (!((sCurrPlot == "") || (nCurrPlotFlag == 0))) {
                WR_SetPlotFlag(sCurrPlot, nCurrPlotFlag, TRUE);   //Currently in Party
            }
         }
 
        // Invoke picker if requested.
 
        if (bInvokePicker) {
             SetPartyPickerGUIStatus(2);
             ShowPartyPickerGUI();
        }
}

int GetCustomFollowerALTable(object oFollower) {
    int nTable = _GetTableToUseForAL(oFollower);
 
    if (GetTag(oFollower) == "bc_party_miera") {               
        nTable = 50143;   
    }   
 
    if (GetTag(oFollower) == "bc_party_jysavin") {
        nTable = 50144;   
    }
 
    if (GetTag(oFollower) == "bc_party_geldual") {
        nTable = 50145;   
    }
 
    if (GetTag(oFollower) == "bc_party_braghon") {
        nTable = 50146;   
    }
 
    return nTable;    
 
}

#include "plt_bc_create_party"   //Make sure you include your party handling plot
#include "hireCustomFollower_h"  // And include the function script - which will in turn include a bunch of stuff
 
void main() {
 
                    //Initialising my objects, not super-relevant to the example 
 
                    object oHero = GetHero();
                    object oMiera = CreateObject(OBJECT_TYPE_CREATURE, R"bc_party_miera.utc", GetLocation(oHero));
                    object oJysavin = CreateObject(OBJECT_TYPE_CREATURE, R"bc_party_jysavin.utc", GetLocation(oHero));
                    object oBraghon = CreateObject(OBJECT_TYPE_CREATURE, R"bc_party_braghon.utc", GetLocation(oHero));
                    object oSpider = CreateObject(OBJECT_TYPE_CREATURE, R"bc_party_geldual.utc", GetLocation(oHero));
 
                    //Simplest hire call - adds to the party as a wizard.  Class is currently compulsory due to a bug.
                    hireCustomFollower(oMiera, CLASS_WIZARD);
 
                    //Add to the party and set joining plot flags
                    hireCustomFollower(oJysavin, CLASS_WARRIOR, PLT_BC_CREATE_PARTY, PARTY_JYSAVIN_JOINED);
 
                    //Add to the party, set plot flags, force a specialisation
                    hireCustomFollower(oBraghon, CLASS_ROGUE, PLT_BC_CREATE_PARTY, PARTY_BRAGHON_JOINED, ABILITY_TALENT_HIDDEN_ASSASSIN);
 
                    //More complex example - Follower added as a unique class (Dog), not granted a specialisation or spec point.  
                    //Note unique classes must have an ALTable passed here or specified in GetCustomFollowerALTable() or they won't work
                    hireCustomFollower(oSpider,   CLASS_DOG, PLT_BC_CREATE_PARTY, PARTY_GELDUAL_JOINED, 0, 0, FALSE,   FOLLOWER_STATE_AVAILABLE, "", 0, 0, FALSE);
 
                    //Show the party picker to let the player choose from their new companions!
                    SetPartyPickerGUIStatus(2);
                    ShowPartyPickerGUI();                                                                                                                        
}

// Party member id (e.g. 1=Alicia, 2=Godwin...)
int zzzPartyMemberID(object oPartyMember)
{
  string sPartyMember = GetTag(oPartyMember);
 
  if (sPartyMember == "zzzcr_alicia") return 1;
  if (sPartyMember == "zzzcr_godwin") return 2;
  if (sPartyMember == "zzzcr_harold") return 3;
  if (sPartyMember == "zzzcr_lara"  ) return 4;
  return 0;
}

// PARTY HIRE PLOT SCRIPT
//
// This is called in conversation when a party member is hired for the first time.
// If the party is full, the party picker is displayed, which forces the PARTYMEMBER_ADDED
// module event.
//
// The flag value is never referenced, because the code is common for all party members.
 
#include "events_h"
#include "global_objects_h"
#include "utility_h"
#include "sys_rewards_h"
#include "log_h"
#include "utility_h"
#include "wrappers_h"
#include "plot_h"
 
#include "zzz_h"                  // A header containing the zzzPartyMemberID function
#include "plt_zzzpt_hired"
#include "plt_zzzpt_party"
 
int StartingConditional()
{
    event  eParms             = GetCurrentEvent();
    int    nType              = GetEventType(eParms);       // GET or SET
    string strPlot            = GetEventString(eParms, 0);  // Plot GUID
    int    nFlag              = GetEventInteger(eParms, 1); // Plot flag
    object oParty             = GetEventCreator(eParms);    // Plot table owner
    object oFollower          = GetEventObject(eParms, 0);  // Conversation owner (if any)
    int    nPlotType          = GetEventInteger(eParms, 5); // Plot type
 
    int    bIsTutorial        = GetM2DAInt(TABLE_PLOT_TYPES, "IsTutorial", nPlotType);
    int    bIsCodex           = GetM2DAInt(TABLE_PLOT_TYPES, "IsCodex", nPlotType);
 
    int    nResult            = FALSE;                      // return value for DEFINED GET
    object oPC                = GetPartyLeader();
 
    plot_GlobalPlotHandler(eParms); // any global plot operations, including debug info
 
    if (nType == EVENT_TYPE_SET_PLOT) // actions -> normal flags only
    {
        int nValue    = GetEventInteger(eParms, 2); // 0=Clear 1=Set
        int nOldValue = GetEventInteger(eParms, 3); // Current flag value
 
        if (nValue)
          {
            if (GetArraySize(GetPartyList(oPC)) < 4)
              {
                // Code from UT_HireFollower with level up bug fixed
                SetAutoLevelUp(oFollower, 2);
                SetGroupId(oFollower, GetGroupId(GetHero()));
                WR_SetFollowerState(oFollower, FOLLOWER_STATE_ACTIVE, TRUE, 0, FALSE);  
                // End of code from UT_HireFollower
                AddCommand(oFollower, CommandJumpToLocation(GetLocation(GetHero())));
                WR_SetPlotFlag(PLT_ZZZPT_PARTY, zzzPartyMemberID(oFollower), TRUE);
              }
            else
              {
                WR_SetFollowerState(oFollower, FOLLOWER_STATE_AVAILABLE, FALSE);
                SetEventScript(oFollower, RESOURCE_SCRIPT_PLAYER_CORE);
                SendPartyMemberHiredEvent(oFollower, TRUE);
//                SetPartyPickerGUIStatus(PP_GUI_STATUS_USE);
//                ShowPartyPickerGUI();
              }
          }
     }
     else // EVENT_TYPE_GET_PLOT -> defined conditions only
     {
        switch(nFlag)
        {
 
        }
    }
 
    plot_OutputDefinedFlag(eParms, nResult);
    return nResult;
}