RPG-RougeLiteBattler/DEBUG_SETTLEMENT_INTERACTION.md

Debug Settlement Interaction Issues

Problem

User reports that settlement interaction UI shows correctly (settlement name and "Press E to enter Town") but pressing E doesn't trigger town scene loading.

Analysis of Code

SettlementInteractionManager Analysis

From examining the code:

1. Input Handling: HandleInput() method checks:

   if (currentNearbySettlement != null && Input.GetKeyDown(enterSettlementKey))
   {
      EnterSettlement(currentNearbySettlement);
   }
   

2. Debug Logging: Is enabled (enableDebugLogs = true)

3. Settlement Detection: CheckForSettlementInteraction() converts world to map coordinates and finds nearby settlements

4. UI Updates: UpdateUI() shows/hides interactionPrompt GameObject

Potential Issues

Issue 1: GameObject Not Instantiated

The SettlementInteractionManager component might not be attached to a GameObject in MapScene2, or the GameObject might be inactive.

Issue 2: Missing TeamMarker Reference

The teamMarker field might not be assigned, causing the system to not track position properly.

Issue 3: MapData Not Initialized

The mapData reference might be null, causing FindNearestSettlement() to return null.

Issue 4: Input System Conflict

If the project uses the new Input System, Input.GetKeyDown() might not work properly.

Issue 5: Settlement Detection Distance

The interactionDistance might be too small, or coordinate conversion might be incorrect.

Issue 6: UI vs Logic Disconnect

The UI is showing (via SettlementInteractionUI) but the manager's currentNearbySettlement might be null.

Debugging Steps Needed

1. Check GameObject Setup: Verify SettlementInteractionManager is attached to active GameObject in MapScene2
2. Check References: Verify teamMarker and mapData are assigned
3. Check Console: Look for debug messages when moving TeamMarker near settlements
4. Test Manual Entry: Use the "Test Enter Current Settlement" context menu option
5. Check Input System: Verify if project uses old or new Input System

Immediate Actions

1. Check if SettlementInteractionManager GameObject exists in MapScene2
2. Verify component references are properly assigned
3. Enable debug logging and check console output
4. Test the context menu function to isolate input vs logic issues