dMZX Forums: Addendum to Documentation on Teleport Player -> MegaZeux Feature Requests -> Tracker

This isn't a bug, per say, but was something I spent 2 hours trying to solve a 'bug' in my script that wasn't a bug at all, but instead wasn't fully documented in the help.


Basically, the issue is that Teleport Player "BOARD" X Y even if it's teleporting to the same board acts as if the player was reinserted into the stage as if they were never there. This causes issues if you don't know this behavior in how you setup Robots to behave. I think for people like myself trying out this command would be served to know this is how the command works. I didn't find the existing description to imply this, much less explicitly state it. If there is another command that can instantly take a player from X1 Y1 to X2 Y2 in a single cycle without resetting Robot execution that a new Robotic scripter (like myself) should use in place of this, it might also be useful to mention it in the Help file's description of the command. Among things it affects if one is not aware of how Teleport Player works is: A non-global robot's variables will be reset. All Robots command execution will reset. JustEntered tag will be executed where used on the board.


I hope I posted this in the right place as I don't think it's a feature request or something to put in a bug report as it's neither, I just hoped it'd get seen as something to consider for the to-do list. Obviously this is low tier stuff.

Thanks for consideration.

This post has been edited by hseiken: 02 April 2021 - 11:25 PM

1) The same-board command you're looking for is PUT PLAYER # #. The next help file revision will have a listing arranged by type, so that should mitigate any need to mention the command in the TELEPORT PLAYER description.

2) TELEPORT PLAYER "board" # # does not seem to act the way you described, at least on 2.92f. While it does trigger any justentered labels that are present when doing a same-board teleport, it does not trigger a reset when the "Reset board on entry" board setting is active. Regardless, those first two conditions (the resets) you describe are effects of that board setting and would not happen through a typical TELEPORT PLAYER.

I've gone ahead and mentioned the justentered behavior, as even in my most recent revision that wasn't noted.

Re: the second point, I briefly looked at this last night. TELEPORT PLAYER "board" # # sends JUSTENTERED and also resets the TIME counter and the player restart coordinates, which is all presumably very old behavior. Robot state is otherwise unmodified. I can confirm that board asset loading and board reset on entry do not occur when TELEPORT PLAYER targets the current board.