TSR_TextColorAddOn by The Northern Frog

TSR

The Northern Frog
Veteran
Joined
Nov 14, 2019
Messages
199
Reaction score
149
First Language
French
Primarily Uses
RMMV

TSR_ColorSc1.png
download:
TSR_TextColorAddOn v1.6.4
Author: TSR, The Northern Frog
RPG Maker MV let you change the font color in text windows using the escape code '\C[x]' where x range from 0 to 31, providing colors from the default window skins of /img/system/Window.png.​
This simple Plugin now allow you to add more text color codes, starting from 32. It also give the option of adding a second color to generate a color gradient effect on the text. You can also change the Outline color and Width of the text, all of this using the commonly used '\C' escape code.​
In addition, the Plugin allow the use of '\C[x]' basically anywhere text can be input.​


TSR_ColorSc2.pngCapture d’écran 2020-04-06 à 16.27.08.png
Capture d’écran 2020-04-29 à 18.37.27.pngCapture d’écran 2020-05-02 à 12.08.34.png
Capture d’écran 2020-05-02 à 12.09.14.png

Text Color Object Properties:
========================================================================
There is only one parameter called Text Color Object. It is a notebox where you can create your colors properties.

Properties consist of pairs of code:color, and each properties must be separated by comas. The codes are starting from 32 and can be any number you want. The color are defined using CSS. You can use either a predefined CSS color name or make your own using Hex value or rgba values to define the color.​

* Exemple: 'Aqua' or '#00ffff' will render the same color

Fill the Text Color Object notebox to your liking, adding colors associated with code above 31 and separate each with comas.​

*Exemple: 32: Aqua, 33: DarkCyan, 34: DarkKhaki

Then, use the associated code with '\C[x]', when allowed, to change the font color to the corresponding color. Like, according to what's above, \C[32] will render Aqua colored text.

To use rgba(r, g, b, a) format in the Text Color Object, enter your rgba values inside the brackets without comas and with a single white space, like this:

*Exemple: rgba(0 0 0 0.5)

Hence, writing:

32: Aqua or 32: #00ffff or 32: rgba(0 255 255 1) will render the same color.


Text Color Gradient:
========================================================================
Thanks to Shadowdragon, the Plugin now integrate the color gradient functions of ShadowDragon_TF.js allowing to render color gradient effect on text.


To add a color gradient effect on a text, enter 2 colors in the brackets, like this:

Exemple: C\[5, 27] *white spaces after the coma doesn't matters


Text Outline Color and Width:
========================================================================
To change the Outline color of the text, add a color code preceded by the letter 'o':

Exemple: \C[12, o18] render text color 12 with outline color 18


You can combine gradient and outline color like: \C[5, 27, o30]

* Note that the outline color should always be the last parameter.


Default outline width is 4 pixels, but sometime, you may want to adjust it depending of the font size you're using and the color effect you want. You can change the outline width by adding 'w' follow by the width in pixels you want.

Exemple: \C[5, 27, o30w3] gradient 5 to 27, outline color 30 and width 3 pixels


*Note that there's no coma between outline color and width. A white space can be accepted, but no coma!


Using text code in database:
======================================================================
By adding text color codes to database entries such as Items, Weapons and armors names, you can change their color when displayed. Color codes can also be use anywhere like Map Name entry or Game Title.​
The same can be done with the Icon Escape Code \I[x] to easily display colors and icons in command menus if desired.​
Exemple: writing '\I[60]\C[11]' in the 'Item' entry of the 'Terms' section of the database, will display icon 60 and color the text in both Battle Command window and Main Menu Command window.​
Other codes that works are \V[x] to show variables value, \N[x] to display actor names and \G to show currency unit. Of course, result may vary when showing long string.​
Try it for yourself and use it with parsimony, because showing too much colors is the same as not enough...​


ToU:
========================================================================
Free to use in any RPG Maker MV projects, including commercials.

Credit is required for using this Plugin.

Credit to 'TSR' followed by either 'The Northern Frog' or 'A frog from the north'

Do not change the Header or the Terms of usage.

Editing of the script is permited but credit would still be required.


DO NOT REDISTRIBUTE! If you want to share it, share the link to my itchi.io account:
https://the-northern-frog.itch.io/

If you edited the plugin and would like to distribute it, contact me.

This plugin was made for free use among the RMMV game dev community. Hence, it is free and will remain free.
 

Conflictx3

Veteran
Veteran
Joined
Aug 11, 2018
Messages
149
Reaction score
194
First Language
English
Primarily Uses
RMMV
Absolutely insane I JUST Now needed this and here you come along! not even a full week out and this plugin has saved someone who has had an issue with text color AND outlines for Alll day. Me and my migraine thank you!
 
  • Like
