NUUN TPB Time Line - NUUN_TPBTimeLine.js

Plugin desc : TPB Timeline

License : MIT License

Author : NUUN

Website : https://github.com/munokura/NUUN-MZ-plugins/blob/master/NUUN_TPBTimeLine.js

Desc page : https://github.com/nuun888/MZ

Download Page : https://raw.githubusercontent.com/munokura/NUUN-MZ-plugins/master/NUUN_TPBTimeLine.js

File name : NUUN_TPBTimeLine.js

Help of plugin :

@target MZ
@url https://github.com/nuun888/MZ
@plugindesc TPB Timeline
@author NUUN
@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/NUUN-MZ-plugins ).
Original plugin by NUUN.
Please check the latest official version at:
https://github.com/nuun888/MZ
-----

Displays the TPB timeline on the battle screen.
You can choose the battler's movement direction from four options:
top-to-bottom， bottom-to-top， left-to-right， or right-to-left.

Actor and Enemy Character Memo Field
<TimeLineImg:[img]> Specifies the image file name to display when the image
type is set to image. If left unspecified， a character chip will be displayed.
[img]: Image file (no extension)

Enemy Character Memo Field
<TpbTimeLineCharacter:[img]， [index]> Specifies the image file name to display
when the character chip type is set to image. If left unspecified， a monster
image will be displayed.
[img]: Image file directly under characters (no extension)
[index]: Index

Terms of Use
This plugin is distributed under the MIT License.

Update History
June 14， 2025 Ver. 1.1.9
Supports Supported Actors Ver. 2.
July 17， 2023 Ver. 1.1.8
Fixed an issue where the cast icon was not displayed.
July 15， 2023 Ver. 1.1.7
Added a conflict prevention display mode.
February 25， 2023 Ver. 1.1.6
Fixed processing when an additional battler is added.
January 29， 2023 Ver. 1.1.5
Fixed an issue where a failed escape would cause the character to extend too
far beyond the timeline.
January 8， 2023 Ver. 1.1.4
Fixed the horizontal timeline anchor.
December 25， 2022 Ver. 1.1.3
Fixed the frame setting description.
November 2， 2022 Ver. 1.1.2
Added a feature to turn on/off the alphabet that appears when there are
multiple identical enemies.
October 28， 2022 Ver. 1.1.1
Fixed the flashing of actor or enemy icons when selecting a target.
October 27， 2022 Ver. 1.1.0
Fixed timeline behavior.
July 10， 2022 Ver. 1.0.1
Fixed an issue that caused an error to occur at the start of battle when
setting the enemy image to an image.
Added a feature to set the timeline's base position on the screen.
July 9， 2022 Ver. 1.0.0
First release

@param Setting
@text Basic settings
@default ////////////////////////////////

@param TPBTimeLineImg
@text Timeline Images
@desc Timeline image.
@type file
@dir img/
@parent Setting

@param TPBTimeLine_X
@text Timeline X coordinate
@desc Specifies the X coordinate of the timeline.
@type number
@default 60
@min -9999
@max 9999
@parent Setting

@param TPBTimeLine_Y
@text Timeline Y coordinate
@desc Specifies the Y coordinate of the timeline.
@type number
@default 20
@min -9999
@max 9999
@parent Setting

@param TPBTimeLineLength
@text Timeline Length
@desc Specifies the length of the timeline.
@type number
@default 300
@min 0
@max 9999
@parent Setting

@param TimeLineDirection
@text Timeline Direction
@desc Specifies the direction in which the battler moves on the timeline.
@type select
@default 'up'
@option Top to bottom
@value 'down'
@option bottom to top
@value 'up'
@option Left to right
@value 'right'
@option Right to left
@value 'left'
@parent Setting

@param TPBTimeLineBattlerHeight
@text Butler Display Height
@desc Specifies the display height of the butler.
@type number
@default 48
@min 0
@max 9999
@parent Setting

@param TimeLinePosition
@text Timeline base position
@desc Specifies the base position on the timeline screen.
@type select
@default 'left'
@option left
@value 'left'
@option right
@value 'right'
@option center
@value 'center'
@parent Setting

@param BattlerStatusShow
@text Hide Butler Status
@desc Does not display the original TPB gauge for Butler status.
@type boolean
@default true
@parent Setting

@param TPBTimeLineActionImg
@text Action Images
@desc Image of the action part (shown in the foreground)
@type file
@dir img/
@parent Setting

@param TPBTimeLineActionImg_X
@text Action image X coordinate
@desc Specifies the X coordinate of the action part image.
@type number
@default 0
@min -9999
@max 9999
@parent Setting

@param TPBTimeLineActionImg_Y
@text Action image Y coordinate
@desc Specifies the Y coordinate of the action part image.
@type number
@default 0
@min -9999
@max 9999
@parent Setting

@param CastIconSetting
@text Cast icon settings
@default ////////////////////////////////

@param CastIconId
@text Cast Time Icon ID
@desc Specifies the icon ID to display during cast time. If set to 0， skill and item icons will be displayed.
@type icon
@default 0
@parent CastIconSetting

@param CastIconScale
@text Cast Time Icon Magnification
@desc Specifies the magnification (percentage) of the icon displayed during casting time.
@type number
@default 50
@parent CastIconSetting

@param FlameSetting
@text Moving Frame Settings
@default ////////////////////////////////

@param ActionDuration
@text Action movement frames
@desc The number of frames to move to the specified coordinates of the action.
@type number
@default 60
@min 0
@max 9999
@parent Setting

