CSMAPI_functions.h

Go to the documentation of this file.

/*
  Cavestory Multiplayer API
  Copyright (C) 2021 Johnny Ledger
 
  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.
 
  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:
 
  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.
*/
 
#pragma once
#include <CSMAPI_begincode.h>
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Logging
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void CSM_Log_EnableStackLines
(
    bool bEnable
);
 
extern CAVESTORY_MOD_API void CSM_Log
(
    const char* pFormat,
    ...
);
 
extern CAVESTORY_MOD_API void CSM_LogInfo
(
    const char* pCategory,
    const char* pFormat,
    ...
);
 
extern CAVESTORY_MOD_API void CSM_LogColor
(
    unsigned int iColor = 0xFFFFFFFF
);
 
extern CAVESTORY_MOD_API void __CSM__LogError
(
    const char* pSourceFile,
    int         iSourceLineNo,
    const char* pCategory,
    const char* pFormat,
    ...
);
 
extern CAVESTORY_MOD_API void __CSM__LogWarn
(
    const char* pSourceFile,
    int         iSourceLineNo,
    const char* pCategory,
    const char* pFormat,
    ...
);
 
#define CSM_LogError(pCategory, pFormat, ...) CSM_LogInfo(pCategory, "\v08" pFormat, __VA_ARGS__)
 
#define CSM_LogWarn(pCategory, pFormat, ...) CSM_LogInfo(pCategory, "\v0B" pFormat, __VA_ARGS__)
 
#define CSM_LogErrorWithInfo(pCategory, pFormat, ...) __CSM__LogError(__FILE__, __LINE__, pCategory, pFormat, __VA_ARGS__)
 
#define CSM_LogWarnWithInfo(pCategory, pFormat, ...) __CSM__LogWarn(__FILE__, __LINE__, pCategory, pFormat, __VA_ARGS__)
 
extern CAVESTORY_MOD_API void CSM_LogInfoNoNL
(
    const char* pCategory,
    const char* pFormat,
    ...
);
 
