fix(PlayerManagerGUI): 修复玩家管理界面中空元素导致的布局错乱问题

当widget不应该绘制时，之前会跳过列位置更新导致后续元素对齐错误，
现在添加了占位推进列位置以确保布局的一致性。

Gui/DefaultWidgets.cs

@@ -40,5 +40,8 @@ public static class DefaultWidgets
 
         if (PlayerManager.ShowNameToggleButton.Value)
             RegisterManager.RegisterPlayerRow(InternalWidgets.NameToggleButton.Create());
+
+        if (PlayerManager.ShowMuteButton.Value)
+            RegisterManager.RegisterPlayerRow(InternalWidgets.MuteButton.Create());
     }
 }

Gui/GUIStyles.cs

@@ -0,0 +1,50 @@
+using UnityEngine;
+
+namespace stick.plugins.playermanager.Gui;
+
+/// <summary>
+/// 集中管理所有 GUIStyle 的静态类。
+/// 必须在 OnGUI 上下文中调用 Initialize() 初始化（依赖 GUI.skin）。
+/// 所有 GUI 组件通过此类的静态字段获取样式，避免重复创建。
+/// </summary>
+public static class GUIStyles
+{
+    /// <summary>标签样式（fontSize=22）</summary>
+    public static GUIStyle Label;
+
+    /// <summary>普通按钮样式（fontSize=22, richText=false）</summary>
+    public static GUIStyle Button;
+
+    /// <summary>黄色按钮样式（已记录玩家）</summary>
+    public static GUIStyle YellowButton;
+
+    /// <summary>红色按钮样式（黑名单玩家）</summary>
+    public static GUIStyle RedButton;
+
+    /// <summary>绿色按钮样式（好友玩家）</summary>
+    public static GUIStyle GreenButton;
+
+    private static bool _initialized;
+
+    /// <summary>
+    /// 初始化所有样式。必须在 OnGUI 上下文中调用，允许多次调用（仅首次生效）。
+    /// </summary>
+    public static void Initialize()
+    {
+        if (_initialized) return;
+
+        Label = new GUIStyle(GUI.skin.label) { fontSize = 22 };
+        Button = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
+
+        YellowButton = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
+        YellowButton.normal.textColor = Color.yellow;
+
+        RedButton = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
+        RedButton.normal.textColor = Color.red;
+
+        GreenButton = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
+        GreenButton.normal.textColor = Color.green;
+
+        _initialized = true;
+    }
+}

Gui/InternalWidgets/KickButton.cs

@@ -2,9 +2,6 @@ using MultiplayerBasicExample;
 
 namespace stick.plugins.playermanager.Gui.InternalWidgets;
 
-/// <summary>
-/// 踢人按钮的纯工厂
-/// </summary>
 public static class KickButton
 {
     public static IPlayerRowWidget Create()
@@ -19,7 +16,6 @@ public static class KickButton
             OnClick = player =>
                 PlayerManager.KickPlayer(player.SteamId, MultiplayerManager.KickResponse.DidNotRecievePackages),
             Width = 100f,
-            Style = PlayerManagerGUI.CommonButtonStyle,
         };
     }
 }

Gui/InternalWidgets/MuteButton.cs

@@ -0,0 +1,31 @@
+using MultiplayerBasicExample;
+
+namespace stick.plugins.playermanager.Gui.InternalWidgets;
+
+public static class MuteButton
+{
+    public static IPlayerRowWidget Create()
+    {
+        return new PlayerRowButtonWidget
+        {
+            Name = "mute",
+            Condition = player =>
+                !PlayerManager.IsHost(player)
+                && !PlayerManager.IsLocalPlayer(player),
+            GetText = player =>
+                PlayerManager.IsMuted(player) ? "取消禁音" : "禁音",
+            OnClick = player =>
+                {
+                    if (PlayerManager.IsMuted(player))
+                    {
+                        PlayerManager.UnmutePlayer(player);
+                    }
+                    else
+                    {
+                        PlayerManager.MutePlayer(player);
+                    }
+                },
+            Width = 100f,
+        };
+    }
+}

