GameState: Expose GetPlayerFailType() to Lua

FailType for a given Player can be overriden with respect to preferences, but
Lua has no way to check it. Expose a function to allow doing that, in order to
not accidentally submit invalid scores to GrooveStats.

Docs/Luadoc/Lua.xml

@@ -926,6 +926,7 @@
 			<Function name='GetNumStagesLeft'/>
 			<Function name='GetPlayMode'/>
 			<Function name='GetPlayerDisplayName'/>
+			<Function name='GetPlayerFailType'/>
 			<Function name='GetPlayerState'/>
 			<Function name='GetPreferredDifficulty'/>
 			<Function name='GetPreferredSong'/>

Docs/Luadoc/LuaDocumentation.xml

@@ -3151,6 +3151,9 @@ end
 	<Function name='GetPlayerDisplayName' return='string' arguments='PlayerNumber pn'>
 		Returns the display name for player <code>pn</code>.
 	</Function>
+	<Function name='GetPlayerFailType' return='FailType' arguments='PlayerNumber pn' since='ITGmania 1.0.0'>
+		Returns the effective <Link class='ENUM' function='FailType' /> for player <code>pn</code>.
+	</Function>
 	<Function name='GetPlayerState' return='PlayerState' arguments='PlayerNumber pn'>
 		Returns the PlayerState for player <code>pn</code>.
 	</Function>