source-engine/game/shared/baseachievement.h
FluorescentCIAAfricanAmerican 3bf9df6b27 1
2020-04-22 12:56:21 -04:00

271 lines
11 KiB
C++

//========= Copyright Valve Corporation, All rights reserved. ============//
//
// Purpose:
//
//=============================================================================
#ifndef BASEACHIEVEMENT_H
#define BASEACHIEVEMENT_H
#ifdef _WIN32
#pragma once
#endif
#include "GameEventListener.h"
#include "hl2orange.spa.h"
#include "iachievementmgr.h"
class CAchievementMgr;
//
// Base class for achievements
//
class CBaseAchievement : public CGameEventListener, public IAchievement
{
DECLARE_CLASS_NOBASE( CBaseAchievement );
public:
CBaseAchievement();
virtual ~CBaseAchievement();
virtual void Init() {}
virtual void ListenForEvents() {};
virtual void Event_EntityKilled( CBaseEntity *pVictim, CBaseEntity *pAttacker, CBaseEntity *pInflictor, IGameEvent *event );
int GetAchievementID() { return m_iAchievementID; }
void SetAchievementID( int iAchievementID ) { m_iAchievementID = iAchievementID; }
void SetName( const char *pszName ) { m_pszName = pszName; }
const char *GetName() { return m_pszName; }
const char *GetStat() { return m_pszStat?m_pszStat:GetName(); }
void SetFlags( int iFlags );
int GetFlags() { return m_iFlags; }
void SetGoal( int iGoal ) { m_iGoal = iGoal; }
int GetGoal() { return m_iGoal; }
void SetGameDirFilter( const char *pGameDir );
bool HasComponents() { return ( m_iFlags & ACH_HAS_COMPONENTS ) > 0; }
void SetPointValue( int iPointValue ) { m_iPointValue = iPointValue; }
int GetPointValue() { return m_iPointValue; }
bool ShouldHideUntilAchieved() { return m_bHideUntilAchieved; }
void SetHideUntilAchieved( bool bHide ) { m_bHideUntilAchieved = bHide; }
void SetStoreProgressInSteam( bool bStoreProgressInSteam ) { m_bStoreProgressInSteam = bStoreProgressInSteam; }
bool StoreProgressInSteam() { return m_bStoreProgressInSteam; }
virtual bool ShouldShowProgressNotification() { return true; }
virtual void OnPlayerStatsUpdate() {}
virtual bool ShouldSaveWithGame();
bool ShouldSaveGlobal();
virtual void PreRestoreSavedGame();
virtual void PostRestoreSavedGame();
void SetCount( int iCount ) { m_iCount = iCount; }
int GetCount() { return m_iCount; }
void SetProgressShown( int iProgressShown ) { m_iProgressShown = iProgressShown; }
int GetProgressShown() { return m_iProgressShown; }
virtual bool IsAchieved() { return m_bAchieved; }
virtual bool IsActive();
virtual bool LocalPlayerCanEarn( void ) { return true; }
void SetAchieved( bool bAchieved ) { m_bAchieved = bAchieved; }
virtual bool IsMetaAchievement() { return false; }
virtual bool AlwaysListen() { return false; }
virtual bool AlwaysEnabled() { return false; }
//=============================================================================
// HPE_BEGIN:
// [pfreese] Notification method for derived classes
//=============================================================================
virtual void OnAchieved() {}
uint32 GetUnlockTime() const { return m_uUnlockTime; }
void SetUnlockTime( uint32 unlockTime ) { m_uUnlockTime = unlockTime; }
//=============================================================================
// HPE_END
//=============================================================================
uint64 GetComponentBits() { return m_iComponentBits; }
void SetComponentBits( uint64 iComponentBits );
void OnComponentEvent( const char *pchComponentName );
void EnsureComponentBitSetAndEvaluate( int iBitNumber );
void EvaluateIsAlreadyAchieved();
virtual void OnMapEvent( const char *pEventName );
virtual void PrintAdditionalStatus() {} // for debugging, achievements may report additional status in achievement_status concmd
virtual void OnSteamUserStatsStored() {}
virtual void UpdateAchievement( int nData ) {}
virtual bool ShouldShowOnHUD() { return m_bShowOnHUD; }
virtual void SetShowOnHUD( bool bShow );
//=============================================================================
// HPE_BEGIN:
// [pfreese] Serialization methods
//=============================================================================
virtual void GetSettings( KeyValues* pNodeOut ); // serialize
virtual void ApplySettings( /* const */ KeyValues* pNodeIn ); // unserialize
//=============================================================================
// HPE_END
//=============================================================================
virtual void Think( void ) { return; }
const char *GetMapNameFilter( void ){ return m_pMapNameFilter; }
CAchievementMgr *GetAchievementMgr( void ){ return m_pAchievementMgr; }
protected:
virtual void FireGameEvent( IGameEvent *event );
virtual void FireGameEvent_Internal( IGameEvent *event ) {};
void SetVictimFilter( const char *pClassName );
void SetAttackerFilter( const char *pClassName );
void SetInflictorFilter( const char *pClassName );
void SetInflictorEntityNameFilter( const char *pEntityName );
void SetMapNameFilter( const char *pMapName );
void SetComponentPrefix( const char *pPrefix );
void IncrementCount( int iOptIncrement = 0 );
void EvaluateNewAchievement();
void AwardAchievement();
void ShowProgressNotification();
void HandleProgressUpdate();
virtual void CalcProgressMsgIncrement();
void SetNextThink( float flThinkTime );
void ClearThink( void );
void SetStat( const char* pStatName ) { m_pszStat = pStatName; }
const char *m_pszName; // name of this achievement
const char *m_pszStat; // stat this achievement uses
int m_iAchievementID; // ID of this achievement
int m_iFlags; // ACH_* flags for this achievement
int m_iGoal; // goal # of steps to award this achievement
int m_iProgressMsgIncrement; // after how many steps show we show a progress notification
int m_iProgressMsgMinimum; // the minimum progress needed before showing progress notification
int m_iPointValue; // # of points this achievement is worth (currently only used for XBox Live)
bool m_bHideUntilAchieved; // should this achievement be hidden until achieved?
bool m_bStoreProgressInSteam; // should incremental progress be stored in Steam. A counter with same name as achievement must be set up in Steam.
const char *m_pInflictorClassNameFilter; // if non-NULL, inflictor class name to filter with
const char *m_pInflictorEntityNameFilter; // if non-NULL, inflictor entity name to filter with
const char *m_pVictimClassNameFilter; // if non-NULL, victim class name to filter with
const char *m_pAttackerClassNameFilter; // if non-NULL, attacker class name to filter with
const char *m_pMapNameFilter; // if non-NULL, map name to filter with
const char *m_pGameDirFilter; // if non-NULL, game dir name to filter with
const char **m_pszComponentNames;
int m_iNumComponents;
const char *m_pszComponentPrefix;
int m_iComponentPrefixLen;
bool m_bAchieved; // is this achievement achieved
uint32 m_uUnlockTime; // time_t that this achievement was unlocked (0 if before Steamworks unlock time support)
int m_iCount; // # of steps satisfied toward this achievement (only valid if not achieved)
int m_iProgressShown; // # of progress msgs we've shown
uint64 m_iComponentBits; // bitfield of components achieved
CAchievementMgr *m_pAchievementMgr; // our achievement manager
bool m_bShowOnHUD; // if set, the player wants this achievement pinned to the HUD
friend class CAchievementMgr;
public:
DECLARE_DATADESC();
};
class CFailableAchievement : public CBaseAchievement
{
DECLARE_CLASS( CFailableAchievement, CBaseAchievement );
public:
CFailableAchievement();
void SetFailed();
virtual bool ShouldSaveWithGame();
virtual void PreRestoreSavedGame();
virtual void PostRestoreSavedGame();
virtual bool IsAchieved() { return !m_bFailed && BaseClass::IsAchieved(); }
virtual bool IsActive() { return m_bActivated && !m_bFailed && BaseClass::IsActive(); }
bool IsFailed() { return m_bFailed; }
virtual void OnMapEvent( const char *pEventName );
virtual void OnActivationEvent() { Activate(); }
virtual void OnEvaluationEvent();
virtual const char *GetActivationEventName() =0;
virtual const char *GetEvaluationEventName() =0;
protected:
void Activate();
bool m_bActivated; // are we activated? (If there is a map event that turns us on, has that happened)
bool m_bFailed; // has this achievement failed
public:
DECLARE_DATADESC();
};
class CMapAchievement : public CBaseAchievement
{
virtual void Init()
{
SetFlags( ACH_LISTEN_MAP_EVENTS | ACH_SAVE_GLOBAL );
SetGoal( 1 );
}
};
//----------------------------------------------------------------------------------------------------------------
class CAchievement_AchievedCount : public CBaseAchievement
{
public:
void Init();
virtual void OnSteamUserStatsStored( void );
virtual bool IsMetaAchievement() { return true; }
int GetLowRange() { return m_iLowRange; }
int GetHighRange() { return m_iHighRange; }
int GetNumRequired() { return m_iNumRequired; }
protected:
void SetAchievementsRequired( int iNumRequired, int iLowRange, int iHighRange );
private:
int m_iNumRequired;
int m_iLowRange;
int m_iHighRange;
};
//
// Helper class for achievement creation
//
typedef CBaseAchievement* (*achievementCreateFunc) (void);
class CBaseAchievementHelper
{
public:
CBaseAchievementHelper( achievementCreateFunc createFunc )
{
m_pfnCreate = createFunc;
m_pNext = s_pFirst;
s_pFirst = this;
}
achievementCreateFunc m_pfnCreate;
CBaseAchievementHelper *m_pNext;
static CBaseAchievementHelper *s_pFirst;
};
#define DECLARE_ACHIEVEMENT_( className, achievementID, achievementName, gameDirFilter, iPointValue, bHidden ) \
static CBaseAchievement *Create_##className( void ) \
{ \
CBaseAchievement *pAchievement = new className( ); \
pAchievement->SetAchievementID( achievementID ); \
pAchievement->SetName( achievementName ); \
pAchievement->SetPointValue( iPointValue ); \
pAchievement->SetHideUntilAchieved( bHidden ); \
if ( gameDirFilter ) pAchievement->SetGameDirFilter( gameDirFilter ); \
return pAchievement; \
}; \
static CBaseAchievementHelper g_##className##_Helper( Create_##className );
#define DECLARE_ACHIEVEMENT( className, achievementID, achievementName, iPointValue ) \
DECLARE_ACHIEVEMENT_( className, achievementID, achievementName, NULL, iPointValue, false )
#define DECLARE_MAP_EVENT_ACHIEVEMENT_( achievementID, achievementName, gameDirFilter, iPointValue, bHidden ) \
class CAchievement##achievementID : public CMapAchievement {}; \
DECLARE_ACHIEVEMENT_( CAchievement##achievementID, achievementID, achievementName, gameDirFilter, iPointValue, bHidden ) \
#define DECLARE_MAP_EVENT_ACHIEVEMENT( achievementID, achievementName, iPointValue ) \
DECLARE_MAP_EVENT_ACHIEVEMENT_( achievementID, achievementName, NULL, iPointValue, false )
#define DECLARE_MAP_EVENT_ACHIEVEMENT_HIDDEN( achievementID, achievementName, iPointValue ) \
DECLARE_MAP_EVENT_ACHIEVEMENT_( achievementID, achievementName, NULL, iPointValue, true )
#endif // BASEACHIEVEMENT_H