Anyone's Message_Face_Switcher v1.2

じ☆ve冰风

Anyone's Message_Face_Switcher v1.2
by Anyone
​

Introduction:
This is a small plugin made for my current project that allows the game to switch out the message face for the face of an actor designated in the message face's file name.

Features:

• Easy switching of faces to actor faces without using escape codes in the message text
  
• Compatible with plugins that hard-edit the command101 (such as Yanfly's Message Core)
  
• The exchange happens early in the message generation, meaning that all text escape codes within the actual message text will act as if that face had been the face assigned in the editor from the start
  
• With normal faces, this saves you the time of using an escape like \af[x] to call the actor's face. With face busts plugins, especially the more complex ones, that load the message face from the message face name (such as Irina's VisualNovelBusts), this is essential to load a different bust as face in a seemless way without glitches and other bugs. (For example if your character has a different bust based on the equipment you're wearing)
  
• New: (v1.2) Redirection to other Files possible through prefix and suffix
  

How To Use:
1. Load the plugin preferably close to the bottom of your load order and activate it.
2. Create a *.png file that you wish to use as placeholder of the actor's face and ensure that it contains "_Actor" followed by the number of the ActorId of the actor whose face you wish to load.
Example: Harold_Actor1.png
3. Use the "Harold_Actor1.png" as the face when creating the "Show Text" function in your dialogue event. Regardless of whether Harold_Actor1.png is an empty png file, or contains some other face, this face will instead be switched to whatever face has currently been assigned to Actor1.

Alternatively, you can also use the phrase "_Partymember" in the *.png files' name to instead reference the face of the current party member in the slot.

Take care: the Actor ID's count from 1,2,3,4...
While the Partymember starts with 0 for the party leader: 0,1,2,3
This means that Actor 2 is "_Actor2" but Partymember 2 is "_Partymember1".

FAQ:
Q: The face isn't getting loaded.
A: Make sure you include the "_" sign in front of Actor. This is done to ensure that it won't pick up stuff like Factor12 as valid terms.
HaroldActor1.png is incorrect
Harold_Actor1.png is correct

Q: The wrong Partymember face is assigned.
A: Keep in mind that partymembers are counted from 0. If you want to reference the Partyleader in Slot 1, use...
_Partymember0.png
The Partymembers 2,3 etc. need -1 deducated from their number.

Partymember 3:
_Partymember2.png

Terms of Use:

• 1. This plugin can be used for free in free and commercial games alike.
  
• 2. Credit must be given to "Anyone".
  
• 3. The code may be edited & altered to your liking.
  
• 4. Redistribution of the original code as well as of edited versions is allowed, so long as proper credit is given.
  

Demo:
New Demo Version!
Equip items and see the message window face use the correct face.
(This is made possible with the Way_Core and Way_OnEquip plugins)
https://workupload.com/file/3NJTLPD4


Spoiler: Anyone's Message Face Switcher v1.0

                Code:       

1. /*:
2. *
3. * @plugindesc Version 1.2. This plugin switches the Message Window Face for the Actor's current Face.
4. *
5. * @author Anyone
6. *
7. * @param Redirect from ActorFace to Image
8. * @type boolean
9. * @on YES
10. * @off NO
11. * @desc Instead of direction to an Actor, it directs to another face based on the prefix
12. * designated in the Reference Phrase Prefix.
13. * @default false
14. *
15. * @param Reference Phrase Prefix
16. * @desc Instead of directing to an Actor, it directs to prefix + ActorFaceFile.
17. * @default prefix_
18. * @help
19. *
20. * @param Reference Phrase Suffix
21. * @desc Instead of directing to an Actor, it directs to ActorFaceFile + suffix.
22. * @default _suffix
23. * @help
24. *
25. * //==========================================================================//
26. * //                     Anyone's Message Face Switcher                         //
27. * //========================================================================//
28. *                            //~~~~~~~~~~~~~~//
29. *                           //   by Anyone  //
30. *                          //~~~~~~~~~~~~~~//
31. *
32. *
33. *
34. * This script allows you to use a placeholder face for an Actor that will switch
35. * out with the Actor's current face.
36. * Simply ensure that the term "_Actor" lower/uppercase insensitive is in the
37. * placeholder face file's name, followed by a number.
38. * So if you use an empty face as a png file called:
39. * "Harold's_Placeholder_Face_Actor1.png"
40. * the "_Actor1" will be detected and the face of Actor 1 will be used instead of
41. * the placeholder face.
42. *
43. * Alternatively you can also use "_Partymember" followed by a number to use a
44. * placeholder for a partymember. Keep in mind that Slot 1, the leader, is
45. * Partymember 0.
46. *
47. * Partymember1 (Leader): _Partymember0.png
48. * Partymember2 (Leader): _Partymember1.png
49. * Partymember3 (Leader): _Partymember2.png
50. * Partymember4 (Leader): _Partymember3.png
51. *
52. * Additionally, instead of directing to the Actor, you can also redirect from
53. * the Actor to a different file based on suffixes and prefixes.
54. * To do so, activate "Redirect from ActorFace to Image" in the plugin parameters
55. * by setting it to true. Then configure the prefix and the suffix for the image
56. * you intend to redirect to.
57. *
58. * E.g. Prefix: "Bust_" and Suffix: "_[Exp5x2]"
59. * The Face assigned to the Actor 1 is "David.png" in img\faces
60. * By using any face image as message face that contains "Actor1" inside the name
61. * the message window face will switch to David.png because this is Actor1's face.
62. * From there, with the Redirection active, it will actually switch over to
63. * Bust_David_[Exp5x2].png and use this as the message window face.
64. *
65. * //==========================================================================//
66. * //                          When is that useful?                           //
67. * //========================================================================//
68. *
69. * If your character's face changes throughout the game, and you want to have the
70. * current one displayed without having * to resort to in-message escapes such as
71. * yanfly's \af[x] to adjust it.
72. *
73. * While that may not seem big...it's huge for plugins that use face busts based
74. * on the message face which use their own escapes in the message text.
75. *
76. * Plugins such as Irina's VisualNovelBusts plugin are almost entirely
77. * incompatible with yanfly's \af[] escapes and at best create glitchy, laggy
78. * busts and at worst, either bug out or don't function at all.
79. *
80. * Since this plugin ensures the switch happens before the message text is even
81. * read,
82. * the switch is entirely seemless as if that face had been the one assigned to
83. * the message from the very beginning.
84. *
85. * //==========================================================================//
86. * //                             TERMS OF USE                                //
87. * //========================================================================//
88. *
89. * 1. This plugin can be used for free in free and commercial games alike.
90. * 2. Credit must be given to "Anyone".
91. * 3. The code may be edited & altered to your liking.
92. * 4. Redistribution of the original code as well as of edited versions is allowed,
93. * so long as proper credit is given.
94. *
95. * //==========================================================================//
96. * //                              CHANGELOG                                  //
97. * //========================================================================//
98. *
99. * Version 1.2:
100. * - Added Suffix Sheet redirection (25th of December 2019)
101. *
102. * Version 1.1:
103. * - Added Prefix Sheet redirection (19th of November 2019)
104. *
105. * Version 1.0:
106. * - Released (12th of November 2019)
107. *
108. */
110. var Imported = Imported || {};
111. Imported.ANY_Message_Face_Switcher = true;
112. var ANY = ANY || {};
113. ANY.MessageFaceSwitcher = ANY.MessageFaceSwitcher || {};
116. (function() {
118. var params = PluginManager.parameters('ANY_Message_Face_Switcher');
119. ANY.MessageFaceSwitcher.UseSheet = String(params['Redirect from ActorFace to Image']);
120. ANY.MessageFaceSwitcher.UseSheet = eval(ANY.MessageFaceSwitcher.UseSheet);
121. ANY.MessageFaceSwitcher.DirectPrefix = String(params['Reference Phrase Prefix'] || "");
122. ANY.MessageFaceSwitcher.DirectSuffix = String(params['Reference Phrase Suffix'] || "");
124. var _IS_Game_Message_Show_Text = Game_Interpreter.prototype.command101;
125. Game_Interpreter.prototype.command101 = function() {
126.         _IS_Game_Message_Show_Text.call(this);
127.         var _IS_ActorId = $gameMessage.faceName().match(/_Actor(\d+)/i);
128.         if (_IS_ActorId) {
129.                 var _Actor_faceName_To_Use = $gameActors.actor(_IS_ActorId[1]).faceName();
130.                 var _Actor_faceIndex_to_Use = $gameActors.actor(_IS_ActorId[1]).faceIndex();
131.                 if (ANY.MessageFaceSwitcher.UseSheet == true) {
132.                         _Actor_faceName_To_Use = ANY.MessageFaceSwitcher.DirectPrefix + _Actor_faceName_To_Use + ANY.MessageFaceSwitcher.DirectSuffix;
133.                         $gameMessage.setFaceImage(_Actor_faceName_To_Use, _Actor_faceIndex_to_Use);
134.                 } else {
135.                 $gameMessage.setFaceImage(_Actor_faceName_To_Use, _Actor_faceIndex_to_Use)};
136.         } else {
137.         var _IS_PartyId = $gameMessage.faceName().match(/_Partymember(\d+)/i);
138.         if (_IS_PartyId) {
139.                 var _Party_Is_Actor = $gameParty.members()[_IS_PartyId[1]].actorId()
140.                 var _Party_faceName_To_Use = $gameActors.actor(_Party_Is_Actor).faceName();
141.                 var _Party_faceIndex_to_Use = $gameActors.actor(_Party_Is_Actor).faceIndex();
142.                 if (ANY.MessageFaceSwitcher.UseSheet == true) {
143.                         _Party_faceName_To_Use = ANY.MessageFaceSwitcher.DirectPrefix + _Party_faceName_To_Use + ANY.MessageFaceSwitcher.DirectSuffix;
144.                         $gameMessage.setFaceImage(_Party_faceName_To_Use, _Party_faceIndex_to_Use);
145.                 } else {
146.                 $gameMessage.setFaceImage(_Party_faceName_To_Use, _Party_faceIndex_to_Use)};
147.                 }
148.         }
149. };
153. })();

复制代码

Also attached as *.rar archive.

Have fun.

CHANGELOG:
-v1.2
Added new Demo version, added a Redirect Functionality


本贴来自国际rpgmaker官方论坛作者:Anyone处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/anyones-message_face_switcher-v1-2.115168/