Reactions: TSR

TSR

The Northern Frog
Veteran
Joined
Nov 14, 2019
Messages
199
Reaction score
149
First Language
French
Primarily Uses
RMMV
Hello all!
New update TSR_TextColorAddOn version 1.7.6

The Plugin now give the option to import a custom sprite sheet in /img/pictures and use it to display some additional custom icons with text code '\i[x]'.

Capture d’écran 2020-05-17 à 14.46.32.png

Code:
 * Custom Icons Sheet:
 * ===========================================================
 * Import a sprite sheet in /img/pictures, specify its dimensions
 * through a few Plugin parameters, and show your new icons in text
 * boxes using escape code '\i[x]' where x is determined by the
 * starting index Plugin parameter.
 *
 * Plugin parameters:
 *
 *     Icons Sheet Name
 *         The file name of the sprite sheet in /img/pictures without
 *         file extension.
 *
 *     Sheet Starting Index
 *         This is the starting icon code for your icon sprite sheet.
 *         Default Plugin value is 500. If you leave it that way, the
 *         icon codes for your custom sprite sheet will start at 500.
 *         That mean writing \I[500] will show the first index of your
 *         sprite sheet, that is the upper left corner frame (index 0).
 *   
 *         If you set the starting index to 0, it will overide all the
 *         default icons, so unless that's what you want, I recommand
 *         leaving it to 500, or any number that won't overlap with your
 *         main icon set in /img/system.
 *
 *     Sheet Frame Size
 *         This is the size of one frame in your sprite sheet. The default
 *         icon set is 32x32 pixels icons, but you can use any size you
 *         want. Enter the number in pixels of the size of one frame in your
 *         custom sheet.
 *
 *     Sheet SpritePerRows
 *         This is to tell the Plugin how many frame (images) are in one
 *         row of the custom sheet. As an exemple, the default icon sheet
 *         have 16 frames (icons) by rows.
 *
 *     Icons Auto Scale
 *         In most cases, when using the icon code '\i[x]' with this Plugin,
 *         icons will auto scale themselves according to the font size, so
 *         they always look in place and aligned with text. If for any reason,
 *         you need your custom icons to appear in their actual dimension, turn
 *         that parameter OFF.
 *
 *
 *     Exemple
 *         We'll use a Battler Sprite sheet as exemple:
 *
 *              Icons Sheet Name:      Actor1_1       
 *              Sheet Starting Index:  500 (default)
 *              Sheet Frame Size:      64             
 *              Sheet SpritePerRows:   9
 *              Icons Auto Scale:      true
 *
 *        Now using code \i[500] in a text string will make Harold appear as
 *        an icon scaled to the text. Since Battlers sheet are 9 columns by
 *        6 rows, we can use icon codes from 500 to 553 for the whole sheet.
 *        Using \i[552] for instance will show a very dead Harold icon.
 *        Turning the Auto scale to false would make Harold icons appear
 *        as 64x64 pixels images that would most likely clash with the text...
 *
 *
DOWNLOAD:
TSR_TextColorAddOn
 

TSR

The Northern Frog
Veteran
Joined
Nov 14, 2019
Messages
199
Reaction score
149
First Language
French
Primarily Uses
RMMV
New update!

This version add 2 new text adjusting parameters for more convenience:

  • Auto Outline Opacity
    Outline Colors looks better when they are shown with half opacity. This parameter allow to set the outline colors opacity to 50% automatically when you set outline colors using text color codes.​
  • Text Adjusting Font Size When this parameter is On, if the text length (after removing all text codes) is over the maximum width allowed for the window/box/menu, the fontSize will be reduced slightly so it fits the available space.
DOWNLOAD:
TSR_TextColorAddOn
 

Users Who Are Viewing This Thread (Users: 0, Guests: 1)

Latest Threads

Latest Posts

Latest Profile Posts

I always thought I was just really, really bad at communication, then the internet proceeds to say "lol no".
Almost 100,000 Threads! We should make a celebration. Make a 100K logo? :p
Cursed problem: Multiple language switches. Say, you want to switch to EN language from JP but you have no idea where the language switch in JP menu language.
Tonight I'm finally going to start putting the dungeons my team has made on grid paper into the engine. That's the final step of making the game world.
Yay! My new Doomsday machine..... er... "Heroic" machine is ready!
//pushes button :LZSexcite:
Uh oh what's that rumbling?!
// Game explodes :kaoback:
That's the fourth time this week! :kaolivid:
// Gets to work building next "Heroic" Machine. :LZSskeptic:

Forum statistics

Threads
99,430
Messages
965,170
Members
131,044
Latest member
DavieLR
Top