From 0afbae9c65e4e037021000a0a85960c1683dde0d Mon Sep 17 00:00:00 2001
From: lamali <lamali292@gmail.com>
Date: Mon, 27 Jul 2026 12:46:18 +0200
Subject: [PATCH 1/3] Add mod credit support and custom localization for
 credits screen

---
 BaseLib/localization/eng/credits.json |   7 +
 BaseLibMain.cs                        |   3 +
 Patches/UI/NCreditsScreenPatch.cs     | 331 ++++++++++++++++++++++++++
 Utils/ModCredits.cs                   |  69 ++++++
 4 files changed, 410 insertions(+)
 create mode 100644 BaseLib/localization/eng/credits.json
 create mode 100644 Patches/UI/NCreditsScreenPatch.cs
 create mode 100644 Utils/ModCredits.cs

diff --git a/BaseLib/localization/eng/credits.json b/BaseLib/localization/eng/credits.json
new file mode 100644
index 00000000..e9cc49cf
--- /dev/null
+++ b/BaseLib/localization/eng/credits.json
@@ -0,0 +1,7 @@
+{
+  "BASELIB-BANNER.name": "— MODS —",
+  "SLAY_THE_SPIRE": "Slay the Spire 2",
+  "BASELIB-BASELIB.title": "BaseLib",
+  "BASELIB-TEAM.header": "Developer",
+  "BASELIB-TEAM.names": "Alchyr"
+}
\ No newline at end of file
diff --git a/BaseLibMain.cs b/BaseLibMain.cs
index 3b13882f..03ffb3a7 100644
--- a/BaseLibMain.cs
+++ b/BaseLibMain.cs
@@ -66,6 +66,9 @@ public static void Initialize()
         MainHarmony.TryPatchAll(assembly);
         
         CustomLocTableManager.Register("card_modifiers");
+        
+        
+        ModCredits.Register(ModId, new ModCredits.Section("TEAM"));
     }
 
     //Hopefully temporary fix for linux
