Release v1.1.0 +semver: minor

.github/workflows/build.yml

@@ -64,7 +64,7 @@ jobs:
     - name: Install dependencies
       run: |
         apt-get update
-        apt install libreadline-dev
+        apt install -y libreadline-dev
     - name: Checkout repository and submodules
       uses: actions/checkout@v4
       with:
@@ -88,6 +88,11 @@ jobs:
       with:
         name: swiftlys2_linux
         path: build/package/addons
+    - name: Upload tracer as artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: swiftlys2_linux_tracer
+        path: tracer/libsw2tracer.so
 
   windows_core:
     needs: versioning
@@ -118,6 +123,11 @@ jobs:
       with:
         name: swiftlys2_windows_pdb
         path: build/windows/x64/release/swiftlys2.pdb
+    - name: Upload tracer as artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: swiftlys2_windows_tracer
+        path: tracer/sw2tracer.dll
 
   linux_loader:
     needs: versioning
@@ -221,7 +231,16 @@ jobs:
       with:
         name: swiftlys2_loader_windows_pdb
         path: ./server.pdb
-
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: swiftlys2_linux_tracer
+        path: ./libsw2tracer.so
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: swiftlys2_windows_tracer
+        path: ./sw2tracer.dll
     - name: Download artifacts
       uses: actions/download-artifact@v4
       with:
@@ -253,6 +272,9 @@ jobs:
         cp -r ./swiftlys2.pdb/swiftlys2.pdb ${{ env.WINDOWS_FOLDER }}/swiftlys2/bin/win64/
         cp -r ./server.pdb/server.pdb ${{ env.WINDOWS_FOLDER }}/swiftlys2/bin/win64/
 
+        cp -r ./libsw2tracer.so/libsw2tracer.so ${{ env.LINUX_FOLDER }}/swiftlys2/bin/linuxsteamrt64/libsw2tracer.so
+        cp -r ./sw2tracer.dll/sw2tracer.dll ${{ env.WINDOWS_FOLDER }}/swiftlys2/bin/win64/sw2tracer.dll
+
         mkdir -p ${{ env.LINUX_FOLDER }}/swiftlys2/plugins/
         mkdir -p ${{ env.LINUX_FOLDER }}/swiftlys2/plugins/disabled
         mkdir -p ${{ env.WINDOWS_FOLDER }}/swiftlys2/plugins/

.gitmodules

@@ -5,3 +5,9 @@
 	path = vendor/s2sdk
 	url = https://github.com/swiftly-solution/s2sdk
 	branch = cs2
+[submodule "vendor/breakpad"]
+	path = vendor/breakpad
+	url = https://github.com/google/breakpad
+[submodule "vendor/third_party/lss"]
+	path = vendor/third_party/lss
+	url = https://chromium.googlesource.com/linux-syscall-support

LICENSE

@@ -643,7 +643,7 @@ state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
     SwiftlyS2 is a scripting framework for Source2-based games.
-    Copyright (C) 2025 Swiftly Solution SRL via Sava Andrei-Sebastian and it's contributors
+    Copyright (C) 2023-2026 Swiftly Solution SRL via Sava Andrei-Sebastian and it's contributors
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -663,7 +663,7 @@ Also add information on how to contact you by electronic and paper mail.
   If the program does terminal interaction, make it output a short
 notice like this when it starts in an interactive mode:
 
