Rpg Maker Developers Group

Original Source

• Original title: KC_MoveRouteTF - Rotate, Translate, and Scale Characters During Move Routes [MV / MZ]
• Original author: Kelly-inactive
• Original date: July 19, 2022
• Source thread: https://forums.rpgmakerweb.com/threads/kc_moveroutetf-rotate-translate-and-scale-characters-during-move-routes-mv-mz.149633/
• Source forum path: Game Development Engines > RPG Maker Javascript Plugins > JS Plugin Releases (RMMZ)

Summary

KC_MoveRouteTF 1.0.2 by Kelly Chavez​ Introduction I felt my cutscenes were a bit bland, so I wrote a few functions to let me add a little flair to my move routes.

Archived First Post

KC_MoveRouteTF 1.0.2
by Kelly Chavez​

Introduction
I felt my cutscenes were a bit bland, so I wrote a few functions to let me add a little flair to my move routes.

Features
This script is fairly minimal in terms of parameters. All they do is allow individual portions of the plugin to be disabled for compatibility. The real meat of this plugin is in the methods added to the character objects that can be easily accessed through move route commands.

Screenshots

How to Use
Using the script is as simple as adding it via the plugin manager and using the script calls in your move route commands.

Script Calls
All of these functions are accessed via the move route commands and prefixed with 'this.'. So, for example, to rotate a character 90 degrees clockwise, you would write 'this.rotate(90)' in the move route command. All arguments have default values used if they are not explicitly defined by the developer. See plugin help for more details.

• Getter Functions:
  • scaleX(), scaleY(), translationX(), translationY(), rotation()
  • Each of these functions returns the CURRENT value of their respective transformations
• Setter Functions:
  • rescaleXTo(scale, duration, wait), rescaleYTo(scale, duration, wait), rescaleTo(x, y, duration, wait), translateXTo(x, duration, wait), translateYTo(y, duration, wait), translateTo(x, y, duration, wait), rotateTo(angle, duration, wait)
  • rescaleX(scale, duration, wait), rescaleY(scale, duration, wait), rescale(x, y, duration, wait), translateX(x, duration, wait), translateY(y, duration, wait), translate(x, y, duration, wait), rotate(angle, duration, wait)
  • Each of these functions transforms the character's sprite. Functions suffixed with 'To' transform the character until they reach the value(s) passed into the function.
  • Functions not suffixed with 'To' offset the current transformation by that amount.
  • To demonstrate the difference between these functions, consider the function calls this.rescaleY(1) and this.rescaleYTo(1) on a character whose vertical scale is 1. this.rescaleY(1) would leave the character with a y scale of 2 (current scale + value = 1 + 1 = 2) whereas this.rescaleYTo(1) would leave the scale at 1.

Demo (MZ)
Current Version (1.0.2) - GitHub
Old Version (1.0.1) - GitHub
Old Version (1.0.0) - GitHub

Demo (MV)
Current Version (1.0.2) - Github
Old Version (1.0.1) - Github
Old Version (1.0.0) - N/A

Download
GitHub (Download 'KC_MoveRouteTF.js')

Compatibility Notes

• Plugin (MZ): VisuMZ_1_EventsMoveCore
  • This plugin's rotation functionality is incompatible with the "Dash tilt?" option of the listed plugin.

Changelog

• 2024/04/09 -v1.0.2
  • Fix 'Play Animation' sprite incorrect positioning bug in MV
    • Character would be incorrectly positioned while animations played if rotations were enabled
  • Fix crash upon load game in certain condition
    • Game would crash when loading a save file that was created without this plugin present
  • General internal code restructure
• 2022/07/20 - v1.0.1
  • Fixed aliasing on Game_CharacterBase.prototype.update
  • Changed how rotations are handled internally to support MV
• 2022/07/19 - v1.0.0
  • Initial Release

Terms and Credits
I've released this plugin under the MIT license. So, you can include this plugin in any project as long as you include the license with your distribution. For most projects, this requirement is fulfilled as long as you keep the license text that is at the top of the plugin's js file intact.

Also, though not strictly required, I would appreciate being credited as K. Chavez or Kelly Chavez in your games' credits.

Features Mentioned

• This script is fairly minimal in terms of parameters. All they do is allow individual portions of the plugin to be disabled for compatibility. The real meat of this plugin is in the methods added to the character objects that can be easily accessed through move route commands.

Downloads / Referenced Files

License / Terms Note

Terms and Credits I've released this plugin under the MIT license. So, you can include this plugin in any project as long as you include the license with your distribution. For most projects, this requirement is fulfilled as long as you keep the license text that is at the top of the plugin's js file intact. Also, though not strictly required, I would appreciate being credited as K. Chavez or Kelly Chavez in your games' credits.