Files
LonaRPG-Online-Games/ModScripts/PaletteChanger/_readme.txt
T
2026-10-29 21:59:06 +04:00

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",