diff --git a/Patches/UI/NCreditsScreenPatch.cs b/Patches/UI/NCreditsScreenPatch.cs
new file mode 100644
index 00000000..81a29ef1
--- /dev/null
+++ b/Patches/UI/NCreditsScreenPatch.cs
@@ -0,0 +1,331 @@
+using BaseLib.Utils;
+using Godot;
+using HarmonyLib;
+using MegaCrit.Sts2.addons.mega_text;
+using MegaCrit.Sts2.Core.ControllerInput;
+using MegaCrit.Sts2.Core.Nodes.CommonUi;
+using MegaCrit.Sts2.Core.Nodes.Screens.Credits;
+
+namespace BaseLib.Patches.UI;
+
+/// <summary>
+/// Single Harmony patch class for <see cref="NCreditsScreen"/>. Each hook just
+/// delegates to <see cref="CreditsNav"/>.
+/// </summary>
+[HarmonyPatch(typeof(NCreditsScreen))]
+public static class NCreditsScreenPatch
+{
+    /// <summary>Renders the modded blocks and side-nav after the screen is ready.</summary>
+    [HarmonyPatch("_Ready"), HarmonyPostfix]
+    public static void OnReady(NCreditsScreen __instance)
+        => CreditsNav.Render(__instance);
+
+    /// <summary>Redirects default focus onto the side-nav.</summary>
+    [HarmonyPatch("DefaultFocusedControl", MethodType.Getter), HarmonyPostfix]
+    public static void OnDefaultFocus(ref Control __result)
+        => CreditsNav.RedirectFocus(ref __result);
+
+    /// <summary>Cleans up the confirm binding when the screen leaves the tree.</summary>
+    [HarmonyPatch("_ExitTree"), HarmonyPostfix]
+    public static void OnExitTree()
+        => CreditsNav.RemoveBindings();
+}
+
+/// <summary>
+/// Rendering and navigation logic for the modded credits screen. Holds all the
+/// non-Harmony work: building the credit blocks, the fixed side-nav, jump-scrolling,
+/// focus seeding, and the controller confirm binding. Driven by <see cref="NCreditsScreenPatch"/>.
+/// </summary>
+internal static class CreditsNav
+{
+    private static readonly Color BannerColor   = new(1f, 0.55f, 0.20f);
+    private static readonly Color ModNameColor  = new(0.53f, 0.81f, 0.92f);
+    private static readonly Color NavColor      = new(1f, 0.965f, 0.886f);
+    private static readonly Color NavHoverColor = new(0.937f, 0.784f, 0.318f);
+
+    /// <summary>Where a jumped-to node lands, measured from the top of the screen.</summary>
+    private const float NavTopPadding = 200f;
+
+    /// <summary>Confirm actions bound while the screen is open (last-wins over the screen's blockers).</summary>
+    private static readonly string[] ConfirmActions = [MegaInput.accept, MegaInput.select];
+
+    /// <summary>First side-nav button; used to seed controller/keyboard focus.</summary>
+    private static Button? _firstNavButton;
+
+    /// <summary>Confirm binding pushed into the hotkey manager while the screen is open.</summary>
+    private static Action? _confirmBinding;
+
+    /// <summary>Focused-button → jump action, so a confirm press triggers the right entry.</summary>
+    private static readonly Dictionary<Button, Action> NavActions = [];
+
+    /// <summary>Builds the modded credit blocks and the side navigation once the screen is ready.</summary>
+    public static void Render(NCreditsScreen screen)
+    {
+        _firstNavButton = null;
+        if (ModCredits.Entries.Count == 0) return;
+
+        var margin = screen.GetNodeOrNull<Control>("%ScreenContents");
+        var vbox = margin?.GetNodeOrNull<VBoxContainer>("VBoxContainer");
+        if (margin == null || vbox == null) return;
+
+        var headerTpl = vbox.GetNodeOrNull<MegaLabel>("ModdingSupportHeader");
+        var namesTpl  = vbox.GetNodeOrNull<MegaRichTextLabel>("ModdingSupportNames");
+        var rolesCTpl = vbox.GetNodeOrNull<HBoxContainer>("zhsContainer");
+        var multiCTpl = vbox.GetNodeOrNull<HBoxContainer>("PlaytestersContainer");
+        if (headerTpl == null || namesTpl == null) return;
+
+        var anchor = vbox.GetNodeOrNull<Control>("Spacer3");
+        var at = anchor?.GetIndex() ?? vbox.GetChildCount();
+
+        // Side-nav targets: the vanilla top first, then one per mod.
+        var navTargets = new List<(string Text, Control Target)>();
+        var top = vbox.GetNodeOrNull<Control>("StS2Logo") ?? (Control)vbox.GetChild(0);
+        navTargets.Add(("Slay the Spire 2", top));
+
+        BuildHeader(vbox, ref at, ModCredits.Resolve("BASELIB-BANNER.name"), BannerColor, headerTpl, "Banner", null, 60);
+
+        var m = 0;
+        foreach (var e in ModCredits.Entries)
+        {
+            var title = ModCredits.Resolve($"{e.ModId}-{e.ModId}.title");
+            var titleNode = BuildHeader(vbox, ref at, title, ModNameColor, headerTpl, "Mod" + m, null, 44);
+            navTargets.Add((title, titleNode));
+
+            var s = 0;
+            foreach (var sec in e.Sections)
+            {
+                var tag  = "M" + m + "S" + s;
+                var head = ModCredits.Resolve(e.ModId + "-" + sec.Name.ToUpperInvariant() + ".header");
+                var body = ModCredits.Resolve(e.ModId + "-" + sec.Name.ToUpperInvariant() + ".names");
+
+                BuildHeader(vbox, ref at, head, null, headerTpl, tag + "H", 60f);
+
+                switch (sec.Kind)
+                {
+                    case ModCredits.Layout.Roles when rolesCTpl != null:
+                        BuildRoles(vbox, ref at, body, rolesCTpl, tag);
+                        break;
+                    case ModCredits.Layout.Columns3 when multiCTpl != null:
+                        BuildMulti(vbox, ref at, body, multiCTpl, tag);
+                        break;
+                    case ModCredits.Layout.Names:
+                    default:
+                        BuildNames(vbox, ref at, body, namesTpl, tag);
+                        break;
+                }
+                s++;
+            }
+            m++;
+        }
+
+        BuildSideNav(screen, margin, headerTpl, navTargets);
+    }
+
+    /// <summary>
+    /// Redirects the screen's default focus onto the side-nav, so a controller starts
+    /// on the navigation list instead of the screen root (which traps directional input).
+    /// </summary>
+    public static void RedirectFocus(ref Control result)
+    {
+        if (_firstNavButton != null && GodotObject.IsInstanceValid(_firstNavButton))
+            result = _firstNavButton;
+    }
+
+    /// <summary>Removes the confirm binding when the screen closes, so bindings don't stack.</summary>
+    public static void RemoveBindings()
+    {
+        if (_confirmBinding == null) return;
+        foreach (var a in ConfirmActions)
+            NHotkeyManager.Instance?.RemoveHotkeyPressedBinding(a, _confirmBinding);
+        _confirmBinding = null;
+    }
+
+    /// <summary>
+    /// Builds the fixed left-hand navigation list: click-to-jump buttons, wrapped
+    /// focus neighbours, seeded focus, and a hotkey-manager confirm binding so a
+    /// controller press fires the focused entry.
+    /// </summary>
+    private static void BuildSideNav(GodotObject creditsScreen, Control scrollContent,
+        Control headerTpl, IReadOnlyList<(string Text, Control Target)> targets)
+    {
+        NavActions.Clear();
+
+        var font = SafeThemeFont(headerTpl);
+
+        var nav = new VBoxContainer { Name = "ModNav" };
+        nav.AddThemeConstantOverride("separation", 10);
+        ((Control)creditsScreen).AddChild(nav);
+        nav.SetAnchorsPreset(Control.LayoutPreset.TopLeft);
+        nav.Position = new Vector2(64, 260);
+
+        var buttons = new List<Button>();
+        foreach (var (text, target) in targets)
+        {
+            var b = new Button
+            {
+                Text = text,
+                Flat = true,
+                Alignment = HorizontalAlignment.Left,
+                FocusMode = Control.FocusModeEnum.All,
+            };
+            b.AddThemeFontSizeOverride("font_size", 24);
+            if (font != null) b.AddThemeFontOverride("font", font);
+            b.AddThemeColorOverride("font_color", NavColor);
+            b.AddThemeColorOverride("font_hover_color", NavHoverColor);
+            b.AddThemeColorOverride("font_focus_color", NavHoverColor);
+            b.AddThemeColorOverride("font_pressed_color", NavHoverColor);
+
+            var captured = target;
+            Action jump = () => JumpTo(creditsScreen, scrollContent, captured);
+            b.Pressed += jump;      // mouse click + native ui_accept
+            NavActions[b] = jump;   // controller-confirm path (see confirm binding below)
+            nav.AddChild(b);
+            buttons.Add(b);
+        }
+
+        // Vertical focus chain with wrap, so a controller/keyboard can move between entries.
+        for (var i = 0; i < buttons.Count; i++)
+        {
+            var up   = buttons[(i - 1 + buttons.Count) % buttons.Count];
+            var down = buttons[(i + 1) % buttons.Count];
+            buttons[i].FocusNeighborTop    = buttons[i].GetPathTo(up);
+            buttons[i].FocusNeighborBottom = buttons[i].GetPathTo(down);
+            buttons[i].FocusPrevious       = buttons[i].GetPathTo(up);
+            buttons[i].FocusNext           = buttons[i].GetPathTo(down);
+        }
+
+        // Confirm: bound through NHotkeyManager (last-wins over the screen's blocking
+        // no-ops) because a bare Button only auto-fires on ui_accept, not ui_select.
+        var viewport = ((Control)creditsScreen).GetViewport();
+        _confirmBinding = () =>
+        {
+            if (viewport?.GuiGetFocusOwner() is Button fb && NavActions.TryGetValue(fb, out var act))
+                act();
+        };
+        foreach (var a in ConfirmActions)
+            NHotkeyManager.Instance?.PushHotkeyPressedBinding(a, _confirmBinding);
+
+        // Seed focus onto the nav (RedirectFocus handles the screen-side redirect;
+        // this deferred grab covers focus taken before that).
+        _firstNavButton = buttons.Count > 0 ? buttons[0] : null;
+        _firstNavButton?.CallDeferred(Control.MethodName.GrabFocus);
+    }
+
+    /// <summary>
+    /// Scrolls the credits so <paramref name="target"/> sits <see cref="NavTopPadding"/>
+    /// below the top, by writing the screen's private <c>_targetPosition</c> field.
+    /// </summary>
+    private static void JumpTo(GodotObject creditsScreen, Control scrollContent, Control target)
+    {
+        var p = scrollContent.Position.Y - target.GlobalPosition.Y + NavTopPadding;
+        Traverse.Create(creditsScreen).Field("_targetPosition").SetValue(p);
+    }
+
+    /// <summary>Reads the header template's font so nav buttons match the credits typeface.</summary>
+    private static Font? SafeThemeFont(Control c)
+    {
+        try { return c.GetThemeFont("font"); }
+        catch { return null; }
+    }
+
+    /// <summary>
+    /// Clones the header template and inserts it, optionally overriding vertical
+    /// spacing (<paramref name="minHeight"/>) and text size (<paramref name="fontSize"/>).
+    /// Returns the created label so callers can reference it (e.g. as a nav target).
+    /// </summary>
+    private static MegaLabel BuildHeader(VBoxContainer vbox, ref int at, string? text,
+        Color? color, MegaLabel tpl, string tag, float? minHeight = null, int? fontSize = null)
+    {
+        var h = (MegaLabel)tpl.Duplicate();
+        h.UniqueNameInOwner = false;
+        h.Name = "Mod_" + tag;
+        h.Text = text ?? "";
+        if (color.HasValue) h.AddThemeColorOverride("font_color", color.Value);
+        if (minHeight.HasValue)
+            h.CustomMinimumSize = new Vector2(h.CustomMinimumSize.X, minHeight.Value);
+        if (fontSize.HasValue)
+        {
+            h.MaxFontSize = fontSize.Value;
+            h.AddThemeFontSizeOverride("font_size", fontSize.Value);
+        }
+        vbox.AddChild(h);
+        vbox.MoveChild(h, at++);
+        return h;
+    }
+
+    /// <summary>Renders a single-column list of names (one per line).</summary>
+    private static void BuildNames(VBoxContainer vbox, ref int at, string? body,
+        MegaRichTextLabel tpl, string tag)
+    {
+        var n = (MegaRichTextLabel)tpl.Duplicate();
+        n.UniqueNameInOwner = false;
+        n.Name = "Mod_" + tag + "_N";
+        n.Text = body ?? "";
+        vbox.AddChild(n);
+        vbox.MoveChild(n, at++);
+    }
+
+    /// <summary>Renders a two-column roles/names block from <c>Role||Name</c> lines.</summary>
+    private static void BuildRoles(VBoxContainer vbox, ref int at, string? body,
+        HBoxContainer tpl, string tag)
+    {
+        var c = (HBoxContainer)tpl.Duplicate();
+        c.UniqueNameInOwner = false;
+        c.Name = "Mod_" + tag + "_C";
+
+        var labels = new List<MegaRichTextLabel>();
+        foreach (var child in c.GetChildren())
+            if (child is MegaRichTextLabel lbl) labels.Add(lbl);
+        if (labels.Count < 2) { c.QueueFree(); return; }
+
+        var roles = new List<string>();
+        var names = new List<string>();
+        foreach (var line in (body ?? "").Split('\n'))
+        {
+            var parts = line.Split(["||"], StringSplitOptions.None);
+            if (parts.Length != 2) continue;
+            roles.Add(parts[0].Trim());
+            names.Add(parts[1].Trim());
+        }
+
+        labels[0].UniqueNameInOwner = false;  // roles column (blue)
+        labels[0].Name = "Mod_" + tag + "_Roles";
+        labels[0].Text = string.Join("\n", roles);
+        labels[1].UniqueNameInOwner = false;  // names column (cream)
+        labels[1].Name = "Mod_" + tag + "_Names";
+        labels[1].Text = string.Join("\n", names);
+
+        vbox.AddChild(c);
+        vbox.MoveChild(c, at++);
+    }
+
+    /// <summary>Renders names across the three columns of the playtester template.</summary>
+    private static void BuildMulti(VBoxContainer vbox, ref int at, string? body,
+        HBoxContainer tpl, string tag)
+    {
+        var c = (HBoxContainer)tpl.Duplicate();
+        c.UniqueNameInOwner = false;
+        c.Name = "Mod_" + tag + "_C";
+
+        var columns = new List<MegaRichTextLabel>();
+        foreach (var child in c.GetChildren())
+            if (child is MegaRichTextLabel lbl) columns.Add(lbl);
+        if (columns.Count == 0) { c.QueueFree(); return; }
+
+        var names = (body ?? "").Split('\n');
+        var buckets = new List<string>[columns.Count];
+        for (var i = 0; i < columns.Count; i++) buckets[i] = [];
+        for (var i = 0; i < names.Length; i++)
+            buckets[i % columns.Count].Add(names[i]);
+
+        for (var i = 0; i < columns.Count; i++)
+        {
+            columns[i].UniqueNameInOwner = false;
+            columns[i].Name = "Mod_" + tag + "_C" + i;
+            columns[i].Text = string.Join("\n", buckets[i]);
+        }
+
+        vbox.AddChild(c);
+        vbox.MoveChild(c, at++);
+    }
+}
\ No newline at end of file
diff --git a/Utils/ModCredits.cs b/Utils/ModCredits.cs
new file mode 100644
index 00000000..72685516
--- /dev/null
+++ b/Utils/ModCredits.cs
@@ -0,0 +1,69 @@
+using BaseLib.Extensions;
+using BaseLib.Patches.UI;
+using MegaCrit.Sts2.Core.Localization;
+
+namespace BaseLib.Utils;
+
+/// <summary>
+/// Public registry for adding mod credit sections to the vanilla credits screen.
+/// Mods call one of the <c>Register</c> overloads at load time; the sections are
+/// rendered later by <see cref="NCreditsScreenPatch"/> when the screen opens.
+/// </summary>
+/// <remarks>
+/// All text is resolved from the vanilla <c>credits</c> loc table, namespaced by
+/// mod id: <c>&lt;MODID&gt;-&lt;SECTION&gt;.header</c> and
+/// <c>&lt;MODID&gt;-&lt;SECTION&gt;.names</c>.
+/// </remarks>
+public static class ModCredits
+{
+    /// <summary>Body layout of a section, determining how its <c>.names</c> value is parsed.</summary>
+    public enum Layout
+    {
+        /// <summary>One name per line.</summary>
+        Names = 1,
+        /// <summary>One <c>Role||Name</c> pair per line, rendered as two columns.</summary>
+        Roles = 2,
+        /// <summary>One name per line, dealt round-robin across three columns.</summary>
+        Columns3 = 3,
+    }
+
+    /// <summary>A single credits section belonging to a mod.</summary>
+    /// <param name="Name">
+    /// Section id; combined with the mod id to form the loc keys
+    /// <c>&lt;MODID&gt;-&lt;NAME&gt;.header</c> / <c>.names</c>.
+    /// </param>
+    /// <param name="Kind">How the section body is laid out.</param>
+    public record Section(string Name, Layout Kind = Layout.Names);
+
+    /// <summary>A registered mod and its sections, in registration order.</summary>
+    internal record Entry(string ModId, List<Section> Sections);
+
+    /// <summary>All registered mods, rendered in the order they registered.</summary>
+    internal static readonly List<Entry> Entries = [];
+
+    /// <summary>
+    /// Registers sections for the mod whose root namespace matches <typeparamref name="TFromMod"/>.
+    /// Pass any type from your mod assembly (plugin class, a card model, etc.).
+    /// </summary>
+    /// <typeparam name="TFromMod">A type in your mod; its root namespace becomes the mod id.</typeparam>
+    /// <param name="sections">The sections to display for this mod.</param>
+    public static void Register<TFromMod>(params Section[] sections)
+        => Entries.Add(new Entry(IdOf(typeof(TFromMod)), [.. sections]));
+
+    /// <summary>Registers sections under an explicit, upper-cased mod id.</summary>
+    /// <param name="modId">The mod id used to namespace loc keys.</param>
+    /// <param name="sections">The sections to display for this mod.</param>
+    public static void Register(string modId, params Section[] sections)
+        => Entries.Add(new Entry(modId.ToUpperInvariant(), [.. sections]));
+
+    /// <summary>
+    /// Derives the mod id from a type's root namespace, matching the prefix
+    /// BaseLib assigns to content ids (minus its trailing dash).
+    /// </summary>
+    private static string IdOf(Type type)
+        => type.GetRootNamespace().ToUpperInvariant();
+
+    /// <summary>Looks up a key in the vanilla <c>credits</c> loc table.</summary>
+    internal static string Resolve(string key)
+        => new LocString("credits", key).GetRawText();
+}

