Add map history and history-based exclusions

Add support for history-based map/group exclusions and a map-history command.

- Introduces two ConVars: multimode_vote_default_groupexclude and multimode_vote_default_mapexclude to provide default behavior when vote calls pass -1.
- Adds utility helpers in utils.inc: MMC_KeyIsSubgroupOfBase, MMC_ResolveVoteGroupExclude, MMC_ResolveVoteMapExclude.
- Adds vote-history helpers in multimode_core.sp: VoteHistory_IsGroupRecentlyPlayed, VoteHistory_IsMapRecentlyPlayed, VoteHistory_MapEverPlayed and integrates them into native checks and vote preparation routines so maps/groups are correctly excluded based on recent play history and resolved ConVar defaults.
- Adds console commands multimode_maphistory and sm_maphistory to list played maps per group/subgroup.
- Fixes include documentation text for groupexclude/mapexclude.
- Compiled plugin binary (multimode_core.smx) updated.

These changes ensure votes respect configurable recent-play exclusions and provide an admin-visible history of played maps.

Author: TheDGB

addons/sourcemod/plugins/multimode_core.smx

@@ -56,8 +56,8 @@ typedef VoteCancelCallback = function void ();
  * @param timestep            Amount of time to extend the time limit when "Extend Map" is selected.
  * @param fragstep            Amount of frag limit to extend when "Extend Map" is selected.
  * @param roundstep           Amount of round limit to extend when "Extend Map" is selected.
- * @param groupexclude        Determines if a previously played group can appear in the vote. (-1 = Use default config)
- * @param mapexclude          Determines if a previously played map can appear in the vote. (-1 = Use default config)
+ * @param groupexclude        Determines if a previously played group can appear in the vote. (-1 uses core ConVar multimode_vote_default_mapexclude. 0 = Off.)
+ * @param mapexclude          Determines if a previously played map can appear in the vote. (-1 uses core ConVar multimode_vote_default_groupexclude. 0 = Off.)
  * @param handlenominations   Specifies how nominations should be handled. (1 - Handle player's nominations, 0 - Do not handle player's nominations)
  * @param threshold           Percentage required for a vote to win.
  * @param maxRunoffs          Maximum number of runoff votes allowed. (0 = No limit)

addons/sourcemod/scripting/include/multimode.inc

@@ -69,6 +69,37 @@ stock KeyValues MMC_GetMapCycle()
     return kv;
 }
 
+stock bool MMC_KeyIsSubgroupOfBase(const char[] key, const char[] baseGroup)
+{
+    int bl = strlen(baseGroup);
+    if (bl == 0 || strlen(key) < bl + 2)
+        return false;
+    if (key[bl] != '/')
+        return false;
+    char buf[128];
+    strcopy(buf, sizeof(buf), key);
+    buf[bl] = '\0';
+    return StrEqual(buf, baseGroup);
+}
+
+stock int MMC_ResolveVoteGroupExclude(int raw)
+{
+    if (raw != -1)
+        return (raw < 0) ? 0 : raw;
+    ConVar cv = FindConVar("multimode_vote_default_groupexclude");
+    int v = (cv != null) ? cv.IntValue : 0;
+    return (v < 0) ? 0 : v;
+}
+
+stock int MMC_ResolveVoteMapExclude(int raw)
+{
+    if (raw != -1)
+        return (raw < 0) ? 0 : raw;
+    ConVar cv = FindConVar("multimode_vote_default_mapexclude");
+    int v = (cv != null) ? cv.IntValue : 0;
+    return (v < 0) ? 0 : v;
+}
+
 stock bool MMC_IsWildcardEntry(const char[] mapname)
 {
     int len = strlen(mapname);