A Python application for previewing and customizing character fashion using palette files, specifically for usage for Trickster Online private server development. Now including Linux Support!
This was made possible by the following players:
- KusanagiKyo
- Dino
- Yuki
- Mewsie
Thank you for your hard work and contributions to bring this tool to life for the community!!!
Join our Trickster Development Discord and get a central repository for live support, tools, information, updates on releases, and more!
- Character Selection: Choose from different characters and jobs
- Fashion Customization: Apply different fashion palettes
- Hair Customization: Apply different hair palettes
- 3rd Job Base Fashion: Special handling for 3rd job characters
- Custom Palettes: Add your own custom palettes in
exports/custom_pals/ - Export Options: Export as transparent PNG, backgrounded BMP, or combined palette
- Multiple Preview Modes: Single frame, all frames, or a custom range
- Live Pal Editing: Single or multiple indexes with sliders and saved colors
- Illustration and Icon Export: To make your life simple with implementation!
- Key Commands: Commands to make your life simple and efficient!
- Click to Index: Jump to an index by clicking on the Live Preview!
- Local Statistics: For the funzies, to track your progress, saved ONLY on your PC!
Quick Actions:
- B: Change background color
- E: Export with current options
- Shift+E: Export all frames
- O: Open custom frame options
- P: Open palette editor
- Shift+P: Export palette
- R: Reset to original
- D: Debug info
- V: Toggle view mode (single/custom)
- Fashion palettes:
chr###_w#.pal(e.g.,chr001_w47.pal) - Hair palettes:
chr###_#.pal(e.g.,chr001_5.pal) - Place custom palettes in the
exports/custom_pals/folder - Saved colors: JSON for Saved Colors boxes, PAL for Icon Colors
- JSON saved in
exports/colors/jsonfolder - PAL saved in
exports/colors/iconfolder
- JSON saved in
- Saved colors do not have to be saved in these folders to be imported
- Install Python 3.7+ from python.org
- Type "Environment" in Windows Start search and Add the location of the
Python folder to your "Paths"
NOTE: For this step, there IS a tutorial image in
AAA Tutorials - Restart
- Double-click
run_previewer.batto start the application- This will automatically check for Python and required folders
- This SHOULD download all dependencies for you, if you haven't already.
- If you get dependency errors, run:
pip install Pillow - If you're on the version WITHOUT the bat/launcher, then type in the
terminal
pip install Pillow(your first time v4.0+) thenpy fashionpreviewer.py
- Install Python 3.7+ from python.org
- Double-left click
run_previewer.shor run in the terminalpip install pillow(your first time v4.0+) and thenpython launch_previewer.py
- Install Python 3.7+ from python.org
- Open terminal/command prompt in this folder
- Run:
pip install pillow - Run:
python launch_previewer.pyorpython fashionpreviewer.py
- Python 3.7 or higher
- Pillow library (for image processing)
- Required folder structure (see below)
The application expects the following folders to be present:
FashionPreviewer/
├── changelog.md # Obvious
├── README.md # This document :3c
├── LICENSE # Legally binding license
├── run_windows.bat # Windows launcher
├── run_linux.sh # Linux launcher
├── AAA Tutorials/ # Tutorial Images (optional--for you!)
│ ├── EditorTutorial.png/ # How to use the editor in general
│ └── pythonpathwind.png/ # How to add Python to Environment Paths
├── exports/ # Export directory (necessary)
│ ├── images/ # Exported BMPs and PNGs
│ ├── custom_pals/ # Exported custom palettes
│ │ ├── fashion/ # Custom fashion palettes
│ │ └── hair/ # Custom hair palettes
│ ├── full_pals/ # Full palette exports
│ ├── icons/ # Exported icons
│ └── colors/ # Saved color collections
│ ├── json/ # JSON color files from all editors
│ └── icon/ # Icon color palette files
└── src/ # Core assets folder
├── fashionpreviewer.py # da main sauce
├── launch_previewer.py # Cross-platform launcher
├── rawbmps/ # Character images
│ ├── chr001/ # Bunny 1st Job images (bmps able to be removed/deleted)
│ ├── chr002/ # Buffalo 1st Job images (bmps able to be removed/deleted)
│ └── ... # Other character folders (bmps able to be removed/deleted)
└── nonremovable_assets/ # Assets that shouldn't be removed/modified
├── myshop_base.bmp # Base image for MyShop exports
├── icons/ # Icon assets
│ ├── chr001/ # Bunny fashion icons
│ │ ├── BMP/ # Icon BMPs
│ │ └── PAL/ # Icon palettes
│ └── ... # Other character icon folders
└── vanilla_pals/ # Default game palettes
├── fashion/ # Fashion palettes
│ ├── chr001_w00.pal
│ ├── chr001_w01.pal
│ └── ...
├── hair/ # Hair palettes
│ ├── chr001_1.pal
│ ├── chr001_2.pal
│ └── ...
└── 3rd_default_fashion/ # 3rd job base fashion
├── chr017/
├── chr018/
└── ...
- When using multi-select, hold down shift and click the last color you want to select a whole bunch at once :3!
- Make sure to always save in case it crashes too...This is vibe-coded, after all.
- If Custom Palettes are loading weird:
- Make sure you DID NOT MOVE THE PALS FOLDER INTO THE CUSTOM PALS FOLDER (don't do that!!!!!!!!!!!!)
- Double check that the palette is correct in another palette editor and compare it to a vanilla of a similar type, including the transparent indexes
- The icon editor's color imports are working now--just feel free to either quicksave or edit it immediately after saving the pal and it should work correctly! Any bugs, let me know or put 'em in the Github!
For a comprehensive list of error messages, their solutions, and other problems you may encounter, please see TROUBLESHOOTING.md for more information.
This document contains detailed information about:
- Python dependency errors
- Launcher and startup issues
- File structure warnings
- Palette loading errors
- Export failures
- Input validation errors
- Icon editor issues
- "Intended" issues
- And much more!
Each error includes the exact message, cause, and solution.
They may be back. Or not properly fixed. We don't know. Better safe than sorry.
-
Sliders move on their own sometimes
- Should be fixed in v2.1
-
Sliders keep resetting
- Should be fixed in v2.1
- Fox First Job fashion (purse) shows green hair when selected
- Should be fixed in v2.2
-
Third Job Dragon Fashion doesn't show the right indexes
- Should be fixed in v2.3
-
Third Job Dragon Fashion sometimes has buttons disappear
- Should be fixed in v2.3
-
Paula fashion is improperly labeled!
- Should be fixed in v3.0
-
Custom pals only support 2 numbers!
- Goes infinitely in v3.0 now
-
Gloves, Satchels, and Shoes are all being sorted together for Bard
- Should be fixed in v3.2
-
BMP BG Style options don't ungrey when BMP is selected
- Should be fixed in v3.2
-
Scroll wheel doesn't work with the scroll boxes
- Should be fixed in v3.2
- Live Edit Pallette editor breaks on Linux
- Should be fixed in v4.0 or v3.1 (if you want to downgrade, for whatever reason)
- Shoes are not showing up for Fox 2nd job Fashion
- Should be fixed in v4.0
- Some Gears Options don't stay when the menu closes
- Should be fixed in v4.0
- Double click bug in Live Pal Editor makes certain colors duplicate!
- Should be fixed in v4.0 (mostly; we can only do so much protection with this, I found, unfortunately.)
- Boxes jitter when selected in Live Pal Editor
- Should be fixed in v4.0, along with a simpler editor to use by default
- The program doesn't switch to All mode when max params are given
- Should be fixed in v4.0
- The program doesn't center the image on single view!
- Honestly I really delayed fixing this because I CBA to rip up the file sooner.
- Should be fixed in v4.0
- The program doesn't support zoom past x% for Custom or All Previews
- Intentional guardrail--needed to program the canvas to clip better
- Should be fixed in v4.0
- The program only populates in rows of 3!
- This was intentional for the zoom at the time
- Should be fixed in v4.0
- Gradients button doesn't use Value and uses Lightness instead!!
- My bad king I used the wrong word and the bot didn't correct me
- Should be fixed in v4.1 for ya, let's get that easy bag
- MANY ICONS ARE SCREWING UP
- I'm so sorry I know I really just wanted to push out as much of the icon editor as possible. I know it was sloppy, I'm sorry
- Should be fixed in v4.1
- TOO MANY BUTTONS!!!!
- Not exactly a bug but yeah that's fixed in this version too, I feel you. I was overwhelmed, too.
- Option added to show excess buttons in v4.1
- Run scripts don't check for pip/pillow/python properly!!
- Should be fixed in v4.1 :3
- Export options don't work without Quicksave enabled
- Should be fixed in v4.2
- Time doesn't save properly in statistics
- Should be fixed in v4.2
- Options Menu doesn't allow you to press OK and only saves options when you press cancel
- Should be fixed in v4.2
- Gradient button settings don't save when using the sliders
- Should be fixed in v4.2
- Many icons/pals still don't export properly from v4.1 prior!!
- HUGE update, with the documentation of it in the
AAA excess scriptsfolder for you, in case you want to analyze it and submit fixes without looking at the code itself. Additionally, the rest of the ranges have been refactored in some way that are readable. So... - Should be fixed in v4.2, along with the icon translator