Dalamud/Dalamud/Plugin/DalamudPluginInterface.cs

using System;
using System.Collections.Generic;
using System.Dynamic;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Runtime.InteropServices;
using System.Text;
using System.Threading.Tasks;
using Dalamud.Configuration;
using Dalamud.Data;
using Dalamud.Game;
using Dalamud.Game.Chat.SeStringHandling;
using Dalamud.Game.Chat.SeStringHandling.Payloads;
using Dalamud.Game.ClientState;
using Dalamud.Game.Command;
using Dalamud.Game.Internal;
using Dalamud.Game.Internal.Gui;
using Dalamud.Interface;

namespace Dalamud.Plugin
{
    /// <summary>
    /// This class acts as an interface to various objects needed to interact with Dalamud and the game.
    /// </summary>
    public class DalamudPluginInterface : IDisposable {
        /// <summary>
        /// The reason this plugin was loaded.
        /// </summary>
        public PluginLoadReason Reason { get; }

        /// <summary>
        /// Get the directory Dalamud assets are stored in.
        /// </summary>
        public DirectoryInfo DalamudAssetDirectory => this.dalamud.AssetDirectory;

        /// <summary>
        /// Get the directory your plugin configurations are stored in.
        /// </summary>
        public DirectoryInfo ConfigDirectory => new DirectoryInfo(GetPluginConfigDirectory());

        /// <summary>
        /// The CommandManager object that allows you to add and remove custom chat commands.
        /// </summary>
        public readonly CommandManager CommandManager;

        /// <summary>
        /// The ClientState object that allows you to access current client memory information like actors, territories, etc.
        /// </summary>
        public readonly ClientState ClientState;

        /// <summary>
        /// The Framework object that allows you to interact with the client.
        /// </summary>
        public readonly Framework Framework;

        /// <summary>
		/// A <see cref="UiBuilder">UiBuilder</see> instance which allows you to draw UI into the game via ImGui draw calls.
        /// </summary>
        public readonly UiBuilder UiBuilder;

        /// <summary>
        /// A <see cref="SigScanner">SigScanner</see> instance targeting the main module of the FFXIV process.
        /// </summary>
        public readonly SigScanner TargetModuleScanner;

        /// <summary>
        /// A <see cref="DataManager">DataManager</see> instance which allows you to access game data needed by the main dalamud features.
        /// </summary>
        public readonly DataManager Data;

        /// <summary>
        /// A <see cref="SeStringManager">SeStringManager</see> instance which allows creating and parsing SeString payloads.
        /// </summary>
        public readonly SeStringManager SeStringManager;

        /// <summary>
        /// Returns true if Dalamud is running in Debug mode or the /xldev menu is open. This can occur on release builds.
        /// </summary>
#if DEBUG
        public bool IsDebugging => true;
#else
        public bool IsDebugging => this.dalamud.DalamudUi.IsDevMenu;
#endif

        private readonly Dalamud dalamud;
        private readonly string pluginName;
        private readonly PluginConfigurations configs;

        /// <summary>
        /// Set up the interface and populate all fields needed.
        /// </summary>
        /// <param name="dalamud"></param>
        internal DalamudPluginInterface(Dalamud dalamud, string pluginName, PluginConfigurations configs, PluginLoadReason reason) {
            Reason = reason;
            this.CommandManager = dalamud.CommandManager;
            this.Framework = dalamud.Framework;
            this.ClientState = dalamud.ClientState;
            this.UiBuilder = new UiBuilder(dalamud, pluginName);
            this.TargetModuleScanner = dalamud.SigScanner;
            this.Data = dalamud.Data;
            this.SeStringManager = dalamud.SeStringManager;

            this.dalamud = dalamud;
            this.pluginName = pluginName;
            this.configs = configs;
        }

        /// <summary>
        /// Unregister your plugin and dispose all references. You have to call this when your IDalamudPlugin is disposed.
        /// </summary>
        public void Dispose() {
            this.UiBuilder.Dispose();
            this.Framework.Gui.Chat.RemoveChatLinkHandler(this.pluginName);
        }

        /// <summary>
        /// Save a plugin configuration(inheriting IPluginConfiguration).
        /// </summary>
        /// <param name="currentConfig">The current configuration.</param>
        public void SavePluginConfig(IPluginConfiguration currentConfig) {
            if (currentConfig == null)
                return;

            this.configs.Save(currentConfig, this.pluginName);
        }

        /// <summary>
        /// Get a previously saved plugin configuration or null if none was saved before.
        /// </summary>
        /// <returns>A previously saved config or null if none was saved before.</returns>
        public IPluginConfiguration GetPluginConfig() {
            // This is done to support json deserialization of plugin configurations
            // even after running an in-game update of plugins, where the assembly version
            // changes.
            // Eventually it might make sense to have a separate method on this class
            // T GetPluginConfig<T>() where T : IPluginConfiguration
            // that can invoke LoadForType() directly instead of via reflection
            // This is here for now to support the current plugin API
            foreach (var type in Assembly.GetCallingAssembly().GetTypes())
            {
                if (type.GetInterface(typeof(IPluginConfiguration).FullName) != null)
                {
                    var mi = this.configs.GetType().GetMethod("LoadForType");
                    var fn = mi.MakeGenericMethod(type);
                    return (IPluginConfiguration)fn.Invoke(this.configs, new object[] { this.pluginName });
                }
            }

            // this shouldn't be a thing, I think, but just in case
            return this.configs.Load(this.pluginName);
        }

