MazeWalkerTv-try2/Assets/Scripts/Maze/Generation/MazeGenerationSettings.cs

using UnityEngine;

namespace MazeGen
{
    [CreateAssetMenu(fileName = "MazeGenerationSettings", menuName = "MazeGen/Generation Settings")]
    public class MazeGenerationSettings : ScriptableObject
    {
        [Header("Exits per room")]
        [Tooltip("Exits are grid-locked to the 4 cardinal directions (N/E/S/W), so a room can have at most one exit per side.")]
        [Range(1, 4)] public int minExitsPerRoom = 1;
        [Range(1, 4)] public int maxExitsPerRoom = 4;

        [Header("Start locations")]
        [Tooltip("Number of separate start rooms generated at level start. Spawning agents are distributed across these.")]
        [Range(1, 16)] public int startRoomCount = 1;
        [Tooltip("World-space radius of the disk start rooms are randomly scattered within. Ignored when startRoomCount is 1 (that one spawns at the origin).")]
        public float startRoomSpread = 6f;

        [Header("Layout")]
        [Tooltip("World-space distance between a room's center and the next room it spawns.")]
        public float roomSpacing = 4f;
        public float startRoomRadius = 1.2f;
        public float normalRoomRadius = 1f;
        public float hallwayRadius = 0.5f;
        public float exitRoomRadius = 1.2f;

        [Header("Room kind mix")]
        [Range(0f, 1f)] public float hallwayChance = 0.25f;

        [Header("Room merging (loops)")]
        [Tooltip("Extra clearance (world units) required between a candidate hallway path and any unrelated room/hallway footprint for that path to be considered clear.")]
        public float hallwayClearance = 0.1f;

        [Header("Collision avoidance (routing)")]
        [Tooltip("Distance (world units) between successive positions when searching for collision-free paths around obstacles.")]
        public float repositionRingStep = 1f;
        [Tooltip("Maximum number of search steps in each direction (straight extension and elbow bends) before declaring a spot truly unreachable. Widened from the old maxRepositionRings (was 10), since it's now the sole fallback for all obstruction routing.")]
        [Range(1, 200)] public int maxRouteSearchSteps = 40;

        [Header("Exit-room eligibility")]
        [Tooltip("Number of NEW (never-before-visited) rooms the agent must have entered before an Exit room is allowed to appear.")]
        public int minNewRoomsBeforeExitEligible = 5;
        [Range(0f, 1f)] public float exitRoomChanceOnceEligible = 0.2f;
        [Tooltip("Safety valve: if no Exit room has appeared naturally in the current branch after this many new rooms, force the next generated room in it to be one, guaranteeing every maze branch is solvable in bounded steps.")]
        public int forceExitAfterNewRooms = 20;
        [Tooltip("Maximum number of Exit rooms allowed to exist in the whole maze (0 = unlimited). Once reached, branches that still need an exit can no longer mint their own and must instead find/grow into one of the existing ones via loop-closing door connections - this is what pushes separate maze branches to join up instead of each getting their own exit.")]
        public int maxExitRooms = 0;
    }
}