RoyaleWindRoyaleWind

How it works

Shopping, try-ons, checkout, player listings, discounts and catalog photos — for players and for staff.

For players

Walking in

Every store has a clerk standing at its counter. Use the target on the clerk (or the marker prompt, if ox_target isn't running) to open the shop. You have to be on foot.

Walking in is covered by the entry curtain: two bars close over the screen, your ped is moved to the store's fitting spot, the camera settles behind you, and the bars open to a letterbox while the shop loads, then slide away. While you're inside you're in your own routing bucket, so nobody sees you change and you don't see other shoppers.

If you've sold outfits since your last visit, a Sales income row shows what they earned — press Collect to take it.

Browsing and trying on

The shop docks to the right edge of the screen and the camera keeps your ped clear of it. The store's name, its logo and any sale that's on sit in the top-left corner. Outfits are grouped into collections (casual, streetwear, formal…) you can filter by.

  • Click a card and your ped wears it. There's no try button — the click is the whole gesture.
  • Drag sideways to turn the ped. Let go mid-turn and it coasts to a stop.
  • Drag up and down to raise or lower the shot.
  • Scroll to come closer or step back.

An outfit you don't own is sealed: the server only sends its name, collection, price and sales count. Trying it on hands the clothing to client Lua once, to dress the ped — never to the page — and the server re-checks your wardrobe on every try-on instead of trusting anything it sent earlier.

Staff can turn on Only owned outfits can be tried on under Settings → Fitting room to stop unowned looks going on the ped at all. Hidden outfits can't be tried on by anyone who doesn't own them.

Buying

Put outfits in the bag, pick which account to pay from (bank or cash, as the server allows), and hold the pay button until the bar fills. Letting go cancels.

The server then checks everything again: your cooldown, the bag size, your distance from the counter, that every outfit is sold in this store, your wardrobe size and duplicates, your balance and, last of all, the canBuy hook. The whole bag goes through or none of it does — if anything fails part way, whatever was claimed is rolled back.

Leaving

Press Esc. The curtain closes, your own clothes, camera and position are put back, and you're on the street.

If you're wearing something you own, its sheet offers to wear it out instead. The server confirms you own it one last time, and the rw_fashion:outfitApplied event fires so your appearance resource can save the look.

Selling your own outfits

Players can sell their own looks. In a store, press Create in the panel header:

  1. The shop captures what your ped is wearing and lists the slots it caught, so you can check it before it goes live.
  2. Give it a name, a description, a price and a collection.
  3. Pay the listing fee and it goes on the shelf under your name, photographed.

Every time it sells, your share (the Seller share under Settings → Player listings) is banked — even while you're offline — and waits for you. Open any store: while you have a listing on the shelves, a Sales income row sits under your balances showing what you've earned. Press Collect to have it paid into the same account the fee comes from.

You manage your own listings from the outfit's sheet:

  • Reprice it, within the same price range it was listed under. The sheet shows what shoppers will pay once the store's multiplier is added.
  • Take it down — if nobody has bought it, it's deleted; if people have, it only comes off the shelves, so nobody loses what they paid for. Putting it back on the shelves is done by staff.

There's no review queue — the listing fee and the per-player limit are the spam control.

For staff

Setting up

  1. Give yourself the rw_fashion.admin ace — see Installation.
  2. Open /fashionAdmin. The shop ships with one store, Ponsonbys in Rockford Hills.
  3. Add more stores from Stores: stand where the clerk should be and press New store.
  4. Adjust collections and which clothing slots outfits carry under Catalog.
  5. Set prices, listings, discounts, the curtain, the camera and the look of the shop under Settings.

Stocking the catalog

Walk into a store, get dressed, and press Create — the same panel players use. Staff listings cost no fee and skip the price range and listing limit, but they're still yours: you earn the seller share when they sell, and can reprice or take them down like any player. You can also turn off the photo toggle and attach an image link later.

Running the shop

  • Home shows today's money and listings, all-time totals and a 30-day revenue chart.
  • Sales is a live feed of every purchase, and where you schedule recurring sales.
  • Listings is where you rename, reprice, hide, give away or delete any outfit — yours or a player's.

Everything is live and saved to the database. See In-game editor.

Prices and discounts

The price a player pays is worked out on the server, never proposed by the client:

catalog price × store price multiplier × (1 − discount)
  • Store multiplier — each store has its own (Ponsonbys is 1.45), between 0.01 and 100.
  • Discounts — by job or gang, plus recurring sale windows. Either the single best one applies or they stack, capped by Largest total discount — set under Settings → Discounts. Recurring sales are set under Sales → Recurring sales.
  • The discount hook can change the final rate, and is the only way past the cap.

Catalog photos

Saving from the Create panel photographs the outfit automatically: the interface hides for a moment, the camera centres on the ped, the image is cropped to the card shape and uploaded to Fivemanage. The token stays on the server — it asks Fivemanage for a one-time upload link and the page uploads to that.

  • Turn the photo toggle off in the Create panel to skip it.
  • Attach or replace a photo later from the editor's Listings tab.
  • Photos lazy-load, and an outfit with no photo or a dead link shows a placeholder.
  • Photos need a Fivemanage token — see Installation.

What gets captured

Only the slots ticked under Catalog → Outfit slots in the editor are saved with an outfit and swapped on try-on. By default that's mask, arms, legwear, bag, footwear, accessory, undershirt, decal and top, plus hat, glasses, earwear, watch and bracelet. Body armour, hair and head overlays are left out, so a player's own haircut is never overwritten. The server reads the ped itself — it never trusts what the page sends.

Sounds and polish

The shop has four sounds: the curtain on the way in and out, a short click behind buttons, chips and cards, a quieter one for typing, and a loop while a purchase is held down. Each can be switched off, and there's a master volume, under Settings → Interface. The same section sets the accent colour the whole interface is tinted from, the currency symbol, the default store logo, and an optional wipe over each try-on (off by default — it adds about 800 ms to every try-on).

On this page