CompatLib

CompatLib is a library designed to streamline mod compatibility by providing a structured approach to detect and manage interactions between various mods. This library offers utilities to check for the presence of specific mods, retrieve mod versions, and register compatibility handlers that ensure seamless integration simplifying the process for mod developers to ensure their mods work harmoniously with others, enhancing the overall modding experience.

Discuss CompatLib: Vintage Story Discord CompatLib mod thread

---

Key Features:

• Mod Detection: Check if specific mods are installed and retrieve their versions.
• Compatibility Management: Register and process compatibility handlers for mods.
• Conflict Tracking: Detect and log compatibility conflicts dynamically.
• Server & Client Commands: In-game commands for debugging compatibility issues.
  - Client-side command: .compatlog
  - Server-side command: /compatlog
• Thread Safety: Utilizes thread-safe operations to ensure data integrity in multithreaded environments.
• Dynamic Handler Control: Enable or disable specific handlers at runtime for flexible compatibility management.
• Version Compatibility Checks: Ensure handlers are compatible with specific mod versions to prevent conflicts.
• User Feedback Mechanism: Inform users about active handlers and detected conflicts, enhancing transparency.
• JSON Export for Compatibility Logs: Export compatibility logs in a structured JSON format for easier debugging and analysis.
• Logging Granularity: Introduced different log levels (INFO, WARNING, ERROR) to categorize messages, allowing for more granular control over logging output.

---

Installation Instructions (Dependency for other mods):

1. Download CompatLib: Ensure you have the correct version of CompatLib the mod is using as a dependency and that they are compatible with your Vintage Story game version.

2. Add to Mods Folder: Place the CompatLib .zip file into your Vintage Story Mods directory.

3. Launch the Game: Start Vintage Story, and CompatLib will be automatically recognized and integrated.

---

For Developers:

To utilize CompatLib in your mod development, follow these steps:

1. Download CompatLib: Get the latest release.

2. Add to Project: Include the CompatLib DLL in your mod's project references.

3. Namespace Inclusion: Add the CompatLib namespace in your code:
   
   using CompatLib;


4. Initialization: Initialize CompatLib within your mod's main class by extending ModSystem:
   
   using Vintagestory.API.Common;

   namespace YourModNamespace
   {
       public class YourModSystem : ModSystem
       {
           public override void Start(ICoreAPI api)
           {
               base.Start(api);
               // Initialize CompatLib
               api.Logger.Notification("YourMod initialized with CompatLib support.");
           }
       }
   }