// Assets/_Project/Scripts/Core/MatchRules.cs
namespace TD.Core
{
    /// <summary>
    /// Match-wide constants that several unrelated systems have to agree on.
    /// </summary>
    public static class MatchRules
    {
        /// <summary>
        /// Maximum players in one lobby.
        /// </summary>
        /// <remarks>
        /// <b>Reduced from 9 to 3 for the 2.0 design</b> as a deliberate scope cut: three players
        /// is enough for the shared-lives and shared-vote mechanics to matter, and it shrinks map
        /// authoring, balance surface, and network load all at once.
        ///
        /// <para><b>Why <see cref="PlayerSlot"/> still runs to 9.</b> Shrinking the enum would
        /// invalidate the owner grids baked into existing <c>LevelData</c> assets and force a
        /// re-bake of every map, for no runtime benefit — the extra values are simply never
        /// allocated. Slot allocation caps here instead, which is the only place that decides who
        /// gets a slot at all. Per-slot arrays stay sized to the enum, so they hold a few unused
        /// entries; that is intentional and costs nothing.</para>
        /// </remarks>
        public const int MaxPlayers = 3;
    }
}