dopan's prioCharZ.js

じ☆ve冰风

dopan's prioCharZ.js​


By default we could only change chars Z anchor by editing the "priorityType"..
This can be done with funny numbers to get the wanted result, but it overwrites the default data which is not stored anywhere else.
By default "priorityTypes" are the trigger for screenZ:

if priorityType = 0 # thats "below chara" and "screenZ_1"

if priorityType = 1 # thats "same as chara" and "screenZ_3"

if priorityType = 2 # thats "above chara" and "screenZ_5"

That happens because of these default rpgMV Functions:
Spoiler                JavaScript:       

1. Game_CharacterBase.prototype.screenZ = function() {
2.     return this._priorityType * 2 + 1;
3. };
5. //"screenZ()" gets updated with this from the Sprite_Character
7. Sprite_Character.prototype.updatePosition = function() {
8.     this.x = this._character.screenX();
9.     this.y = this._character.screenY();
10.     this.z = this._character.screenZ();
11. };

复制代码

This plugin Provides you with scriptcalls that can replace "priorityType", without overwriting it.
It can be reseted to default with scriptcalls aswell and the "priorityType" wont be Touched/Edited. It will be replaced instead.
(default "priorityType" remains as system default storage)

Basicly "._charZ" the PluginData which replaces "._priorityType", when "._charZ" is not Undefined, is a PlaceHolder & Script Clone of the "._priorityType"-script.

Spoiler: Meme

As soon "._charZ" is activated with the plugin scriptcalls, this works for:
(on these examples Number of eventId & dataId & _charZ must be added)

- $gameMap.event(eventId)._charZ;
# eventId start with 1 #

- $gamePlayer._charZ;
# ._charZ can be any number that returns a valid z.Anchor #

- $gamePlayer._followers._data[dataId]._charZ;   
# dataId start with 0 #


The plugin provides you with more scriptcalls and Infos, i just wanted to show the basic infos here

MIT Licence

Free to Use for any Project

GitHub Link

Plugin Code:
Spoiler                JavaScript:       