From cf0c9c774587609ed6bb85a534c847151b2ae890 Mon Sep 17 00:00:00 2001
From: lamali <lamali292@gmail.com>
Date: Tue, 28 Jul 2026 14:23:08 +0200
Subject: [PATCH 2/3] Add nested mod credit groups and child section rendering
 logic to credits screen

---
 Patches/UI/NCreditsScreenPatch.cs | 87 +++++++++++++++++++------------
 Utils/ModCredits.cs               | 22 ++++++--
 2 files changed, 71 insertions(+), 38 deletions(-)

diff --git a/Patches/UI/NCreditsScreenPatch.cs b/Patches/UI/NCreditsScreenPatch.cs
index 81a29ef1..00942618 100644
--- a/Patches/UI/NCreditsScreenPatch.cs
+++ b/Patches/UI/NCreditsScreenPatch.cs
@@ -33,21 +33,22 @@ public static void OnExitTree()
 
 /// <summary>
 /// Rendering and navigation logic for the modded credits screen. Holds all the
-/// non-Harmony work: building the credit blocks, the fixed side-nav, jump-scrolling,
-/// focus seeding, and the controller confirm binding. Driven by <see cref="NCreditsScreenPatch"/>.
+/// non-Harmony work: building the (possibly nested) credit blocks, the fixed
+/// side-nav, jump-scrolling, focus seeding, and the controller confirm binding.
+/// Driven by <see cref="NCreditsScreenPatch"/>.
 /// </summary>
 internal static class CreditsNav
 {
-    private static readonly Color BannerColor   = new(1f, 0.55f, 0.20f);
-    private static readonly Color ModNameColor  = new(0.53f, 0.81f, 0.92f);
-    private static readonly Color NavColor      = new(1f, 0.965f, 0.886f);
-    private static readonly Color NavHoverColor = new(0.937f, 0.784f, 0.318f);
+    private static readonly Color BannerColor   = new(1f, 0.55f, 0.20f);       // orange
+    private static readonly Color ModNameColor  = new(0.53f, 0.81f, 0.92f);    // blue
+    private static readonly Color NavColor      = new(1f, 0.965f, 0.886f);     // cream
+    private static readonly Color NavHoverColor = new(0.937f, 0.784f, 0.318f); // gold
 
     /// <summary>Where a jumped-to node lands, measured from the top of the screen.</summary>
     private const float NavTopPadding = 200f;
 
     /// <summary>Confirm actions bound while the screen is open (last-wins over the screen's blockers).</summary>
-    private static readonly string[] ConfirmActions = [MegaInput.accept, MegaInput.select];
+    private static readonly string[] ConfirmActions = [(string)MegaInput.accept, (string)MegaInput.select];
 
     /// <summary>First side-nav button; used to seed controller/keyboard focus.</summary>
     private static Button? _firstNavButton;
@@ -70,6 +71,7 @@ public static void Render(NCreditsScreen screen)
 
         var headerTpl = vbox.GetNodeOrNull<MegaLabel>("ModdingSupportHeader");
         var namesTpl  = vbox.GetNodeOrNull<MegaRichTextLabel>("ModdingSupportNames");
+        var greenTpl  = vbox.GetNodeOrNull<MegaLabel>("LocalizationHeader") ?? headerTpl;
         var rolesCTpl = vbox.GetNodeOrNull<HBoxContainer>("zhsContainer");
         var multiCTpl = vbox.GetNodeOrNull<HBoxContainer>("PlaytestersContainer");
         if (headerTpl == null || namesTpl == null) return;
@@ -84,6 +86,24 @@ public static void Render(NCreditsScreen screen)
 
         BuildHeader(vbox, ref at, ModCredits.Resolve("BASELIB-BANNER.name"), BannerColor, headerTpl, "Banner", null, 60);
 
+        // Renders a section body (names) according to its layout.
+        void EmitBody(ModCredits.Layout kind, string body, string tag)
+        {
+            switch (kind)
+            {
+                case ModCredits.Layout.Roles when rolesCTpl != null:
+                    BuildRoles(vbox, ref at, body, rolesCTpl, tag);
+                    break;
+                case ModCredits.Layout.Columns3 when multiCTpl != null:
+                    BuildMulti(vbox, ref at, body, multiCTpl, tag);
+                    break;
+                case ModCredits.Layout.Names:
+                default:
+                    BuildNames(vbox, ref at, body, namesTpl, tag);
+                    break;
+            }
+        }
+
         var m = 0;
         foreach (var e in ModCredits.Entries)
         {
@@ -93,32 +113,36 @@ public static void Render(NCreditsScreen screen)
 
             var s = 0;
             foreach (var sec in e.Sections)
-            {
-                var tag  = "M" + m + "S" + s;
-                var head = ModCredits.Resolve(e.ModId + "-" + sec.Name.ToUpperInvariant() + ".header");
-                var body = ModCredits.Resolve(e.ModId + "-" + sec.Name.ToUpperInvariant() + ".names");
-
-                BuildHeader(vbox, ref at, head, null, headerTpl, tag + "H", 60f);
-
-                switch (sec.Kind)
-                {
-                    case ModCredits.Layout.Roles when rolesCTpl != null:
-                        BuildRoles(vbox, ref at, body, rolesCTpl, tag);
-                        break;
-                    case ModCredits.Layout.Columns3 when multiCTpl != null:
-                        BuildMulti(vbox, ref at, body, multiCTpl, tag);
-                        break;
-                    case ModCredits.Layout.Names:
-                    default:
-                        BuildNames(vbox, ref at, body, namesTpl, tag);
-                        break;
-                }
-                s++;
-            }
+                Emit(sec, e.ModId, "M" + m + "S" + s++);
+
             m++;
         }
 
         BuildSideNav(screen, margin, headerTpl, navTargets);
+        return;
+
+        // Recursive section renderer. Leaves render gold header + names. Groups render
+        // a green header, optional own names (only if the .names key exists), then children.
+        void Emit(ModCredits.Section sec, string modId, string tag)
+        {
+            var baseKey = modId + "-" + sec.Name.ToUpperInvariant();
+
+            if (sec.IsGroup)
+            {
+                BuildHeader(vbox, ref at, ModCredits.Resolve(baseKey + ".header"), null, greenTpl, tag + "G", 60f);
+
+                if (ModCredits.Has(baseKey + ".names"))
+                    EmitBody(sec.Kind, ModCredits.Resolve(baseKey + ".names"), tag);
+
+                var ci = 0;
+                foreach (var child in sec.Children!)
+                    Emit(child, modId, tag + "_" + ci++);
+                return;
+            }
+
+            BuildHeader(vbox, ref at, ModCredits.Resolve(baseKey + ".header"), null, headerTpl, tag + "H", 60f);
+            EmitBody(sec.Kind, ModCredits.Resolve(baseKey + ".names"), tag);
+        }
     }
 
     /// <summary>
