Player VS Event position plugin

This plugin compares the position of the player and an event. Although it's very simple, it's also extremely useful!
Imagine you want to check if the player is on the left of an event. How would you do that in RMMV? Unless you use
an extremely complicated process, this might make the development of your game stop completely, or maybe you'll
have to abandon on an awesome idea! Well, this plugin is here to help you with that!

Script calls (to use with a conditional branch):

• this.eventVsEventDistance(distance, event1, event2) === true/false; checks if an event is within range of another event (range is determined by the 'distance' parameter).
• this.playerVsThisEventDistance(distance) === true/false; checks if the player is within range of the event (range is determined by the 'distance' parameter).
• this.playerVsThisEventPosition() === 'string';
• this.playerVsEventPosition(eventId) === 'string';

Possible strings:

1. 'up'
2. 'down'
3. 'left'
4. 'right'
5. 'center'
6. 'up-left'
7. 'up-right'
8. 'down-left'
9. 'down-right'

example:
this.playerVsThisEventPosition() === 'left'; ---> checks if the player is on the left of this player.
this.playerVsThisEventDistance(7) === true -> checks if the player is withing 7 tiles of the event.


This plugin can be used in association with a lot of different plugins to make tons of original content, so have fun with it!

Terms of use: Can be used for non-commercial as well as commercial games. Be sure to mention me, though! :D
(Having a copy of your game would also be nice ;) )

Thanks to Eis | Kino, GaryCXJk and Pivoo for helping me make this first plugin of mine! :p

24/10/17: v. 1.03 : the distance checker now checks in a circle (it was a square in v. 1.02)
24/10/17: v. 1.04 : fixed the bug of the plugin description not appearing in the plugin editor.

Download: github

hi you arrow key direction are not correct !
in rmmv it use numPad key direction

Hi, amazing plugin! Is there any possible way to check if the player is occupying the same space as an?

@Warped_Tales Sure, just type 'center' in the conditional branch, it should work normally :D
(also, thx for the remark, gonna update the description :p )

:kaoback:@Jonforum I don't really understand what you mean, do you want me to return 2, 4, 6 and 8 instead of 'down', 'left', 'right' and 'up' ?

Interesting! I can already imagine combining this with a player-event distance checker to pull off some smooth stealth mechanics.

@dahlys Actually, you can do the distance checker by checking the distance between the y and x positions of the player and event without using any plugins!

@DaedraTalos Yeah but it's easier with a plugin when I want to include a formula for distance (circle) and check line of sight (135 deg). And do this over and over again.

no sorry!. I had just misunderstood lol!
but yes you can also add number, these more powerful and fast than to compare 'string', but more hard for people who do not know the directions.

Plugin updated, new function this.playerVsThisEventDistance(distance) :D

Plugin fixed + updated! Please give me feedback! :D Also, if you have any ideas for a plugin, or for more futures for this plugin, please tell me! :p

@dahlys I added a function to check the distance in a circle :p Although it may not be enough for what you wanted ^-^

Plugin updated! New: bug fixes:

• a distance of 0 will indicate the event's location (it was 1 before)
• indicating 0 as an event will select the player instead

Hello @DaedraTalos ! What a wonderful plugin!

Update: added simplicity of access to variables data:
-when inputing the distance, you can put in any code just as before, but if you want to easily access variables, just add strings around the distance value, and use v[x] just like for usual rpg maker mv stuff.

Examples:
- this.eventVsEventDistance(5, 15, 20)
- this.eventVsEventDistance($gameVariables.value(15) - 2, 15, 20)
but now you can also use instead:
- this.eventVsEventDistance("v[15] - 2", 15, 20)