Add player_hevsentence

Author: FreeSlave

dlls/player.cpp

@@ -7599,6 +7599,62 @@ class CPlayerSpeed : public CPointEntity
 
 LINK_ENTITY_TO_CLASS( player_speed, CPlayerSpeed )
 
+#define SF_PLAYER_HEVSENTENCE_QUEUE (1 << 1)
+
+class CPlayerHevSentence : public CPointEntity
+{
+public:
+	void Use(CBaseEntity *pActivator, CBaseEntity *pCaller, USE_TYPE useType, float value)
+	{
+		CBasePlayer* pPlayer = g_pGameRules->EffectivePlayer(pActivator);
+		if (!pPlayer)
+			return;
+
+		if (FStringNull(pev->message))
+		{
+			pPlayer->SetSuitUpdate(nullptr, false, 0);
+			return;
+		}
+
+		const char* message = STRING(pev->message);
+		if (FBitSet(pev->spawnflags, SF_PLAYER_HEVSENTENCE_QUEUE))
+		{
+			int noRepeat = pev->impulse;
+			if (*message == '!')
+			{
+				pPlayer->SetSuitUpdate(message, false, noRepeat);
+			}
+			else
+			{
+				pPlayer->SetSuitUpdate(message, true, noRepeat);
+			}
+		}
+		else
+		{
+			if (*message == '!')
+			{
+				EMIT_SOUND_SUIT(pPlayer->edict(), message);
+			}
+			else
+			{
+				EMIT_GROUPNAME_SUIT(pPlayer->edict(), message);
+			}
+		}
+	}
+	void KeyValue(KeyValueData *pkvd)
+	{
+		if (FStrEq(pkvd->szKeyName, "norepeat"))
+		{
+			pev->impulse = atoi( pkvd->szValue );
+			pkvd->fHandled = true;
+		}
+		else
+			CPointEntity::KeyValue(pkvd);
+	}
+};
+
+LINK_ENTITY_TO_CLASS( player_hevsentence, CPlayerHevSentence )
+
 static void DisableChangelevels()
 {
 	CBaseEntity* pEntity = 0;

documentation/content/docs/entity-guide/entities/player_hevsentence.md

@@ -0,0 +1,17 @@
+---
+bookHidden: true
+bookToC: false
+---
+
+# player_hevsentence
+
+Plays HEV sentence, queued or at the moment of triggering.
+
+### Parameters
+
+* `Sentence` - HEV sentence to play. Can be a group name (e.g. `HEV_MED`) or a specific sentenc name `!HEV_PISTOL`.
+* `No repeat time` - the time in seconds to not play the sentence if it was played recently. Applied only if `Queue sentence` spawnflag is set.
+
+### Spawnflags
+
+* `Queue sentence` - whether to put HEV sentence into queue instead of playing right away. This might play the sentence later if there have been other previously queued sentences.

fgd/halflife.fgd

@@ -7986,6 +7986,16 @@
 	fail_target(target_destination) : "Fail Target"
 ]
 
+@PointClass base(Targetname) = player_hevsentence : "Play HEV sentence"
+[
+	message(string) : "Sentence"
+	norepeat(integer) : "No repeat time (if queued)" : 60
+	spawnflags(flags) =
+	[
+		2 : "Queue sentence" : 1
+	]
+]
+
 @PointClass base(Targetname) size(-16 -16 -16, 16 16 16) = player_loadsaved : "Load Auto-Saved game"
 [
 	duration(string) : "Fade Duration (seconds)" : "2"