Списки и вложенные словари

Автоматическое преобразование коллекций в деревья переменных.

Списки и массивы

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.

Введите запрос для поиска по руководству.