Altimit Character Animations [0.01α]

じ☆ve冰风

Altimit Character Animations 0.01 alpha

This is an open-source project, feel free to clone the repository and make pull requests.

About

This Plugin adds the ability to greatly extend the animation system for character sprites.

Altimit Character Animations offers flexibility that no-other character animation Plugin can through the use of Javascript as a scripting method for selecting your animation states.

This allows custom states to be created and custom conditions to be written to massively expand how character animations can be done.

The goal is for Altimit Character Animations to be the ultimate extra-frames Plugin.

Download Latest Version

• Download Plugin (Right-click, save-as)
  
• View on GitHub
  

Features

• 8 direction support
  
• Unlimited animation frames
  
• Any sized, any layout sprite-sheets
  
• Compatibility with Altimit Movement, including XML defined colliders
  
• Javascript scripting interface
  

Alpha Release

The alpha release is the early days of the Plugin whilst the API is assessed and features added.

The goal is to bring it up to par with other existing extra-frames Plugins and provide everything needed for developers to create a game using all the features available with the Plugin.

Known Issues

The latest issues are listed on the project page at the following URL: github.com/AltimitSystems/mv-plugins/issues

Feel free to report issues in this thread or create a new issue on the project tracker (label as Altimit Character Animations).

API

$params includes the following properties:

• direction - character facing direction
  
• direction4 - direction limited to up, down, left, right
  
• direction8 - for use with 8 direction movement, some Plugins will let you use normal "direction"
  
• travelled - How many pixels has the character moved since the last frame
  

• state - contains character's current state and how many frames they've been in the state
  
• lastState - contains character's previous state (if there is one)
  
• override - Boolean set to true if the state has been overridden with a custom state
  

• tilesetId - sprite tileset ID
  
• tileId - sprite tile ID
  
• characterName - This should be the same as the XML file name
  
• characterIndex - Sprite index on multi-sprite character sheets
  
• character - Game_Character, comes with all properties that Game_Character has. Very powerful!
  

• isDebugThrough - Boolean set to true when debug walk-through-walls is active
  
• isDashButtonPressed - Different to $params.state.dashing
  
• isOnDamageFloor - Character on floor damage tile (applies only to Player by default)
  

The in-built states are:

• state.bush - Character is in a bush
  
• state.dashing - Character is dashing (running)
  
• state.jumping - Character is jumping
  
• state.ladder - Character is on ladder
  
• state.moving - Character is moving
  
• state.idle - Character is doing nothing
  

Custom states should not use these names. So if you want a state for when your character is handsome, don't call it "dashing", call it "handsome" and then you can reference it with $params.state.handsome

The animation return structure has the following options:

• animation - ID of the XML animation to play-back
  
• oneShot - Boolean, if set to true then the animation will play once and stop on the last frame (default false)
  
• scaleX - Scales sprite in X axis (default 1)
  
• scaleY - Scales sprite in Y axis(default 1)
  
• speed - Play-back speed multiplier (default 1)
  

Both the XML animation-list and animation tags support scaling properties "sx" and "sy":
                Code:       

1. <!-- All sprite frames will be 2x bigger -->
2. <animation-list sheet="my_sheet" sx="2" sy="2">
4.     <!-- When this animation is playing, sprite will be 50% sized -->
5.     <!-- Combined with the animation-list scale, this results in a 1x (normal!) sized sprite -->
6.     <animation id="my_animation" sx="0.5" sy="0.5">
8.         <!-- Frames go here -->
10.     </animation>
12. </animation-list>

复制代码

These scaling properties can be used to mirror sprites; simply scale with a negative value. This is useful if you want to re-use sprite frames for both the left and right directions.

Usage

To add a character animation extension to a sprite sheet simply create an XML file in the img/characters folder with the same file name as the character sheet you wish to extend.

For example, to extend Actor1.png we'd create Actor1.xml next to it.

There are two required structures in the XML file:

• animation-list
  
• script
  

The animation list must contain a property defining which image to use as a source of the extra frames.

So to extend Actor1.png with Actor1_extra.png our XML file should look similar to this:
                HTML:       

1. <!-- Notice Actor1_extra, this says "Use Actor1_extra.png for these frames" -->
2. <animation-list sheet="Actor1_extra">
3. </animation-list>
5. <!-- The script is where we write our animation state logic -->
6. <script>
7. </script>

复制代码

Let's say we want to add an "idle" animation for when the first Actor1 character is waiting around for more than 10 seconds (600 frames).

We first need to write out where in the Actor1_extra these "idle" animation frames are.
                HTML:       

1. <animation-list sheet="Actor1_extra">
3.     <!-- Our idle animation for when the character is facing "down" -->
4.     <!-- The "rate" is the frames-per-second of the animation -->
5.     <animation id="idle_south" rate="10">
7.         <!-- The animation frames -->
8.         <!-- These are texture co-ordinates on the sprite sheet -->
9.         <!-- In this example, one frame is 64x64 pixels and there are 5 frames, left-to-right -->
10.         <frame x="0" y="0" width="64" height="64" />
11.         <frame x="64" y="0" width="64" height="64" />
12.         <frame x="128" y="0" width="64" height="64" />
13.         <frame x="196" y="0" width="64" height="64" />
14.         <frame x="256" y="0" width="64" height="64" />
16.     </animation>
18. </animation-list>
20. <script>
21. </script>

复制代码

Now that we've written out where the animation frames for our down-facing idle animation is we need to write script logic for selecting the frames.

                HTML:       

1. <animation-list sheet="Actor1_extra">
3.     <animation id="idle_south" rate="10">
5.         <frame x="0" y="0" width="64" height="64" />
6.         <frame x="64" y="0" width="64" height="64" />
7.         <frame x="128" y="0" width="64" height="64" />
8.         <frame x="196" y="0" width="64" height="64" />
9.         <frame x="256" y="0" width="64" height="64" />
11.     </animation>
13. </animation-list>
15. <!-- Scripting is in Javascript -->
16. <script>
17.     // The $params variable holds information about the current state
18.     // The script must return a structure defining the animation
19.   
20.     // If we are facing south and have been idle for over 10 seconds (600 frames)
21.     if ( $params.direction == 2 && $params.state.idle > 600 ) {
22.         // Play the idle_south animation, defined in XML
23.         // oneShot will play the animation once and stay on the final frame
24.         return { animation: "idle_south", oneShot: true };
25.     }
26. </script>

复制代码

For an idea of how advanced this can be, animations for "enter idle" can be defined and the $params.state.idle frames can be used to detect the start of idling, then after N frames it can play an "idle loop" animation.

Character states can be override with custom states also. If I wanted to set a "fishing" state to $gamePlayer I can call $gamePlayer.extraStateSet( ["fishing"] ). If I want to stop overriding states (such as fishing has been completed) I can use $gamePlayer.extraStateReset().


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