Positioning Characters - shawna-p/mysterious-messenger GitHub Wiki

Notice

These pages are out of date! The most recent version of the documentation can be found here: https://mysterious-messenger.readthedocs.io/en/stable/

This page is retained so that it can still be linked to.

Writing a VN Section

Example files to look at: tutorial_6_meeting.rpy, tutorial_3b_VN.rpy

There are several pre-defined positions you can move the characters to. These are:

  • vn_farleft
  • vn_left
  • vn_midleft
  • vn_center
  • vn_midright
  • vn_right
  • vn_farright
  • default

Not every position will work for every character due to spacing and differences in sprite design. You can define more positions in vn_variables.rpy under Transforms/VN Positions.

vn_center is a unique position because it moves the character closer to the screen in addition to centering them. It's often used to imply the character is talking directly to the player. However, if you want to move a character who is currently shown in the vn_center position to another position, you have to hide them first. See the example files for examples of this.

To show a character at a given position, write

show jumin front at vn_right

where jumin front is the name + attributes of the character you want to show (e.g. expressions, outfits, etc), and vn_right is the position to show them in. You can also add a transition like so:

show jumin side happy at vn_left with ease

where ease is a transition. (See Transitions in the Ren'Py documentation for more).