Expose FindMap/ResolveFuzzyMapName to plugins.

core/HalfLife2.cpp

@@ -1208,53 +1208,73 @@ const char *CHalfLife2::GetEntityClassname(CBaseEntity *pEntity)
 	return *(const char **)(((unsigned char *)pEntity) + offset);
 }
 
-#if SOURCE_ENGINE >= SE_LEFT4DEAD
-static bool ResolveFuzzyMapName(const char *fuzzyName, char *outFullname, int size)
+#if SOURCE_ENGINE != SE_TF2
+enum eFindMapResult {
+	eFindMap_Found,
+	eFindMap_NotFound,
+	eFindMap_FuzzyMatch,
+	eFindMap_NonCanonical,
+	eFindMap_PossiblyAvailable
+};
+#endif
+
+eFindMapResult CHalfLife2::FindMap(char *pMapName, int nMapNameMax)
 {
+#if SOURCE_ENGINE >= SE_LEFT4DEAD
+	static char mapNameTmp[PLATFORM_MAX_PATH];
+	g_SourceMod.Format(mapNameTmp, sizeof(mapNameTmp), "maps%c%s.bsp", PLATFORM_SEP_CHAR, pMapName);
+	if (filesystem->FileExists(mapNameTmp, "GAME"))
+	{
+		// If this is already an exact match, don't attempt to autocomplete it further (de_dust -> de_dust2).
+		// ... but still check that map file is actually valid.
+		// We check FileExists first to avoid console message about IsMapValid with invalid map.
+		return engine->IsMapValid(pMapName) == 0 ? eFindMap_NotFound : eFindMap_Found;
+	}
+
 	static ConCommand *pHelperCmd = g_pCVar->FindCommand("changelevel");
+	
+	// This shouldn't happen.
 	if (!pHelperCmd || !pHelperCmd->CanAutoComplete())
-		return false;
+	{
+		return engine->IsMapValid(pMapName) == 0 ? eFindMap_NotFound : eFindMap_Found;
+	}
 
 	static size_t helperCmdLen = strlen(pHelperCmd->GetName());
 
 	CUtlVector<CUtlString> results;
-	pHelperCmd->AutoCompleteSuggest(fuzzyName, results);
+	pHelperCmd->AutoCompleteSuggest(pMapName, results);
 	if (results.Count() == 0)
-		return false;
+		return eFindMap_NotFound;
 
 	// Results come back as you'd see in autocomplete. (ie. "changelevel fullmapnamehere"),
 	// so skip ahead to start of map path/name
 
 	// Like the engine, we're only going to deal with the first match.
 
-	strncopy(outFullname, &results[0][helperCmdLen + 1], size);
-
-	return true;
-}
+	bool bExactMatch = Q_strcmp(pMapName, &results[0][helperCmdLen + 1]) == 0;
+	if (bExactMatch)
+	{
+		return eFindMap_Found;
+	}
+	else
+	{
+		strncopy(pMapName, &results[0][helperCmdLen + 1], nMapNameMax);
+		return eFindMap_FuzzyMatch;
+	}
+#elif SOURCE_ENGINE == SE_TF2
+	return engine->FindMap(pMapName, nMapNameMax);
+#else
+	return engine->IsMapValid(pMapName) == 0 ? eFindMap_NotFound : eFindMap_Found;
 #endif
+}
 
 bool CHalfLife2::IsMapValid(const char *map)
 {
 	if (!map || !map[0])
 		return false;
-
-	bool ret;
-#if SOURCE_ENGINE == SE_TF2
-	char szTmp[PLATFORM_MAX_PATH];
+	
+	static char szTmp[PLATFORM_MAX_PATH];
 	strncopy(szTmp, map, sizeof(szTmp));
-	ret = engine->FindMap(szTmp, sizeof(szTmp)) != eFindMap_NotFound;
-#else
-	ret = engine->IsMapValid(map);
-#if SOURCE_ENGINE >= SE_LEFT4DEAD
-	if (!ret)
-	{
-		static char szFuzzyName[PLATFORM_MAX_PATH];
-		if (ResolveFuzzyMapName(map, szFuzzyName, sizeof(szFuzzyName)))
-		{
-			ret = engine->IsMapValid(szFuzzyName);
-		}
-	}
-#endif
-#endif // SE_TF2
-	return ret;
+
+	return FindMap(szTmp, sizeof(szTmp)) != eFindMap_NotFound;
 }

core/HalfLife2.h

@@ -129,6 +129,10 @@ public:
 #endif
 };
 
+// See TF2 eiface.h for description.
+// Not yet in other games, but eventually in others on same branch.
+enum eFindMapResult : int;
+
 class CHalfLife2 : 
 	public SMGlobalClass,
 	public IGameHelpers
