Half Move - HalfMove.js

Plugin desc : Half Step Movement Plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com/

Desc page : https://triacontane.blogspot.com/

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MV-plugins/refs/heads/main/HalfMove.js

File name : HalfMove.js

Help of plugin :

@url https://triacontane.blogspot.com/
@plugindesc Half Step Movement Plugin
@author Triacontane
@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/triacontane-MV-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----
The character's movement unit will be half a tile.
If half-step movement is enabled, all characters except vehicles will
move in half-step increments.

Plugin Command Details
Execute from the "Plugin Command" event command.
(Separate parameters with a space.)

HALF_MOVE_DISABLE
Temporarily disables half-step movement.
This information is included in the save data.
Use this to disable half-step movement for specific events, etc.

HALF_MOVE_ENABLE
Restores disabled half-step movement.

To enable or disable half-step movement for individual players or events,
specify the following character ID after the command.
-1: Player
0: Currently running event
1..: Event with the specified ID

Disable half-step movement for the player
HALF_MOVE_DISABLE -1

However, if you disable only half-step movement for the player,
events at half-step positions may not be triggered.

To use the event-specific expansion feature,
enter the following in the event's Note field.

The target event will not move half a step.
<HMHalfDisable>

The target event will not pass through.
<HMThroughDisable>

Individually enable or disable trigger expansion for the target event.
If no setting is made, the value of the "Trigger Expansion" parameter will be
applied.
<HMTriggerExpansion:ON>
<HMTriggerExpansion:OFF>

- Specifications when Trigger Expansion is ON
You can individually set the trigger area by entering information in the
event's Note field.
// To expand by 1, 2, 3, or 4 squares downward, left, right, or upward,
respectively.
<HMExpansionArea:1,2,3,4>

// To expand by 0.5, 1, 1, or 0.5 squares downward, left, right, or upward,
respectively.
<HMExpansionArea:0.5,1,1,0.5>

If priority is "same as normal character" and event slip-through is
disabled, 
The activation area will expand by half a square to the left and right.

Otherwise, the trigger area will expand by half a square to the top,
bottom, left, and right.

Adds half a step to the initial event position.
Use this when you want to place the event half a step from the beginning.
<HMInitialHalfX:+>
<HMInitialHalfY:+>

Use this Note field to subtract half a step.
<HMInitialHalfX:->
<HMInitialHalfY:->

Caution!
The following tags, which expand the area of the target event, have been
deprecated.
<HMWidth:2>
<HMHeight:3>

- 8-Way Autonomous Movement in Events
When the player is capable of 8-way movement, events will also use 8-way
movement for random movement and
player approach movement.
You can disable 8-way movement in events by specifying the following tag:
<HM8MoveDisable>

- Script (executed from "Scripts" in the Movement Route Settings)

Forced half-step movement will be used even when the "Disable Half-Step
Movement During Forced Movement Route" setting is enabled.
this.setHalfMoveDuringRouteForce();

Reverts the above setting to its original state.
this.resetHalfMoveDuringRouteForce();

- Integration with Other Plugins

1. When combined with PD_8DirDash.js, 8-way movement with graphic changes
is applied to half-step movement.

Distributed by:
https://pixeldog.x.2nt.com/material_script.html

2. When combined with OverpassTile.js, overpasses can be applied to
half-step movement.

Distributed by: Included in the official sample game
"Nina and the Keykeeper's Hero."

Please define OverpassTile.js above this plugin.

3. When combined with FloatVariables.js, you can move to a half-step
location or set an event location.

Distributed by: Same distributor as the Half-Step Movement plugin.

4. When combined with YEP_MoveRouteCore.js, place this plugin below it.

5. When combined with MPP_MiniMap_OP1.js, place this plugin below it.

When using this plugin in conjunction with other plugins, please be sure
to read the terms and conditions and notes of each distributor beforehand.

