Списки и вложенные словари
Автоматическое преобразование коллекций в деревья переменных.
Списки и массивы
setVar("_items::*", List.of("меч", "щит"));
List<?> items = getList("_items");
Java-коллекция или массив превращается в индексы Skript от 1. getList принимает имя с ::* или без него. Для отсутствующего списка возвращается пустая коллекция.
Вложенные словари
setVar("profile::*", Map.of(
"name", "Алекс",
"stats", Map.of("wins", 12)
));
Map<String, Object> profile = getMap("profile");
Это создаёт пути profile::name и profile::stats::wins. Чтение возвращает копию структуры.
Индексы и форма результата
getVar("name::*") возвращает List, если индексы плотно идут от 1 до N. При именованных или разреженных индексах возвращается Map. getMap сохраняет строковые ключи верхнего уровня, а вложенные плотные ветки могут быть списками. getList отклоняет разреженное дерево: в таком случае используйте getMap.
Ограничения дерева
- Ключи превращаются в строки; коллизии путей недопустимы.
- Пустые ключи,
::,*и фигурные скобки в ключах отклоняются. $valueзарезервирован для скалярного значения вложенного узла, у которого также есть дети.- Циклы, чрезмерная глубина и слишком много листовых значений отклоняются до замены дерева.
- Пустая коллекция не создаёт индексы Skript; при чтении она выглядит как пустой список или словарь.
Изменения прочитанной Java-структуры не синхронизируются автоматически. Передайте обновлённую структуру обратно в setVar.