1. //=============================================================================
2. // prioCharZ.js
3. //=============================================================================
4. /*:
5. * @plugindesc v1.0 <prioCharZ> Controll the Z_Anchor of Chars & manipulate prioType
6. * @author dopan
7. *
8. *
9. *
10. *
11. * @help
12. *
13. * this plugin allows to change the z data of Chars
14. *
15. * it works for $gameMap.event(id) & $gamePlayer & "gameFollowers"
16. *
17. * this wont edit the prioType directly, and can be reseted to default prioType
18. *
19. * the default prioTypes have following default rpgMV maker system Z data:
20. *
21. * # prio0 = screenZ_1 # prio1 = screenZ_3 # prio2 = screenZ_5 #
22. *
23. * default rpgMV maker system prio 0 is called "belowChara"
24. *
25. * default rpgMV maker system prio 1 is called "sameAsChara"
26. *
27. * default rpgMV maker system prio 2 is called "aboveChara"
28. *
29. *
30. * __Plugin ScriptCalls __ ALWAYS INSERT NUMBERS AS DATA TO THE ScriptCall-ARRAYS
31. *
32. * # for $gameMap.event(id) # insert eventId number & zValue number
33. *
34. * - $gameMap.setCharPrio(eventId, zValue); # eventId of manipulated event ,zValue is the z Achor and can be any Number
35. *
36. * - $gameMap.resetCharPrio(eventId);       # eventId of event ,that will be reseted to default prioType data
37. *
38. * # for $gamePlayer # insert zValue number
39. *
40. * - $gamePlayer.setCharPrio(zValue);       # zValue is the z Achor and can be any Number, it replaces the prioType data
41. *
42. * - $gamePlayer.resetCharPrio();           # reset $gamePlayer to default prioType data
43. *
44. * # for $gamePlayer._followers # insert dataId number & zValue number
45. *
46. * - $gamePlayer._followers.setCharPrio([dataId], zValue); # dataId starts with 0 (decides which follower is triggered), zValue is the new Z Anchor
47. *
48. * - $gamePlayer._followers.resetCharPrio([dataId]);       # dataId starts with 0 (decides which follower is triggered)
49. *
50. *
51. *
52. *
53. * # default rpgMV maker system Scriptcalls to double check ScreenZ:
54. * (it cant change data it only shows the final data which is used, its often updated by the system)
55. *
56. * # for $gameMap.event(id) # insert eventId
57. *
58. * - $gameMap.event(eventId).screenZ();              # shows the Final Z data which is used for eventCharAnchor based on eventId
59. *
60. * # for $gamePlayer # insert nothing
61. *
62. * - $gamePlayer.screenZ();                        # shows the Final Z data which is used for gamePlayer Char Anchor
63. *
64. * # for $gamePlayer._followers # insert dataId number
65. *
66. * - $gamePlayer._followers._data[dataId].screenZ(); # dataId starts with 0 (decides which follower is triggered)
67. *---------------------------------------------------------------------------------------------------------------
68. *
69. * pls Note: All scriptCalls return the current active Z anchor in Console F8 !
70. *
71. *(Plugin scriptCalls return false if any added data/eventId/Number ect is wrong)
72. *
73. * CREDITS to Eliaquim who mentioned a similar idea in rpg maker Forum
74. *
75. * ============================================================================
76. * Terms of Use (MIT License)
77. * ============================================================================
78. * Free for any commercial or non-commercial project!
79. * (edits are allowed but pls dont claim it as yours without Credits.thx)
80. * ============================================================================
81. * Changelog
82. * ============================================================================
83. * Version 1.0:
84. * - first Release 08.11.2022 for rpg mv!
85. */
87. (function() {
89.   // Plugin param Variables:
91.   var parameters = PluginManager.parameters("prioCharZ") ||
92.   $plugins.filter(function (plugin) {return plugin.description.contains('<prioCharZ>')});
94. //-----------------------------------------------------------------------------------------
96. // replace Default function
97. // dopan add Z controll.. by default=> # prio0 = screenZ 1 # prio1 = screenZ 3 # prio2 = screenZ 5 #
98. Game_CharacterBase.prototype.screenZ = function() {
99.     // if new Z was installed
100.     if (this._charZ !== undefined) return this._charZ;
101.     // default function usage
102.     return this._priorityType * 2 + 1;
103. };
105. // new functions:
107.     Game_Map.prototype.setCharPrio = function(eventId, zValue) {
108.         var evId = eventId; var charZ = zValue;
109.         if (this.event(evId) && charZ) this.event(evId)._charZ = charZ; return this.event(evId)._charZ
110.         return false;
111.     };
113.     Game_Map.prototype.resetCharPrio = function(eventId) {
114.         if (this.event(evId)._charZ !== undefined) this.event(evId)._charZ = undefined; return this.event(evId).screenZ();
115.         return false;
116.     };
118.     Game_Player.prototype.setCharPrio = function(zValue) {
119.         var charZ = zValue;
120.         if (charZ) this._charZ = charZ; return this._charZ
121.         return false;
122.     };
124.     Game_Player.prototype.resetCharPrio = function() {
125.         if (this._charZ !== undefined) this._charZ = undefined; return this.screenZ();
126.         return false;
127.     };
129.     Game_Followers.prototype.setCharPrio = function(dataId, zValue) {
130.         var dId = dataId; var charZ = zValue;
131.         if (dId && charZ) this._data[dId]._charZ = charZ; return this._data[dId]._charZ
132.         return false;
133.     };
135.     Game_Followers.prototype.resetCharPrio = function(dataId) {
136.         var dId = dataId;
137.         if (dId && this._charZ !== undefined) this._data[dId]._charZ = undefined; return this._data[dId].screenZ();
138.         return false;
139.     };
141. //--End:
143. })();

复制代码

If anybody finds a Bug, it must be a typo, in such case pls let me know and i will fix it asap..
----
----
SideNote:
if anybody is looking for a free plugin that can manipulate the x/y Anchors of Chars pls visit here:
Character Anchors

Character Anchors 2019.02.13 by Shaz  Introduction This plugin allows you to adjust the position of a character's sprite by changing the X and/or Y anchors. This would allow you, for example, to have a sprite that is larger than 48x48 centered both vertically and horizontally on the tile...

                                        forums.rpgmakerweb.com                               






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