Difference between revisions of "Message Core (YEP)"

From Yanfly.moe Wiki
Jump to navigation Jump to search
(Created page with "{{MvPlugin |preview=<youtube>https://www.youtube.com/watch?v=iVg_RTP_0HU</youtube> |link1=<html><iframe src="https://itch.io/embed/398015" height="167" width="552" frameborder...")
 
Line 1: Line 1:
 
{{MvPlugin
 
{{MvPlugin
|preview=<youtube>https://www.youtube.com/watch?v=iVg_RTP_0HU</youtube>
+
|preview = <youtube>https://www.youtube.com/watch?v=iVg_RTP_0HU</youtube>
|link1=<html><iframe src="https://itch.io/embed/398015" height="167" width="552" frameborder="0"></iframe></html>
+
|link1 = <html><iframe src="https://itch.io/embed/398015" height="167" width="552" frameborder = "0"></iframe></html>
|link2=[http://yanfly.moe/plugins/en/YEP_MessageCore.js Mirror]
+
|link2 = [http://yanfly.moe/plugins/en/YEP_MessageCore.js Mirror]
  
 
}}
 
}}
Line 17: Line 17:
 
{{Yanfly Engine Plugins}}
 
{{Yanfly Engine Plugins}}
  
== Help File ==
+
</nowiki>
  
<nowiki>
+
== Introduction ==
============================================================================
 
Introduction
 
============================================================================
 
  
While RPG Maker MV Ace certainly improved the message system a whole lot, it
+
<nowiki>While RPG Maker MV Ace certainly improved the message system a whole lot, it
 
wouldn't hurt to add in a few more features, such as name windows,
 
wouldn't hurt to add in a few more features, such as name windows,
 
converting textcodes to write out the icons and/or names of items, weapons,
 
converting textcodes to write out the icons and/or names of items, weapons,
Line 30: Line 27:
 
the ability to adjust the size of the message window during the game, give
 
the ability to adjust the size of the message window during the game, give
 
it a separate font, and to give the player a text fast-forward feature.
 
it a separate font, and to give the player a text fast-forward feature.
 +
</nowiki>
  
============================================================================
+
== Word Wrapping ==
Word Wrapping
 
============================================================================
 
  
Word wrapping is now possible through the message system. You can enable and
+
<nowiki>Word wrapping is now possible through the message system. You can enable and
 
disable Word wrap using Plugin Commands. While using word wrap, if the word
 
disable Word wrap using Plugin Commands. While using word wrap, if the word
 
is to extend past the message window's area, it will automatically go to the
 
is to extend past the message window's area, it will automatically go to the
Line 47: Line 43:
 
places that you'd like to see word wrapping, such as item descriptions,
 
places that you'd like to see word wrapping, such as item descriptions,
 
insert <WordWrap> at the beginning of the text to enable it.
 
insert <WordWrap> at the beginning of the text to enable it.
 +
</nowiki>
  
============================================================================
+
== Text Codes ==
Text Codes
 
============================================================================
 
  
By using certain text codes in your messages, you can have the game replace
+
<nowiki>By using certain text codes in your messages, you can have the game replace
 
them with the following:
 
them with the following:
  
Line 157: Line 152:
 
of these text codes only work for the Message Window. Otherwise, they'll
 
of these text codes only work for the Message Window. Otherwise, they'll
 
work for help descriptions, actor biographies, and others.
 
work for help descriptions, actor biographies, and others.
 +
</nowiki>
  
============================================================================
+
== Plugin Commands ==
Plugin Commands
 
============================================================================
 
  
The following are some plugin commands you can use through the Event Editor
+
<nowiki>The following are some plugin commands you can use through the Event Editor
 
to change various aspects about the Message system.
 
to change various aspects about the Message system.
  
Line 190: Line 184:
 
   DisableFastForward
 
   DisableFastForward
 
   - Disables Fast Forward key from working with messages.
 
   - Disables Fast Forward key from working with messages.
 +
</nowiki>
  
============================================================================
+
== Changelog ==
Changelog
 
============================================================================
 
  
Version 1.19:
+
<nowiki>Version 1.19:
 
- Updated for RPG Maker MV version 1.5.0.
 
- Updated for RPG Maker MV version 1.5.0.
  
Line 277: Line 270:
 
Version 1.00:
 
Version 1.00:
 
- Finished plugin!
 
- Finished plugin!
</nowiki>
 

Revision as of 19:39, 21 June 2019

Welcome to the wiki! This is where you can find resources from Yanfly.moe, Ækashics.moe,
VisuStella, Caz Wolf, Fallen Angel Olivia, Atelier Irina, and other affiliated content creators.



Download

System

This is a plugin created for RPG Maker MV.

For help on how to install plugins, click here.

For help on how to update plugins, click here.

Got errors with your RPG Maker MV plugin? Click here.


Masterarbeit Writer

Extension Plugins

The following plugins are Extension Plugins that require this plugin as its Parent Plugin.

Place the following plugins below this plugin located in the Plugin Manager if you plan on using them.

Yanfly Engine Plugins

This plugin is a part of the Yanfly Engine Plugins library.


</nowiki>

Introduction

While RPG Maker MV Ace certainly improved the message system a whole lot, it
wouldn't hurt to add in a few more features, such as name windows,
converting textcodes to write out the icons and/or names of items, weapons,
armours, and* more in quicker fashion. This script also gives the developer
the ability to adjust the size of the message window during the game, give
it a separate font, and to give the player a text fast-forward feature.

Word Wrapping

Word wrapping is now possible through the message system. You can enable and
disable Word wrap using Plugin Commands. While using word wrap, if the word
is to extend past the message window's area, it will automatically go to the
following line. That said, word wrap will disable the editor's line breaks
and will require you to use the ones provided by the plugin:

<br> or <line break> is text code to apply a line break. Use this before or
after a part in which you wish to start a new line.

Keep in mind word wrapping is mostly for message windows. However, in other
places that you'd like to see word wrapping, such as item descriptions,
insert <WordWrap> at the beginning of the text to enable it.

Text Codes

By using certain text codes in your messages, you can have the game replace
them with the following:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Text Code   Function
  \V[n]       Replaced by the value of the nth variable.
  \N[n]       Replaced by the name of the nth actor.
  \P[n]       Replaced by the name of the nth party member.
  \G          Replaced by the currency unit.
  \C[n]       Draw the subsequent text in the nth color.
  \I[n]       Draw the nth icon.
  \{          Increases the text size by one step.
  \}          Decreases the text size by one step.
  \\          Replaced with the backslash character.
  \$          Opens the gold window.
  \.          Waits 1/4th seconds.
  \|          Waits 1 second.
  \!          Waits for button input.
  \>          Display remaining text on same line all at once.
  \<          Cancel the effect that displays text all at once.
  \^          Do not wait for input after displaying text.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Wait:       Effect:
   \w[x]     - Waits x frames (60 frames = 1 second). Message window only.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 NameWindow: Effect:
   \n<x>     - Creates a name box with x string. Left side. *Note
   \nc<x>    - Creates a name box with x string. Centered. *Note
   \nr<x>    - Creates a name box with x string. Right side. *Note

             *Note: Works for message window only.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Line Break  Effect:
   <br>      - If using word wrap mode, this will cause a line break.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Position:   Effect:
   \px[x]    - Sets x position of text to x.
   \py[x]    - Sets y position of text to y.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Outline:    Effect:
  \oc[x]    - Sets outline colour to x.
  \ow[x]    - Sets outline width to x.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Font:       Effect:
   \fr       - Resets all font changes.
   \fs[x]    - Changes font size to x.
   \fn<x>    - Changes font name to x.
   \fb       - Toggles font boldness.
   \fi       - Toggles font italic.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Actor:      Effect:
   \af[x]    - Shows face of actor x. *Note
   \ac[x]    - Writes out actor's class name.
   \an[x]    - Writes out actor's nickname.

             *Note: Works for message window only.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Party:      Effect:
   \pf[x]    - Shows face of party member x. *Note
   \pc[x]    - Writes out party member x's class name.
   \pn[x]    - Writes out party member x's nickname.

             *Note: Works for message window only.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Names:      Effect:
   \nc[x]    - Writes out class x's name.
   \ni[x]    - Writes out item x's name.
   \nw[x]    - Writes out weapon x's name.
   \na[x]    - Writes out armour x's name.
   \ns[x]    - Writes out skill x's name.
   \nt[x]    - Writes out state x's name.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 Icon Names: Effect:
   \ii[x]    - Writes out item x's name including icon.
   \iw[x]    - Writes out weapon x's name including icon.
   \ia[x]    - Writes out armour x's name including icon.
   \is[x]    - Writes out skill x's name including icon.
   \it[x]    - Writes out state x's name including icon.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

And those are the text codes added with this script. Keep in mind that some
of these text codes only work for the Message Window. Otherwise, they'll
work for help descriptions, actor biographies, and others.

Plugin Commands

The following are some plugin commands you can use through the Event Editor
to change various aspects about the Message system.

Plugin Comand
  MessageRows 6
  - Changes the Message Rows displayed to 6. If you are using continuous
  Show Text events, this will continue displaying the following lines's
  texts until it hits the row limit. Anything after that is cut off until
  the next message starts to avoid accidental overlap.

  MessageWidth 400
  - Changes the Message Window Width to 400 pixels. This will cut off any
  words that are shown too far to the right so adjust accordingly!

  EnableWordWrap
  - Enables wordwrapping. If a word extends past the window size, it will
  automatically move onto the next line. Keep in mind, you will need to use
  \br to perform line breaks.

  DisableWordWrap
  - This disables wordwrapping. Line breaks will be automatic at points
  where a new line is started in the editor.

  EnableFastForward
  - Enables Fast Forward key from working with messages.

  DisableFastForward
  - Disables Fast Forward key from working with messages.

Changelog

<nowiki>Version 1.19:

- Updated for RPG Maker MV version 1.5.0.

Version 1.18: - Added new plugin parameters: 'Font Name CH' and 'Font Name KR'.

Version 1.17: - Compatibility update with Message Macros for 'Name Box Auto Close' option.

Version 1.16: - Added 'Tight Wrap' plugin parameter as a word wrap option to make the word wrap tighter when using faces.

Version 1.15: - Added a failsafe where if the name box window would be off the screen, it will automatically reposition itself to under the main message window.

Version 1.14: - Added 'Name Box Close' plugin parameter. If this is enabled, the message window will check for the Name Window speaker each time a follow up message occurs. If the name in the currently Name Window matches the name in the following Name Window, the message window will remain open. If it doesn't, the Name Window will close and reopen to indicate a new speaker.

Version 1.13: - Added 'Maintain Font' plugin parameter under the Font category. This will allow you to use text codes \fn<x> and \fs[x] to permanently change the font of your messages until you use it again. \fr will reset them to the plugin's default parameter settings.

Version 1.12: - 'Word Wrap Space' parameter no longer leaves a space at the beginning of each message.

Version 1.11: - Added 'Font Outline' parameter for the plugin parameters. This adjusts the font outline width used by default for only message fonts.

Version 1.10: - Updated the Message Row system for Extended Message Pack 1's Autosizing feature to work with extended heights.

Version 1.09: - Replaced 'Fast Forward' parameter with the 'Fast Forward Key' parameter and 'Enable Fast Forward' parameter. Two new Plugin Commands are added. They are 'EnableFastForward' and 'DisableFastForward' for control over when fast forwarding is allowed as to not cause timed cutscenes to desynch.

Version 1.08: - Fixed a bug regarding Input Number positioning when the Message Window's position was middle.

Version 1.07: - Added 'Word Wrap Space' for word wrap users. This parameter will leave a space behind for those who want a space left behind.

Version 1.06: - Fixed a bug that would cause masking problems with mobile devices.

Version 1.05: - Fixed a bug that would cause the namebox window to appear distorted.

Version 1.04: - Fixed a bug that captured too many text codes with the namebox window. - Timed Name Window's closing speed with main window's closing speed.

Verison 1.03: - Fixed a bug with textcodes that messed up wordwrapping. - Fixed a bug with font reset, italic, and bold textcodes.

Version 1.02: - Namebox Window's overlap feature that's in every MV window is now disabled to allow for overlapping with main message window. - Updated window positioning for Branch Choices, Number Input, and Item Selection windows.

Version 1.01: - Added 'Description Wrap' into the parameters to allow for all item descriptions to be automatically processed with word wrapping.

Version 1.00: - Finished plugin!