Gui/InternalWidgets/NameToggleButton.cs

@@ -1,8 +1,5 @@
 namespace stick.plugins.playermanager.Gui.InternalWidgets;
 
-/// <summary>
-/// 曾用名切换按钮的纯工厂
-/// </summary>
 public static class NameToggleButton
 {
     public static IPlayerRowWidget Create()
@@ -14,7 +11,6 @@ public static class NameToggleButton
             GetText = player => player.DisplayNameRecorded ? "显示现用名" : "显示曾用名",
             OnClick = player => player.DisplayNameRecorded = !player.DisplayNameRecorded,
             Width = 120f,
-            Style = PlayerManagerGUI.CommonButtonStyle,
         };
     }
 }

Gui/InternalWidgets/PlayerInfoButton.cs

@@ -1,13 +1,9 @@
 using Steamworks;
 using UnityEngine;
 using stick.plugins.playermanager.Recorder;
-using static stick.plugins.playermanager.Gui.PlayerManagerGUI;
 
 namespace stick.plugins.playermanager.Gui.InternalWidgets;
 
-/// <summary>
-/// 玩家信息按钮的纯工厂
-/// </summary>
 public static class PlayerInfoButton
 {
     public static IPlayerRowWidget Create()
@@ -22,11 +18,14 @@ public static class PlayerInfoButton
                 SteamFriends.ActivateGameOverlayToUser("steamid", player.SteamId);
             },
             Width = 500f,
-            GetStyle = player => player.RecordStatus switch
+            GetStyle = player =>
             {
-                PlayerRecordStatus.Blacklisted => RedButtonStyle,
+                return player.RecordStatus switch
-                PlayerRecordStatus.Recorded => YellowButtonStyle,
+                {
-                _ => player.IsFriend ? GreenButtonStyle : CommonButtonStyle,
+                    PlayerRecordStatus.Blacklisted => GUIStyles.RedButton,
+                    PlayerRecordStatus.Recorded => GUIStyles.YellowButton,
+                    _ => player.IsFriend ? GUIStyles.GreenButton : GUIStyles.Button,
+                };
             },
         };
     }

Gui/InternalWidgets/RecordButton.cs

@@ -3,9 +3,6 @@ using stick.plugins.playermanager.Recorder;
 
 namespace stick.plugins.playermanager.Gui.InternalWidgets;
 
-/// <summary>
-/// 记录/拉黑按钮的纯工厂
-/// </summary>
 public static class RecordButton
 {
     public static IPlayerRowWidget Create()
@@ -41,7 +38,6 @@ public static class RecordButton
                 PlayerManager.OnLobbyMembersChanged();
             },
             Width = 100f,
-            Style = PlayerManagerGUI.CommonButtonStyle,
         };
     }
 }

Gui/InternalWidgets/RoomPublicityButton.cs

@@ -1,10 +1,5 @@
-using static stick.plugins.playermanager.Gui.PlayerManagerGUI;
-
 namespace stick.plugins.playermanager.Gui.InternalWidgets;
 
-/// <summary>
-/// 切换公开性按钮的纯工厂，返回 IHeaderWidget（由 DefaultWidgets 放入 HeaderRow）
-/// </summary>
 public static class RoomPublicityButton
 {
     public static IHeaderWidget Create()
@@ -15,7 +10,6 @@ public static class RoomPublicityButton
             Text = "切换公开性",
             Action = () => PlayerManager.ToggleLobbyPublicity(),
             Width = 150f,
-            Style = CommonButtonStyle,
         };
     }
 }

Gui/InternalWidgets/RoomPublicityLabel.cs

@@ -1,10 +1,5 @@
-using static stick.plugins.playermanager.Gui.PlayerManagerGUI;
-
 namespace stick.plugins.playermanager.Gui.InternalWidgets;
 
