- Joined
- Sep 12, 2016
- Messages
- 645
- Reaction score
- 530
- First Language
- German
- Primarily Uses
- RMMV
More Hud Faces (Moghunter Extension) v1.2.2
LadyBaskerville
IntroductionLadyBaskerville
Moghunter / Atelier Rgss provides visually impressive plugins to show your actors' faces on the screen, be it in battle or on the map. However, the MV plugins do not provide an easy way to change the graphic assigned to an actor mid-game. This extension now adds this functionality.
Features
This plugin is an extension to the following Moghunter plugins:
RMV - Battle Hud
RMV - Actor Hud
RMV - Party Hud
You can use this extension with any combinations of those plugins.
The current version of this extension plugin is made for the plugin versions Battle Hud 3.7, Actor Hud 1.9, and Party Hud 1.3. It will probably not work with older versions. (Version 1.0.1 of this extension is still available for download, if you are using older versions of Moghunter's plugins and cannot / do not want to update them.)
This extension plugin provides Plugin Commands and Script Calls to change the face graphics used in Moghunter's Battle HUD, Party HUD and/or Actor HUD mid-game. You can also specify a different default face file for each actor using notetags.
Apart from manually changing the HUD face graphic during the game, you can now assign face graphics for different states to an actor, and the graphic will change automatically when the actor is afflicted by the respective states. You can set these up with notetags in the actor notebox, or change them during the game with Plugin Commands and Script Calls. The state with the highest priority will determine the face graphic used. If there is no face graphic assigned to the actor for this state, the state with the next highest priority will determine the face graphic. If there is no face graphic assigned for ANY of the actor's states, the default face graphic will be used instead.
How to use
To use this plugin, place it below Moghunter's plugins in your plugin list.
Plugin Commands
Change HUD faces immediately:
Code:
change_ahud_face ACTOR_ID FILENAME
change_bhud_face ACTOR_ID FILENAME
change_phud_face ACTOR_ID FILENAME
Immediately change the face file used in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud). This also changes the face file used by default when the actor is not afflicted by any states.
Example:
Code:
change_ahud_face 1 HaroldFace12
Set faces to show based on state:
Code:
set_ahud_face ACTOR_ID STATE_ID FILENAME
set_bhud_face ACTOR_ID STATE_ID FILENAME
set_phud_face ACTOR_ID STATE_ID FILENAME
Set the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
Enter 0 as the state ID to change the face file used by default when the actor is not afflicted by any states.
Example:
Code:
set_ahud_face 1 4 HaroldFacePoison
Clear state faces assigned to the actor:
Code:
clear_ahud_face ACTOR_ID STATE_ID
clear_bhud_face ACTOR_ID STATE_ID
clear_phud_face ACTOR_ID STATE_ID
Clear the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. If the actor is afflicted by this state, the face graphic will no longer automatically change.
Script Calls (advanced)
The following functions have been added to Game_Actor:
Change HUD faces immediately:
Code:
changeAhudFace(FILENAME)
changeBhudFace(FILENAME)
changePhudFace(FILENAME)
Immediately change the face file used in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
This also changes the face file used by default when the actor is not afflicted by any states.
Example:
Code:
$gameActors.actor(1).changeAhudFace("HaroldFace12")
Set faces to show based on state:
Code:
setAhudFace(STATE_ID, FILENAME)
setBhudFace(STATE_ID, FILENAME)
setPhudFace(STATE_ID, FILENAME)
Set the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
Enter 0 as the state ID to change the face file used by default when the actor is not afflicted by any states.
Example:
Code:
$gameActors.actor(1).setAhudFace(4, "HaroldFacePoison")
Clear state faces assigned to the actor:
Code:
clearAhudFace(STATE_ID)
clearBhudFace(STATE_ID)
clearPhudFace(STATE_ID)
Clear the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. If the actor is afflicted by this state, the face graphic will no longer automatically change.
Notetags
You can specify a different face file to be used at the start of the game with the following notetags in the Actor tab:
Code:
<AHudFace: FILENAME>
<BHudFace: FILENAME>
<PHudFace: FILENAME>
Use the file FILENAME.png to represent this actor in the Actor, Battle, or Party HUD by default. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
Code:
<AHudFace State STATE_ID: FILENAME>
<BHudFace State STATE_ID: FILENAME>
<PHudFace State STATE_ID: FILENAME>
Automatically change the actor's face graphic in the Actor, Battle, or Party HUD to FILENAME.png when the actor is afflicted with the state. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
Plugin
Download it here: MOG_X_MoreHudFaces.js
(If you are using older versions of Moghunter's HUD plugins and cannot / do not want to update them, you can still download version 1.0.1 of the extension here: MOG_X_MoreHudFaces_v101.js
Credit and Thanks
- LadyBaskerville (optional)
- Moghunter
Terms of Use
- Free for use in both non-commercial and commercial games.
- You may repost and edit this plugin.
Version 1.2.2
- Fixed a bug where animated faces would not display properly when the face graphic was changed in battle.
Version 1.2.1
- Fixed a bug with Party and Battle HUD when there were less than 4 members.
Version 1.2.0
- Added notetags, plugin commands and script calls to set up automatic state faces: The face graphic can be changed based on the states the actor is afflicted with.
- Cleaned up the documentation.
Version 1.1.1
- Fixed a bug where changing the battle HUD image would try to load an image from the actor HUD folder.
Version 1.1.0
- Reworked the plugin to work with Moghunter's updated plugins.
- Added script calls.
- Faces are now changed without refreshing the entire HUD.
Version 1.0.1
- Only refresh the HUDs when the face graphic has changed.
Version 1.0.0
- Finished the plugin.
- Fixed a bug where animated faces would not display properly when the face graphic was changed in battle.
Version 1.2.1
- Fixed a bug with Party and Battle HUD when there were less than 4 members.
Version 1.2.0
- Added notetags, plugin commands and script calls to set up automatic state faces: The face graphic can be changed based on the states the actor is afflicted with.
- Cleaned up the documentation.
Version 1.1.1
- Fixed a bug where changing the battle HUD image would try to load an image from the actor HUD folder.
Version 1.1.0
- Reworked the plugin to work with Moghunter's updated plugins.
- Added script calls.
- Faces are now changed without refreshing the entire HUD.
Version 1.0.1
- Only refresh the HUDs when the face graphic has changed.
Version 1.0.0
- Finished the plugin.
Last edited: