IGameGui

Dalamud.Plugin.Services

public event EventHandler<bool> UiHideToggled;

public event EventHandler<ulong> HoveredItemChanged;

public event EventHandler<HoveredAction> HoveredActionChanged;

public event Action<AgentUpdateFlag> AgentUpdate;

public bool GameUiHidden { get; }

public ulong HoveredItem { get; set; }

public HoveredAction HoveredAction { get; }

public bool OpenMapWithMapLink(MapLinkPayload mapLink);

public bool WorldToScreen(Vector3 worldPos, out Vector2 screenPos);
public bool WorldToScreen(Vector3 worldPos, out Vector2 screenPos, out bool inView);

public bool ScreenToWorld(Vector2 screenPos, out Vector3 worldPos, float rayDistance = 100000.0f);

public UIModulePtr GetUIModule();

public AtkUnitBasePtr GetAddonByName(string name, int index = 1);
public T* GetAddonByName<T>(string name, int index = 1) where T : unmanaged;

public AgentInterfacePtr GetAgentById(int id);

public AgentInterfacePtr FindAgentInterface(string addonName);
public AgentInterfacePtr FindAgentInterface(AtkUnitBasePtr addon);

public class MyPlugin : IDalamudPlugin
{
    private readonly IGameGui gameGui;
    
    public MyPlugin(IGameGui gameGui)
    {
        this.gameGui = gameGui;
        
        // Subscribe to UI hide event
        this.gameGui.UiHideToggled += OnUiHideToggled;
        
        // Subscribe to hovered item changes
        this.gameGui.HoveredItemChanged += OnHoveredItemChanged;
    }
    
    private void OnUiHideToggled(object? sender, bool isHidden)
    {
        Log.Information($"UI is now {(isHidden ? "hidden" : "visible")}");
    }
    
    private void OnHoveredItemChanged(object? sender, ulong itemId)
    {
        if (itemId > 0)
        {
            var isHq = itemId > 1_000_000;
            var actualItemId = isHq ? itemId - 1_000_000 : itemId;
            Log.Information($"Hovering item {actualItemId} (HQ: {isHq})");
        }
    }
    
    public void DrawWorldMarker(Vector3 worldPos)
    {
        // Convert world position to screen position
        if (this.gameGui.WorldToScreen(worldPos, out var screenPos))
        {
            // screenPos now contains the screen coordinates
            ImGui.GetForegroundDrawList().AddCircle(
                screenPos,
                10f,
                ImGui.GetColorU32(new Vector4(1, 0, 0, 1)));
        }
    }
    
    public void Dispose()
    {
        this.gameGui.UiHideToggled -= OnUiHideToggled;
        this.gameGui.HoveredItemChanged -= OnHoveredItemChanged;
    }
}

public unsafe void CheckAddon()
{
    // Get an addon by name
    var addon = this.gameGui.GetAddonByName("NamePlate");
    
    if (addon != null && addon.IsVisible)
    {
        Log.Information("NamePlate addon is visible");
    }
    
    // Get a typed addon pointer
    var characterAddon = this.gameGui.GetAddonByName<AddonCharacter>("Character");
    if (characterAddon != null)
    {
        // Work with typed addon
    }
}

public void HandleMouseClick(Vector2 mousePos)
{
    if (this.gameGui.ScreenToWorld(mousePos, out var worldPos))
    {
        Log.Information($"Clicked world position: {worldPos}");
    }
}

public void OpenMapLocation(uint territoryId, uint mapId, float x, float y)
{
    var mapLink = new MapLinkPayload(
        territoryId,
        mapId,
        (int)(x * 1000),
        (int)(y * 1000));
    
    if (this.gameGui.OpenMapWithMapLink(mapLink))
    {
        Log.Information("Map opened successfully");
    }
}