FilesJS

FilesJS - это небольшой, но полезный плагин-мод для KubeJS, который добавляет возможность ограниченной работы с файлами прямо из скриптов. Если ты уже используешь KubeJS для настройки своей сборки или сервера, то FilesJS даёт тебе больше гибкости, но при этом не подставляет систему под удар.

Зачем это нужно

В ванильном KubeJS нет прямого доступа к файловой системе - это сделано в целях безопасности. Но иногда нужно сохранить какие-то данные, сделать лог или бэкап конфига прямо внутри скрипта. Тут и приходит FilesJS. Он разблокирует работу с файлами, но с очень строгими ограничениями.

Что можно делать

С помощью FilesJS ты можешь выполнять типовые файловые операции:

• Чтение и запись - только в папке экземпляра Minecraft, наружу никак не выйти. Внешние файлы остаются недоступны.
• Удаление файлов - например, очистить временные логи или старые скрипты.
• Бэкап файлов - FilesJS может создавать резервные копии прямо внутри той же папки.

Вот как это выглядит в коде:

// Запись нескольких строк в файл
FilesJS.writeLines("kubejs/server_scripts/src/test.js", ["test1","test2","test3"])

// Удаление файла
FilesJS.delete("kubejs/server_scripts/src/test.js")

// Бэкап по событию клика правой кнопкой
ItemEvents.rightClicked('nether_star', event => {
    FilesJS.backupFile("kubejs/README.txt")
})

// Событие создания бэкапа
Files.fileBackupCreated(event => {
    event.server.tell("File backup path:", event.getPath())
})

Безопасность прежде всего

Разработчик явно подумал о рисках. FilesJS не даёт доступ к папке mods, а также блокирует работу с некоторыми расширениями файлов. По факту, это компромисс: ты получаешь удобство работы с файлами, не развязывая руки потенциально опасным скриптам.

Если ты пишешь скрипты для KubeJS и тебе не хватает функций для сохранения данных, FilesJS - хорошее решение. Главное не забывай, что все операции ограничены папкой экземпляра Minecraft, и наружу не вылезти. Скачай FilesJS и расширь свои скриптовые возможности без страха за систему.