Skip to main content

Class PluginConfigurations

Configuration to store settings for a dalamud plugin.

Assembly: Dalamud.dll
Declaration
public sealed class PluginConfigurations

Methods

Save(IPluginConfiguration, string, Guid)

Save/Load plugin configuration. NOTE: Save/Load are still using Type information for now, despite LoadForType superseding Load and not requiring or using it. It might be worth removing the Type info from Save, to strip it from all future saved configs, and then Load() can probably be removed entirely.

Declaration
public void Save(IPluginConfiguration config, string pluginName, Guid workingPluginId)
Parameters
TypeNameDescription
Dalamud.Configuration.IPluginConfigurationconfigPlugin configuration.
System.StringpluginNamePlugin name.
System.GuidworkingPluginIdWorkingPluginId of the plugin.

Load(string, Guid)

Load plugin configuration.

Declaration
public IPluginConfiguration? Load(string pluginName, Guid workingPluginId)
Returns

Dalamud.Configuration.IPluginConfiguration: Plugin configuration.

Parameters
TypeNameDescription
System.StringpluginNamePlugin name.
System.GuidworkingPluginIdWorkingPluginID of the plugin.

Delete(string)

Delete the configuration file and folder for the specified plugin. This will throw an System.IO.IOException if the plugin did not correctly close its handles.

Declaration
public void Delete(string pluginName)
Parameters
TypeNameDescription
System.StringpluginNameThe name of the plugin.

GetDirectory(string)

Get plugin directory.

Declaration
public string GetDirectory(string pluginName)
Returns

System.String: Plugin directory path.

Parameters
TypeNameDescription
System.StringpluginNamePlugin name.

LoadForType<T>(string)

Load Plugin configuration. Parameterized deserialization. Currently this is called via reflection from DalamudPluginInterface.GetPluginConfig(). Eventually there may be an additional pluginInterface method that can call this directly without reflection - for now this is in support of the existing plugin api.

Declaration
public T LoadForType<T>(string pluginName) where T : IPluginConfiguration
Returns

<T>: Plugin Configuration.

Parameters
TypeNameDescription
System.StringpluginNamePlugin Name.
Type Parameters
NameDescription
TConfiguration Type.

GetConfigFile(string)

Get FileInfo to plugin config file.

Declaration
public FileInfo GetConfigFile(string pluginName)
Returns

System.IO.FileInfo: FileInfo of the config file.

Parameters
TypeNameDescription
System.StringpluginNameInternalName of the plugin.