-/// <summary>
-/// 房间类型标签的纯工厂，返回 IHeaderWidget（由 DefaultWidgets 放入 HeaderRow）
-/// </summary>
 public static class RoomPublicityLabel
 {
     public static IHeaderWidget Create()
@@ -14,7 +9,6 @@ public static class RoomPublicityLabel
             Name = "RoomPublicityLabel",
             Content = () => $"房间类型: {(PlayerManager.IsPublic ? "公开" : "好友可见")}",
             Width = 200f,
-            Style = TitleStyle,
         };
     }
 }

Gui/PlayerManagerGUI.cs

@@ -32,63 +32,6 @@ public static class PlayerManagerGUI
 
     #endregion
 
-    #region GUIStyle缓存（internal 供 DefaultWidgets 引用）
-
-    /// <summary>
-    /// 标题样式
-    /// </summary>
-    internal static GUIStyle TitleStyle;
-
-    /// <summary>
-    /// 普通按钮样式
-    /// </summary>
-    internal static GUIStyle CommonButtonStyle;
-
-    /// <summary>
-    /// 黄色按钮样式（已记录玩家）
-    /// </summary>
-    internal static GUIStyle YellowButtonStyle;
-
-    /// <summary>
-    /// 红色按钮样式（黑名单玩家）
-    /// </summary>
-    internal static GUIStyle RedButtonStyle;
-
-    /// <summary>
-    /// 绿色按钮样式（好友）
-    /// </summary>
-    internal static GUIStyle GreenButtonStyle;
-
-    /// <summary>
-    /// 样式是否已初始化
-    /// </summary>
-    private static bool StylesInitialized;
-
-    #endregion
-
-    #region 样式初始化
-
-    internal static void InitializeStyles()
-    {
-        if (StylesInitialized) return;
-
-        TitleStyle = new GUIStyle(GUI.skin.label) { fontSize = 22 };
-        CommonButtonStyle = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
-
-        YellowButtonStyle = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
-        YellowButtonStyle.normal.textColor = Color.yellow;
-
-        RedButtonStyle = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
-        RedButtonStyle.normal.textColor = Color.red;
-
-        GreenButtonStyle = new GUIStyle(GUI.skin.button) { fontSize = 22, richText = false };
-        GreenButtonStyle.normal.textColor = Color.green;
-
-        StylesInitialized = true;
-    }
-
-    #endregion
-
     #region 主绘制方法
 
     /// <summary>
@@ -96,7 +39,7 @@ public static class PlayerManagerGUI
     /// </summary>
     public static void DrawLobbyInfoGUI()
     {
-        InitializeStyles();
+        GUIStyles.Initialize();
         Cursor.Reset();
 
         if (PlayerManager.MatchmakingHandler.IsInsideLobby)
@@ -108,7 +51,7 @@ public static class PlayerManagerGUI
             GUI.Label(
                 Cursor.NextLine(500f, 40f),
                 "当前不在大厅中",
-                TitleStyle
+                GUIStyles.Label
             );
             DrawLobbySearchInfo();
         }
@@ -128,7 +71,7 @@ public static class PlayerManagerGUI
         GUI.Label(
             Cursor.NextLine(2000f, 40f),
             $"当前大厅: {PlayerManager.CurrentLobbyID} 房主: {PlayerManager.LobbyOwner.CurrentName}",
-            TitleStyle
+            GUIStyles.Label
         );
 
         // HeaderRow 区域：纵向迭代每一行，行内横向迭代 Children
@@ -156,6 +99,8 @@ public static class PlayerManagerGUI
             {
                 if (widget.ShouldDraw(member))
                     widget.Draw(Cursor.NextColumn(widget.Width, 40f), member);
+                else
+                    Cursor.NextColumn(widget.Width, 40f); // 占位推进列位置
             }
             Cursor.EndRow();
         }
