Дата-файлы

Дата-файлы в Oxide используются для хранения переменных данных, которые должны сохраняться между перезапусками сервера.
Они позволяют плагинам записывать и загружать информацию, такую как статистика игроков, настройки, временные события, и другие важные данные.

Где хранятся дата-файлы?

Дата-файлы плагинов находятся в папке: /oxide/data/
Каждый плагин создает свой файл в формате .json, более сложные плагины могут иметь несколько дата-файлов, или вовсе для каждого игрока - отдельный дата-файл.

Какие бывают виды структур

Рассмотрим несколько видов структур дата-файлов :

1. Простой пример с дата-файлом:

oxide/
 ├── config/           
 ├── data/             # Дата-файлы (сохраняемые данные)
 │   ├── VanishPlayers.json  # Файл данных плагина Vanish
 ├── lang/             
 ├── logs/             
 ├── plugins/

2. Дата-файл в определенной директории

oxide/
 ├── config/           
 ├── data/            # Дата-файлы (сохраняемые данные)
 │   ├── IQSystem     # Папка для системы плагинов ветки IQ
 │   │   ├── IQChat   # Папка для плагина IQChat
 │   │   │   ├── UserInfo.json        # Файл данных игроков в IQChat
 │   │   │   ├── Moderators.json      # Файл данных модераторов в IQChat
 ├── lang/             
 ├── logs/             
 ├── plugins/

3. Дата-файл с дополнительными объектами

oxide/
 ├── config/           
 ├── data/            # Дата-файлы (сохраняемые данные)
 │   ├── IQSystem     # Папка для системы плагинов ветки IQ
 │   │   ├── IQChat   # Папка для плагина IQChat
 │   │   │   ├── Images                  # Папка для хранения изображений
 │   │   │   │   ├── Icon.png            # Папка для хранения изображений
 │   │   │   │   ├── Background.png      # Папка для хранения изображений
 │   │   │   ├── UserInfo.json        # Файл данных игроков в IQChat
 │   │   │   ├── Moderators.json      # Файл данных модераторов в IQChat
 ├── lang/             
 ├── logs/             
 ├── plugins/

Это одни из самых распространенных видов дата-файлов

Что такое дата-файл?

Дата-файлы это хранилище для плагина, и обычно администратор не взаимодействует с ней, ведь нарушив синтаксис или допустив ошибку - вы рискуете потерять все хранимые данные

Дата-файлы могут выглядеть по разному:

1. Простой дата-файл

{
"76561198000000000": 5,
"76561198000000001": 12
}

2. Более продвинутая структура

{
  "76561198000000000": {
    "Info": {
      "Prefix": "<color=#CC99FF>[PLAYER]</color>",
      "ColorNick": "#0099FF",
      "ColorMessage": "#eee",
      "Rank": "",
      "CustomColorNick": null,
      "CustomColorMessage": null,
      "PrefixList": []
    },
    "Settings": {
      "TurnPM": true,
      "TurnAlert": true,
      "TurnBroadcast": true,
      "TurnSound": true,
      "IgnoreUsers": []
    },
    "MuteInfo": {
      "TimeMuteChat": 0.0,
      "TimeMuteVoice": 0.0
    }
  }
}

Изменение данных в дата-файле или его очистка

Если вы все-же решили изменить данные в дата-файле или вовсе удалить один или все файлы, то вы обязательно должны выполнить эти действия :

1. Выгрузить плагин - o.unload PluginName
2. Сделать резервную копию дата-файла(/ов)
3. После изменений убедиться в соблюдении синтаксиса и сохранить файл
4. Загрузить плагин - o.load PluginName

Очень важно!

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

DANGER

Сделав резервную копию дата-файлов вы сохраните себе много времени и все данные ваших игроков!