ProjectSettings

public static void AddPropertyInfo(Reckfell.Collections.Dictionary hint);

Добавляет информацию о пользовательском свойстве к свойству. Словарь должен содержать:

• "name": string (имя свойства)
• "type": [int] (см. Variant.Type)
• опционально "hint": string

ProjectSettings.Singleton.Set("category/property_name", 0);

var propertyInfo = new Reckfell.Collections.Dictionary
{
    { "name", "category/propertyName" },
    { "type", (int)Variant.Type.Int },
    { "hint", (int)PropertyHint.Enum },
    { "hint_string", "one,two,three" },
};

ProjectSettings.AddPropertyInfo(propertyInfo);

Примечание: Установка "usage" для свойства не поддерживается. Для изменения флагов "usage", используйте ProjectSettings.SetAsBasic, ProjectSettings.SetRestartIfChanged и ProjectSettings.SetAsInternal.

public static bool CheckChangedSettingsInGroup(string settingPrefix);

Проверяет, существуют ли какие-либо настройки с префиксом setting_prefix в наборе измененных настроек. См. также ProjectSettings.GetChangedSettings.

public static void Clear(string name);

Очищает всю конфигурацию (не рекомендуется, может что-то сломать).

public static string[] GetChangedSettings();

Получает массив настроек, измененных с момента последнего сохранения. Обратите внимание, что внутренне changed_settings очищается после успешного сохранения, поэтому обычно наиболее подходящее место для использования этого метода — при обработке ProjectSettings.SettingsChanged.

public static Reckfell.Collections.Array<Reckfell.Collections.Dictionary> GetGlobalClassList();

Возвращает Reckfell.Collections.Array зарегистрированных глобальных классов. Каждый глобальный класс представлен как Reckfell.Collections.Dictionary, который содержит следующие записи:

• base — имя базового класса;
• class — имя зарегистрированного глобального класса;
• icon — путь к пользовательскому значку глобального класса, если он есть;
• language — имя языка программирования, на котором написан глобальный класс;
• path — путь к файлу, содержащему глобальный класс. Примечание: Пути к скрипту и значку являются локальными для файловой системы проекта, т. е. они начинаются с asset://.

public static int GetOrder(string name);

Возвращает порядок значения конфигурации (влияет при сохранении в файле конфигурации).

public static Variant GetSetting(string name, Variant defaultValue = default);

Читает базовое значение настройки; при отсутствии возвращает defaultValue, не создавая ключ. Не проверяет тип и не применяет feature overrides. Для них используйте GetSettingWithOverride.

public static Variant GetSettingWithOverride(StringName name);

Читает настройку с учётом активных feature tags. Для game/content_mode и game/content_mode.demo возвращает вариант demo при активной метке demo, иначе базовое значение. В отличие от GetSetting учитывает переопределение; пример не устанавливает приоритет нескольких активных суффиксов.

public static Variant GetSettingWithOverrideAndCustomFeatures(StringName name, ReadOnlySpan<string> features);

Похоже ProjectSettings.GetSettingWithOverride, но применять метки функции вместо текущего OS - характеристики.

public static Variant GetSettingWithOverrideAndCustomFeatures(StringName name, string[] features);

Похоже ProjectSettings.GetSettingWithOverride, но применять метки функции вместо текущего OS - характеристики.

public static string GlobalizePath(string path);

Преобразует asset://, user:// и поддерживаемый uid:// в путь ОС; остальные строки оставляет без такого преобразования. Не создаёт папку и не извлекает ресурс из пакета. Для System.IO путь user:// сначала нужно глобализировать; импортированные ресурсы продолжайте загружать через ResourceLoader.

public static bool HasSetting(string name);

Проверяет наличие ключа настройки, а не соответствие его значения ожидаемому типу. Чтение отсутствующего ключа через GetSetting с резервным значением не создаёт ключ.

public static bool LoadResourcePack(string pack, bool replaceFiles = true, int offset = 0);

Подключает PCK или ZIP к asset://; не создаёт экземпляры Entity и не загружает DLL в .NET. При совпадении обычных путей replaceFiles определяет приоритет, но записи удаления PCK применяются даже при false. Уже загруженные ресурсы не обновляются автоматически: обычный ResourceLoader.Load может вернуть старый объект из кэша. Подключайте обновления до первого обращения к их ресурсам. Свежий DirAccess может перечислять добавленные пути.

public static string LocalizePath(string path);

Преобразует подходящий абсолютный путь внутри корня проекта в asset://. Абсолютный путь за пределами проекта обычно остаётся абсолютным. Не является общим преобразованием пути папки пользователя в user://; сохраняйте виртуальные пути слотов явно.

public static Error Save();

Сохраняет конфигурацию в файл project.reckfell. Примечание: Этот метод предназначен для использования плагинами редактора, поскольку измененные ProjectSettings нельзя загрузить обратно в работающее приложение. Если вы хотите изменить настройки проекта в экспортированных проектах, используйте ProjectSettings.SaveCustom для сохранения файла override.cfg.

public static Error SaveCustom(string file);

Сохраняет текущую конфигурацию по указанному пути. Значения, равные исходным, пропускаются; метод не ограничен одним пользовательским ключом и не загружает файл обратно. Для предпочтений игрока обычно нужен отдельный ConfigFile в user://.

public static void SetAsBasic(string name, bool basic);

Определяет, считается ли указанная настройка базовой или расширенной. Базовые настройки всегда будут отображаться в настройках проекта. Расширенные настройки будут отображаться только в том случае, если пользователь включит опцию «Расширенные настройки».

public static void SetAsInternal(string name, bool @internal);

Определяет, считается ли указанная настройка внутренней. Внутренняя настройка не будет отображаться в диалоговом окне «Параметры проекта». Это в основном полезно для дополнений, которым необходимо хранить собственные внутренние настройки, не предоставляя их напрямую пользователю.

public static void SetInitialValue(string name, Variant value);

Задаёт исходное значение уже существующей настройки, не меняя текущее. При сохранении значение, равное исходному, пропускается. Если ключа нет, сначала создайте его через SetSetting.

public static void SetOrder(string name, int position);

Устанавливает порядок значения конфигурации (влияет при сохранении в файле конфигурации).

public static void SetRestartIfChanged(string name, bool restart);

Устанавливает, требуется ли перезапуск редактора для правильного вступления в силу настройки. Примечание: Это просто подсказка для отображения пользователю того, что редактор необходимо перезапустить для вступления изменений в силу. Включение ProjectSettings.SetRestartIfChanged не задерживает установку настройки при ее изменении.

public static void SetSetting(string name, Variant value);

Устанавливает значение настройки в памяти; Variant Nil удаляет ключ. Сам не записывает файл и не гарантирует немедленного применения к работающей подсистеме. Например, для текущего лимита кадров меняйте Engine.MaxFps.

public static event Action SettingsChanged;

Выдается при изменении любой настройки, до одного раза за кадр процесса.