@@ -175,7 +120,7 @@ public static class PlayerManagerGUI
         if (GUI.Button(
             Cursor.NextLine(400f, 40f),
             $"搜索范围 {areaText}",
-            CommonButtonStyle
+            GUIStyles.Button
         ))
         {
             CycleLobbyDistanceFilter();
@@ -186,7 +131,7 @@ public static class PlayerManagerGUI
         if (GUI.Button(
             new Rect(Cursor.OffsetX + 420f, Cursor.CurrentY, 100f, 40f),
             "刷新",
-            CommonButtonStyle
+            GUIStyles.Button
         ))
         {
             PlayerManager.RequestLobbyList();
@@ -196,7 +141,7 @@ public static class PlayerManagerGUI
         GUI.Label(
             Cursor.NextLine(500f, 40f),
             $"搜索到大厅数量: {PlayerManager.lobbyDataList.Count}",
-            TitleStyle
+            GUIStyles.Label
         );
 
         // 大厅列表滚动视图
@@ -247,7 +192,7 @@ public static class PlayerManagerGUI
             if (GUI.Button(
                 new Rect(Cursor.OffsetX, Cursor.LineHeight * i, 500f, 40f),
                 $"{lobbyId} 人数{SteamMatchmaking.GetNumLobbyMembers(lobbyId)}",
-                CommonButtonStyle
+                GUIStyles.Button
             ))
             {
                 PlayerManager.JoinSpecificServer(lobbyId);

Gui/Widget.cs

@@ -106,7 +106,7 @@ public class HeaderLabelWidget : IHeaderWidget
 
     public void Draw(Rect rect)
     {
-        GUI.Label(rect, Content?.Invoke() ?? string.Empty, Style ?? GUI.skin.label);
+        GUI.Label(rect, Content?.Invoke() ?? string.Empty, Style ?? GUIStyles.Label);
     }
 }
 
@@ -126,7 +126,7 @@ public class HeaderButtonWidget : IHeaderWidget
 
     public void Draw(Rect rect)
     {
-        if (GUI.Button(rect, Text ?? string.Empty, Style ?? GUI.skin.button))
+        if (GUI.Button(rect, Text ?? string.Empty, Style ?? GUIStyles.Button))
             Action?.Invoke();
     }
 }
@@ -179,7 +179,7 @@ public class PlayerRowButtonWidget : IPlayerRowWidget
 
     public void Draw(Rect rect, PlayerInfo player)
     {
-        GUIStyle style = GetStyle?.Invoke(player) ?? Style ?? GUI.skin.button;
+        GUIStyle style = GetStyle?.Invoke(player) ?? Style ?? GUIStyles.Button;
         if (GUI.Button(rect, GetText?.Invoke(player) ?? string.Empty, style))
             OnClick?.Invoke(player);
     }
@@ -200,7 +200,7 @@ public class PlayerRowLabelWidget : IPlayerRowWidget
 
     public void Draw(Rect rect, PlayerInfo player)
     {
-        GUI.Label(rect, GetText?.Invoke(player) ?? string.Empty, Style ?? GUI.skin.label);
+        GUI.Label(rect, GetText?.Invoke(player) ?? string.Empty, Style ?? GUIStyles.Label);
     }
 }
 

Patches/LogLeverAngle.cs

@@ -1,20 +0,0 @@
-using HarmonyLib;
-using stick.plugins.playermanager;
-
-using Steamworks;
-using UnityEngine;
-
-[HarmonyPatch(typeof(HostLeverHandler), "Update")]
-class LogLeverAngle
-{
-    static Vector3 lastForward = Vector3.zero;
-    public static void PostFix()
-    {
-        Vector3 currentForward = PlayerManager.HostLeverHandler.lever.transform.forward;
-        if (currentForward != lastForward)
-        {
-            Debug.Log("Current Lever Angle: " + currentForward);
-            lastForward = currentForward;
-        }
-    }
-}

Plugin.cs

@@ -9,6 +9,8 @@ using System.Data;
 using System.Reflection;
 using stick.plugins.playermanager.Recorder;
 using stick.plugins.playermanager.Gui;
+using System.Collections;
+using MultiplayerBasicExample;
 
 namespace stick.plugins.playermanager;
 
@@ -57,6 +59,11 @@ public class PlayerManager : BaseUnityPlugin
     /// </summary>
     internal static ConfigEntry<bool> ShowRoomPublicityButton;
 
