⏬ The Settler — localize your aliases, fix missing or deleted base variables

About this plugin

(Русский внизу 👇)

Update

12 September 2025

✨ Smart Collection Renaming!

Now, the plugin can automatically rename your target collection to match the original one. Just check the "Rename collection to match donor" option, and you won't have to do it manually anymore

---

This plugin localises all alias variables that refer to missing base variables (those located in external files or simply deleted)

🎦 Video demonstration: https://youtu.be/f9Ofv7lB-Lk

Why is this a problem?!

Here's the thing... Figma doesn't care about these links, it doesn't transfer them to the new file, but leaves the links to the companion variables (base/master variables) in the old file. And this isn't what you expect when you copy variables :)

In simple words, what the plugin does:

1. It looks for alias variables that have a reference to base variables that didn't make it to this file (either left in another file or simply missing)
2. Creates copies of such variables in this file
3. Rebinds the alias variable, changing the reference from the external master variable (base variable) to the newly created local one

Works for variables of all types:

1. color,
2. text,
3. boolean,
4. numeric

It should work with multiple mods, but I haven't tested this part.

-----------------

Обновление

12 Сентября 2025

✨ Умное переименование коллекций!

Теперь плагин может автоматически переименовать целевую коллекцию, чтобы она соответствовала исходной. Просто поставьте галочку "Rename collection to match donor", и вам больше не придется делать это вручную!

---

Плагин поможет, когда вы взяли и просто скопировали переменные из другого файла, а там были алиасы (переменные ссылались на другие переменные).

🎦 Видео-демонстрация: https://youtu.be/f9Ofv7lB-Lk

В чём же проблема?

Но вот незадача... Figma не заботиться об этих связях, она не переносит их в новый файл, а оставляет ссылки на переменные-спутники (базовые/мастер-переменные) в старом файле. А это вообще не то, чего ждёшь, когда копируешь переменные :)

Простыми словами, что делает плагин:

1. Ищет переменные-алиасы, которые ссылаются на базовые переменные, не дошедшие до этого файла (либо оставшиеся в другом файле, либо пропавшие без вести)
2. Создает копии таких переменных в этом файле
3. Перевязывает алиас-переменную, меняя ссылку с внешней мастер-переменной (базовой переменной) на локальную

Работает для переменных всех типов:

1. цветовые,
2. текстовые,
3. булевы,
4. числовые

По идее, должно работает и с множественными модами, но я не тестил этот момент