extern CAVESTORY_MOD_API void CSM_Explode
(
    int iErrorCode,
    const char* pErrorName,
    const char* pTitle = "\\a{0} crashed!",
    const char* pMessage = "The mod's DLL has crashed!",
    bool bGenerateCrashLog = true
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Dedicated Server Commands
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API int CSM_DediServer_RunCommand
(
    const char* pFormat,
    ...
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Platform Passthrough
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API bool CSM_Platform_GetGameFilePath
(
    const char* pDesiredSubpath,
    const char* pFileName,
    char* pOutputFilePath,
    char* pOutputFileName,
    const char* pFileNameFormat = "*.*",
    void* pModPointer = NULL
);
 
extern CAVESTORY_MOD_API void CSM_Platform_GetProgramMode
(
    CSM_ProgramMode* eModePtr
);
 
extern CAVESTORY_MOD_API BOOL CSM_Platform_IsProgramMode
(
    CSM_ProgramMode eMode
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Function Management
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API BOOL CSM_FindNetScoreType
(
    const char*                                 pName,
    CaveNet::DataStructures::NetScoreType**     pOut
);
 
extern CAVESTORY_MOD_API BOOL CSM_FindNetScoreTypeByHash
(
    unsigned int                                iNameHash,
    CaveNet::DataStructures::NetScoreType** pOut
);
 
extern CAVESTORY_MOD_API BOOL CSM_RegisterNetScoreType
(
    const char*                             pName,
    const char*                             pUIFormat,
    const char*                             pUIDynamicFormat,
    unsigned long long int                  iMaskBits   = 0,
    unsigned long long int                  iFlags      = 0,
    CSM_NetScore_GetScoreModifyAmount       pModifyFunc = NULL
);
 
extern CAVESTORY_MOD_API bool CSM_RegisterWeaponByName
(
    const char* pWeaponName,
    CSM_Weapon_ShootFunc pFunc
);
 
extern CAVESTORY_MOD_API bool CSM_RegisterWeapon
(
    int iWeaponIndex,
    CSM_Weapon_ShootFunc pFunc
);
 
extern CAVESTORY_MOD_API bool CSM_RegisterBullet
(
    int iBulletIndex,
    CSM_Bullet_ActFunc pFunc
);
 
extern CAVESTORY_MOD_API bool CSM_RegisterNpc
(
    int iNpcIndex,
    CSM_Npc_ActFunc pFunc
);
 
extern CAVESTORY_MOD_API int CSM_RegisterCaret
(
    CSM_Caret_ActFunc pFunc,
    int iWidth,
    int iHeight
);
 
extern CAVESTORY_MOD_API BOOL CSM_RegisterPlayerState
(
    const char* pStateName,
    unsigned long long int iFlags,
    unsigned int iTransmitFlags,
    PlayerState_ActFuncType pActFunc,
    PlayerState_AnimFuncType pAnimFunc,
    PlayerState_DrawFuncType pDrawFunc = NULL,
    int* pPlayerStateIndex = NULL,
    unsigned int iIndexOverride = 0,
    PlayerStateAnimator_OutputType iOutputType = PlayerStateAnimator_OutputType::PSAOT_PLAYER_FRAME
);
 
extern CAVESTORY_MOD_API BOOL CSM_RegisterTextScriptCommand
(
    const char* pCmdName,
    const char* pShortDesc,
    const char* pDesc,
    const char* pArgs,
    void(*pFuncPtr)(int&, int&, int&, int&, bool&, int&)
);
 
extern CAVESTORY_MOD_API void CSM_ResetNetScoreTypes
(
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Config Functions
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
typedef void(*CSM_HOOK_OnPostDrawFunc)();
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnPostDraw
(
    CSM_HOOK_OnPostDrawFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnDrawHUDFunc)(BOOL bFlash);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnDrawHUD
(
    CSM_HOOK_OnDrawHUDFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnDrawMapBackFunc)();
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnDrawMapBack
(
    CSM_HOOK_OnDrawMapBackFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnDrawMapFrontFunc)();
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnDrawMapFront
(
    CSM_HOOK_OnDrawMapFrontFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnPreDrawHUDFunc)();
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnPreDrawHUD
(
    CSM_HOOK_OnPreDrawHUDFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnDrawItemFunc)(GUI_RECT pDrawRect, MYCHAR* pMC, ITEM* pItem, int iItemIndex);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnDrawItem
(
    CSM_HOOK_OnDrawItemFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnClientDisconnectedFunc)(CaveNet::DataStructures::NetClient* pClient);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnClientDisconnected
(
    CSM_HOOK_OnClientDisconnectedFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnClientConnectedFunc)(CaveNet::DataStructures::NetClient* pClient);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnClientConnected
(
    CSM_HOOK_OnClientConnectedFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnClientSpawnFunc)(CaveNet::DataStructures::NetClient* pClient);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnClientSpawn
(
    CSM_HOOK_OnClientSpawnFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnGetTeamSpawnPointFunc)(CaveNet::DataStructures::NetTeam* pTeam, int* pSpawnX, int* pSpawnY);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnGetTeamSpawnPoint
(
    CSM_HOOK_OnGetTeamSpawnPointFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnClientDieFunc)(CaveNet::DataStructures::NetClient* pClient, PlayerDeathType iDeathType, NPCHAR* pKillerNpc, CaveNet::DataStructures::NetClient* pKillerClient);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnClientDie
(
    CSM_HOOK_OnClientDieFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnClientReviveFunc)(CaveNet::DataStructures::NetClient* pClient, CaveNet::DataStructures::NetClient* pSavior);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnClientRevive
(
    CSM_HOOK_OnClientReviveFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnStageChangeFunc)(const char* pStageName, int iAreaIndex);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnStageChange
(
    CSM_HOOK_OnStageChangeFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnPlayerPickupHeartFunc)(NPCHAR* pHeart, CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, int iHealth);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnPlayerPickupHeart
(
    CSM_HOOK_OnPlayerPickupHeartFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnPlayerPickupMissileFunc)(NPCHAR* pMissile, CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, int iAmmo);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnPlayerPickupMissile
(
    CSM_HOOK_OnPlayerPickupMissileFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnPlayerPickupExperienceFunc)(NPCHAR* pExp, CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, int iExp);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnPlayerPickupExperience
(
    CSM_HOOK_OnPlayerPickupExperienceFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnServerTickFunc)();
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnServerTick
(
    CSM_HOOK_OnServerTickFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnClientTickFunc)();
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnClientTick
(
    CSM_HOOK_OnClientTickFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnTeamAddMemberFunc)(CaveNet::DataStructures::NetClient* pClient, CaveNet::DataStructures::NetClient* pServerClient, CaveNet::DataStructures::NetTeam* pTeam);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnTeamAddMember
(
    CSM_HOOK_OnTeamAddMemberFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnTeamRemoveMemberFunc)(CaveNet::DataStructures::NetClient* pClient, CaveNet::DataStructures::NetClient* pServerClient, CaveNet::DataStructures::NetTeam* pTeam);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnTeamRemoveMember
(
    CSM_HOOK_OnTeamRemoveMemberFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnPlayerPickupNpcFunc)(CaveNet::DataStructures::NetClient* pClient, CaveNet::DataStructures::NetPlayer* pPlayer, MYCHAR* pMC, NPCHAR* pNpc);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnPlayerPickupNpc
(
    CSM_HOOK_OnPlayerPickupNpcFunc pFuncPtr
);
 
extern CAVESTORY_MOD_API void CSM_SetNpcCodeCharWhitelisted
(
    int iCodeChar,
    bool bWhitelisted
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnHitBulletMapFunc)(BULLET* pBullet);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnHitBulletMap
(
    CSM_HOOK_OnHitBulletMapFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnHitMyCharNpCharFunc)(CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, bool bNoclip);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnHitMyCharNpChar
(
    CSM_HOOK_OnHitMyCharNpCharFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnMyCharCollisionTest_NpChar)(CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, NPCHAR* pNpc, BOOL bNoclip, BOOL& bCallAgain);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnMyCharCollisionTest_NpChar
(
    int iNpcId,
    CSM_HOOK_OnMyCharCollisionTest_NpChar pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnHitMyCharMapTileFunc)(CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, int iTileX, int iTileY, int iTileAttrib, bool bNoclip);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnHitMyCharMapTile
(
    CSM_HOOK_OnHitMyCharMapTileFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnHitMyCharMapFunc)(CaveNet::DataStructures::NetClient* pClient, MYCHAR* pMC, bool bNoclip);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnHitMyCharMap
(
    CSM_HOOK_OnHitMyCharMapFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnProcessAIFunc)(CaveNet::DataStructures::NetClient* pClient, CaveNet::DataStructures::NetPlayer* pPlayer, CaveNet::DataStructures::NetTeam* pTeam);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnProcessAI
(
    CSM_HOOK_OnProcessAIFunc pFuncPtr
);
 
//-------------
 
typedef BOOL(*CSM_HOOK_OnMessageSentFunc)(CaveNet::DataStructures::NetClient* pClient, const char* pMessage);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnMessageSent
(
    CSM_HOOK_OnMessageSentFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnReceiveUserCmdFromClientFunc)(CaveNet::DataStructures::NetClient* pClient, int iArg1, int iArg2, int iArg3, int iArg4, int iArg5, int iArg6, const char* pString1);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnReceiveUserCmdFromClient
(
    CSM_HOOK_OnReceiveUserCmdFromClientFunc pFuncPtr
);
 
//-------------
 
typedef void(*CSM_HOOK_OnReceiveUserCmdFromServerFunc)(int iArg1, int iArg2, int iArg3, int iArg4, int iArg5, int iArg6, const char* pString1);
 
extern CAVESTORY_MOD_API void CSM_SetHook_OnReceiveUserCmdFromServer
(
    CSM_HOOK_OnReceiveUserCmdFromServerFunc pFuncPtr
);
 
//-------------
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Config Functions
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API bool Config_GetBool
(
    const char* pCVarName
);
 
extern CAVESTORY_MOD_API int Config_GetInt
(
    const char* pCVarName
);
 
extern CAVESTORY_MOD_API const char* Config_GetString
(
    const char* pCVarName
);
 
extern CAVESTORY_MOD_API void Config_GetColor
(
    const char* pCVarName,
    GUI_COLOR& pColor
);
 
extern CAVESTORY_MOD_API bool Config_SetValue
(
    const char* pCVarName,
    const char* pValue,
    bool bUserInput = false
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Server Functions
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API bool CSM_CaveNet_ConnectedAsClient
(
);
 
extern CAVESTORY_MOD_API bool CSM_CaveNet_IsHosting
(
);
 
extern CAVESTORY_MOD_API int CSM_CaveNet_GetClientCount
(
);
 
 
extern CAVESTORY_MOD_API int CSM_CaveNet_GetRealClientCount
(
);
 
extern CAVESTORY_MOD_API BOOL CSM_CaveNet_SendUserCmdToClient
(
    CaveNet::DataStructures::NetClient* pClient,
    int iArg1 = 0,
    int iArg2 = 0,
    int iArg3 = 0,
    int iArg4 = 0,
    int iArg5 = 0,
    int iArg6 = 0,
    const char* pString1 = NULL
);
 
extern CAVESTORY_MOD_API BOOL CSM_CaveNet_SendUserCmdToServer
(
    int iArg1 = 0,
    int iArg2 = 0,
    int iArg3 = 0,
    int iArg4 = 0,
    int iArg5 = 0,
    int iArg6 = 0,
    const char* pString1 = NULL
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Game Functions
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void CSM_Boss_ResetAllBossesHealth
(
);
 
extern CAVESTORY_MOD_API NPCHAR* CSM_Boss_GetBossNpc
(
    int iIndex
);
 
extern CAVESTORY_MOD_API int CSM_Boss_GetBossCount
(
);
 
extern CAVESTORY_MOD_API int CSM_Boss_GetCurrentBossDefaultHealth
(
);
 
extern CAVESTORY_MOD_API void CSM_Boss_SetInitHealth
(
    CSM_BossTypes iBossType,
    int iHealth
);
 
 
 
extern CAVESTORY_MOD_API BOOL CSM_Raycasting_CastRay
(
    GUI_POINT pPointStart,
    GUI_POINT pPointEnd,
    RAYCAST_QUERY* pInfo = NULL,
    bool bHitEndBlock = true,
    bool bHitStartBlock = true
);
 
extern CAVESTORY_MOD_API BOOL CSM_Raycasting_CastRay_Quick
(
    int iStartX,
    int iStartY,
    int iEndX,
    int iEndY,
    unsigned int iHitMask,
    RAYCAST_QUERY* pInfo = NULL,
    bool bHitEndBlock = true,
    bool bHitStartBlock = true
);
 
extern CAVESTORY_MOD_API void CSM_Raycasting_SetBounds
(
    GUI_RECT* pRect
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Game Functions
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void CSM_Video_SetResolution
(
    int iNewWidth,
    int iNewHeight,
    int iNewMagnification = -1
);
 
extern CAVESTORY_MOD_API void CSM_Video_GetResolution
(
    int* iWidth,
    int* iHeight
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Game Functions
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void CSM_SaveScreenshot
(
    const char* pOutputImagePath,
    GUI_RECT* pSource = NULL
);
 
extern CAVESTORY_MOD_API void CSM_SetFramerateVisible
(
    BOOL bValue
);
 
extern CAVESTORY_MOD_API BOOL CSM_IsFramerateVisible
(
);
 
extern CAVESTORY_MOD_API void CSM_PlayerState_DrawWeapon
(
    int iFrameX,
    int iFrameY,
    SafeClientInterface* pInterface,
    float fScale = 1.f
);
 
extern CAVESTORY_MOD_API void CSM_PlayerState_DrawCharacter
(
    int iFrameX,
    int iFrameY,
    SafeClientInterface* pInterface,
    float fScale = 1.f
);
 
extern CAVESTORY_MOD_API int CSM_FindPlayerAnimFrameByName
(
    const char* pName
);
 
extern CAVESTORY_MOD_API BOOL CSM_CustomPlayer_IsPixelSolid
(
    CustomPlayer* pCharacter,
    int iFrame,
    int iX,
    int iY
);
 
extern CAVESTORY_MOD_API Surface_Ids CSM_CustomPlayer_GetNormalSurfaceId
(
    CustomPlayer* pCharacter
);
 
extern CAVESTORY_MOD_API Surface_Ids CSM_CustomPlayer_GetNormalMaskSurfaceId
(
    CustomPlayer* pCharacter
);
 
extern CAVESTORY_MOD_API Surface_Ids CSM_CustomPlayer_GetFaceSurfaceId
(
    CustomPlayer* pCharacter
);
 
extern CAVESTORY_MOD_API Surface_Ids CSM_CustomPlayer_GetFaceMaskSurfaceId
(
    CustomPlayer* pCharacter
);
 
extern CAVESTORY_MOD_API void ClearValueView
(
);
 
extern CAVESTORY_MOD_API void SetValueView
(
    int* pX, int* pY, int iValue
);
 
extern CAVESTORY_MOD_API void ActValueView
(
);
 
extern CAVESTORY_MOD_API void PutValueView
(
    int iFrameX,
    int iFrameY
);
 
extern CAVESTORY_MOD_API BOOL IsNpCharInsideNpChar
(
    NPCHAR* pNpc,
    NPCHAR* pOther
);
 
extern CAVESTORY_MOD_API bool IsSpecificPlayerInsideNpChar
(
    MYCHAR* pMC,
    NPCHAR* pNpc
);
 
extern CAVESTORY_MOD_API bool IsPlayerInsideNpChar
(
    NPCHAR* pNpc
);
 
extern CAVESTORY_MOD_API bool IsFocusInsideNpChar
(
    NPCHAR* pNpc
);
 
extern CAVESTORY_MOD_API void SetQuake
(
    int iTime
);
 
extern CAVESTORY_MOD_API void SetQuake2
(
    int iTime
);
 
extern CAVESTORY_MOD_API void ResetQuake
(
);
 
extern CAVESTORY_MOD_API bool IsAgilityAllowed
(
);
 
extern CAVESTORY_MOD_API bool IsFishingAllowed
(
);
 
extern CAVESTORY_MOD_API bool IsCarryingAllowed
(
);
 
extern CAVESTORY_MOD_API void SetBullet
(
    int iBulNo,
    int iSpawnX,
    int iSpawnY,
    int iDirection,
    int iCodeArms,
    int iLevel,
    int iGhostId = 0
);
 
extern CAVESTORY_MOD_API void SetCaret
(
    int iSpawnX,
    int iSpawnY,
    int iCaretId,
    int iDirection,
    CARET** pOut = NULL
);
 
extern CAVESTORY_MOD_API void SetNpChar
(
    int iNpcId,
    int iSpawnX,
    int iSpawnY,
    int iVelocityX,
    int iVelocityY,
    int iDirection,
    NPCHAR* pNpc,
    int iStartIndex,
    NPCHAR** iOutNPC = 0,
    bool bForceSpawn = false
);
 
extern CAVESTORY_MOD_API void DeleteNpCharEvent
(
    int     iEventNo,
    BOOL    bSetFlag = TRUE
);
 
extern CAVESTORY_MOD_API void DeleteNpCharFlag
(
    int     iFlagNo,
    BOOL    bSetFlag = FALSE
);
 
extern CAVESTORY_MOD_API void DeleteNpCharCode
(
    int iCharCode,
    BOOL bSmoke,
    BOOL bSetFlag = TRUE
);
 
void CAVESTORY_MOD_API SetNpChar_Backwards(
    int iNpcId,
    int iSpawnX,
    int iSpawnY,
    int iVelocityX,
    int iVelocityY,
    int iDirection,
    NPCHAR* pNpc,
    int iStartIndex,
    NPCHAR** iOutNPC = 0,
    bool bForceSpawn = false
);
 
extern CAVESTORY_MOD_API bool SetAnimNpChar
(
    int iNpcId,
    int iVelocityX,
    int iVelocityY,
    int iDirection,
    NPCHAR* pNpc,
    int iStartIndex,
    MYCHAR* pMC,
    CustomPlayer* pCustomChar,
    NPCHAR** iOutNPC = 0
);
 
extern CAVESTORY_MOD_API void CSM_SpawnEXP
(
    int iSubPixelX,
    int iSubPixelY,
    int iAmount
);
 
extern CAVESTORY_MOD_API void CSM_SpawnHeart
(
    int iSubPixelX,
    int iSubPixelY,
    int iAmount
);
 
extern CAVESTORY_MOD_API void CSM_SpawnAmmo
(
    int iSubPixelX,
    int iSubPixelY,
    int iAmount
);
 
extern CAVESTORY_MOD_API int CountArmsBullet
(
    int iArmsCode,
    int iGhostId = -1
);
 
extern CAVESTORY_MOD_API int CountBulletNum
(
    int iBulletCode,
    int iGhostId = -1
);
 
extern CAVESTORY_MOD_API void DeleteArmBullets
(
    int iArmsCode
);
 
extern CAVESTORY_MOD_API void ClearBullet
(
);
 
extern CAVESTORY_MOD_API bool IsActiveSomeBullet
(
);
 
extern CAVESTORY_MOD_API BOOL HasArmsData
(
    long iCode
);
 
extern CAVESTORY_MOD_API BOOL AddArmsData2
(
    long iCode,
    long iNum,
    long iMaxNum,
    long iLevel
);
 
extern CAVESTORY_MOD_API BOOL UseArmsEnergy
(
    long iNum,
    ARMS* pArmsTable,
    int iSelectedIdx
);
 
extern CAVESTORY_MOD_API void ChangeToFirstArms
(
);
 
extern CAVESTORY_MOD_API MYCHAR* GetLocalPlayerCharacter
(
);
 
extern CAVESTORY_MOD_API BOOL ChargeArmsEnergy
(
    long iChargeAmt,
    ARMS* pArmsTable,
    int iSelectedWeapon
);
 
extern CAVESTORY_MOD_API void SetDestroyNpCharUp
(
    int iSpawnX,
    int iSpawnY,
    int iMaxRandomXOffset,
    int iSmokeAmt
);
 
extern CAVESTORY_MOD_API BOOL TransferDataStage
(
    int iStageNo,
    int iEventNo,
    int iSpawnX,
    int iSpawnY
);
 
extern CAVESTORY_MOD_API BOOL TransferStage
(
    int iStageNo,
    int iEventNo, 
    int iSpawnX,
    int iSpawnY
);
 
extern CAVESTORY_MOD_API BOOL TransferStage2
(
    int iStageNo,
    int iEventNo
);
 
extern CAVESTORY_MOD_API unsigned int CSM_EntProp_GetFieldNameCRC
(
    const char* pFieldName
);
 
extern CAVESTORY_MOD_API int CSM_EntProp_GetFieldIndexByCrc
(
    NPCHAR* pNpc,
    unsigned int iFieldCrc
);
 
extern CAVESTORY_MOD_API int CSM_EntProp_GetFieldIndex
(
    NPCHAR* pNpc,
    const char* pFieldName
);
 
extern CAVESTORY_MOD_API int CSM_EntProp_GetFieldValue_ScanString
(
    NPCHAR* pNpc,
    int iFieldIndex,
    const char* pFormat,
    ...
);
 
extern CAVESTORY_MOD_API char* CSM_EntProp_GetFieldValue_String
(
    NPCHAR* pNpc,
    int iFieldIndex,
    char* pOutBuffer,
    int iOutBufferSize,
    const char* pDefaultValue = ""
);
 
extern CAVESTORY_MOD_API int CSM_EntProp_GetFieldValue_Int
(
    NPCHAR* pNpc,
    int iFieldIndex,
    int iDefaultValue = 0
);
 
extern CAVESTORY_MOD_API float CSM_EntProp_GetFieldValue_Float
(
    NPCHAR* pNpc,
    int iFieldIndex,
    float fDefaultValue = 0.0f
);
 
extern CAVESTORY_MOD_API BOOL CSM_EntProp_GetFieldValue_Boolean
(
    NPCHAR* pNpc,
    int iFieldIndex,
    BOOL bDefaultValue = FALSE
);
 
extern CAVESTORY_MOD_API GUI_COLOR* CSM_EntProp_GetFieldValue_Color
(
    NPCHAR* pNpc,
    int iFieldIndex,
    GUI_COLOR* pColorPtr,
    GUI_COLOR pDefaultValue = GUI_COLOR(0, 0, 0, 0)
);
 
extern CAVESTORY_MOD_API GUI_POINT* CSM_EntProp_GetFieldValue_Point
(
    NPCHAR* pNpc,
    int iFieldIndex,
    GUI_POINT* pPointPtr,
    GUI_POINT pDefaultValue = GUI_POINT(0, 0)
);
 
extern CAVESTORY_MOD_API GUI_RECT* CSM_EntProp_GetFieldValue_Rect
(
    NPCHAR* pNpc,
    int iFieldIndex,
    GUI_RECT* pRectPtr,
    GUI_RECT pDefaultValue = GUI_RECT(0, 0, 0, 0)
);
 
extern CAVESTORY_MOD_API void CSM_Map_DeleteTile
(
    int             iX,
    int             iY,
    bool            bRecordChange        = true
);
 
extern CAVESTORY_MOD_API void CSM_Map_ShiftTileIndex
(
    int             iX,
    int             iY,
    bool            bRecordChange        = true
);
 
extern CAVESTORY_MOD_API BOOL CSM_Map_SetTileIndex
(
    int             iX,
    int             iY,
    unsigned short  iTileIndex,
    bool            bCreateSmoke         = true,
    bool            bRecordChange        = true
);
 
extern CAVESTORY_MOD_API void CSM_Map_ActAnimatedTiles
(
);
 
extern CAVESTORY_MOD_API void CSM_Map_ClearAllTileAnimations
(
    bool bForeground
);
 
extern CAVESTORY_MOD_API void CSM_Map_ClearTileAnimation
(
    bool bForeground,
    unsigned int iX,
    unsigned int iY
);
 
extern CAVESTORY_MOD_API void CSM_Map_SetTileAnimation
(
    bool bForeground,
    unsigned int iX,
    unsigned int iY,
    RECT* pRectList,
    unsigned char iRectCount,
    unsigned short iWait,
    Surface_Ids iSurfaceId = SURFACE_ID_LEVEL_TILESET
);
 
extern CAVESTORY_MOD_API TEXT_SCRIPT_PTR_DATA* GetCurrentTextScriptConfig
(
);
 
extern CAVESTORY_MOD_API void GetTextScriptPath
(
    char* pPath
);
 
extern CAVESTORY_MOD_API void SetTextScriptContext
(
    TEXT_SCRIPT_PTR_DATA* pData = &default_TextScriptPtrData
);
 
extern CAVESTORY_MOD_API BOOL StartTextScript
(
    int iEventNo,
    bool bTransmit = true,
    TEXT_SCRIPT_PTR_DATA* pData = &default_TextScriptPtrData,
    bool bUseRestrictionLevel = false,
    TextScriptTarget iTargetType = TextScriptTarget::TS_TARGET_EVERYONE,
    NPCHAR* pSourceNpc = NULL
);
 
extern CAVESTORY_MOD_API void StopTextScript
(
);
 
extern CAVESTORY_MOD_API int LoadTimeCounter
(
    const char* pFileName = "290.rec"
);
 
extern CAVESTORY_MOD_API unsigned long long int GetHellTimerGlobalTimerOffset
(
);
 
extern CAVESTORY_MOD_API void SetHellTimerGlobalTimerOffset
(
    unsigned long long int iOffset
);
 
extern CAVESTORY_MOD_API void SetHellTimerFrameCount
(
    int iFrameCount
);
 
extern CAVESTORY_MOD_API int GetHellTimerFrameCount
(
);
 
extern CAVESTORY_MOD_API void SetHellTimerMS
(
    int iTimeInMS
);
 
extern CAVESTORY_MOD_API int GetHellTimerMS
(
);
 
extern CAVESTORY_MOD_API BOOL IsProfile
(
);
 
extern CAVESTORY_MOD_API BOOL SaveProfile
(
    const char* pFileName,
    MYCHAR* pMC = NULL
);
 
extern CAVESTORY_MOD_API BOOL LoadProfile
(
    const char* pFileName,
    BOOL bDoGameFuncs = TRUE
);
 
extern CAVESTORY_MOD_API BOOL SaveProfileIntoMem
(
    PROFILE* pProfile
);
 
extern CAVESTORY_MOD_API BOOL LoadProfileFromMem
(
    PROFILE* pProfile
);
 
extern CAVESTORY_MOD_API BOOL LoadProfileIntoMem
(
    const char* pName,
    PROFILE* pProfile,
    unsigned long long* pModifyTime = NULL
);
 
extern CAVESTORY_MOD_API unsigned int CompareTileTypeXY
(
    int iX,
    int iY,
    unsigned int iTileTypes
);
 
extern CAVESTORY_MOD_API unsigned int CompareTileTypeNPC
(
    NPCHAR* pNpc,
    unsigned int iTileTypes
);
 
extern CAVESTORY_MOD_API unsigned int CompareTileType
(
    unsigned int iTileTypes,
    unsigned int iOtherTileTypes
);
 
extern CAVESTORY_MOD_API unsigned int GetTileFlagsXY
(
    int iX,
    int iY
);
 
extern CAVESTORY_MOD_API unsigned int GetTileFlagsNPC
(
    NPCHAR* pNpc
);
 
extern CAVESTORY_MOD_API void GetFramePosition
(
    int* iX,
    int* iY
);
 
extern CAVESTORY_MOD_API void SetFramePosition
(
    int iX,
    int iY
);
 
extern CAVESTORY_MOD_API void SetFadeMask
(
);
 
extern CAVESTORY_MOD_API void ClearFade
(
);
 
extern CAVESTORY_MOD_API void StartFadeOut
(
    signed char iDirect
);
 
extern CAVESTORY_MOD_API void StartFadeIn
(
    signed char iDirect
);
 
extern CAVESTORY_MOD_API void ProcFade
(
);
 
extern CAVESTORY_MOD_API void PutFade
(
);
 
extern CAVESTORY_MOD_API BOOL GetFadeActive
(
);
 
extern CAVESTORY_MOD_API BOOL IsFadedOut
(
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Extended input
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void CSM_ExtendedInput_SetKeyState
(
    CSM_SDL_Scancode iScanCode,
    BOOL bPressed
);
 
extern CAVESTORY_MOD_API BOOL CSM_ExtendedInput_GetKey
(
    CSM_SDL_Scancode iScanCode
);
 
extern CAVESTORY_MOD_API BOOL CSM_ExtendedInput_GetKeyDown
(
    CSM_SDL_Scancode iScanCode
);
 
extern CAVESTORY_MOD_API BOOL CSM_ExtendedInput_GetKeyUp
(
    CSM_SDL_Scancode iScanCode
);
 
extern CAVESTORY_MOD_API BOOL CSM_ExtendedInput_GetKeyRepeated
(
    CSM_SDL_Scancode iScanCode
);
 
extern CAVESTORY_MOD_API void CSM_ExtendedInput_ProcessFrame
(
);
 
extern CAVESTORY_MOD_API void CSM_ExtendedInput_ProcessShortcuts
(
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Input
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API int TextScriptProc
(
);
 
extern CAVESTORY_MOD_API void PutTextScript
(
);
 
 
extern CAVESTORY_MOD_API int GetKeybind
(
    CSM_KEYBIND_DESC iType
);
 
extern CAVESTORY_MOD_API int GetInput
(
    CSM_KEY_DESC iType
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Time
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API unsigned int GetTicks
(
);
 
extern CAVESTORY_MOD_API unsigned long long int CSM_GetFrameCount
(
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Math
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
#ifndef NO_WINDOWS
extern CAVESTORY_MOD_API int Random
(
    int iMin,
    int iMax
);
#endif
 
extern CAVESTORY_MOD_API int GetCos
(
    unsigned char iDeg
);
 
extern CAVESTORY_MOD_API int GetSin
(
    unsigned char iDeg
);
 
extern CAVESTORY_MOD_API unsigned char GetArktan
(
    int iX,
    int iY
);
 
extern CAVESTORY_MOD_API bool IsNpcOnScreen
(
    NPCHAR* pNpc
);
 
extern CAVESTORY_MOD_API void CSM_Npc_GetPosition
(
    NPCHAR* pNpc,
    NpcPositionType iType = NpcPositionType::NPT_DRAW_POSITION,
    int* iOutX = NULL,
    int* iOutY = NULL,
    int iFrameX = -1,
    int iFrameY = -1
);
 
extern CAVESTORY_MOD_API void CSM_Npc_SkipUpdate
(
    NPCHAR* pNpc
);
 
extern CAVESTORY_MOD_API unsigned long long int CSM_Npc_GetTransmitNodes
(
    unsigned int iCodeChar,
    int iActNo
);
 
extern CAVESTORY_MOD_API unsigned long long int CSM_Npc_GetUpdateNodes
(
    unsigned int iCodeChar,
    int iActNo
);
 
extern CAVESTORY_MOD_API void GetMyCharDrawRectangle
(
    MYCHAR* pMC,
    GUI_RECT* pOut
);
 
extern CAVESTORY_MOD_API void CSM_Weapon_GetDrawOffset
(
    MYCHAR* pMC,
    int iWeaponCode,
    GUI_POINT* pOut
);
 
extern CAVESTORY_MOD_API void CSM_Puppy_GetDrawOffset
(
    MYCHAR* pMC,
    GUI_POINT* pOut
);
 
extern CAVESTORY_MOD_API void CSM_Carry_GetDrawOffset
(
    MYCHAR* pMC,
    GUI_POINT* pOut
);
 
inline int SubpixelToScreenCoord(
    int iCoord
)
{
    return iCoord * magnification / 0x200;
}
 
inline int PixelToScreenCoord(
    int iCoord
)
{
    return iCoord * magnification;
}
 
inline int ScreenCoordToPixel(
    int iCoord
)
{
    return iCoord / magnification;
}
 
 
inline int ScreenCoordToSubPixel(
    int iCoord
)
{
    return 0x200 * iCoord / magnification;
}
 
extern CAVESTORY_MOD_API int CSM_GetWindowWidth
(
);
 
extern CAVESTORY_MOD_API int CSM_GetWindowHeight
(
);
 
extern CAVESTORY_MOD_API void CSM_SetBitmapLoadMagnification
(
    int iMagnification
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Misc
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API int OpenEscapeMenu
(
);
 
extern CAVESTORY_MOD_API int OpenOptionsMenu
(
    const char** pCategoryList = NULL,
    int iCategoryCount = 0
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// PlayerStates
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void SetPlayerState
(
    SafeClientInterface* pInterface,
    int iStateType = -1,
    bool bForce = false
);
 
extern CAVESTORY_MOD_API int GetPlayerState
(
    SafeClientInterface* pInterface
);
 
inline bool IsPlayerState(MYCHAR* pChar, int iStateType) { return pChar->netanim == iStateType; }
 
extern CAVESTORY_MOD_API unsigned int GetPlayerStateFlags
(
    MYCHAR* pChar
);
 
extern CAVESTORY_MOD_API PlayerStateAnimator_OutputType GetPlayerStateAnimatorType
(
    MYCHAR* pChar
);
 
extern CAVESTORY_MOD_API unsigned int GetPlayerStateFlagsFromCarrier
(
    MYCHAR* pChar
);
 
extern CAVESTORY_MOD_API int FindPlayerStateByName
(
    const char* pName
);
 
extern CAVESTORY_MOD_API int GetStateByUnitIndex
(
    int iUnitIndex
);
 
extern CAVESTORY_MOD_API int GetUnitIndexByState
(
    int iPlayerState
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Text Script
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void CheckNewLine
(
);
 
extern CAVESTORY_MOD_API void SetNumberTextScript
(
    int iIndex
);
 
extern CAVESTORY_MOD_API void SetCharacterNameTextScript
(
);
 
extern CAVESTORY_MOD_API void ClearTextLine
(
);
 
extern CAVESTORY_MOD_API void Server_FocusOnCurrentPlayer
(
);
 
extern CAVESTORY_MOD_API void Server_ClearFocusFromPlayer
(
);
 
extern CAVESTORY_MOD_API int GetTextScriptNo
(
    int a
);
 
extern CAVESTORY_MOD_API bool ReturnTextScript
(
);
 
extern CAVESTORY_MOD_API bool JumpTextScript
(
    int no,
    BOOL call = FALSE
);
 
extern CAVESTORY_MOD_API void ShowTextLines
(
    const char* pLine4,
    const char* pLine3,
    const char* pLine2,
    const char* pLine1
);
 
extern CAVESTORY_MOD_API void DisplayCustomTextToScript
(
    const char* pString,
    bool        bSanitize = false
);
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Flags
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
extern CAVESTORY_MOD_API void SetNPCFlag
(
    long iFlagNo,
    bool bTransmit = true
);
 
extern CAVESTORY_MOD_API void CutNPCFlag
(
    long iFlagNo,
    bool bTransmit = true
);
 
extern CAVESTORY_MOD_API BOOL GetNPCFlag
(
    long iFlagNo
);
 
extern CAVESTORY_MOD_API void SetSkipFlag
(
    long iFlagNo,
    bool bTransmit = true
);
 
extern CAVESTORY_MOD_API void CutSkipFlag
(
    long iFlagNo,
    bool bTransmit = true
);
 
extern CAVESTORY_MOD_API BOOL GetSkipFlag
(
    long iFlagNo
);
 
 
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
// Sound
//----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 
 
typedef int CSM_CustomPixToneId;
typedef int CSM_CustomSoundId;
 
extern CAVESTORY_MOD_API CSM_CustomPixToneId CSM_LoadPixTone
(
    const char* pPath
);
 
extern CAVESTORY_MOD_API CSM_CustomSoundId CSM_LoadCustomSound
(
    const char* pPath
);
 
extern CAVESTORY_MOD_API void CSM_SetCustomSoundPan
(
    CSM_CustomSoundId iSoundId,
    unsigned char iPanAmount = 50
);
 
extern CAVESTORY_MOD_API void CSM_SetCustomSoundVolume
(
    CSM_CustomSoundId iSoundId,
    unsigned char iVolume
);
 
extern CAVESTORY_MOD_API BOOL CSM_UnloadPixTone
(
    CSM_CustomPixToneId iSoundId
);
 
extern CAVESTORY_MOD_API BOOL CSM_UnloadCustomSound
(
    CSM_CustomSoundId iSoundId
);
 
extern CAVESTORY_MOD_API void CSM_Sound_Process2D
(
);
 
extern CAVESTORY_MOD_API void PlaySoundObject2D
(
    int iSubpixelX,
    int iSubpixelY,
    int iRadius,
    bool bAlwaysOnScreen,
    int iSoundIndex,
    int iPlayMode = SOUND_MODE_STOP_THEN_PLAY,
    unsigned int iPlayVolume = 0x100,
    unsigned int iFalloffRadius = 0x7FFFFFFE
);
 
extern CAVESTORY_MOD_API void CSM_Sound_SetPitch
(
    int iSoundIndex,
    unsigned short iPitch
);
 
extern CAVESTORY_MOD_API void CSM_Sound_SetPan
(
    int iSoundIndex,
    char iPan
);
 
extern CAVESTORY_MOD_API void CSM_Sound_SetVolume
(
    int iSoundIndex,
    unsigned char iVolume
);
 
extern CAVESTORY_MOD_API void PlaySoundObject
(
    int iSoundIndex,
    int iPlayMode = SOUND_MODE_STOP_THEN_PLAY,
    unsigned int iPlayVolume = 0x100
);
 
extern CAVESTORY_MOD_API BOOL IsSoundPlaying
(
    int iSoundId
);
 
extern CAVESTORY_MOD_API void ChangeMusic
(
    int iMusicIndex
);
 
extern CAVESTORY_MOD_API void PlayCustomMusic
(
    const char* pFileName
);
 
extern CAVESTORY_MOD_API void CSM_Music_SetVolume
(
    unsigned char iVolume
);
 
extern CAVESTORY_MOD_API void ReCallMusic
(
);
 
 
#include <CSMAPI_endcode.h>