-    SwiftlyS2 Copyright (C) 2025 Swiftly Solution SRL via Sava Andrei-Sebastian
+    SwiftlyS2 Copyright (C) 2023-2026 Swiftly Solution SRL via Sava Andrei-Sebastian
     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
     This is free software, and you are welcome to redistribute it
     under certain conditions; type `show c' for details.

LICENSE.MIT

@@ -1,6 +1,17 @@
+SwiftlyS2 is licensed under the GNU General Public License, version 3. 
+
+As a special exception to the GNU General Public License 3.0, the license 
+holder permits licensing of DERIVATIVE WORKS ONLY (that is, SwiftlyS2 
+plugins, or any software built referencing published .NET packages) 
+under the MIT license.
+
+The licensed is reproduced below.
+
+----------------------------------------------------------------------------------------------
+
 MIT License
 
-Copyright (c) 2025 Swiftly Solution SRL via Sava Andrei-Sebastian and it's contributors
+Copyright (c) 2023-2026 Swiftly Solution SRL via Sava Andrei-Sebastian and it's contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

generator/docs_generator/generator.py

@@ -19,11 +19,108 @@ def escape_generics(text):
 
 
 def fix_html_for_jsx(text):
-    """Fix HTML attributes for JSX compatibility."""
+    """Convert HTML to Markdown for MDX compatibility."""
     if not text:
         return text
-    # Replace class= with className=
-    return text.replace('class=', 'className=')
+
+    # Convert pre/code blocks to markdown code fences first
+    def convert_code_block(match):
+        lang = ''
+        lang_match = re.search(r'class(?:Name)?="lang-(\w+)"', match.group(0))
+        if lang_match:
+            lang = lang_match.group(1)
+        code_match = re.search(r'<code[^>]*>(.*?)</code>', match.group(0), re.DOTALL)
+        if code_match:
+            content = code_match.group(1)
+            content = content.replace('&gt;', '>').replace('&lt;', '<').replace('&amp;', '&')
+            return f'\n\n```{lang}\n{content}\n```\n\n'
+        return match.group(0)
+    text = re.sub(r'<pre><code[^>]*>.*?</code></pre>', convert_code_block, text, flags=re.DOTALL)
+
+    # Convert inline code tags to backticks
+    text = re.sub(r'<code>(.*?)</code>', r'`\1`', text)
+
+    # Remove XML doc tags like <param>, <returns>, <typeparam>, etc.
+    text = re.sub(r'<param\s+name="([^"]+)">(.*?)</param>', r'- `\1`: \2', text)
+    text = re.sub(r'<typeparam\s+name="([^"]+)">(.*?)</typeparam>', r'- `\1`: \2', text)
+    text = re.sub(r'<returns>(.*?)</returns>', r'Returns: \1', text)
+    text = re.sub(r'<see\s+cref="([^"]+)"\s*/>', r'`\1`', text)
+    text = re.sub(r'<seealso\s+cref="([^"]+)"\s*/>', r'`\1`', text)
+
+    # Fix HTML entities
+    text = text.replace('&gt;', '>').replace('&lt;', '<').replace('&amp;', '&')
+
+    # Convert HTML lists to Markdown lists
+    if '<ul>' in text or '<li>' in text:
+        # Process nested lists
+        def convert_list(html):
+            result = []
+            depth = 0
+            parts = re.split(r'(</?(?:ul|li)>)', html)
+            current = ''
+            for part in parts:
+                if part == '<ul>':
+                    depth += 1
+                elif part == '</ul>':
+                    depth = max(0, depth - 1)
+                elif part == '<li>':
+                    current = ''
+                elif part == '</li>':
+                    if current.strip():
+                        indent = '  ' * max(0, depth - 1)
+                        result.append(f'{indent}- {current.strip()}')
+                    current = ''
+                else:
+                    current += part
+            return '\n'.join(result)
+        text = convert_list(text)
+
+    # Convert p tags to paragraphs
+    def convert_p(match):
+        content = match.group(1)
+        # Don't collapse if contains code block
+        if '```' in content:
+            return f'{content.strip()}\n\n'
+        # Collapse whitespace for regular text
+        content = ' '.join(content.split())
+        return f'{content}\n\n'
+    text = re.sub(r'<p>\s*(.*?)\s*</p>', convert_p, text, flags=re.DOTALL)
+
+    # Clean up extra newlines
+    text = re.sub(r'\n{3,}', '\n\n', text)
+
+    return text.strip()
+
+
+def convert_xref_tags(text):
+    """Convert DocFX <xref> tags to plain text or links."""
+    if not text:
+        return text
+
+    import urllib.parse
+
+    def replace_xref(match):
+        href = match.group(1)
+        # Parse the href to extract type and text
+        if '?' in href:
+            type_name, query = href.split('?', 1)
+            params = urllib.parse.parse_qs(query)
+            display_text = params.get('text', [type_name])[0]
+            display_text = urllib.parse.unquote_plus(display_text)
+        else:
+            type_name = href
+            display_text = type_name
+
+        # Create link for System types to Microsoft docs
+        if type_name.startswith('System.'):
+            url = f"https://learn.microsoft.com/dotnet/api/{type_name.lower()}"
+            return f"[{display_text}]({url})"
+
+        return display_text
+
+    # Match <xref href="..." ...></xref> or <xref href="..." ... />
+    pattern = r'<xref\s+href="([^"]+)"[^>]*(?:></xref>|/>)'
+    return re.sub(pattern, replace_xref, text)
 
 
 def escape_generics_in_link_text(text):
@@ -155,14 +252,14 @@ def generate_markdown(yaml_data):
                     md += f"**{fact_name}**: {fact_value}\n\n"
 
         if 'markdown' in item:
-            md += f"{item['markdown']}\n\n"
+            md += f"{fix_html_for_jsx(item['markdown'])}\n\n"
 
         if 'h2' in item:
             md += f"## {item['h2']}\n\n"
 
         if 'h4' in item:
             h4_text = item['h4']
