Let TTTLastWordsMsg hook override default behaviour (#1784)

from Facepunch/garrysmod#2227

---------

Co-authored-by: Tim Goll <github@timgoll.de>

Author: wgetJane

CHANGELOG.md

@@ -9,6 +9,7 @@ All notable changes to TTT2 will be documented here. Inspired by [keep a changel
 - Added C4 cvars for adjusting the range & falloff of C4 explosions (by @Spanospy)
   - C4 explosions will now also respect the weapon's configured damage scaling
 - Added option to select preferred unit of length for distance displays (by @wgetJane)
+- Added `GM:TTTLastWordsMsg` hook from base TTT (Facepunch/garrysmod/pull/2227, by @wgetJane)
 - Port new TTT entity ttt_filter_role to TTT2 (Facepunch/garrysmod/pull/2225 by @figardo, ported by @wgetJane)
 
 ### Changed

gamemodes/terrortown/gamemode/server/sv_gamemsg.lua

@@ -426,10 +426,16 @@ local function LastWordsMsg(ply, words)
     -- add optional context relating to death type
     local context = LastWordContext[ply.death_type] or ""
 
-    net.Start("TTT_LastWordsMsg")
-    net.WritePlayer(ply)
-    net.WriteString(words .. (final and "" or "--") .. context)
-    net.Broadcast()
+    local lastWordsStr = words .. (final and "" or "--") .. context
+
+    ---
+    -- @realm server
+    if hook.Run("TTTLastWordsMsg", ply, lastWordsStr, words) ~= true then
+        net.Start("TTT_LastWordsMsg")
+        net.WritePlayer(ply)
+        net.WriteString(lastWordsStr)
+        net.Broadcast()
+    end
 end
 
 local function deathrec(ply, cmd, args)
@@ -552,6 +558,16 @@ concommand.Add("_ttt_radio_send", ttt_radio_send)
 -- @realm server
 function GM:TTTPlayerRadioCommand(ply, msgName, msgTarget) end
 
+---
+-- Called when a player tries to speak their last words on death
+-- @param Player ply The player that is sending their last words
+-- @param string msg The last words that is about to be sent
+-- @param string msgOriginal The original unmodified message
+-- @return[default=nil] boolean Return true to block last words
+-- @hook
+-- @realm server
+function GM:TTTLastWordsMsg(ply, msg, msgOriginal) end
+
 ---
 -- Whether or not the @{Player} can receive the chat message.
 -- @param Player reader The @{Player} who can receive chat