Skip to content

Commit

Permalink
add tutoral
Browse files Browse the repository at this point in the history
  • Loading branch information
radioegor146 committed Dec 19, 2023
1 parent 109bfce commit 4384e80
Show file tree
Hide file tree
Showing 25 changed files with 210 additions and 0 deletions.
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

A simple tool that allows you to pack your mod .jar file to .dll and inject it into running Minecraft

## Simple tutorial

[English](/for-dummies/FOR_DUMMIES_EN.md) | [На русском](/for-dummies/FOR_DUMMIES_EN.md)

## Usage

For building this I personally recommend using WSL on Windows or Linux
Expand Down
103 changes: 103 additions & 0 deletions for-dummies/FOR_DUMMIES_EN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
# Manual for dummies

This manual is for people who don't want to waste their time trying to install all stuff that is required

## Steps

### Register account on GitHub

Your account will be required to build all stuff that you'll need

### Create private repository

Create repository that will be required to run GitHub Actions on it

![create-repo-1](images/create-repo-1.png)

Specify the name of repository and mark it private, if you don't want to make your .jar and .dll public

![create-repo-2](images/create-repo-2.png)

### Import code from this repository

Click `Import` to import

![import-1](images/import-1.png)

Specify this repository URL, e.g. `https://github.com/radioegor146/jar-to-dll`

![import-2](images/import-2.png)

Wait for import to complete

![import-3](images/import-3.png)

After completion go to your repository

![import-4](images/import-4.png)

### Allow GitHub Actions

Navigate to `Settings` tab

![allow-gh-actions-1](images/allow-gh-actions-1.png)

Open `Actions` menu

![allow-gh-actions-2](images/allow-gh-actions-2.png)

Click on `General`

![allow-gh-actions-3](images/allow-gh-actions-3.png)

Allow all actions to be run

![allow-gh-actions-4](images/allow-gh-actions-4.png)

### Enable GitHub Actions

Navigate to `Actions` tab

![enable-gh-actions-1](images/enable-gh-actions-1.png)

Click `Enable Actions on this repository` to enable actions

![enable-gh-actions-2](images/enable-gh-actions-2.png)

### Upload your .jar file and build .dll

Navigate to `Code` tab

![upload-1](images/upload-1.png)

Open `Add file` menu

![upload-2](images/upload-2.png)

Click `Upload files` to upload your .jar file

![upload-3](images/upload-3.png)

Rename your .jar file on your computer to `input.jar` (IMPORTANT!) and drag-and-drop it here

![upload-4](images/upload-4.png)

Ensure that it is uploaded and click `Commit changes`

![upload-5](images/upload-5.png)

How that the file is uploaded, navigate to `Actions` tab

![upload-6](images/upload-6.png)

Here, click on the running workflow

![upload-7](images/upload-7.png)

Wait for action to complete

![upload-8](images/upload-8.png)

Refresh page and verify that there are no warnings. Now you can download you .dll file and use it as you want!

![upload-9](images/upload-9.png)
103 changes: 103 additions & 0 deletions for-dummies/FOR_DUMMIES_RU.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
# Туториал для неискушенных

Этот туториал предназначен в первую очередь для тех, кому лень разбираться с установкой всего, что нужно

## Шаги

### Зарегестрируйте свой аккаунт на GitHub

Ваша учетная запись потребуется для сборки всего, что вам будет нужно

### Создать приватный репозиторий

Создайте репозиторий, который потребуется для запуска GitHub Actions

![create-repo-1](images/create-repo-1.png)

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

![create-repo-2](images/create-repo-2.png)

### Импортируйте код из этого репозитория

Нажмите `Import` для импорта

![import-1](images/import-1.png)

Укажите URL этого репозитория, т.е. `https://github.com/radioegor146/jar-to-dll`

![import-2](images/import-2.png)

Дождитесь завершения импорта

![import-3](images/import-3.png)

После завершения перейдите в свой репозиторий

![import-4](images/import-4.png)

### Разрешите GitHub Actions

Переместитесь на вкладку `Settings`

![allow-gh-actions-1](images/allow-gh-actions-1.png)

Откройте меню `Actions`

![allow-gh-actions-2](images/allow-gh-actions-2.png)

Нажмите `General`

![allow-gh-actions-3](images/allow-gh-actions-3.png)

Установите `Allow all actions to be run`

![allow-gh-actions-4](images/allow-gh-actions-4.png)

### Enable GitHub Actions

Переместитесь на вкладку `Actions`

![enable-gh-actions-1](images/enable-gh-actions-1.png)

Нажмите `Enable Actions on this repository` что бы включить Actions

![enable-gh-actions-2](images/enable-gh-actions-2.png)

### Загрузите свой .jar-файл и запустите сборку .dll

Переместитесь на вкладку `Code`

![upload-1](images/upload-1.png)

Откройте меню `Add file`

![upload-2](images/upload-2.png)

Нажмите `Upload files` для загрузки вашего .jar-файла

![upload-3](images/upload-3.png)

Переименуйте свой .jar-файл на вашем компьютере в `input.jar` (ОЧЕНЬ ВАЖНО!) и перетащите его сюда

![upload-4](images/upload-4.png)

Убедитесь, что он загружен, и нажмите `Commit changes`

![upload-5](images/upload-5.png)

Как будет загружен файл, перейдите во вкладку `Actions`

![upload-6](images/upload-6.png)

Здесь нажмите на запущенный Action

![upload-7](images/upload-7.png)

Дождитесь его выполнения

![upload-8](images/upload-8.png)

Обновите страницу и убедитесь, что предупреждений нет. Теперь вы можете скачать свой .dll-файл и использовать его по своему усмотрению!

![upload-9](images/upload-9.png)
Binary file added for-dummies/images/allow-gh-actions-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/allow-gh-actions-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/allow-gh-actions-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/allow-gh-actions-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/create-repo-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/create-repo-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/enable-gh-actions-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/enable-gh-actions-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/import-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/import-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/import-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/import-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added for-dummies/images/upload-9.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed input.jar.test
Binary file not shown.

0 comments on commit 4384e80

Please sign in to comment.