Как установить fabric api
User Tools
Site Tools
Table of Contents
Установка Fabric с помощью официального лаунчера Minecraft
ШАГ 1: Скачивание установщика Fabric
Перейдите на https://fabricmc.net/use/ и выберите пункт “Vanilla”, затем скачайте установщик для Windows (exe) или универсальный (jar).
Закройте лаунчер Minecraft.
В поле Select Install Location должен быть написан путь, где лаунчер Minecraft хранит свои данные и данные игры.
Как только процесс установки завершится, вы можете закрыть установщик.
НЕ ЗАПУСКАЙТЕ ИГРУ С ТОЛЬКО ЧТО СОЗДАННЫМ ПРОФИЛЕМ FABRIC!
ШАГ 2: Изменение директории игры, где находится профиль с Fabric
Создайте папку, которую только что установленный загрузчик будет использовать вместо игровой, например:
Нажмите на Настроить
Измените поле ПАПКА ИГРЫ на папку, которую вы только что создали, то есть, не
Нажмите на Сохранить
Теперь вы можете запускать игру вместе с Fabric.
ЗАМЕТКИ
Вы можете установить ПАПКУ ИГРЫ на любую, какую пожелаете, но мы рекомендуем вам использовать папку пользователя, например:
userprofile\minecraft-installations\fabric-1.14.2 для Minecraft 1.14.2
Где userprofile это путь к папке вашего пользователя в системе, в Windows это C:\Users\yourusername
ШАГ 3: Установка Fabric API
Профиль, который вы только что создали содержит загрузчик модов Fabric, теперь вам нужно установить Fabric API прежде, чем приступить к установке модов.
Перейдите на https://www.curseforge.com/minecraft/mc-mods/fabric-api/files/all и скачайте новейший файл, и поместите его в папку Minecraft, которую вы использовали в конфигурации MultiMC.
Обратите внимание, что Curse обычно не обновляет последние версии Minecraft, поэтому версия в таблице “Версия игры” может быть версией не игры, а файла! Сверьтесь с названием файла, чтобы уточнить, какую версию Minecraft он поддерживает.
Переместите скачанный файл в директорию игры, которую вы задали. Если вы не знаете, какую директорию игры вы задали, сверьтесь со ШАГОМ 2
ШАГ 4: Установка модов Fabric
Чтобы узнать, какие моды на данный момент установлнеы и изменить их настройки, вы можете установить мод Mod Menu (Fabric). Этот мод добавит новую кнопку в главное меню Minecraft:
Если вы нажмёте на эту кнопку, вы увидите список установленных модов. Их настройки вы можете изменить, если нажмёте на шестерёнку в правом верхнем углу:
Чтобы установить Mod Menu, перейдите на официальную страницу мода на CurseForge и нажмите на “файлы”, затем выберите желаемую версию Minecraft. Сохраните файл в директорию игры в папку “mods”.
Также имейте в виду, что некоторые моды требуют для своей работы другие. Когда вы скачиваете мод, нажмите на его название, прокрутите страницу до конца и посмотрите в раздел “Related Projects”, где написаны все зависимости. Если вы хотите использовать этот мод, будьте уверены в том, что вы установили все требуемые ему зависимости.
Как установить Fabric в TLauncher / Майнкрафт
Fabric является загрузчиком модов для Minecraft, альтернатива или аналог Forge. На Фабрик сделано уже достаточно много модов, поддерживает множество версий Minecraft. В данном гайде узнаете, как скачать и установить в ТЛаунчер версию с Fabric.
0) Проверяем, что у вас последняя версия нашего лаунчера. Скачать актуальной версии TLauncher можно с главной страницы.
Автоматическая установка через TLauncher
В нашем лаунчере началось внедрение автоматической установки Fabric, как и с другими версиями в главном списке, они устанавливаются в один клик.
Условия: Ваш TLauncher выше версии 2.7.
Ручная установка Fabric
Вы по прежнему сможете установить любую версию Fabric вручную в TLauncher, следуйте инструкции ниже и у вас всё получится.
Где скачать Fabric
1) Самым правильный вариантом, будет скачивание с официального сайта: fabricmc.net. Мы не гарантируем, что скаченное с других сайтов запустится через наш лаунчер!
2) На представленном сайте выбираем вкладку «Vanilla» (ТОЛЬКО ЕГО!), версию можно оставлять первую (это не версия игры, а установщика, выбор версии игры будет дальше!). Скачиваем под Windows или универсальный Jar:
Установка Fabric
3) Запускаем скаченный вами Установщик (Installer) Fabric, и из списка «Minecraft Version» выбираем нужную версию игры.
4) Больше нечего можно не выбирать, только если нужно, включить галочку снапшоты! Нечего более не меняя, кликаем на «Install». Готово!
5) Закрываем установщик и открываем TLauncher, в списке версий теперь ищем новую версию «fabric-loader-XXX+XXX«. Можем запускать.
Где найти моды на Fabric
Моды на Fabric устанавливаются абсолютно так же, как и у forge, в папку mods. При такой ручной установке вам необходимо обязательно на скачиваемом сайте найти, что мод именно на Fabric. На нашем сайте есть моды Майнкрафт на Фабрик, в блоке с инструкцией установки сможете найти информации о принадлежности к Fabric или Forge:
Как установить fabric api
Essential hooks for modding with Fabric.
Fabric API is the library for essential hooks and interoperability mechanisms for Fabric mods. Examples include:
Also check out Fabric Loader, the (mostly) version-independent mod loader that powers Fabric. Fabric API is a mod like any other Fabric mod which requires Fabric Loader to be installed.
For support and discussion for both developers and users, visit the Fabric Discord server.
Using Fabric API to play with mods
Make sure you have install fabric loader first. More information about installing Fabric Loader can be found here.
To use Fabric API, download it from CurseForge, GitHub Releases or Modrinth.
The downloaded jar file should be placed in your mods folder.
Using Fabric API to develop mods
To setup a Fabric development environment, check out the Fabric example mod and follow the instructions there. The example mod already depends on Fabric API.
To include the full Fabric API with all modules in the development environment, add the following to your dependencies block in the gradle buildscript:
Alternatively, modules from Fabric API can be specified individually as shown below (including module jar to your mod jar):
Instead of hardcoding version constants all over the build script, Gradle properties may be used to replace these constants. Properties are defined in the gradle.properties file at the root of a project. More information is available here.
See something Fabric API doesn’t support, a bug or something that may be useful? We welcome contributions to improve Fabric API.
* The contributing guidelines are work in progress
Fabric API is designed to be modular for ease of updating. This also has the advantage of splitting up the codebase into smaller chunks.
Each module contains its own README.md * explaining the module’s purpose and additional info on using the module.
* The README for each module is being worked on; not every module has a README at the moment
jenyay.net
Софт, исходники и фото
Основы использования Fabric
Оглавление
Введение
Как известно, то, что обычный пользователь делает мышкой, повторяя одни и те же действия по 10 раз, программисты и, особенно, админы, делают скриптами. Инструментов и языков для написания скриптов существует огромное количество. Некоторые из них предназначены для определенных задач, например, на сборку и компиляцию программ, как Makefile и его последователи, другие являются более низкоуровневыми, например тот же bash. Промежуточное место я бы отвел для таких скриптовых языков как Python, Perl, Ruby. Преимущество последних в первую очередь в читаемости кода, когда нужно писать что-то большое, но в то же время, например, для работы с файлами, при работе с этими языками приходится писать больше кода, чем на том же bash.
Если мельком взглянуть на документацию Fabric, то складывается впечатление, что эта библиотека предназначена в первую очередь для работы на удаленном сервере при подключении к нему через SSH, однако, ее можно использовать и для локальных задач.
Лично я на данный момент Fabric использую для трех типов задач:
Разбираться с Fabric мы начнем с самого начала, т.е. с установки.
Установка
Установка под Linux не должна вызывать никаких затруднений. Достаточно написать в консоли
кому что больше нравится. И Fabric будет установлен вместе с необходимыми зависимостями.
А вот под Windows с установкой зависимостей могут возникнуть затруднения. Fabric использует библиотеку шифрования PyCrypto, которая, как правило, распространяется в исходных кодах и компилируется на месте при установке. Компиляция ее под Linux проблем не возникает, потому что редкая Linux-система (особенно система админа или программиста) не имеет компилятора C/C++.
Чтобы убедиться, что Fabric установлен, наберем в консоли команду
Если вы получите сообщение вида:
Fatal error: Couldn’t find any fabfiles!
Aborting.
Couldn’t find any fabfiles!
То значит, что все нормально и можно двигаться дальше.
Если вы пользуетесь Windows и вы получите сообщение о том, что команда fab не найдена, то убедитесь, что у вас добавлен путь до папки C:\Python27\Scripts\ или ее аналога для той версии Python, который вы используете, в переменную окружения PATH. В крайнем случае, вы всегда можете писать команду в виде
но просто fab писать удобнее.
Использование Fabric
Использование Fabric во многом напоминает использование Makefile, т.е. вы создаете в какой-то папке файл fabfile.py, в котором описываете задачи (как они описываются, мы рассмотрим чуть позже). Например, там может быть задача backup (для создания резервной копии) или deploy (для развертывания сайта) и т.д.
Затем в консоли вы запускаете команду
И Fabric выполняет нужные задачи. Можно указать несколько задач, тогда они будут выполнены последовательно, например, сначала создать резервную копию, а потом развернуть приложение:
В задачи можно передавать параметры. Параметры передаются после символа «:» после имени задачи. Пусть, например, мы можем указать путь до папки, куда делать резервную копию:
Если в параметрах нет пробелов, то кавычки можно не писать. Если параметров несколько, то они перечисляются через запятую. Но про передачу параметров мы еще поговорим.
Файл fabfile.py
Структура файла
Библиотека Fabric замечательна тем, что для ее использования не нужно разбираться с новым языком описания задач или каким-то новым синтаксисом, все задачи описываются на языке Python, возможно, с использованием вспомогательных средств Fabric. Так, например, для создания двух задач, которые были приведены выше в качестве примера, достаточно создать файл с именем fabfile.py (имя важно, хотя при желании его можно изменить, о чем будет сказано ниже) со следующим содержимым:
def backup ( ) :
print u ‘Run backup. ‘
print u ‘Ok’
def deploy ( ) :
print u ‘Run deploy. ‘
print u ‘Ok’
Кроме того, в файле профиля пользователя можно создать файл .fabricrc (под Linux путь будет выглядеть как
/.fabricrc), в котором задаются различные настройки по умолчанию. Если в этот файл добавить строку
то по умолчанию Fabric будет искать не файл fabfile.py, а файл my_fabfile.py.
Документирование задач
В таком виде подсказка уже полезна, но лучше все-таки еще добавить комментарии к каждой задаче. Чтобы их добавить, достаточно для каждой функции добавить описание в виде docstring:
def backup ( ) :
«»»
Создание резервной копии
«»»
print u ‘Run backup. ‘
print u ‘Ok’
def deploy ( ) :
«»»
Развертывание сайта mycoolsite.com
«»»
print u ‘Run deploy. ‘
print u ‘Ok’
В этом случае параметр —list выведет список задач следующим образом:
backup Создание резервной копии
deploy Развертывание сайта mycoolsite.com
На самом деле лучше не использовать в описаниях русские символы, поскольку в консоли под Windows они превратятся в кракозяблы (под Linux все будет работать нормально). Кроме того, не стоит писать очень длинные описания, поскольку они будут обрезаны до чуть больше чем 70 символов.
Понятно, что одни задачи могут вызывать другие задачи, кроме того внутри fabfile.py могут быть функции для внутреннего использования, попадание которых в список задач, выводимых с помощью параметра —list, нежелательно. Такие «внутренние» функции должны начинаться с символа «_». Так, например, функция _internal() из следующего прмиера fabfile.py не будет видна как задача:
def backup ( ) :
«»»
Создание резервной копии
«»»
print u ‘Run backup. ‘
print u ‘Ok’
def deploy ( ) :
«»»
Развертывание сайта mycoolsite.com
«»»
print u ‘Run deploy. ‘
print u ‘Ok’
def _internal ( ) :
pass
backup Создание резервной копии
deploy Развертывание сайта mycoolsite.com
Передача параметров
Выше мы уже говорили о том, что в задачи для Fabric мы можем передавать параметры, приведем несколько примеров. Для демонстрации мы будем использовать простую функцию, которая просто выводит переданный параметр:
def task ( param ) :
print param
Если мы забудем передать параметр, то вызов команды fab task приведет к ошибке:
Traceback (most recent call last):
File «/usr/local/lib/python2.7/dist-packages/Fabric-1.10.1-py2.7.egg/fabric/main.py», line 743, in main
*args, **kwargs
File «/usr/local/lib/python2.7/dist-packages/Fabric-1.10.1-py2.7.egg/fabric/tasks.py», line 424, in execute
results[‘ ‘] = task.run(*args, **new_kwargs)
File «/usr/local/lib/python2.7/dist-packages/Fabric-1.10.1-py2.7.egg/fabric/tasks.py», line 174, in run
return self.wrapped(*args, **kwargs)
TypeError: task() takes exactly 1 argument (0 given)
Если мы укажем значение параметра, то все будет работать, как положено:
$ fab task:»Hello world!»
Аналогичного результата мы добьемся, если будем указывать имя параметра:
$ fab task:param=»Hello world!»
Как и везде в языке Python, можно использовать значения параметров по умолчанию:
def task ( param = False ) :
print param
В этом случае значение параметра можно не передавать:
Если же задача функция принимает два и более значений, то параметры передаются через запятую. Например:
Главное тут не ошибиться и не добавить после запятой пробел, иначе второй параметр будет воспринят, как имя другой команды:
$ fab task:»Hello», «World»
Warning: Command(s) not found:
World
Как видно из предыдущей ошибки, Fabric позволяет одной командой запускать сразу несколько задач, которые будут выполняться последовательно.
def task1 ( ) :
print «Task 1»
def task2 ( ) :
print «Task 2»
Но если одна из них завершится с ошибкой, то следующая задача выполнена не будет.
def task1 ( ) :
raise Exception
def task2 ( ) :
print «Task 2»
Task 1
Traceback (most recent call last):
File «/usr/local/lib/python2.7/dist-packages/Fabric-1.10.1-py2.7.egg/fabric/main.py», line 743, in main
*args, **kwargs
File «/usr/local/lib/python2.7/dist-packages/Fabric-1.10.1-py2.7.egg/fabric/tasks.py», line 424, in execute
results[‘ ‘] = task.run(*args, **new_kwargs)
File «/usr/local/lib/python2.7/dist-packages/Fabric-1.10.1-py2.7.egg/fabric/tasks.py», line 174, in run
return self.wrapped(*args, **kwargs)
File «/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/03/fabfile.py», line 5, in task1
raise Exception
Exception
Теперь, когда мы рассмотрели способы запуска задач, перейдем к рассмотрению того, какие возможности нам предоставляет библиотека Fabric и ее модули. Внутри функций-задач мы можем использовать любые функции Python, в том числе и для копирования, удаления, переименования файлов и т.д. Также в Python есть средства для запуска программ. Но давайте посмотрим, какие функции нам предоставляет Fabric для облегчения работы на локальной компьютере и на удаленном сервере.
Использование Fabric на локальном компьютере
Знакомство с Fabric у меня началось с того, что я начал использовать эту библиотеку в качестве замены команды make и Makefile. Когда-то давно для сборки OutWiker использовался обычный Makefile. Например, команда make win собирала версию под Windows, а команда make deb делала deb-пакет под Linux’ы на основе Debian.
В результате Makefile по-прежнему используется, но только как часть сборки deb-пакетов под Linux, в остальном везде используется Fabric.
Рассмотрим пример, в котором будут выводиться рабочие директории с помощью функции стандартной библиотеки os.getpwd() и с помощью команды pwd консоли (для выполнения команды pwd будет использоваться вышеупомянутая функция local:
Результат в моем случае выглядит так (понятно, что у вас директории будут называться иначе):
jenyay@jenyay-desktop:/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/04$ fab task
**** Before ‘with’ operator
/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/04
[localhost] local: pwd
/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/04
**** Inside ‘with’ operator
/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/04
[localhost] local: pwd
/home/jenyay
**** After ‘with’ operator
/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/04
[localhost] local: pwd
/media/Data/Workdir/Черновики/В процессе/Fabric/__attach/examples/04
Разумеется, внутри функции local можно выполнять что-то более полезное. Например, в fabfile проекта OutWiker в задаче win, с помощью которой создается сборка OutWiker под Windows, можно найти такие строки:
На момент написания этих строк fabfile проекта OutWiker из модуля fabric.api используются только функции lcd и local.
Использование Fabric для взаимодействия с удаленным сервером
Настройка удаленного интерпретатора
Fabric удобно использовать на локальном компьютере, но больше всего возможностей эта библиотека предоставляет для работы по сети на удаленных серверах. Все возможности библиотеки в этой статье мы не рассмотрим, но, чтобы понять принцип работы, поговорим о некоторых из них.
Для работы на удаленном сервере существуют аналоги локальных функций lcd и local, это функции cd и run соответственно. Чтобы научиться подключаться к серверу, сделаем fabfile с одной задачей, которая просто выполняет команду ls на сервере, чтобы вывести список файлов в домашней директории.
В простейшем случае скрипт будет такой, но нужно заранее предупредить, что он может не сработать:
from fabric. api import run
def runls ( ) :
run ( «ls» )
Как видите, в скрипте мы не задаем никакого адреса (хотя мы может это сделать, и воспользуемся этой возможностью позже). Если мы теперь выполним команду fab runls, то Fabric сначала попросит ввести адрес, куда мы должны подключиться, а затем результат уже будет зависеть от настроек удаленного сервера. Далее приведен вывод команды fab runls при подключении к удаленному хранилищу по локальной сети:
No hosts found. Please specify (single) host string for connection: 192.168.100.10
[192.168.100.10] run: ls
[192.168.100.10] Passphrase for private key:
[192.168.100.10] out: Distrib VirtualBox VMs music projects Кино Фото
[192.168.100.10] out: Downloads backup photo temp Книги
[192.168.100.10] out:
Done.
Disconnecting from 192.168.100.10. done.
Но вполне может случиться и такая ошибка:
No hosts found. Please specify (single) host string for connection: 192.168.100.10
[192.168.100.10] run: ls
[192.168.100.10] Passphrase for private key:
[192.168.100.10] Login password for ‘jenyay’:
[192.168.100.10] out: sh: /bin/bash: not found
[192.168.100.10] out:
Fatal error: run() received nonzero return code 127 while executing!
Aborting.
Disconnecting from 192.168.100.10. done.
run() received nonzero return code 127 while executing!
Указать путь до интерпретатора можно разными способами. Во-первых, можно воспользоваться параметром командной строки —shell:
No hosts found. Please specify (single) host string for connection: 192.168.100.10
[192.168.100.10] run: ls
[192.168.100.10] Passphrase for private key:
[192.168.100.10] out: Distrib VirtualBox VMs music projects Кино Фото
[192.168.100.10] out: Downloads backup photo temp Книги
[192.168.100.10] out:
Done.
Disconnecting from 192.168.100.10. done.
Поскольку на данном сервере не установлен интерпретатор bash, я воспользовался интерпретатором sh.