Skip to main content

RootControllerManager

This class manages UI control for controller-based interaction in the game. It handles hotbar visibility, injected UI overlays, tab switching, and contextual interaction prompts. It serves as the central controller interface for player interactions and dynamic UI elements.

public class RootControllerManager : MonoBehaviour

🎮 Key Responsibilities​

  • Controller Tab Management: Switches between different controller UI tabs like Chat, Build, Emote, Hotbar, and Settings.
  • UI Injection System: Allows temporary injection of custom UI, such as modals or menus.
  • Interaction Prompt Handling: Displays input button prompts when the player is near interactable objects.
  • Multiplayer Actor Integration: Monitors spawned/despawned actors and ties into their interaction events.

🧩 Dependencies​

  • UIVisibilityController, AnimatedVisibilityComponent – manages visibility transitions.
  • ContextualInteractionPrompt, InteractionListProvider, PopupMessageProvider – control user-facing prompts.
  • PlayerActor – each player's interaction state is tied to this.

🔀 Controller Tabs​

Enum: ControllerTab
Controls which UI view is active:

  • None: No tab active.
  • Hotbar, Chat, Emote, Build, Settings: Activates respective UI panels.

ChangeTab(ControllerTab newTab)​

Switches active UI tab. Also toggles hotbar, joystick, and directional buttons visibility.

📟 Injected UI System​

Dynamically loads custom UI panels and blocks player input when active.

ShowInjectedUI(...)​

Instantiates and shows a new UI panel, optionally blocking other UI interactions.

ReleaseInjectedUI(...)​

Destroys the current injected UI and returns to a default tab.

🧠 Actor Interaction Logic​

  • Tracks active PlayerActor instances.
  • Updates input prompts based on InteractionOptionsChanged callback.
  • Provides ShowInteractionList() to display full interaction menus.

💬 Interaction Prompts​

Dynamically creates prompts to indicate which buttons trigger what actions.

InteractionOptionsChanged(Dictionary<InputButton, string>)​

Destroys and recreates prompts for all available input interactions.

📦 UI Injection Interface​

public interface IRootControllerUIProvider
{
    Task<GameObject> GetUIPrefab();
    void ReleaseUIPrefab();
}

Use this to inject UI that interacts with the root controller system, such as modals, inventory, or quest windows.

🧪 Singleton Access​

Static property:

public static RootControllerManager Local;

Provides global access to the current instance.

📲 Credits UI​

Text field creditLabel is updated when the user's profile changes via OnUserDetailsChanged().

🧼 Cleanup​

Properly disconnects from all events and disposes of any dynamic UI or input bindings during OnDisable() and OnDestroy().

✅ Example Use Cases​

  • Switch to Build tab:

    RootControllerManager.Local.ChangeTabWrapper_Build();

  • Show modal and block interactions:

    RootControllerManager.Local.ShowInjectedUI(provider, null, true);

  • Display button prompt for ButtonSouth:
    Shown automatically via interaction events.