Работа с RSI

Что такое RSI?

RSI (Resource State Interface) — это специальная папка, содержащая спрайты (.png) и управляющий файл meta.json. Каждый спрайт должен находиться в своей RSI-папке с правильно заданными параметрами.

Пример правильного и неправильного имени RSI-папки

Путь: Clothing/Uniforms/Jumpsuit

Пример имени	Описание
`Odejda-capitana.rsi`	❌ Плохо — транслит, дефис
`Одежда капитана.rsi`	❌ Плохо — кириллица, пробел
`captain.rsi`	✅ Хорошо — лаконично, на английском, строчные буквы

Правила именования RSI-папок

Осмысленность — название должно отражать содержимое;
Строчные буквы — только нижний регистр;
Разделение подчёркиванием — слова разделяются _;
Без приписок — избегать _ss220, _corvax, _event и т.п.;
Без избыточной детализации — не дублируйте категорию:
- captain_uniform.rsi ❌ в Jumpsuit/ — избыточно;
- centcom_glasses.rsi ❌ в Glasses/ — избыточно.

Эти правила касаются только .rsi-папок, не обычных: Textures, Clothing, Weapons и т.д.

Правила для одежды

Если спрайт связан с конкретной должностью — это должно быть отражено в названии:

Название	Описание
`atmospheric_technician_casual.rsi`	Повседневная униформа атмосферного техника
`cmo_corp.rsi`	Корпоративная униформа главврача
`lawyer_trusted.rsi`	Костюм доверенного юриста
`nanotrasen_diplomat.rsi`	Униформа дипломата НаноТрейзен

Названия самих спрайтов

Основные названия:

Название	Описание
`icon.png`	Иконка предмета (32x32)
`equipped-INNERCLOTHING.png`	Спрайт на персонаже — внутренняя одежда (64x64, 4 направления)
`equipped-OUTERCLOTHING.png`	Спрайт на персонаже — верхняя одежда (64x64, 4 направления)
`inhand-left.png`	Отображение в левой руке (64x64, 4 направления)
`inhand-right.png`	Отображение в правой руке (64x64, 4 направления)

Вариации по расам:

Название	Для кого
`equipped-INNERCLOTHING-monkey.png`	Обезьяны
`equipped-INNERCLOTHING-vox.png`	Воксы
…	Другие расы при необходимости

Варианты для других слотов:

equipped-BACKPACK.png — рюкзак
equipped-HELMET.png — шлем
и т.д. по слотам

Файл meta.json

meta.json — обязательный управляющий файл. Без него спрайты не будут отображаться в игре.

Пример стандартного `meta.json`:

{
  "version": 1, 
  "license": "CC-BY-SA-3.0", 
  "copyright": "Sprited by SonicHDC (github) for ss14, resprited by Kit0vras (Github) for SS220", 
  "size": {
    "x": 32, 
    "y": 32
  }, 
  "states": [ 
    { 
      "name": "icon" 
    }, 
    {
      "name": "equipped-INNERCLOTHING",
       "directions": 4 
    }, 
    {
      "name": "inhand-left", 
      "directions": 4 
    }, 
    {
      "name": "inhand-right", 
      "directions": 4
    }
  ] 
}

Поле	Значение
`version`	Версия формата, всегда `1`
`license`	Лицензия спрайтов (см. ниже)
`copyright`	Автор спрайтов
`size`	Размеры спрайта (в пикселях)
`states`	Названия спрайтов и их параметры

Лицензии

Лицензия	Когда использовать
`"CC-BY-SA-3.0"`	Используете чужие или переработанные спрайты
`"EULA/CLA..."`	Вы — автор оригинального спрайта для SS220

Лицензия SS220 EULA/CLA with a hosting restriction, full text: https://raw.githubusercontent.com/SerbiaStrong-220/space-station-14/master/CLA.txt означает, что:

Изменения с этой лицензией передаются SS220 бесплатно и безотзывно.
Разрешено использовать и модифицировать локально и некоммерчески.
Запрещено коммерческое использование, публичный хостинг без разрешения.

Если в папке спрайты с разными лицензиями:

Либо поместите их в разные папки;
Либо используйте "CC-BY-SA-3.0" для всех спрайтов в папке.

✍️ Как указывать автора

Ситуация	Пример
Вы — автор	`Sprited by ТвойНик (Github / Discord) for SS220`
Вы сделали респрайт чужого спрайт	`Sprited by НикОригинала (Github), resprited by ТвойНик (Github) for SS220`