+    /// <summary>
+    /// 是否显示禁音按钮
+    /// </summary>
+    internal static ConfigEntry<bool> ShowMuteButton;
+
     #endregion
 
     #region Steam回调
@@ -117,15 +124,10 @@ public class PlayerManager : BaseUnityPlugin
         "ChangeLobbyType"
     );
 
-    /// <summary>
-    /// leverhandler实例
-    /// </summary>
-    public static HostLeverHandler HostLeverHandler => UnityEngine.Object.FindObjectOfType<HostLeverHandler>();
-
     /// <summary>
     /// 房间公开性
     /// </summary>
-    public static bool IsPublic => HostLeverHandler?.isOn ?? MatchmakingHandler.LobbyType == ELobbyType.k_ELobbyTypePublic;
+    public static bool IsPublic => MatchmakingHandler.LobbyType == ELobbyType.k_ELobbyTypePublic;
 
     /// <summary>
     /// 当前大厅ID
@@ -140,7 +142,29 @@ public class PlayerManager : BaseUnityPlugin
     /// <summary>
     /// 本地玩家信息
     /// </summary>
-    public static PlayerInfo LocalPlayer => new(SteamUser.GetSteamID());
+    public static PlayerInfo LocalPlayer;
+
+    /// <summary>
+    /// 初始化localPlayer和只需要初始化一次的steam相关的协程
+    /// </summary>
+    IEnumerator InitAfterSteam()
+    {
+        // 等待 Steam 初始化（给游戏一点初始化时间）
+        yield return new WaitForSeconds(2f);
+
+        // 或者轮询检查 Steam 是否就绪
+        while (!SteamManager.Initialized) // 如果游戏有 SteamManager
+        {
+            yield return null;
+        }
+
+        LocalPlayer = new(SteamUser.GetSteamID());
+    }
+
+    /// <summary>
+    /// 禁音玩家列表
+    /// </summary>
+    public static HashSet<PlayerInfo> MutedPlayers = [];
 
     #endregion
 
@@ -150,13 +174,21 @@ public class PlayerManager : BaseUnityPlugin
     {
         InitializeConfiguration();
         ApplyPatches();
-        PlayerManagerGUI.InitializeStyles();
         DefaultWidgets.RegisterAll();
     }
 
+    void Start()
+    {
+        StartCoroutine(InitAfterSteam());
+    }
+
     private void Update()
     {
         HandleInput();
+        if (SteamManager.Initialized)
+        {
+            LocalPlayer = new(SteamUser.GetSteamID());
+        }
     }
 
     private void OnGUI()
@@ -211,6 +243,13 @@ public class PlayerManager : BaseUnityPlugin
             "是否显示曾用名切换按钮"
         );
 
