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 Original Vehicle - NRP_OriginalVehicle.js

Plugin desc : v1.03 Add the original vehicles.

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_OriginalVehicle.js

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

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

File name : NRP_OriginalVehicle.js

Help of plugin :

Normally there are only three types of vehicles
 * that can be set, but you can freely add more.
 * In addition, detailed settings can be made for each of them.
 * 
 * - A low-flying carpet that can't go over mountains.
 * - A yellow bird that runs on land and shallow water.
 * - A black bird that can only land in forests.
 * - A machine that can go over dungeon-specific trap zones.
 *
 * ...... and so on.
 * 
 * The settings that can be configured for each vehicle are as follows.
 * 
 * - Standard setting information such as images and background music
 * - Terrain that can be passed through and get on/off
 * - Battle background
 * - Encounter rate
 * - Speed
 * - Direction when stopped
 * - Altitude of airship
 * 
 * [Usage]
 * In the list of vehicles in the plugin parameters,
 * set the Set the information of the vehicle you want to add.
 * The following fields are required.
 * 
 * ◆OriginalId
 * This is an ID to identify the vehicle.
 * This is required when you want to operate it from a plugin command.
 * 
 * ※Do not use the following values for your ID!!!
 *   Since they are used as IDs for existing rides.
 *   It will not be processed correctly.
 * 
 * 0, 1, 2, boat, ship, airship
 * 
 * ◆VehicleType
 * The type of vehicle to be used as the base.
 * If you want to fly in the sky, make it an airship.
 * 
 * Passage and getting on/off decisions
 * are also inherited from the base vehicle.
 * 
 * ◆Image & ImageIndex
 * The image to be displayed and its index.
 * 
 * 
 * If necessary, set other information
 * such as the PassageList (passage & getting on/off judgment).
 * It is possible to switch between enabling it
 * for all tilesets or calling it for each tileset,
 * depending on the parameters in the list.
 * 
 * Note that the location of the vehicle cannot be set
 * by the plugin parameters.
 * Please use the following plug-in commands to set the location.
 * 
 * [Plugin Command (MZ)]
 * By specifying the OriginalId, the target vehicle can be operated.
 * The following functions are enabled.
 * 
 * ◆Set Vehicle Location
 * ◆Change Vehicle Image
 * ◆Change Vehicle BGM
 * 
 * The contents are all the same
 * as the event commands for normal vehicles.
 * The only command that does not exist is "Get on/off Vehicle".
 * You can simply execute the "Get on/off Vehicle" event command.
 * 
 * In addition, the following additional commands are available.
 * 
 * ◆Force Get On
 * Forces the player to board the vehicle with the specified OriginalId,
 * regardless of the position of the vehicle.
 * One step forward processing when boarding a ship, etc. can also be omitted.
 * This is useful when you want to control the ride during the event.
 * 
 * By the way, you can also specify a normal vehicle
 * by setting the value of "boat", "ship", or "airship" to OriginalId.
 * 
 * ◆Force Get Off
 * Forcibly disembark from the current ride without making a landing decision.
 * This is useful when you want to control the vehicle during the same event.
 * 
 * [Plugin Command (MV)]
 * ※No distinction is made between individual capital letters.
 *   Also, do not include [].
 * 
 * ◆Set Vehicle Location
 * NRP.OriginalVehical.SetVehicleLocation [OriginalId] [MapId] [X] [Y]
 * 
 * ◆Change Vehicle Image
 * NRP.OriginalVehical.ChangeVehicleImage [OriginalId] [ImageName] [ImageIndex]
 * 
 * ◆Change Vehicle BGM
 * NRP.OriginalVehical.ChangeVehicleBgm [OriginalId] [BgmName] [Volume] [Pitch] [Pan]
 * ※The items after the Volume can be omitted.
 * 
 * ◆Force Get On
 * NRP.OriginalVehical.ForceGetOn [OriginalId] [NoStep(true/false)]
 * ※『NoStep』は省略可能(trueが標準)です。
 * 
 * ◆Force Get Off
 * NRP.OriginalVehical.ForceGetOff [前進しない(true/false)]
 * ※『NoStep』は省略可能(trueが標準)です。
 * 
 * [Tilesets Notes]
 * If you want to set the passage and getting on/off judgment for each tileset,
 * specify the following in the Note field of the tileset.
 * 
 * <VehiclePassage:?>
 * 
 * ? is the "SettingId" registered in the PassageList.
 * It is also possible to specify multiple values
 * by separating them with commas.
 * <VehiclePassage:A,B,C>
 * 
 * [Script]
 * The following script can be used to determine
 * if you are on a specific vehicle.
 * Feel free to use them in combination with the event commands.
 * 
 * $gamePlayer.vehicleId() == "test"
 * 
 * ※Set the OriginalId in the "test" section.
 * 
 * [Notice]
 * Added vehicles are managed using OriginalId as a key.
 * 
 * If you change the OriginalId of the plugin parameter
 * when upgrading a published game,
 * the vehicle will disappear from the existing save data.
 * 
 * [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.
 * 
 * @command SetVehicleLocation
 * @text Set Vehicle Location
 * @desc Change the location of the original vehicle.
 * 
 * @arg OriginalId
 * @type string
 * @desc The ID of the target vehicle.
 * 
 * @arg MapId
 * @desc The map ID to move the vehicle to.
 * If blank, the current map is targeted.
 * @type combo
 * @option $gameVariables.value(1)
 * 
 * @arg X
 * @desc The X coordinate to move the vehicle.
 * @type combo
 * @option $gameVariables.value(1)
 * @option $gamePlayer.x
 * 
 * @arg Y
 * @desc The Y coordinate to move the vehicle.
 * @type combo
 * @option $gameVariables.value(1)
 * @option $gamePlayer.y
 * 
 * 
 * @command ChangeVehicleImage
 * @text Change Vehicle Image
 * @desc Change the image of the original vehicle.
 * 
 * @arg OriginalId
 * @type string
 * @desc The ID of the target vehicle.
 * 
 * @arg Image
 * @type file
 * @dir img/characters/
 * @desc Character Image for the vehicle.
 * Must be specified as a set with ImageIndex.
 * 
 * @arg ImageIndex
 * @type number
 * @min 0 @max 7
 * @desc Index of character imagesto be used for the vehicle. Specify a value between 0 and 7.
 * 
 * @command ChangeVehicleBgm
 * @text Change Vehicle BGM
 * @desc Change the BGM of the original vehicle.
 * 
 * @arg OriginalId
 * @type string
 * @desc The ID of the target vehicle.
 * 
 * @arg BGM
 * @type struct<BGM>
 * @desc Information about the background music played during boarding.
 * 
 * @-----------------------------------------------------
 * @ Plugin Parameters
 * @-----------------------------------------------------
 * 
 * @param VehicleList
 * @type struct<Vehicle>[]
 * @desc This is a list of original vehicles.
 * 
 * @param ConsiderTileEvent
 * @type boolean
 * @default true
 * @desc If a tile event is placed, it is determined by the tile ID of the event.

スポンサードリンク

-MZ plugins

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