Interface INamePlateUpdateHandler
A class representing a single nameplate. Provides mechanisms to look up the game object associated with the nameplate and allows for modification of various backing fields in number and string array data, which in turn affect aspects of the nameplate's appearance when drawn. Instances of this class are only valid for a single frame and should not be kept across frames.
Assembly: Dalamud.dll​
public interface INamePlateUpdateHandler
Properties​
GameObjectId​
Gets the GameObjectId of the game object associated with this nameplate.
ulong GameObjectId { get; }
GameObject​
Gets the Dalamud.Game.ClientState.Objects.Types.IGameObject associated with this nameplate, if possible. Performs an object table scan and caches the result if successful.
IGameObject? GameObject { get; }
InfoView​
Gets a read-only view of the nameplate info object data for a nameplate. Modifications to
Dalamud.Game.Gui.NamePlate.NamePlateUpdateHandler fields do not affect fields in the returned view.
INamePlateInfoView InfoView { get; }
ArrayIndex​
Gets the index for this nameplate data in the backing number and string array data. This is not the same as the rendered or object index, which can be retrieved from Dalamud.Game.Gui.NamePlate.INamePlateUpdateHandler.NamePlateIndex.
int ArrayIndex { get; }
BattleChara​
Gets the Dalamud.Game.ClientState.Objects.Types.IBattleChara associated with this nameplate, if possible. Returns null if the nameplate has an associated Dalamud.Game.ClientState.Objects.Types.IGameObject, but that object cannot be assigned to Dalamud.Game.ClientState.Objects.Types.IBattleChara.
IBattleChara? BattleChara { get; }
PlayerCharacter​
Gets the Dalamud.Game.ClientState.Objects.SubKinds.IPlayerCharacter associated with this nameplate, if possible. Returns null if the nameplate has an associated Dalamud.Game.ClientState.Objects.Types.IGameObject, but that object cannot be assigned to Dalamud.Game.ClientState.Objects.SubKinds.IPlayerCharacter.
IPlayerCharacter? PlayerCharacter { get; }
NamePlateInfoAddress​
Gets the address of the nameplate info struct.
nint NamePlateInfoAddress { get; }
NamePlateObjectAddress​
Gets the address of the first entry associated with this nameplate in the NamePlate addon's int array.
nint NamePlateObjectAddress { get; }
NamePlateKind​
Gets a value indicating what kind of nameplate this is, based on the kind of object it is associated with.
NamePlateKind NamePlateKind { get; }
UpdateFlags​
Gets the update flags for this nameplate.
int UpdateFlags { get; }
TextColor​
Gets or sets the overall text color for this nameplate. If this value is changed, the appropriate update flag will be set so that the game will reflect this change immediately.
uint TextColor { get; set; }
EdgeColor​
Gets or sets the overall text edge color for this nameplate. If this value is changed, the appropriate update flag will be set so that the game will reflect this change immediately.
uint EdgeColor { get; set; }
MarkerIconId​
Gets or sets the icon ID for the nameplate's marker icon, which is the large icon used to indicate quest availability and so on. This value is read from and reset by the game every frame, not just when a nameplate changes. Setting this to 0 disables the icon.
int MarkerIconId { get; set; }
NameIconId​
Gets or sets the icon ID for the nameplate's name icon, which is the small icon shown to the left of the name. Setting this to -1 disables the icon.
int NameIconId { get; set; }
NamePlateIndex​
Gets the nameplate index, which is the index used for rendering and looking up entries in the object array. For number and string array data, Dalamud.Game.Gui.NamePlate.INamePlateUpdateHandler.ArrayIndex is used.
int NamePlateIndex { get; }
DrawFlags​
Gets the draw flags for this nameplate.
int DrawFlags { get; }
VisibilityFlags​
Gets or sets the visibility flags for this nameplate.
int VisibilityFlags { get; set; }
IsUpdating​
Gets a value indicating whether this nameplate is undergoing a major update or not. This is usually true when a nameplate has just appeared or something meaningful about the entity has changed (e.g. its job or status). This flag is reset by the game during the update process (during requested update and before draw).
bool IsUpdating { get; }
IsPrefixTitle​
Gets or sets a value indicating whether the title (when visible) will be displayed above the object's name (a prefix title) instead of below the object's name (a suffix title).
bool IsPrefixTitle { get; set; }
DisplayTitle​
Gets or sets a value indicating whether the title should be displayed at all.
bool DisplayTitle { get; set; }
Name​
Gets or sets the name for this nameplate.
ReadOnlySeString Name { get; set; }
NameParts​
Gets a builder which can be used to help cooperatively build a new name for this nameplate even when other plugins modifying the name are present. Specifically, this builder allows setting text and text-wrapping payloads (e.g. for setting text color) separately.
NamePlateSimpleParts NameParts { get; }
Title​
Gets or sets the title for this nameplate.
ReadOnlySeString Title { get; set; }
TitleParts​
Gets a builder which can be used to help cooperatively build a new title for this nameplate even when other plugins modifying the title are present. Specifically, this builder allows setting text, text-wrapping payloads (e.g. for setting text color), and opening and closing quote sequences separately.
NamePlateQuotedParts TitleParts { get; }
FreeCompanyTag​
Gets or sets the free company tag for this nameplate.
ReadOnlySeString FreeCompanyTag { get; set; }
FreeCompanyTagParts​
Gets a builder which can be used to help cooperatively build a new FC tag for this nameplate even when other plugins modifying the FC tag are present. Specifically, this builder allows setting text, text-wrapping payloads (e.g. for setting text color), and opening and closing quote sequences separately.
NamePlateQuotedParts FreeCompanyTagParts { get; }
StatusPrefix​
Gets or sets the status prefix for this nameplate. This prefix is used by the game to add BitmapFontIcon-based online status icons to player nameplates.
ReadOnlySeString StatusPrefix { get; set; }
TargetSuffix​
Gets or sets the target suffix for this nameplate. This suffix is used by the game to add the squared-letter target tags to the end of combat target nameplates.
ReadOnlySeString TargetSuffix { get; set; }