+        ShowMuteButton = Config.Bind(
+            "GUI",
+            "ShowMuteButton",
+            true,
+            "是否显示禁音按钮"
+        );
+
         ShowRoomPublicityLabel = Config.Bind(
             "GUI",
             "ShowRoomPublicityLabel",
@@ -271,6 +310,42 @@ public class PlayerManager : BaseUnityPlugin
 
     #region 公共方法
 
+    /// <summary>
+    /// 判断指定玩家是否被静音
+    /// </summary>
+    /// <param name="player">要检查的玩家</param>
+    /// <returns>如果被静音返回true</returns>
+    public static bool IsMuted(PlayerInfo player)
+    {
+        return player != null && MutedPlayers.Contains(player);
+    }
+
+    /// <summary>
+    /// 静音指定玩家
+    /// </summary>
+    /// <param name="player">被静音的玩家</param>
+    public static void MutePlayer(PlayerInfo player)
+    {
+        if (player != null)
+        {
+            MutedPlayers.Add(player);
+            Debug.Log($"玩家 {player} 已被静音");
+        }
+    }
+
+    /// <summary>
+    /// 取消静音指定玩家
+    /// </summary>
+    /// <param name="player">要取消静音的玩家</param>
+    public static void UnmutePlayer(PlayerInfo player)
+    {
+        if (player != null && MutedPlayers.Contains(player))
+        {
+            MutedPlayers.Remove(player);
+            Debug.Log($"玩家 {player} 已被取消静音");
+        }
+    }
+
     /// <summary>
     /// 判断指定玩家是否为房主
     /// </summary>
@@ -298,7 +373,7 @@ public class PlayerManager : BaseUnityPlugin
     {
         if (MultiplayerManager.IsServer)
         {
-            var targetType = IsPublic ? ELobbyType.k_ELobbyTypePublic : ELobbyType.k_ELobbyTypeFriendsOnly;
+            var targetType = IsPublic ? ELobbyType.k_ELobbyTypeFriendsOnly : ELobbyType.k_ELobbyTypePublic;
             MatchmakingHandler.SetNewLobbyType(targetType);
             RawChangeLobbyTypeMI.Invoke(MatchmakingHandler, [targetType]);
         }

Recorder/RecorderBase.cs

@@ -9,20 +9,16 @@ namespace stick.plugins.playermanager.Recorder;
 /// <summary>
 /// 记录器基类
 /// 提供玩家记录和黑名单功能的通用实现
+/// 使用 Dictionary<CSteamID, PlayerInfo> 实现 O(1) 查找
 /// </summary>
 public abstract class RecorderBase
 {
     #region 字段
 
     /// <summary>
-    /// 玩家信息集合（用于快速查找）
+    /// 玩家信息字典（以 SteamID 为键，O(1) 查找）
     /// </summary>
-    protected HashSet<PlayerInfo> playerSet = new HashSet<PlayerInfo>();
+    protected Dictionary<CSteamID, PlayerInfo> playerDict = new Dictionary<CSteamID, PlayerInfo>();
-
-    /// <summary>
-    /// 玩家信息列表（用于有序遍历和文件写入）
-    /// </summary>
-    protected List<PlayerInfo> playerList = new List<PlayerInfo>();
 
     #endregion
 
@@ -68,7 +64,7 @@ public abstract class RecorderBase
     /// </summary>
     public bool IsPlayerRecorded(PlayerInfo playerInfo)
     {
-        return playerInfo != null && playerSet.Contains(playerInfo);
+        return playerInfo != null && playerDict.ContainsKey(playerInfo.SteamId);
     }
 
     /// <summary>
@@ -76,8 +72,7 @@ public abstract class RecorderBase
     /// </summary>
     public bool IsPlayerRecorded(CSteamID playerId)
     {
-        PlayerInfo playerInfo = new PlayerInfo(playerId);
+        return playerDict.ContainsKey(playerId);
-        return playerSet.Contains(playerInfo);
     }
 
     /// <summary>
@@ -89,9 +84,9 @@ public abstract class RecorderBase
 
         playerInfo.RecordStatus = RecordStatus;
 
-        if (playerSet.Add(playerInfo))
+        if (!playerDict.ContainsKey(playerInfo.SteamId))
         {
-            playerList.Add(playerInfo);
+            playerDict.Add(playerInfo.SteamId, playerInfo);
         }
 
         AppendToFile(playerInfo);
@@ -104,27 +99,22 @@ public abstract class RecorderBase
     {
         if (playerInfo == null) return;
 
-        if (playerSet.Remove(playerInfo))
+        if (playerDict.Remove(playerInfo.SteamId))
         {
-            playerList.Remove(playerInfo);
             WriteBackToFile();
         }
     }
 
     /// <summary>
-    /// 检查并合并玩家记录信息
+    /// 检查并合并玩家记录信息（O(1) 字典查找）
     /// </summary>
     public void CheckAndMerge(PlayerInfo playerInfo)
     {
         if (playerInfo == null) return;
 
-        foreach (PlayerInfo existingInfo in playerSet)
+        if (playerDict.TryGetValue(playerInfo.SteamId, out PlayerInfo existingInfo))
         {
-            if (existingInfo.Equals(playerInfo))
+            playerInfo.MergeWith(existingInfo);
-            {
-                playerInfo.MergeWith(existingInfo);
-                return;
-            }
         }
     }
 
@@ -142,8 +132,7 @@ public abstract class RecorderBase
             return;
         }
 
-        playerSet.Clear();
+        playerDict.Clear();
-        playerList.Clear();
 
         using (StreamReader reader = new StreamReader(FilePath))
         {
@@ -157,9 +146,9 @@ public abstract class RecorderBase
                     RecordStatus = RecordStatus
                 };
 
-                if (playerSet.Add(playerInfo))
+                if (!playerDict.ContainsKey(playerInfo.SteamId))
                 {
-                    playerList.Add(playerInfo);
+                    playerDict.Add(playerInfo.SteamId, playerInfo);
                 }
             }
         }
