appearance

Last updated on

At join the module decides which body the world loads with, puts the stored face and clothes on, and sends the announcement that lets the player into the world. It opens the game's own mirror to edit a face, runs the fitting room where a player picks clothes slot by slot, and hands every player's look to the others so they are drawn at all. Players open their panel with /opx.appearance; the fitting room opens at a clothing store, a shop, from staff, or once after character creation. Other modules use the contract to dress, preview or bill clothing.

Joining the world

The client sends open77:session:gameplayReady as soon as the character's world entry starts, even when the platform has not reset the body yet: the platform resets and revives the body only after that announcement.

• The face and clothes go on once the platform's reset has brought the body alive.
• Before the reset, the entry waits up to 60 s (counted from the announcement), then enters on no face with a warning.
• After the reset, a body that is still not alive after 5 s settles on no face. A failed reset (open77:playerReset:failed) ends the wait at once.
• A face given up on a dead body goes on when the body is alive again (after a revive).
• A character switch in the world (SWITCH = 'relog') and a restart of opx_infinity mid-session settle like a join: the new character is dressed and its look published.

Commands

There is no fitting-room command (/opx.appearance.wardrobe is gone) and no panel key. Staff open the room for a player with /opx.admin.player.wardrobe.

What the panel offers

• Looks: put the stored face back on (Wear it), open the mirror on the face (Edit face, ripperdoc mode) or the hair (Hair only, hairdresser mode).
• Body: shows the body type. It cannot be changed: it belongs to the character.
• Outfits: opens the fitting room. A room opened this way has no server grant, so its save is refused with clothing.noFittingRoom unless another door granted one in the last 10 minutes.

Garment names and pictures

The fitting room shows each piece with its real name and a picture on the player's body family. The data is generated; nothing here is a setting.

local name, picture = M.Garments.Describe(record, family)

• record: string — an Items.* name
• family: 'female' | 'male'
• Returns the name and picture (each may be nil): the family's own picture, else the other body's, else nil. A malformed row is reported once with OPX.Note and treated as missing. Not on the contract.

• Each box in the room is drawn through the panel tiles spec with labels (the garment name, or one made from the record) and images (the picture, or '' for a monogram).
• Category names are the wardrobe.slot.* locale keys: Head, Face, Top (InnerChest), Jacket (OuterChest), Pants (Legs), Shoes (Feet), Outfit; in French Tête, Visage, Haut, Veste, Pantalon, Chaussures, Tenue.

Configuration

config/appearance.lua sets OPX.Config.MODULES.appearance. Shared script. Nothing else in opx_infinity sends the join announcement, so enabled = false only when another resource does.

WARDROBE = {
  OFFER_POLICY = 'first',
  CREATION_WAIT_MS = 60000,
  CAMERA_OFFSET = { X = 0.0, Y = 2.6, Z = 1.1 },
  CAMERA_FOV = 95,
},

• OFFER_POLICY: which world entries get the room. 'first': only a character just built in the creator. 'always': every entry. 'never': none. Unknown: warning, reads 'first'.
• CREATION_WAIT_MS: how long the join retries opening the owed room before moving on.
• CAMERA_OFFSET: camera position in metres in the puppet's space (X across, Y in front, Z up).
• CAMERA_FOV: used only when the camera cannot be moved to CAMERA_OFFSET; nil leaves the player's own.

Join order for a new character: name → fitting room → spawn menu. A player dressing is inside the spawn module's HOLD_MAX_SECONDS; keep that longer than a player needs to dress.

Refusal codes

Sent on opx:net:appearance:refused. Face refusals are also shown to the player through the locale catalogue; clothing refusals are only published and logged.

Validation details on appearance.invalid: unsupported_schema, unsupported_game_build, invalid_catalog_digest, invalid_gender, invalid_option_count, option_out_of_range, duplicate_option, sparse_options. On clothing.invalid: unknown_field, invalid_slot, invalid_item, invalid_active, invalid_outfit, invalid_outfit_slot.