James' Easier Distance Conditions

じ☆ve冰风

        Distance Conditional 1.0
​

        Written By James Westbrook(assistance given by Galv)
​

Introduction


        Normally to make a conditional that makes an event happen if you(or another event) are X spaces close to an event, you have to either make a bunch of variables and assign each of them to the correct value of the event and player. Or you could write 4 lines of code that does it without the need of variables. With my plugin it's as simple as entering in one line of code.


        This can be used in any way, even commercial. Credit not necessary since this is the probably the simplest plugin out there.


Features


        This plugin has two basic functions:


        Allows you to make conditional statement that only happens if you are X away from the event.


        Or it allows you to make a conditional statement that only happens if an event is X away from another event.


        I would use screenshots here, but I cannot think of a way to show this, unless you were actively playing the demo yourself.


How to Use


        To install 1.0 of this plugin, you simply take the "JMW_DistanceConditional.js" file and copy it over to your project folder, inside the "plugins" folder which resides in "js". In your project, open the plugin manager. Double click on an empty space to add a plugin. In the drop down under "name" select "JMW_DistanceConditional". Then change the status to "on". Click "OK. Then click "OK" a second time, or click "APPLY".


        To use the script, make a new event command. The command you are entering is under the first tab, "Conditonal Branch". Go to the fourth tab and enter either of the script commands below into the box. 


JMW.checkDist(eventID, distance)


        This script command will be used when making things happen if the player is close enough to the event.


        You replace "eventID" with the ID of the event. "Distance" you replace with the number of how close you want to be to make the event happen. For example, if I put "JMW.checkDist(5,2)", if my character walked within 2 spaces near event 5, the specified actions in the conditional will go off!


JMW.checkEventsDist(eventNumber1, eventNumber2, distance)


        This command is if you want something to happen if two events get close enough.


        You replace "eventNumber1" with the first event's ID, and "eventNumber2" with the second event's ID. "Distance" you replace with the distance you want to be between them.


        For example, If I put "JMW.checkEventsDist(1,16,8), and events 1 and 16 were as little as 8 spaces close to each other, the actions specified in the conditional will occur!


        Demo


Demo 1.0


        Plugin Download:


Plugin 1.0


        Script

                Code:       

1. //-----------------------------------------------------------------------------
2. // James Westbrook's Distance Conditional
3. // Version 1.0
4. var Imported = Imported || {};
5. Imported.JMW_DistanceConditional = true;
7. var JMW = JMW || {};                // Main object
8. JMW.DC = JMW.DC || {};  // Plugin object
10. /*:
11. * @plugindesc Version 1.0 Checks how close the event is to the player/ another event.
12. *
13. * @author James Westbrook 1.0
14. *
15. * @param
16. * @desc
17. * @default
18. *
19. * @help
20. *Credits: James Westbrook for writing plugin, and Galv for
21. *assisting James in writing his first plugin.
22. *(find Galv at galvs-scripts.com)
23. *Allowed for any use. Credit not necessary since this
24. *is one of the easiest plugins to make.
25. *
26. * Normally when determining the distance between the player and an event(or an
27. *event with another event), you need four lines of scripting that you will have
28. *to insert into a conditional command. This plugin allows you to need only
29. *one line!
30. *
31. *Uses for this plugin:
32. *You can use this plugin to determine if the player is close enough to an
33. *event to meet the distance requirement. You are able to modify this distance
34. *number to suit your needs. You can also use it with two different events,
35. *instead of with a player.
36. *
37. *Script Calls:
38. *You can put either of the scripts in a conditional event.
39. *
40. *JMW.checkDist(eventID, X distance)
41. *
42. *JMW.checkEventsDist(eventNumber1, eventNumber2, distance)
43. *
44. *(read later in help for further instructions
45. * on how to use these calls)
46. *
47. *The first is used when you want the condition to be if
48. *the player is X close to the event. In "eventID"
49. *you fill in what the event's ID is.
50. *In "X distance" you fill in the distance you
51. *want. For example if I put "JMW.checkDist(4, 5)"
52. *, it would make the conditional would only
53. *be met if the player was within 5 spaces
54. *of event 4!
55. *
56. *The second script can be used to determine
57. *if two events were within X range. For
58. *example, if I put "JMW.checkEventsDist(7, 8, 5)"
59. * if events 7 and 8 were within 5 spaces, the
60. condition is met.
61. *The exact place you will be using these SCRIPT
62. *commands is found in the first tab when making
63. * an event. Under "Flow Control", select
64. *"Conditional Branch". Go to the fourth
65. *tab. At the bottom is the script option.
66. *Click onto the word "Script" and then
67. fill in the box with your script call!
68. *For a visual aid, refer to my Distance
69. *Conditional Demo!
70. *
71. *
72. */
73.    
75. (function() {
76.    
78. JMW.checkDist = function(eventNumber, playerDistance) {
79. return $gameMap.event(eventNumber)._x > $gamePlayer._x - playerDistance && $gameMap.event(eventNumber)._x < $gamePlayer._x + playerDistance && $gameMap.event(eventNumber)._y > $gamePlayer._y - playerDistance && $gameMap.event(eventNumber)._y < $gamePlayer._y + playerDistance
80. };
82. JMW.checkEventsDist = function(eventFirst, eventSecond, distanceSecond) {
83.     return $gameMap.event(eventFirst)._x > $gameMap.event(eventSecond)._x - distanceSecond && $gameMap.event(eventFirst)._x < $gameMap.event(eventSecond)._x + distanceSecond && $gameMap.event(eventFirst)._y > $gameMap.event(eventSecond)._y - distanceSecond && $gameMap.event(eventFirst)._y < $gameMap.event(eventSecond)._y + distanceSecond
84. };
85.    
86.        
89. })();

复制代码

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