        /// <summary>
        /// Get the config directory
        /// </summary>
        /// <returns>directory with path of AppData/XIVLauncher/pluginConfig/PluginInternalName </returns>
        public string GetPluginConfigDirectory() => this.configs.GetDirectory(this.pluginName);

        #region Chat Links

        /// <summary>
        /// Register a chat link handler.
        /// </summary>
        /// <param name="commandId"></param>
        /// <param name="commandAction"></param>
        /// <returns>Returns an SeString payload for the link.</returns>
        public DalamudLinkPayload AddChatLinkHandler(uint commandId, Action<uint, SeString> commandAction) {
            return this.Framework.Gui.Chat.AddChatLinkHandler(this.pluginName, commandId, commandAction);
        }

        /// <summary>
        /// Remove a chat link handler.
        /// </summary>
        /// <param name="commandId"></param>
        public void RemoveChatLinkHandler(uint commandId) {
            this.Framework.Gui.Chat.RemoveChatLinkHandler(this.pluginName, commandId);
        }

        /// <summary>
        /// Removes all chat link handlers registered by the plugin.
        /// </summary>
        public void RemoveChatLinkHandler() {
            this.Framework.Gui.Chat.RemoveChatLinkHandler(this.pluginName);
        }
        #endregion

        #region IPC

        internal Action<string, ExpandoObject> anyPluginIpcAction;

        /// <summary>
        /// Subscribe to an IPC message by any plugin.
        /// </summary>
        /// <param name="action">The action to take when a message was received.</param>
        public void SubscribeAny(Action<string, ExpandoObject> action)
        {
            if (this.anyPluginIpcAction != null)
                throw new InvalidOperationException("Can't subscribe multiple times.");

            this.anyPluginIpcAction = action;
        }

        /// <summary>
        /// Subscribe to an IPC message by a plugin.
        /// </summary>
        /// <param name="pluginName">The InternalName of the plugin to subscribe to.</param>
        /// <param name="action">The action to take when a message was received.</param>
        public void Subscribe(string pluginName, Action<ExpandoObject> action) {
            if (this.dalamud.PluginManager.IpcSubscriptions.Any(x => x.SourcePluginName == this.pluginName && x.SubPluginName == pluginName))
                throw new InvalidOperationException("Can't add multiple subscriptions for the same plugin.");

            this.dalamud.PluginManager.IpcSubscriptions.Add((this.pluginName, pluginName, action));
        }

        /// <summary>
        /// Unsubscribe from messages from any plugin.
        /// </summary>
        public void UnsubscribeAny()
        {
            if (this.anyPluginIpcAction == null)
                throw new InvalidOperationException("Wasn't subscribed to this plugin.");

            this.anyPluginIpcAction = null;
        }

        /// <summary>
        /// Unsubscribe from messages from a plugin.
        /// </summary>
        /// <param name="pluginName">The InternalName of the plugin to unsubscribe from.</param>
        public void Unsubscribe(string pluginName) {
            var sub = this.dalamud.PluginManager.IpcSubscriptions.FirstOrDefault(x => x.SourcePluginName == this.pluginName && x.SubPluginName == pluginName);
            if (sub.SubAction == null)
                throw new InvalidOperationException("Wasn't subscribed to this plugin.");

            this.dalamud.PluginManager.IpcSubscriptions.Remove(sub);
        }

        /// <summary>
        /// Send a message to all subscribed plugins.
        /// </summary>
        /// <param name="message">The message to send.</param>
        public void SendMessage(ExpandoObject message) {
            var subs = this.dalamud.PluginManager.IpcSubscriptions.Where(x => x.SubPluginName == this.pluginName);
            foreach (var sub in subs.Select(x => x.SubAction)) {
                sub.Invoke(message);
            }
        }

        /// <summary>
        /// Send a message to a specific plugin.
        /// </summary>
        /// <param name="pluginName">The InternalName of the plugin to send the message to.</param>
        /// <param name="message">The message to send.</param>
        /// <returns>True if the corresponding plugin was present and received the message.</returns>
        public bool SendMessage(string pluginName, ExpandoObject message)
        {
            var (_, _, pluginInterface, _) = this.dalamud.PluginManager.Plugins.FirstOrDefault(x => x.Definition.InternalName == pluginName);

            if (pluginInterface?.anyPluginIpcAction == null)
                return false;

            pluginInterface.anyPluginIpcAction.Invoke(this.pluginName, message);
            return true;
        }

        #endregion

        #region Logging

        /// <summary>
        /// Log a templated message to the in-game debug log.
        /// </summary>
        /// <param name="messageTemplate">The message template.</param>
        /// <param name="values">Values to log.</param>
        [Obsolete]
        public void Log(string messageTemplate, params object[] values) {
            Serilog.Log.Information(messageTemplate, values);
        }

        /// <summary>
        /// Log a templated error message to the in-game debug log.
        /// </summary>
        /// <param name="messageTemplate">The message template.</param>
        /// <param name="values">Values to log.</param>
        [Obsolete]
        public void LogError(string messageTemplate, params object[] values)
        {
            Serilog.Log.Error(messageTemplate, values);
        }

        /// <summary>
        /// Log a templated error message to the in-game debug log.
        /// </summary>
        /// <param name="exception">The exception that caused the error.</param>
        /// <param name="messageTemplate">The message template.</param>
        /// <param name="values">Values to log.</param>
        [Obsolete]
        public void LogError(Exception exception, string messageTemplate, params object[] values)
        {
            Serilog.Log.Error(exception, messageTemplate, values);
        }

        #endregion
    }
}