@@ -174,6 +178,7 @@ public: //IGameHelpers
 	const char *GetEntityClassname(edict_t *pEdict);
 	const char *GetEntityClassname(CBaseEntity *pEntity);
 	bool IsMapValid(const char *map);
+	eFindMapResult FindMap(char *pMapName, int nMapNameMax);
 public:
 	void AddToFakeCliCmdQueue(int client, int userid, const char *cmd);
 	void ProcessFakeCliCmdQueue();

core/smn_halflife.cpp

@@ -67,6 +67,16 @@ static cell_t IsMapValid(IPluginContext *pContext, const cell_t *params)
 	return g_HL2.IsMapValid(map);
 }
 
+static cell_t FindMap(IPluginContext *pContext, const cell_t *params)
+{
+	char *pMapname;
+	pContext->LocalToString(params[1], &pMapname);
+		
+	cell_t size = params[2];
+	
+	return g_HL2.FindMap(pMapname, size);
+}
+
 static cell_t IsDedicatedServer(IPluginContext *pContext, const cell_t *params)
 {
 	return engine->IsDedicatedServer();
@@ -626,6 +636,7 @@ REGISTER_NATIVES(halflifeNatives)
 	{"GetRandomInt",			GetRandomInt},
 	{"IsDedicatedServer",		IsDedicatedServer},
 	{"IsMapValid",				IsMapValid},
+	{"FindMap",					FindMap},
 	{"SetFakeClientConVar",		SetFakeClientConVar},
 	{"SetRandomSeed",			SetRandomSeed},
 	{"PrecacheModel",			PrecacheModel},

plugins/include/halflife.inc

@@ -91,6 +91,26 @@ enum EngineVersion
 	Engine_BlackMesa,			/**< Black Mesa Multiplayer */
 };
 
+enum FindMapResult
+{
+	// A direct match for this name was found
+	FindMap_Found,
+	// No match for this map name could be found.
+	FindMap_NotFound,
+	// A fuzzy match for this mapname was found and pMapName was updated to the full name.
+	// Ex: cp_dust -> cp_dustbowl
+	// Supported on many newer games.
+	FindMap_FuzzyMatch,
+	// A match for this map name was found, and the map name was updated to the canonical version of the
+	// name.
+	// Ex: workshop/1234 -> workshop/cp_qualified_name.ugc1234
+	// Only supported on "Orangebox" games with workshop support.
+	FindMap_NonCanonical,
+	// No currently available match for this map name could be found, but it may be possible to load
+	// Only supported on "Orangebox" games with workshop support.
+	FindMap_PossiblyAvailable
+};
+
 #define INVALID_ENT_REFERENCE 0xFFFFFFFF
 
 /**
@@ -136,6 +156,17 @@ native GetRandomInt(nmin, nmax);
  */
 native bool:IsMapValid(const String:map[]);
 
+/**
+ * Returns whether a full or partial map name is found or can be resolved
+ * 
+ * @param map 			Map path relative to maps/ folder, excluding .bsp extension.
+ *						If result is FindMap_FuzzyMatch or FindMap_NonCanonical,
+						this will be updated to the full path.
+ * @param maxlen		Maximum length to write to map var.
+ * @return				Result of the find operation. Not all result types are supported on all games.
+ */
+native FindMapResult FindMap(char[] map, int maxlen);
+
 /**
  * Returns whether the server is dedicated.
  *

plugins/testsuite/findmap.sp

@@ -0,0 +1,31 @@
+#include <sourcemod>
+
+public void OnPluginStart()
+{
+	RegServerCmd("test_findmap", test_findmap);
+}
+
+public Action test_findmap( int argc )
+{
+	char mapName[PLATFORM_MAX_PATH];
+	GetCmdArg(1, mapName, sizeof(mapName));
+	
+	char resultName[16];
+	switch (FindMap(mapName, sizeof(mapName)))
+	{
+	case FindMap_Found:
+		strcopy(resultName, sizeof(resultName), "Found");
+	case FindMap_NotFound:
+		strcopy(resultName, sizeof(resultName), "NotFound");
+	case FindMap_FuzzyMatch:
+		strcopy(resultName, sizeof(resultName), "FuzzyMatch");
+	case FindMap_NonCanonical:
+		strcopy(resultName, sizeof(resultName), "NonCanonical");
+	case FindMap_PossiblyAvailable:
+		strcopy(resultName, sizeof(resultName), "PossiblyAvailable");
+	}
+	
+	PrintToServer("FindMap says %s - \"%s\"", resultName, mapName);
+	
+	return Plugin_Handled;
+}