feat: dump module metadata

Author: Poggicek

src/main/appframework.cpp

@@ -183,5 +183,7 @@ void InitializeAppSystems()
 
 			fn(SCHEMASYSTEM_INTERFACE_VERSION, Interfaces::schemaSystem);
 		}
+
+		Modules::allModules.emplace_back(std::move(module));
 	}
 }

src/main/dumpers/module_metadata/module_metadata.cpp

@@ -0,0 +1,94 @@
+/**
+ * =============================================================================
+ * DumpSource2
+ * Copyright (C) 2026 ValveResourceFormat Contributors
+ * =============================================================================
+ *
+ * This program is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, version 3.0, as published by the
+ * Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "module_metadata.h"
+#include <spdlog/spdlog.h>
+#include "modules.h"
+#include "utils/module.h"
+#include "utils/common.h"
+#include "globalvariables.h"
+#include "keyvalues3.h"
+#include <unordered_set>
+
+namespace Dumpers::ModuleMetadata
+{
+
+void GetModuleMetadata(const CModule& module, SimpleCUtlString& err, SimpleCUtlString& buf)
+{
+	spdlog::info("Dumping metadata for {}", module.m_pszModule);
+
+	typedef void* (*ExtractModuleMetadata)(SimpleCUtlString& str);
+	auto extractModuleMetadataFn = module.GetSymbol<ExtractModuleMetadata>("ExtractModuleMetadata");
+
+	SimpleCUtlString additional_info;
+	auto kv3 = extractModuleMetadataFn(additional_info);
+
+	typedef int (*SaveKV3Text_ToString)(KV3ID_t const&, void* kv3, SimpleCUtlString& err, SimpleCUtlString& str);
+#ifdef WIN32
+	static auto saveKV3Text_ToStringFn = Modules::tier0->GetSymbol<SaveKV3Text_ToString>("?SaveKV3Text_ToString@@YA_NAEBUKV3ID_t@@PEBVKeyValues3@@PEAVCUtlString@@2I@Z");
+#else
+	static auto saveKV3Text_ToStringFn = Modules::tier0->GetSymbol<SaveKV3Text_ToString>("_Z20SaveKV3Text_ToStringRK7KV3ID_tPK10KeyValues3P10CUtlStringS6_j");
+#endif
+
+	saveKV3Text_ToStringFn(g_KV3Encoding_Text, kv3, err, buf);
+
+	if (additional_info.Get())
+		spdlog::warn("{} has additional_info {}", module.m_pszModule, additional_info.Get());
+}
+
+void Dump()
+{
+	spdlog::info("Dumping module metadata");
+	std::unordered_set<std::string> foundModules;
+	const auto outputPath = Globals::outputPath / "module_metadata";
+
+	for (const auto& module : Modules::allModules)
+	{
+		SimpleCUtlString err, buf;
+		GetModuleMetadata(module, err, buf);
+
+		if (buf.Get())
+		{
+			auto sanitizedModuleName = std::string(module.m_pszModule);
+			std::replace(sanitizedModuleName.begin(), sanitizedModuleName.end(), '/', '_');
+			foundModules.insert(sanitizedModuleName);
+
+
+			if (!std::filesystem::is_directory(outputPath) && !std::filesystem::create_directory(outputPath))
+			{
+				spdlog::error("Failed to create module_metadata directory");
+				return;
+			}
+
+			std::ofstream output((outputPath / sanitizedModuleName).replace_extension(".kv3"));
+			output << buf.Get() << std::endl;
+		}
+	}
+
+	for (const auto& typeScopePath : std::filesystem::directory_iterator(outputPath))
+	{
+		if (foundModules.find(typeScopePath.path().stem().string()) == foundModules.end())
+		{
+			spdlog::info("Removing orphan metadata file {}", typeScopePath.path().generic_string());
+			std::filesystem::remove(typeScopePath.path());
+		}
+	}
+}
+
+} // namespace Dumpers::ModuleMetadata

src/main/dumpers/module_metadata/module_metadata.h

@@ -0,0 +1,26 @@
+/**
+ * =============================================================================
+ * DumpSource2
+ * Copyright (C) 2026 ValveResourceFormat Contributors
+ * =============================================================================
+ *
+ * This program is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, version 3.0, as published by the
+ * Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#pragma once
+
+namespace Dumpers::ModuleMetadata
+{
+
+void Dump();
+
+} // namespace Dumpers::ModuleMetadata

src/main/dumpers/schemas/metadata_stringifier.cpp

@@ -32,18 +32,7 @@
 #include <modules.h>
 #include <vector>
 #include <regex>
-
-class SimpleCUtlString
-{
-public:
-	const char* Get()
-	{
-		return m_pString;
-	}
-
-private:
-	const char* m_pString = nullptr;
-};
+#include "utils/common.h"
 
 namespace Dumpers::Schemas
 {

src/main/main.cpp

@@ -18,7 +18,6 @@
  */
 
 #include "main.h"
-#include "utils/common.h"
 #include "interfaces.h"
 #include "globalvariables.h"
 #include "appframework.h"
@@ -27,7 +26,8 @@
 
 #include "dumpers/concommands/concommands.h"
 #include "dumpers/schemas/schemas.h"
-#include <modules.h>
+#include "dumpers/module_metadata/module_metadata.h"
+
 #include <fmt/format.h>
 
 void Usage()
@@ -84,6 +84,7 @@ int main(int argc, char** argv)
 
 	Dumpers::ConCommands::Dump();
 	Dumpers::Schemas::Dump();
+	Dumpers::ModuleMetadata::Dump();
 
 	std::ofstream file(Globals::outputPath / ".stringsignore");
 	file << Globals::stringsIgnoreStream.str();

src/main/modules.h

@@ -20,9 +20,11 @@
 
 #include <memory>
 #include "utils/module.h"
+#include <vector>
 
 namespace Modules
 {
+inline std::vector<CModule> allModules;
 
 inline std::unique_ptr<CModule> schemaSystem = nullptr;
 inline std::unique_ptr<CModule> tier0 = nullptr;

src/main/utils/common.cpp

@@ -1,3 +1,4 @@
+#include "common.h"
 #include <cstdarg>
 #include <stdlib.h>
 #include <stdio.h>
@@ -7,6 +8,10 @@
 #include "utlbuffer.h"
 #include <spdlog/spdlog.h>
 
+const char* SimpleCUtlString::Get() {
+	return m_pString;
+}
+
 void ExitError(const char* pMsg, ...)
 {
 	static char szBuffer[2048];

src/main/utils/common.h

@@ -1,7 +1,17 @@
+#pragma once
 #ifdef _WIN32
 #define PLATFORM_FOLDER "win64"
 #else
 #define PLATFORM_FOLDER "linuxsteamrt64"
 #endif
 
-void ExitError(const char* pMsg, ...);
+void ExitError(const char* pMsg, ...);
+
+class SimpleCUtlString
+{
+public:
+	const char* Get();
+
+private:
+	const char* m_pString = nullptr;
+};

src/main/utils/module.h

@@ -186,9 +186,13 @@ class CModule
 	}
 
 	template <typename T>
-	T GetSymbol(const char* name)
+	T GetSymbol(const char* name) const
 	{
-		return (T)dlsym(m_hModule, name);
+		auto ptr = (T)dlsym(m_hModule, name);
+		if (!ptr)
+			ExitError("Could not find %s in %s", name, m_pszModule);
+
+		return ptr;
 	}
 #ifdef _WIN32
 	void InitializeSections();