@@ -172,7 +161,7 @@ public abstract class RecorderBase
     {
         using (StreamWriter writer = new StreamWriter(FilePath, false))
         {
-            foreach (PlayerInfo info in playerList)
+            foreach (PlayerInfo info in playerDict.Values)
             {
                 writer.WriteLine(info.ToInfoString());
             }

readme.md

@@ -15,9 +15,18 @@
 - 可选择开启，默认开启的防踢
 - 可配置的界面开启按键，默认为F2
 - 可以随时切换房间的公开性
+- 静音单个玩家
 
 ## 更新日志
 
+### v4.0.3
+
+1. 静音单个玩家
+1. 性能优化
+1. 提供了更多可选是否开启功能显示的配置项
+1. 提供按钮组件注册入口
+1. 更好的房间公开性切换
+
 ### v3.1.1
 
 1. 添加了房间公开性切换功能
@@ -72,3 +81,143 @@
 感谢老狼的原版插件
 
 旧版插件用户可以通过把 `...\StickFightTheGame\StickFight_Data`下的 `CustomPlayerRecord.txt`文件移动到 `...\StickFightTheGame\BepInEx\config\`目录来保留以前的记录
+
+## 接口文档
+
+### 组件注册
+
+v4.0.3 起开放 GUI 组件注册，允许其他插件向界面的 Header 区或玩家行插入自定义控件。
+
+命名空间：`stick.plugins.playermanager.Gui`
+
+---
+
+#### `RegisterManager` — 注册/反注册 API
+
+```csharp
+// 注册一个 Header 行（纵向排列，行内子组件横向排列）
+static void RegisterHeaderRow(IHeaderRow row);
+
+// 注册一个玩家行组件（每个玩家行中横向排列）
+static void RegisterPlayerRow(IPlayerRowWidget widget);
+
+// 按 Name 反注册
+static bool UnregisterHeaderRow(string name);
+static bool UnregisterPlayerRow(string name);
+```
+
+---
+
+#### 玩家行组件
+
+每个大厅成员对应一行，注册的组件在行内从左到右排列。两种组件：
+
+**`PlayerRowButtonWidget`** — 可点击按钮
+
+| 参数        | 类型                         | 必填 | 说明                            |
+| ----------- | ---------------------------- | ---- | ------------------------------- |
+| `Name`      | `string`                     | ✓    | 唯一标识，用于反注册            |
+| `Width`     | `float`                      | ✓    | 组件宽度（像素）                |
+| `GetText`   | `Func<PlayerInfo, string>`   | ✓    | 按钮文字，`player` 为当前行玩家 |
+| `OnClick`   | `Action<PlayerInfo>`         | ✓    | 点击回调                        |
+| `Condition` | `Func<PlayerInfo, bool>`     |      | 返回 `false` 时对该玩家隐藏     |
+| `Style`     | `GUIStyle`                   |      | 静态样式                        |
+| `GetStyle`  | `Func<PlayerInfo, GUIStyle>` |      | 动态样式，优先于 `Style`        |
+
+**`PlayerRowLabelWidget`** — 只读文本
+
+| 参数        | 类型                       | 必填 | 说明                |
+| ----------- | -------------------------- | ---- | ------------------- |
+| `Name`      | `string`                   | ✓    | 唯一标识            |
+| `Width`     | `float`                    | ✓    | 组件宽度（像素）    |
+| `GetText`   | `Func<PlayerInfo, string>` | ✓    | 显示文本            |
+| `Condition` | `Func<PlayerInfo, bool>`   |      | 返回 `false` 时隐藏 |
+| `Style`     | `GUIStyle`                 |      | 自定义样式          |
+
+---
+
+#### Header 组件
+
+Header 区位于标题下方，每行可含多个子组件。两种子组件：
+
+**`HeaderRow`** — 一个 Header 行
+
+| 参数        | 类型                  | 必填 | 说明                    |
+| ----------- | --------------------- | ---- | ----------------------- |
+| `Name`      | `string`              | ✓    | 唯一标识                |
+| `Children`  | `List<IHeaderWidget>` | ✓    | 行内子组件列表          |
+| `Condition` | `Func<bool>`          |      | 返回 `false` 时整行隐藏 |
+
+**`HeaderLabelWidget`** — 行内文本
+
+| 参数        | 类型           | 必填 | 说明                |
+| ----------- | -------------- | ---- | ------------------- |
+| `Name`      | `string`       | ✓    | 唯一标识            |
+| `Width`     | `float`        | ✓    | 组件宽度（像素）    |
+| `Content`   | `Func<string>` | ✓    | 显示文本            |
+| `Condition` | `Func<bool>`   |      | 返回 `false` 时隐藏 |
+| `Style`     | `GUIStyle`     |      | 自定义样式          |
+
+**`HeaderButtonWidget`** — 行内按钮
+
+| 参数        | 类型         | 必填 | 说明                |
+| ----------- | ------------ | ---- | ------------------- |
+| `Name`      | `string`     | ✓    | 唯一标识            |
+| `Width`     | `float`      | ✓    | 组件宽度（像素）    |
+| `Text`      | `string`     | ✓    | 按钮文字            |
+| `Action`    | `Action`     | ✓    | 点击回调            |
+| `Condition` | `Func<bool>` |      | 返回 `false` 时隐藏 |
+| `Style`     | `GUIStyle`   |      | 自定义样式          |
+
+---
+
+#### 示例
+
+```csharp
+using stick.plugins.playermanager.Gui;
+using stick.plugins.playermanager.Recorder;
+
+// 玩家行按钮
+RegisterManager.RegisterPlayerRow(new PlayerRowButtonWidget
+{
+    Name = "MyButton",
+    GetText = player => "打招呼",
+    OnClick = player => Debug.Log($"你好 {player}"),
+    Width = 100f,
+    Condition = player => !PlayerManager.IsLocalPlayer(player),
+});
+
+// 玩家行标签
+RegisterManager.RegisterPlayerRow(new PlayerRowLabelWidget
+{
+    Name = "MyLabel",
+    GetText = player => $"#{player.SteamId}",
+    Width = 150f,
+    Style = GUIStyles.Label,
+});
+
+// Header 行（含标签 + 按钮）
+RegisterManager.RegisterHeaderRow(new HeaderRow
+{
+    Name = "MyHeader",
+    Condition = () => PlayerManager.IsHost(PlayerManager.LocalPlayer),
+    Children = new List<IHeaderWidget>
+    {
+        new HeaderLabelWidget
+        {
+            Name = "Status",
+            Content = () => "状态: 运行中",
+            Width = 150f,
+        },
+        new HeaderButtonWidget
+        {
+            Name = "Action",
+            Text = "执行",
+            Action = () => Debug.Log("点击"),
+            Width = 100f,
+        },
+    },
+});
+
+// 反注册
+RegisterManager.UnregisterPlayerRow("MyButton");

stick.plugins.playermanager.csproj

@@ -4,7 +4,7 @@
     <TargetFramework>net35</TargetFramework>
     <AssemblyName>stick.plugins.playermanager</AssemblyName>
     <Product>PlayerManager</Product>
-    <Version>4.0.1</Version>
+    <Version>4.0.3</Version>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <LangVersion>latest</LangVersion>
     <RestoreAdditionalProjectSources>