Notes
When forcing a route with the "Disable during forced movement" parameter
turned on, there is an issue where follower movement and path detection
become erratic. This issue remains unresolved. Please be careful when
enabling this parameter.

Terms of Use:
You may modify and redistribute this plugin without permission from the
author, and there are no restrictions on its use (commercial, 18+, etc.).
This plugin is now yours.

@param Direction8Move
@desc Allows movement in eight directions, including diagonal movement.
@type boolean
@default true

@param 8MoveSwitch
@desc Allows movement in eight directions only when the switch with the specified ID is ON. If 0, it is always allowed.
@type switch
@default 0

@param EventThrough
@desc If you come into contact with an event from the side, you can slip through it if you take half a step.
@type boolean
@default true

@param DisableForcing
@desc Disable half-step movement while forcing a movement route.
@type boolean
@default false

@param AvoidCorner
@desc If you get caught on a corner of the map while moving straight, switch to diagonal movement and try again. Disabled if there is an event that can be triggered in the direction of travel.
@type boolean
@default true

@param DiagonalSlow
@desc Walking speed while moving diagonally is reduced to 0.8x.
@type boolean
@default false

@param TriggerExpansion
@desc The event activation area is expanded. The expansion area differs depending on the priority.
@type boolean
@default false

@param AdjustmentRealStep
@desc The timing of step count increases by one step for every two steps. The timing of encounter steps and damage floors has also been adjusted.
@type boolean
@default false

@param UpperNpTerrainTag
@desc This is a terrain tag that makes only the upper half of the tiles impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param UpperNpRegionId
@desc Region ID where only the upper half of the tiles are impassable. Specifying 0 disables it.
@type number[]
@default ["0"]

@param LowerNpTerrainTag
@desc This is a terrain tag that makes only the lower half of the tiles impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param LowerNpRegionId
@desc Region ID where only the bottom half of the tiles are impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param RightNpTerrainTag
@desc This is a terrain tag that makes only the right half of the tiles impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param RightNpRegionId
@desc Region ID where only the right half of the tiles are impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param LeftNpTerrainTag
@desc This is a terrain tag that makes only the left half of the tiles impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param LeftNpRegionId
@desc Region ID where only the left half of the tiles are impassable. Specifying 0 disables it.
@type number[]
@default ["0"]

@param RightUpNpTerrainTag
@desc This is a terrain tag that makes only the top right corner of the tile impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param RightUpNpRegionId
@desc The region ID where only the top right corner of the tile is blocked. Specifying 0 disables it.
@type number[]
@default ["0"]

@param RightDownNpTerrainTag
@desc This is a terrain tag that makes only the bottom right corner of the tile impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param RightDownNpRegionId
@desc The region ID where only the bottom right of the tile is impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param LeftUpNpTerrainTag
@desc This is a terrain tag that makes only the top left corner of the tile impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param LeftUpNpRegionId
@desc The region ID where only the top left corner of the tile is blocked. Specifying 0 disables it.
@type number[]
@default ["0"]

@param LeftDownNpTerrainTag
@desc This is a terrain tag that makes only the bottom left of the tile impassable. Set to 0 to disable.
@type number[]
@default ["0"]

@param LeftDownNpRegionId
@desc The region ID where only the bottom left of the tile is impassable. Specifying 0 disables it.
@type number[]
@default ["0"]

@param AllNpTerrainTag
@desc This is a terrain tag that prohibits passage in all directions. Specifying 0 disables it.
@type number[]
@default ["0"]

@param AllNpRegionId
@desc Region ID where all-direction traffic is prohibited. Specifying 0 disables it.
@type number[]
@default ["0"]

@param MultiStartDisable
@desc If multiple events that meet the trigger conditions exist simultaneously, only the event with the smallest ID will be triggered.
@type boolean
@default false

@param EventOverlap
@desc Overlapping positions are allowed for events with a priority other than "same as normal characters."
@type boolean
@default false

munokura

Welcome to PGMV! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.