Update BUILD.md about docker

BUILD.md

@@ -0,0 +1,42 @@
+# How to build ISO file
+
+> [!IMPORTANT]  
+> Creating an ISO file requires to be Void Linux installed, if you dont want to install Void Linux, you should use [Docker](https://www.docker.com) (docker pull voidlinux/voidlinux).
+
+## Preparing minceraft
+
+At first, you need to prepare minceraft.
+
+Minceraft preparing consists of 5 steps:
+
+- Copying UltimMC configs to `data/mine` dir
+- Building and copying mods to MC instance
+- Compiling UltimMC from source (if you want to skip this step, you only need to copy built release of UltimMC to `ultimmc/build` directory)
+- Downloading assets and libraries (just launches instance in online mode)
+- Copying UltimMC configs again
+
+Use `mkmine` to do all this automatically:
+
+```bash
+./mkmine
+
+# IMPORTANT: if you get java selection window, choose Java 21
+```
+
+## Creating ISO file
+
+Use `mkiso` script to create ISO file. Result will be in the `output/` directory.
+
+Script compiles it only for x86_64, but I think it's not really hard to make it compile for any other architecture
+
+This script only work on Void Linux (because it needs XBPS).
+
+```bash
+sudo ./mkiso
+
+# idk why it needs sudo, please pr if you know how to remove it
+```
+
+## One-liner
+
+Finally, you can forget all above and use just `[ -d data/mine ] || ./mkmine; sudo ./mkiso`

HACKING.md

@@ -0,0 +1,46 @@
+# How to add extra mods
+
+Important: we use Fabric Loader by default, if you want to change it to another one, read [section below](https://github.com/MeexReay/minceraftOS/blob/main/HACKING.md#how-to-change-mc-version-or-loader).
+
+## Building mod from source
+
+If you want to build them from source, just add new directory with `build.sh` script to `mods/`
+
+Example of build.sh:
+```bash
+#!/bin/bash
+
+./gradlew build 
+# build jar file
+
+mv build/libs/*.jar ../build 
+# move jar file to mods/build/
+```
+
+## Add an already built mod
+
+To add any mod you want, just add this line to `mods/build-all.sh`
+
+If you have downloading link:
+```bash
+wget https://example.com/path/to/your-mod.jar
+```
+
+If your jar is in some dir:
+```bash
+cp /path/to/your-mod.jar .
+```
+
+# How to change MC version or loader
+
+To change version or loader of Minceraft, edit `mine-data/mmc-pack.json` file.
+You can generate it with MultiMC or PrismLauncher, and just copy.
+If you are changing the loader, you might also want to remove existing fabric mods, they are located in the `mods/` folders. 
+
+# How to change my nickname
+
+UltimMC's nickname is stored in `run_mine.sh` file. Just change it from Steve to your one.
+
+# Finally
+
+Finally, after all the changes, build the ISO by [this guide](https://github.com/MeexReay/minceraftOS/blob/main/BUILD.md)

LICENSE

@@ -0,0 +1,13 @@
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                   Version 2, December 2004
+ 
+Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed.
+ 
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. You just DO WHAT THE FUCK YOU WANT TO.

README.md

@@ -1,7 +1,8 @@
 # minceraftOS
 
 OS that uses Minceraft as a Desktop Environment. \
-Now it only starts minceraft and does nothing.
+Now it only starts minceraft and does nothing. \
+Based on [void-mklive](https://github.com/void-linux/void-mklive) repository
 
 ## Screenshots
 
@@ -17,11 +18,11 @@ Maybe one day there will be a terminal blocks that could run commands and start
 
 ## How to burn ISO to disk
 
-Precompiled images: [Latest release](https://github.com/MeexReay/minceraftOS/releases/tag/latest)
+Precompiled images: [Latest release](https://github.com/MeexReay/minceraftOS/releases/latest)
 
 To burn live-cd iso to disk use:
 
-```
+```bash
 sudo dd if=/path/to/minceraftOS.iso of=/dev/<disk_id> status=progress
 ```
 
@@ -29,45 +30,11 @@ To find out your `<disk_id>` (ex. sda), use `lsblk` or `fdisk -l`
 
 For now, there is no read-write mode, only live-cd
 
-## How to make ISO file
+## How to build ISO file
 
-### Preparing minceraft
+One-liner: `[ -d data/mine ] || ./mkmine; sudo ./mkiso` \
-
+Read more: [BUILD.md](https://github.com/MeexReay/minceraftOS/blob/main/BUILD.md) \
-At first, you need to prepare minceraft.
+Modification: [HACKING.md](https://github.com/MeexReay/minceraftOS/blob/main/HACKING.md)
-
-Minceraft preparing consists of 5 steps:
-
-- Copying UltimMC configs to `data/mine` dir
-- Building and copying mods to MC instance
-- Compiling UltimMC from source (if you want to skip this step, you only need to copy built release of UltimMC to `ultimmc/build` directory)
-- Downloading assets and libraries (just launches instance in online mode)
-- Copying UltimMC configs again
-
-Use `mkmine` to do all this automatically:
-
-```
-./mkmine
-
-# IMPORTANT: if you get java selection window, choose Java 21
-```
-
-### Creating ISO file
-
-Use `mkiso` script to create ISO file. Result will be in the `output/` directory.
-
-Script compiles it only for x86_64, but I think it's not really hard to make it compile for any other architecture
-
-This script only work on Void Linux (because it needs XBPS).
-
-```
-sudo ./mkiso
-
-# idk why it needs sudo, please pr if you know how to remove it
-```
-
-### One-liner
-
-Finally, you can forget all above and use just `[ -d data/mine ] || ./mkmine; sudo ./mkiso`
 
 ## Roadmap
 

mods/build-all.sh

@@ -13,4 +13,8 @@ for dir in */; do
     fi
 done
 
-curl -o build/fabric-api.jar https://cdn.modrinth.com/data/P7dR8mSH/versions/IXeiAH6H/fabric-api-0.118.5%2B1.21.4.jar
+cd build
+
+###   Add your extra mods here   ###
+
+wget https://cdn.modrinth.com/data/P7dR8mSH/versions/IXeiAH6H/fabric-api-0.118.5%2B1.21.4.jar

version

@@ -1 +1 @@
-0.1.1
+0.1.1