@@ -183,7 +207,6 @@ private static void BuildSideNav(GodotObject creditsScreen, Control scrollConten
             buttons.Add(b);
         }
 
-        // Vertical focus chain with wrap, so a controller/keyboard can move between entries.
         for (var i = 0; i < buttons.Count; i++)
         {
             var up   = buttons[(i - 1 + buttons.Count) % buttons.Count];
@@ -194,8 +217,6 @@ private static void BuildSideNav(GodotObject creditsScreen, Control scrollConten
             buttons[i].FocusNext           = buttons[i].GetPathTo(down);
         }
 
-        // Confirm: bound through NHotkeyManager (last-wins over the screen's blocking
-        // no-ops) because a bare Button only auto-fires on ui_accept, not ui_select.
         var viewport = ((Control)creditsScreen).GetViewport();
         _confirmBinding = () =>
         {
@@ -205,8 +226,6 @@ private static void BuildSideNav(GodotObject creditsScreen, Control scrollConten
         foreach (var a in ConfirmActions)
             NHotkeyManager.Instance?.PushHotkeyPressedBinding(a, _confirmBinding);
 
-        // Seed focus onto the nav (RedirectFocus handles the screen-side redirect;
-        // this deferred grab covers focus taken before that).
         _firstNavButton = buttons.Count > 0 ? buttons[0] : null;
         _firstNavButton?.CallDeferred(Control.MethodName.GrabFocus);
     }
diff --git a/Utils/ModCredits.cs b/Utils/ModCredits.cs
index 72685516..9a03b251 100644
--- a/Utils/ModCredits.cs
+++ b/Utils/ModCredits.cs
@@ -27,13 +27,23 @@ public enum Layout
         Columns3 = 3,
     }
 
-    /// <summary>A single credits section belonging to a mod.</summary>
+    /// <summary>
+    /// A credits section. A <b>leaf</b> renders a gold header plus its names. A
+    /// <b>group</b> (when <paramref name="Children"/> is non-empty) renders a green
+    /// header, then — if a <c>.names</c> key exists — its own names, then its child
+    /// sections. Groups may nest arbitrarily.
+    /// </summary>
     /// <param name="Name">
     /// Section id; combined with the mod id to form the loc keys
     /// <c>&lt;MODID&gt;-&lt;NAME&gt;.header</c> / <c>.names</c>.
     /// </param>
-    /// <param name="Kind">How the section body is laid out.</param>
-    public record Section(string Name, Layout Kind = Layout.Names);
+    /// <param name="Kind">How this section's body is laid out (applies to a group's own names too).</param>
+    /// <param name="Children">Child sections; supplying any makes this a group.</param>
+    public record Section(string Name, Layout Kind = Layout.Names, Section[]? Children = null)
+    {
+        /// <summary>True when this section owns child sections (renders as a green group header).</summary>
+        public bool IsGroup => Children is { Length: > 0 };
+    }
 
     /// <summary>A registered mod and its sections, in registration order.</summary>
     internal record Entry(string ModId, List<Section> Sections);
@@ -66,4 +76,8 @@ private static string IdOf(Type type)
     /// <summary>Looks up a key in the vanilla <c>credits</c> loc table.</summary>
     internal static string Resolve(string key)
         => new LocString("credits", key).GetRawText();
-}
+
+    /// <summary>True when <paramref name="key"/> exists in the credits table.</summary>
+    internal static bool Has(string key)
+        => LocString.Exists("credits", key);
+}
\ No newline at end of file

