/arena/customization/set
Сменить имя, скин, аватар или рамку на арене.
Адрес метода
/arena/customization/set
Требует сессию пользователя
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
| name | НЕТ | string | Имя на арене — по правилам имени, см. /arena/onboarding/complete |
| skin_id | НЕТ | string(0..64) | cid скина |
| avatar_id | НЕТ | string(0..64) | cid аватара |
| frame_id | НЕТ | string(0..64) | cid рамки |
Результат
{"response": {"success": 1, "arena": {"...arena"}}}
Ошибки
| Код | Когда |
|---|---|
| 10062 | Имя не прошло проверку, которую клиент делает и сам (длина, символы, формат, серия цифр и, если включено, один алфавит на слово). Какое правило сработало, не сообщается: поля reason нет |
| 10063 | Имя не разрешено правилом, которое есть только на сервере. Поле reason: profanity — фильтр ненормативной лексики, not_allowed — всё остальное (резерв, адрес сайта) |
| 10066 | Имя занято другим игроком (с точностью до регистра, похожих букв и разделителей) |
| 10064 | Смена имени раньше конца кулдауна; момент доступности — в поле available_at |
Что важно знать
Имя проходит те же правила, что при онбординге, и сохраняется нормализованным (без пробелов по краям; что именно сводится — в onboarding/complete) — в ответе приходит сохранённая форма. Раньше метод принимал любые 1–50 символов.
Имя уникально. Своё текущее имя занятым не бывает: его можно прислать снова или сменить в нём регистр. Прежнее имя после смены сразу свободно для любого. Если занято, не меняется ничего — ни имя, ни присланная вместе с ним косметика.
После онбординга это имя персонажа везде, поэтому оно приходит и полем character_name в объекте пользователя. Здесь его меняет профиль игрока.
Кулдаун смены имени — arena_config.name_change_cooldown_sec (по умолчанию 0, без кулдауна; решение геймдизайна — переименование свободное). Когда смена снова доступна, клиент знает заранее: name.change_available_at в /arena/info. Повтор текущего имени — не смена и кулдаун не тратит.
Косметику нужно иметь открытой — иначе отказ по соответствующему параметру. Проверка идёт по cid, а не по номеру строки конфига.
Изменения попадают и в строку участника группы, из которой соперники видят имя и косметику в списке целей и в таблице лидеров.
Пустой параметр означает «не менять», а не «стереть».