Namecard

Displays a clean, styled player profile — including avatar, name, title, level, and tier. Used in headers or footers to show who's logged in, their status, or game rank.


Structure

{
    type = "namecard",
    avatar = "avatar_1.jpg",
    background = "namecard_bg_2.jpg",
    name = "Player Name",
    title = "Some Player Title",
    level = 99,
    tier = "silver"
}

Where to Use

You can place a namecard in:

  • header.left, or header.right

  • footer.left, or footer.right


Fields

  • type: Always "namecard" to use this component.

  • avatar: File name or path for the avatar image (stored in /ui/assets/namecards/avatars/). If a full URL or nui:// path is provided, it will be used directly.

  • background (optional): Background image file (stored in /ui/assets/namecards/backgrounds/). Defaults to "avatar_placeholder.png". Full links or nui:// paths are supported.

  • name (optional): The player’s name. Defaults to "Player Name".

  • title (optional): Role or description (e.g., "Founder", "Police Chief").

  • level (optional): Player level — displayed as Lv. 99.

  • tier (optional): Style pre-set ("bronze", "silver", "gold", etc.) for colouring and badges.


Notes

  • avatar and background must match filenames in the asset folders.

  • Tiers can be styled via CSS — each one has a visual style (.bronze, .gold, etc.).

Last updated