# 游戏内用户装扮

登录时游戏取得完整账户外观。它属于账户状态，不写入游戏存档，也不能通过游戏脚本修改。聊天和排行榜里的每位用户同样带有完整 appearance。退出或换号后不会沿用前一账户装扮，到期先回退，再尝试刷新。

# 读取本人

普通脚本、动态字符串的求值脚本和只读布局脚本均可读取：

const slots = player.cosmeticSlots
const items = player.cosmetics
const banner = items.profile_banner // 装扮描述或 null
const layer = banner?.render_spec.layers?.[0]
const url = layer?.frames > 1 ? layer.poster_url : layer?.url

十三槽为 envs、heads、clos、tops、eyess、mouths、avatar_frame、avatar_effect、name_effect、profile_background、profile_banner、leaderboard_background、chat_bubble。前六槽是基础头像部件，其他槽未装备时为 null。排行榜行背景和聊天气泡未装备时由客户端显示默认背景，不改变槽位数据。items 的非空值包含 cosmetic_id、slot_key 和 render_spec。网络响应不重复传槽位说明；客户端按注册信息补齐 slots，提供场景、默认项、顺序与可空元信息。多语言名称等管理信息仅在装扮背包接口提供。

render_spec.renderer_kind 为 image 时可读取 layers，每层含 resource_id、url、poster_url、frames，以及非默认的 x/y/width/height、anchor_x/anchor_y、rotation、opacity、fit、focal_x/focal_y。图片、透明图片、SVG、动图使用相同图层格式。内置部件与文字效果使用 builtin_avatar_fragment、builtin_effect 或 effect_template，不保证有图片层；不要将内置 renderer_key 当成 URL。

布局脚本可使用受控 img 展示指定槽，必须转义 HTML 属性，不插入远程 SVG 源码：

const layer = player.cosmetics.profile_banner?.render_spec.layers?.[0]
const url = layer?.frames > 1 ? layer.poster_url : layer?.url
if (!url) return '<section></section>'
const escape = value => String(value).replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;')
return '<section><img alt="" style="width:100%;object-fit:cover;pointer-events:none" src="' + escape(url) + '"></section>'

示例采用静态海报，适用于减少动态效果和大量列表。游戏不会自动使用社区主页背景或 banner；由作者决定位置。游戏属性未变化时，外观刷新也会更新布局。

# 读取聊天与排行榜用户

聊天使用 users[username].appearance，消息以 username 关联，排行榜使用 entry.appearance。显示昵称可能相同，不能按昵称查找装扮。

自定义布局中，lp-repeat-control 的聊天/排行行可直接使用 {lp_chat_head} / {lp_board_head}，由统一渲染器安全叠加头像。行内动态字符串求值脚本可读取完整外观：

const appearance = tools.kwargs.row?.appearance
const banner = appearance?.items.profile_banner
return banner?.cosmetic_id || ''

player.cosmetics 始终代表本人。不能用它绘制排行榜其他玩家。系统或已注销用户的 appearance.user_id 为 null，但仍有基础部件和空可选槽，客户端会补齐本地 slots。