-            if h4_text in ['Parameters', 'Returns', 'Field Value', 'Property Value']:
+            if h4_text in ['Parameters', 'Returns', 'Field Value', 'Property Value', 'Type Parameters', 'Exceptions', 'Remarks', 'Event Type']:
                 md += f"<ApiLabel>{h4_text}</ApiLabel>\n\n"
             else:
                 md += f"#### {h4_text}\n\n"
@@ -229,7 +326,8 @@ def generate_markdown(yaml_data):
         if 'api3' in item:
             src = item.get('src', '')
             api3_title = str(item.get('api3', ''))
-            api3_title = re.sub(r'<[^>]+>', '', api3_title)
+            # Escape generics for markdown heading (use backslash)
+            api3_title = api3_title.replace('<', '\\<').replace('>', '\\>')
             api3_title = re.sub(r'\[[^\]]+\]', '', api3_title)
             md += f"### {api3_title}\n\n"
             if src != '':
@@ -272,31 +370,35 @@ def convert_yaml_file(src_path, dest_path):
         os.makedirs(folder_path, exist_ok=True)
 
     md_content = md_content.replace('/api/shared', '/api').replace('/api/core', '/api')
+    md_content = convert_xref_tags(md_content)
+    # Escape < followed by numbers (like <1000) which MDX interprets as JSX tags
+    md_content = re.sub(r'<(\d)', r'\\<\1', md_content)
 
     with open(final_path, 'w', encoding='utf-8') as f:
         f.write(md_content)
 
 
-for root, dirs, files in os.walk(SOURCE_DIR):
-    for file in files:
-        if file.endswith(".yml") or file.endswith(".yaml"):
-            raw_base = os.path.splitext(file)[0]
-            for prefix in ["SwiftlyS2.Core.", "SwiftlyS2.Shared.", "SwiftlyS2."]:
-                if raw_base.startswith(prefix):
-                    raw_base = raw_base[len(prefix):]
-                    break
-            new_base = transform_filename(raw_base)
-            dest_file = os.path.join(DEST_DIR, "/".join(new_base.split(".")).lower() + ".mdx")
-            convert_yaml_file(os.path.join(root, file), dest_file)
-
-script_dir = os.path.dirname(os.path.abspath(__file__))
-index_source = os.path.join(script_dir, "index.mdx")
-index_dest = os.path.join(DEST_DIR, "index.mdx")
-
-if os.path.exists(index_source):
-    shutil.copy2(index_source, index_dest)
-    print(f"Copied index.mdx to {index_dest}")
-else:
-    print(f"Warning: index.mdx not found at {index_source}")
-
-print("MDX generation complete!")
+if __name__ == "__main__":
+    for root, dirs, files in os.walk(SOURCE_DIR):
+        for file in files:
+            if file.endswith(".yml") or file.endswith(".yaml"):
+                raw_base = os.path.splitext(file)[0]
+                for prefix in ["SwiftlyS2.Core.", "SwiftlyS2.Shared.", "SwiftlyS2."]:
+                    if raw_base.startswith(prefix):
+                        raw_base = raw_base[len(prefix):]
+                        break
+                new_base = transform_filename(raw_base)
+                dest_file = os.path.join(DEST_DIR, "/".join(new_base.split(".")).lower() + ".mdx")
+                convert_yaml_file(os.path.join(root, file), dest_file)
+
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    index_source = os.path.join(script_dir, "index.mdx")
+    index_dest = os.path.join(DEST_DIR, "index.mdx")
+
+    if os.path.exists(index_source):
+        shutil.copy2(index_source, index_dest)
+        print(f"Copied index.mdx to {index_dest}")
+    else:
+        print(f"Warning: index.mdx not found at {index_source}")
+
+    print("MDX generation complete!")

generator/native_generator/main.py

@@ -103,7 +103,6 @@ def parse_native(lines: list[str]):
     writer.add_line()
 
     def write_class_content():
-        writer.add_line("private static int _MainThreadID;")
 
         for raw_line in native_lines:
             if raw_line.strip() == "":
@@ -156,7 +155,7 @@ def write_class_content():
 
             def write_method_content():
                 if is_marked_sync:
-                    writer.add_block("if (Thread.CurrentThread.ManagedThreadId != _MainThreadID)", lambda: writer.add_line('throw new InvalidOperationException("This method can only be called from the main thread.");'))
+                    writer.add_block("if (!NativeBinding.IsMainThread)", lambda: writer.add_line('throw new InvalidOperationException("This method can only be called from the main thread.");'))
 
                 string_params = []
                 bytes_params = []