Card studio
Customize the rank card and leaderboard images.
Levels has two visual editors. Rank Card Studio controls the /level rank PNG. Leaderboard Studio controls the /level leaderboard PNG. Both layouts are shared with the bot through card-layouts.ts and are merged with defaults before storage.
Rank card controls include typography, canvas width 600–1400, height 180–600, radius, padding, text column X/top/gap, username and stat alignment, avatar visibility, shape, size, ring, and position. Element controls include username color, rank badge toggle/color, level and XP colors, total XP line, and a free custom text layer with text, size, color, X, and Y.
Rank progress controls can enable the bar, choose linear or segmented, set thickness, radius, segments 4–40, neon glow, track color, fill color, and percent text. Background controls choose gradient or HTTPS image, image opacity, accent color, glow, and inner border.
Leaderboard controls include font family/weight, title/name/meta sizes, width, radius, padding, optional header, title/subtitle colors, optional top-3 podium, podium height, halo intensity, #1 avatar scale, crown, row height/gap/radius/avatar size, alternating shading, top-3 tint, rank colors for #1–#3, metric colors, and the same background controls. Height is automatic and grows to fit rows and podium.
Safe layouts
The API runs both card designs through mergeRankCardLayout and mergeLeaderboardLayout, so invalid colors, unsafe image URLs, and out-of-range values fall back or clamp instead of breaking rendering.