From c2a0b790ddfb3f3430663a97699fed9d12e75642 Mon Sep 17 00:00:00 2001
From: lamali292 <57643961+lamali292@users.noreply.github.com>
Date: Fri, 31 Jul 2026 13:09:08 +0200
Subject: [PATCH 3/3] Update ConfirmActions to only include MegaInput.select

Removed 'MegaInput.accept' from ConfirmActions array.
---
 Patches/UI/NCreditsScreenPatch.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Patches/UI/NCreditsScreenPatch.cs b/Patches/UI/NCreditsScreenPatch.cs
index 00942618..f06a6dbf 100644
--- a/Patches/UI/NCreditsScreenPatch.cs
+++ b/Patches/UI/NCreditsScreenPatch.cs
@@ -48,7 +48,7 @@ internal static class CreditsNav
     private const float NavTopPadding = 200f;
 
     /// <summary>Confirm actions bound while the screen is open (last-wins over the screen's blockers).</summary>
-    private static readonly string[] ConfirmActions = [(string)MegaInput.accept, (string)MegaInput.select];
+    private static readonly string[] ConfirmActions = [(string)MegaInput.select];
 
     /// <summary>First side-nav button; used to seed controller/keyboard focus.</summary>
     private static Button? _firstNavButton;
@@ -347,4 +347,4 @@ private static void BuildMulti(VBoxContainer vbox, ref int at, string? body,
         vbox.AddChild(c);
         vbox.MoveChild(c, at++);
     }
-}
\ No newline at end of file
+}