@param ActionReturnDuration
@text Number of frames to move the initial position
@desc The number of frames to move when returning to the initial position coordinates.
@type number
@default 3
@min 0
@max 9999
@parent Setting

@param ActionResetDuration
@text Number of frames moved after the action ends
@desc The number of frames of movement when returning to the coordinates at the time of charge completion after the action is completed.
@type number
@default 6
@min 0
@max 9999
@parent Setting

@param ActorSetting
@text Actor Settings
@default ////////////////////////////////

@param TimeLineActorImgMode
@text Display Actor Image Type
@desc Specifies the image type of the actor to display.
@type select
@default 'chip'
@option Character chip
@value 'chip'
@option image
@value 'imges'
@parent ActorSetting

@param ActorImgDirekutoriy
@text Actor display image directory file
@desc Specify the directory directly under the img file for the actor display image. Example: pictures or pictures/sub
@type string
@default pictures
@parent ActorSetting

@param TPBTimeLineActor_X
@text Timeline actor X coordinate
@desc Specifies the actor's X coordinate on the timeline (relative to the timeline X coordinate).
@type number
@default -30
@min -9999
@max 9999
@parent ActorSetting

@param TPBTimeLineActor_Y
@text Timeline Actor Y Coordinate
@desc Specifies the actor's Y coordinate on the timeline (relative to the timeline Y coordinate).
@type number
@default 0
@min -9999
@max 9999
@parent ActorSetting

@param ActorCastTimeSetting
@text Cast Time Settings
@default ////////////////////////////////
@parent ActorSetting

@param TPBTimeLineActorCastTimeImg
@text Cast time image
@desc Image taken during casting time (behind the actor)
@type file
@dir img/
@parent ActorCastTimeSetting

@param ActorChargedSetting
@text Charge completion setting
@default ////////////////////////////////
@parent ActorSetting

@param ActorCharged
@text Coordinates when charging is complete
@desc Specify the coordinates when charging is complete.
@type number
@default 60
@min -9999
@max 9999
@parent ActorChargedSetting

@param ActorActionSetting
@text Action Settings
@default ////////////////////////////////
@parent ActorSetting

@param TPBTimeLineActionActor_X
@text X coordinate during action
@desc Specifies the X coordinate at the time of the action (relative to the timeline X coordinate).
@type number
@default 0
@min -9999
@max 9999
@parent ActorActionSetting

@param TPBTimeLineActionActor_Y
@text Y coordinate during action
@desc Specifies the Y coordinate at the time of the action (relative to the timeline Y coordinate).
@type number
@default 0
@min -9999
@max 9999
@parent ActorActionSetting

@param EnemySetting
@text Enemy character settings
@default ////////////////////////////////

@param TimeLineEnemyImgMode
@text Display enemy character image type
@desc Specifies the image type of the enemy character to display.
@type select
@default 'enemy'
@option Monster Images
@value 'enemy'
@option Character chip
@value 'chip'
@option image
@value 'imges'
@parent EnemySetting

@param EnemyImgDirekutoriy
@text Enemy character display image directory file
@desc When the display enemy character image type is Image， specify the directory directly under the img file for the enemy character display image. Example: pictures or pictures/sub
@type string
@default pictures
@parent EnemySetting

@param TPBTimeLineEnemy_X
@text Timeline enemy character X coordinate
@desc Specifies the X coordinate of the enemy character on the timeline.
@type number
@default 30
@min -9999
@max 9999
@parent EnemySetting

@param TPBTimeLineEnemy_Y
@text Timeline enemy character Y coordinate
@desc Specifies the Y coordinate of the enemy character on the timeline.
@type number
@default 0
@min -9999
@max 9999
@parent EnemySetting

@param EnemyLetterShow
@text Enemy alphabet display
@desc Displays the alphabet that appears when there are multiple identical enemies.
@type boolean
@default true
@parent EnemySetting

@param EnemyCastTimeSetting
@text Cast Time Settings
@default ////////////////////////////////
@parent ActorSetting

@param TPBTimeLineEnemyCastTimeImg
@text Cast time image
@desc Image at cast time. (Enemy character image is behind)
@type file
@dir img/
@parent EnemyCastTimeSetting

@param EnemyChargedSetting
@text Charge completion time setting
@default ////////////////////////////////
@parent EnemySetting

@param EnemyCharged
@text Coordinates when charging is complete
@desc Specify the coordinates when charging is complete.
@type number
@default 60
@min -9999
@max 9999
@parent EnemySetting

@param EnemyActionSetting
@text Action Settings
@default ////////////////////////////////
@parent EnemySetting

@param TPBTimeLineActionEnemy_X
@text X coordinate during action
@desc Specifies the X coordinate at the time of the action (relative to the timeline X coordinate).
@type number
@default 0
@min -9999
@max 9999
@parent EnemyActionSetting

@param TPBTimeLineActionEnemy_Y
@text Y coordinate during action
@desc Specifies the Y coordinate at the time of the action (relative to the timeline Y coordinate).
@type number
@default 0
@min -9999
@max 9999
@parent EnemyActionSetting

@param Anti-conflictSettings
@text Conflict prevention settings
@default ////////////////////////////////

@param TimeLineDisplayMode
@text Timeline display mode
@desc Specifies the timeline display mode.
@type select
@default 'Sprite'
@option Sprite
@value 'Sprite'
@option Scene_Battle
@value 'Scene_Battle'
@parent Anti-conflictSettings

@param ShowSupportActor
@text Supporting Actor Display
@desc Displays supporting actors on the timeline. (Ver.2.0.0 and later)
@type boolean
@default false
@parent Anti-conflictSettings

munokura

Welcome to PGMZ! 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.