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

PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

MZ plugins

NRP Bush EX - NRP_BushEX.js

Plugin desc : v1.05 Extends the functionality of the bushes attribute.

License :
・Copyright: Retained
・Commercial Use: Allowed
・Modification: Allowed
・Redistribution: Allowed
・Details: See Download Page / In-plugin documentation

Author : Takeshi Sunagawa (http://newrpg.seesaa.net/)

Website : https://github.com/NewRPGProject/MZMV_Plugin/blob/main/NRP_BushEX.js

Desc page : http://newrpg.seesaa.net/article/481013577.html

Download Page : https://raw.githubusercontent.com/NewRPGProject/MZMV_Plugin/main/NRP_BushEX.js

File name : NRP_BushEX.js

Help of plugin :

Extends the functionality of the bushes attribute.
 * 
 * Normally, when standing on a tile with the bush attribute added,
 * the lower half of the character's body will appear translucent.
 * This feature is used not only for bushes, but also for water features.
 * 
 * However, the trouble is that the bushes attribute is applied to all layers.
 * For example, let's say you have a bridge that spans the water.
 * Your character is standing on it.
 * Your character will then become translucent,
 * as if he were standing on the bridge, but he is underwater.
 * 
 * So, if there are other tiles on the layer above the bushes,
 * do not apply the bushes attribute.
 * 
 * In addition, you can adjust the opacity, the depth of the bushes,
 * and, as an added extra, the color.
 * You can also fine-tune the settings by using TerrainTags,
 * RegionIDs, TileIDs and AutoTileTypes as conditions.
 * 
 * If you add a "SettingId" to the settings you have created,
 * you can call up the settings for each tileset.
 * 
 * -------------------------------------------------------------------
 * [Usage]
 * -------------------------------------------------------------------
 * When the plugin is applied,
 * the "LimitBushLayer" function is initially turned on.
 * The depth and opacity of the bushes can be set by parameters.
 * 
 * In addition, it allows finer tuning than the SettingList.
 * Whether the setting is enabled for all tilesets
 * or invoked for each tileset can be toggled by a parameter in the list.
 * 
 * -------------------------------------------------------------------
 * [Note of Tilesets]
 * -------------------------------------------------------------------
 * To recall the settings for each tileset,
 * specify the following in Note.
 * 
 * <BushSetting:?>
 * 
 * ? is the "SettingId" registered in the setting by condition.
 * You can also specify multiple settings by separating them with commas.
 * 
 * <BushSetting:A,B,C>
 * 
 * -------------------------------------------------------------------
 * [Note of Events]
 * -------------------------------------------------------------------
 * <SetBush:?>
 * Force the bush effect to the target regardless of the current terrain.
 * ? is the "SettingId" registered in the setting by condition.
 * 
 * Also fill in the tag in the note at the top of the event page.
 * You can switch the status of this one for each of the current pages.
 * 
 * <NoBush>
 * Events are no longer affected by the bush attribute.
 * 
 * -------------------------------------------------------------------
 * [Plugin Commands MZ]
 * -------------------------------------------------------------------
 * ◆SetBushEffect
 * Force the bush effect to the target regardless of the current terrain.
 * Specify the target event ID in the TargetsId.
 * Also, -1 targets players and -2 or less targets followers.
 * 
 * If any parameter other than the TargetsId is left blank,
 * it will be canceled.

 * ◆SetBushEffectVehicle
 * Forces the bush effect to the vehicle regardless of the current terrain.
 * If any parameter other than VehicleType is left blank,
 * it will be cancelled.

 * -------------------------------------------------------------------
 * Orders for events are automatically released if the player transfers.
 * 
 * On the other hand, orders for players, followers,
 * and vehicles will not be released by transferring or saving and loading.
 * Be sure to release them when they are no longer needed.
 * 
 * -------------------------------------------------------------------
 * [Notice]
 * -------------------------------------------------------------------
 * When using this plugin together with OverpassTile.js,
 * be sure to place this plugin on the top.
 * 
 * -------------------------------------------------------------------
 * [Terms]
 * -------------------------------------------------------------------
 * There are no restrictions.
 * Modification, redistribution freedom, commercial availability,
 * and rights indication are also optional.
 * The author is not responsible,
 * but will deal with defects to the extent possible.
 * 
 * @------------------------------------------------------------------
 * @ Plugin Commands
 * @------------------------------------------------------------------
 * 
 * @command SetBushEffect
 * @desc Forces the bush effect on the target regardless of terrain.
 * Leave parameters other than TargetsId blank to cancel.
 * 
 * @arg TargetsId
 * @desc Target Event ID.
 * -1 or less to target player to follower.
 * @type combo
 * @option 1,2,3 #Multiple
 * @option 1~3 #Range
 * @option $gameVariables.value(1) #Variable number events
 * @option -1 #Player
 * @option -1~-4 #Party
 * 
 * @arg BushDepth
 * @type number
 * @desc The height at which the bush effect is applied to the lower body.
 * 0 always disables the bush effect.
 * 
 * @arg BushOpacity
 * @type number
 * @max 255
 * @desc Opacity to be applied to the lower body.
 * 255 makes it completely opaque.
 * 
 * @arg BushColor
 * @type string
 * @desc This color applies to the lower half of the body.
 * e.g.: [255,255,255,255] (red, green, blue, strength)
 * 
 * @arg FloatAmplitude
 * @type text
 * @desc The amplitude of the floating effect.
 * Formula is available.
 * 
 * @arg FloatPeriodicTime
 * @type text
 * @desc The period of the amplitude of the floating effect. Default 120.
 * 
 * @------------------------------------------------------------------
 * 
 * @command SetBushEffectVehicle
 * @desc Forces the bush effect on the vehicle regardless of terrain.
 * Leave parameters other than VehicleType blank to cancel.
 * 
 * @arg VehicleType
 * @type combo
 * @desc Target Vehicle Type.
 * @option boat
 * @option ship
 * @option airship
 * 
 * @arg BushDepth
 * @type number
 * @desc The height at which the bush effect is applied to the lower body.
 * 0 always disables the bush effect.
 * 
 * @arg BushOpacity
 * @type number
 * @max 255
 * @desc Opacity to be applied to the lower body.
 * 255 makes it completely opaque.
 * 
 * @arg BushColor
 * @type string
 * @desc This color applies to the lower half of the body.
 * e.g.: [255,255,255,255] (red, green, blue, strength)
 * 
 * @arg FloatAmplitude
 * @type text
 * @desc The amplitude of the floating effect.
 * Formula is available.
 * 
 * @arg FloatPeriodicTime
 * @type text
 * @desc The period of the amplitude of the floating effect. Default 120.
 * 
 * @------------------------------------------------------------------
 * @ Plugin Parameters
 * @------------------------------------------------------------------
 * 
 * @param LimitBushLayer
 * @type boolean
 * @default true
 * @desc If there are other tiles on the layer above the bushes, the bush attribute will not be applied.
 * 
 * @param ExcludedTerrain
 * @type string
 * @desc Specify the terrain tags (1~7) to be excluded for "LimitBushLayer". Multiple allowed (e.g. 1,3).
 * 
 * @param BushDepth
 * @type number
 * @desc The height of the translucency effect applied to the lower body on the bushes. Default 12.
 * 
 * @param BushOpacity
 * @type number
 * @max 255
 * @desc The opacity to apply to the lower body on the bushes.
 * Opaque at 255. Default value is 128.
 * 
 * @param SettingList
 * @type struct<Setting>[]
 * @desc This is a list of bush settings.
 * This is useful when you want to specify detailed conditions.

スポンサードリンク

-MZ plugins

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