128 lines
7.8 KiB
Plaintext
128 lines
7.8 KiB
Plaintext
##################################################################
|
|
LonaRPG Bitmap(Palette) Changer (PCh for short)
|
|
|
|
All code made by Teravisor
|
|
Some palettes and color fix made by ECCMA417
|
|
Everything else (include this readme) by cyancyan214
|
|
|
|
this readme is no good and needs to be completely rewritten by someone
|
|
|
|
##################################################################
|
|
tl;dr
|
|
|
|
put some .json from ModScripts/PaletteChanger/unactive_jsons folder in to ModScripts/PaletteChanger/ folder to activate it. "number_" will be the load order
|
|
|
|
If u made color mod, but see weird 00FFFF (u guys call it blue) color - check _viewme.png
|
|
|
|
this mod's files:
|
|
ModScripts/2_LonaBitmapChanger.rb - main code. Contains remarks with most ESSENTIAL explanations, read it to learn basics
|
|
currently unused:
|
|
ModScripts/Unused/3_PaletteLoader.rb - Lets you set custom path for .jsons
|
|
ModScripts/Unused/3_GimpTxt.rb.DIS - compatibility for GIMP .txt palettes
|
|
|
|
##################################################################
|
|
some random explanations:
|
|
|
|
default path - for PaletteChanger to look for .json - "game_folder\ModScripts\PaletteChanger\*.json" - all .json that is inside this folder will be active
|
|
Put .json somewhere else to deactivate it
|
|
|
|
PaletteChanger uses FileGetter's default code when load files, but loads .json instead of .rb
|
|
FileGetter will look for "number_" prefix in filename to decide loading order
|
|
it will consider anything else than "number_" as 0 (or random?), so naming ur files "number_filename.json" is recommended
|
|
|
|
.json loaded first will prevent other .jsons to overwrite it if it recolors same parts (colors)
|
|
|
|
color cells order (structure) inside palette_new must be same as in palette_old, or u'll see 00FFFF
|
|
|
|
If some color cell in palette_new has same color code as in palette_old, that cell will be ignored, unchanged (will not change something in to same exact color)
|
|
This can cause weird looking glitch sometimes if you make active multiple .jsons, that recolors same exact parts
|
|
If there is a .json that is "below" that tries to recolor that skipped color cell, you'll see that color in the "gap" created by that ignored color in the "upper" .json
|
|
To avoid it, make sure, that any color from ur palette_new is != palette_old:
|
|
If u made, for example, some eyes mod, changed all colors, but decided to keep it's brightest color same as original - 247.255.128
|
|
You just need to change that color code by 1, like, in to 248.255.128
|
|
You can also ignore it and use this feature for your advantage in some cases (like it's done with .act 00FFFF background)
|
|
|
|
Pay attention for "," symbol when making a custom .json. It might not work just because , is missing or put in wrong place
|
|
|
|
there is currently no difference if u use capital letters or lowercase letters in .json for files you add in there
|
|
|
|
.jsons with "DEFAULT" in its names (number_DEFAULT_*.json) are used in base game, removing or editing them may cause breaking of game immersion (unless u know what u doing)
|
|
|
|
.act = Adobe Color Table - file that can store 256 colors
|
|
|
|
##################################################################
|
|
Recoloring:
|
|
|
|
Get the LonaRPG-PChPreviewer.psd file, that contains ALL colors from source_mc and lets you preview what you recoloring, from here:
|
|
https://mega.nz/folder/vdYhSDyI#VgWhG0UfQu56rTsRUKY3jQ
|
|
This .psd gonna update from time to time, so check its version. It doesn't have ALL graphics in it, that's not really necessary
|
|
|
|
Every layer(name) in it = (name).act - select it, recolor, create your custom .acts!
|
|
Watch Videos examples to learn how to create an .act
|
|
|
|
Preview.Edits(*).psd are storages that contains import of all palette_new from the base game
|
|
|
|
Suggested soft:
|
|
Photoshop(PS), any version of it, even old CS5 or CS6 (dont use CS1, it will lag crazy). Use it's indexed mod (good at recolor, bad if try move colors inside .act)
|
|
Fighter Factory(FF) (freeware), use it's Advanced palette editor. (good at move bunch of colors in .act, not that good at recolor)
|
|
Cyotek Color Palette Editor (freeware) if u hate/don't have PS. Good for pick colors from anywhere (from .psd) easy to open an .act to quickly look what's inside it
|
|
|
|
Spidey's Palette Dump Tool (freeware) Absolute timesaver. Instantly creates .act from .png while keeping order of colors intact. No more manual labor.
|
|
Download from here: http://baghead.drdteam.org click on DoomCrap
|
|
|
|
Other:
|
|
CLIP Studio Paint (CLIP) - OK, but can't work with .acts. Loads the .psd a bit slow
|
|
anything that can edit .act or it's converted analog
|
|
anything that can open a .psd
|
|
|
|
Not recommended:
|
|
Krita - (freeware) can open .psd, but doesn't support mask and adjustment layers. No support for .act. Loading slow
|
|
GIMP - (freeware) supports PS' masks but doesn't support PS' adjustment layers. UI looks like shit. Eats a lot of RAM. Can save palettes to a .txt
|
|
|
|
One needs at least a basic understanding, how Photoshop mask layers does work to operate this .psd. YouTube can help
|
|
PCh uses RGB and ignores the Alpha channel (transparency, RGBA) so u can ignore it too in every partly-transparent layers, that's why there is masks, to imitate it
|
|
|
|
please, create your own unique folder for your .acts for convenience and to avoid creating file mess: ModScripts/PaletteChanger/USERNAME/*.act
|
|
please, do not include contents of source_mc in to your mod, unless your palette_old is unique
|
|
|
|
##################################################################
|
|
some more boring random explanations:
|
|
|
|
While the source_mc .acts has defined structure of the color cells/rows, it just made for convenience and compability
|
|
colors can be placed in any order, there is no rules. One .act can easily contain colors from many parts, at complete random order
|
|
Just make palette_new's color order to be equal to palette_old's color order
|
|
|
|
if some thing contain more, than 256 colors, more than one .act can be used to recolor it (put them in a subfolder?) Or a .txt can be used(?) never tested it :\
|
|
|
|
Why background inside .acts is 00FFFF color? Because I like it. And It's not used in game graphics, so can be used as "neutral" color
|
|
It's better(?) to keep the "background" color to be same in the palette_old and palette_new so it can be ignored by PCh to spare some performance
|
|
|
|
source_mc - folder that contains base game colors from ingame graphics - used as palette_old
|
|
base game color palettes from source_mc is recommended as a base for recoloring. Drawn by 417, it's already has good saturation/value correlations
|
|
DO NOT edit any .act inside source_mc folder. DO NOT report any visual bug if u did
|
|
|
|
acc1, 2 etc - hair accessories: twin braid; ponytail etc
|
|
|
|
skin_h; eyes_h. H - short for Hentai
|
|
|
|
You don't need to have unique .acts in palette_new for every palette_old .act
|
|
You can combine multiple parts in to one palette_new. Get reference from the Previewer.psd and base game .acts/.jsons
|
|
|
|
How to make Lona with heterochromia:
|
|
In .json's palette_old line: add R(ight) or L(eft) after "eyes", "sclera" etc. Supported parts: eyes, eyes_h, sclera
|
|
example:
|
|
"palette_old": ["source_mc/eyesr.act", "source_mc/eyesR_h.act", "source_mc/scleraR.act"]
|
|
this will make .json to recolor right eye only. All base game palette_new eyes and sclera .acts is with support for this
|
|
Left and Right eyes position is based on Lona's own point of view
|
|
The following palettes can be set to it too, but this needs to be done manually, inside the .act: glasses_basic
|
|
|
|
Why "_" symbol is everywhere? Because you can copypaste it easily by mouse double click
|
|
|
|
If you really know wtf you doing, only set of rules you should follow is in 2_LonaBitmapChanger.rb
|
|
|
|
##################################################################
|
|
"Graphics/Characters/item_icon01@48,144,24,24", #x, y , witdh,height
|
|
"Graphics/Characters/item_icon02@264,72,24,48",
|
|
"Graphics/Characters/item_icon02@192,96,24,24",
|
|
#"Graphics/Characters/item_icon02@24,144,24,24",
|