An open library of RPG Maker MV plugins, powered by the community.

PGMV - The Community-Driven Plugin Library for RPG Maker MV

MV plugins

TM Cloud Dust - TMCloudDust.js

Plugin desc : Adds dust effects to jumps and dashes.

License : MIT License

Author : tomoaky

Desc page : https://github.com/munokura/tomoaky-MV-plugins

Download Page : https://raw.githubusercontent.com/munokura/tomoaky-MV-plugins/refs/heads/master/TMCloudDust.js

File name : TMCloudDust.js

Help of plugin :

@plugindesc Adds dust effects to jumps and dashes.
@author tomoaky
@url https://github.com/munokura/tomoaky-MV-plugins
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/tomoaky-MV-plugins ).
Original plugin by tomoaky.
-----
TMPlugin - Dust Smoke ver2.1.0

How to Use:

Save the dust image distributed with the plugin in the img/system folder. The file name is Dust1.png.
If you need to change the file name, please also change the dustImage plugin parameter.
https://github.com/munokura/tomoaky-MV-plugins/tree/master/img/system

When the plugin is enabled, dust will be displayed when the character lands after a jump.
Dust will also be displayed when the player sprints (by holding down the shift key or clicking).

You can also use the plugin command to display dust at specified coordinates at any time.

This plugin has been tested with RPG Maker MV Version 1.5.0.

This plugin is distributed under the MIT License and is free to use, including for commercial purposes, modifications, and redistribution.

Plugin Command:

setDustXy 5 8
Displays dust at the specified coordinates. The values are the same as the coordinates used in the "Move Location" Event's Contents, not the screen resolution.
You can also specify a point halfway between coordinates (5, 8) and (6, 8) by entering a decimal point, such as setDustXy 5.5 8.

setDustXy 5 8 3
Displays three dust clouds at the specified coordinates. If this setting is omitted, only one will be displayed.

setDustXy 5 8 1 0.04
Sets the movement speed of the dust clouds to be displayed. If this setting is omitted, 0.02 will be applied.

setDustXy 5 8 1 0.02 3.14
Limits the movement direction of the dust clouds to be displayed. The value is 0 for right, and 6.28 for one full rotation clockwise.
Specifying 3.14 as shown above will move the dust clouds slightly to the left.

setDustEvent 3
Displays dust clouds at the feet of event 3. Specifying 0 targets the event executing the command, while specifying -1 targets the player.

As with setDustXy, you can also specify the number of dust clouds, movement direction, and movement speed.
Add the event number, number of dust clouds, movement speed, and movement direction, in that order.

setJumpDusts 5
Changes the number of sprites displayed when landing from a jump to the specified value.

setDashDusts 3
Changes the number of sprites displayed when sprinting to the specified value.

stopDust
Prevents new dust clouds from being displayed.
Does not affect dust clouds already displayed.

startDust
Cancels the effect of stopDust, allowing new dust clouds to be displayed.

Parameters following the command cannot be omitted.
When specifying a movement direction, you must also specify the number and movement speed.

Plugin Parameter Notes:

dustImage
Specify the dust image filename (without the extension). Save the file in the img/system folder.

maxDusts
If you attempt to display more dust particles than specified in this parameter,
nothing will be displayed and the plugin command will be ignored.
Increasing the value will allow more dust particles to be displayed, but it will also increase processing load and cause FPS drops on low-spec systems.

jumpDusts
This parameter specifies the number of dust particles to display when the character lands after jumping using the "Set Movement Route" Event's Contents, etc.
The dust particles will overlap by this number,
resulting in a denser dust cloud.
Setting this parameter to 0 will hide the dust particles upon landing.

dashDusts
This parameter specifies the number of dust particles to display when the player dashes.
The dust particles will overlap by this number,
resulting in a denser dust cloud.
Setting this parameter to 0 will hide the dust particles when dashing.

@param dustImage
@desc Image file name to use as dust cloud. Default: Dust1
@default Dust1
@type file
@require 1
@dir img/system/

@param maxDusts
@desc Number of sprites that can be displayed simultaneously. Default: 64
@default 64
@type number

@param jumpDusts
@desc Number of sprites to display when landing from a jump. Default: 5
@default 5
@type number

@param dashDusts
@desc Number of sprites to display when dashing. Default: 3
@default 3
@type number

スポンサードリンク

-MV plugins

Copyright© PGMV - The Community-Driven Plugin Library for RPG Maker MV , 2026 All Rights Reserved.