Use at your own risk. Everything here is shared by the community and is not tested or security-checked by rA Vault. Always try it on a sandbox / test server first.Not security-checked. Test on a sandbox server first. Read the disclaimer

Stylist UI

Server-side implementation of the kRO Stylist window for rAthena. **Features** - Numeric selectors for BodyColor, HairStyle and HairColor, using the loaded client catalogue - Outfits from the…

by Scanty · listed Oct 29, 2026

Screenshot of Stylist UI

Server-side implementation of the kRO Stylist window for rAthena.

**Features**
- Numeric selectors for BodyColor, HairStyle and HairColor, using the loaded client catalogue
- Outfits from the character's evolution branch, while preserving the actual job
- Outfit eligibility by job tier, sex and catalogue, rechecked on login, job/sex changes and configuration reloads
- Purchases paid with zeny or coupons, validated server-side before anything is consumed
- Accessories delivered through RODEX, with a durable SQL purchase journal and retry handling
- Client EXE patcher: dye removal fix, outfit-tab eligibility and favorites per character/job
- StylistTools.exe: change the number of clothing colors, hairstyles and hair colors from a window, no Python needed

**Requirements**
- rAthena master (Renewal)
- Client 2026-02-19
- PACKETVER 20260219 (exe date)

**Install**
1. `git apply diff/stylist_ui.diff` in your rAthena folder
2. Set `#define PACKETVER 20260219` in `src/custom/defines_pre.hpp`
3. Import `server/sql-files/upgrades/stylist_accessories.sql` into your database
4. Recompile map-server and char-server, copy `client/` to your client and run `patcher/StylistUIPatcher.exe` on your client EXE
5. Install the palettes GRF in your client

The Stylist NPC is at **Prontera 170,180**. Default counts: 667 clothing colors, 42 hairstyles and 5 hair colors. (See stylist.conf)```

// Modern Stylist UI. Loaded by conf/battle_athena.conf.
feature.stylist: on

// Minimum group level. 0 enables all players; 99 restricts a test rollout.
stylist_min_group: 0
// Every eligible class may wear outfits from its own evolution branch.
// Install client/data (expanded catalogue). Standard variant requires off.
stylist_class_lineage: on
// Add tier bits: 1 = all eligible jobs, 2 = second, 4 = transcendent,
// 8 = third, 16 = fourth. Novice and Baby jobs cannot change outfits.
stylist_costume_jobs: 30
// Requires sql-files/upgrades/stylist_accessories.sql and InnoDB tables.
stylist_accessory_mail: on

// Limits matched to the included human catalogue. Color 0 is the default.
max_hair_style: 42
max_hair_color: 5
max_cloth_color: 667

**Palettes (GRF):** https://drive.google.com/file/d/10zQj1eJj0blOS9pyyiopvrdMsFTssn7p/view?usp=sharing

**Download / full guide:** https://github.com/JassoRaygoza/rathena-stylist-ui

Feedback, bug reports and pull requests are welcome.

Client Patched (using StylistUIPatcher.exe (https://github.com/JassoRaygoza/rathena-stylist-ui/blob/main/patcher/StylistUIPatcher.exe))

Old Window:

Known issues

No known issues yet.

Having trouble with Stylist UI? Ask about it →