mirror of
https://github.com/MeexReay/minceraftOS.git
synced 2025-06-25 11:02:59 +03:00
Compare commits
No commits in common. "main" and "0.1.1" have entirely different histories.
42
BUILD.md
42
BUILD.md
@ -1,42 +0,0 @@
|
|||||||
# 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`
|
|
46
HACKING.md
46
HACKING.md
@ -1,46 +0,0 @@
|
|||||||
# 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)
|
|
13
LICENSE
13
LICENSE
@ -1,13 +0,0 @@
|
|||||||
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.
|
|
49
README.md
49
README.md
@ -1,8 +1,7 @@
|
|||||||
# minceraftOS
|
# minceraftOS
|
||||||
|
|
||||||
OS that uses Minceraft as a Desktop Environment. \
|
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
|
## Screenshots
|
||||||
|
|
||||||
@ -18,11 +17,11 @@ Maybe one day there will be a terminal blocks that could run commands and start
|
|||||||
|
|
||||||
## How to burn ISO to disk
|
## How to burn ISO to disk
|
||||||
|
|
||||||
Precompiled images: [Latest release](https://github.com/MeexReay/minceraftOS/releases/latest)
|
Precompiled images: [Latest release](https://github.com/MeexReay/minceraftOS/releases/tag/latest)
|
||||||
|
|
||||||
To burn live-cd iso to disk use:
|
To burn live-cd iso to disk use:
|
||||||
|
|
||||||
```bash
|
```
|
||||||
sudo dd if=/path/to/minceraftOS.iso of=/dev/<disk_id> status=progress
|
sudo dd if=/path/to/minceraftOS.iso of=/dev/<disk_id> status=progress
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -30,11 +29,45 @@ To find out your `<disk_id>` (ex. sda), use `lsblk` or `fdisk -l`
|
|||||||
|
|
||||||
For now, there is no read-write mode, only live-cd
|
For now, there is no read-write mode, only live-cd
|
||||||
|
|
||||||
## How to build ISO file
|
## How to make ISO file
|
||||||
|
|
||||||
One-liner: `[ -d data/mine ] || ./mkmine; sudo ./mkiso` \
|
### Preparing minceraft
|
||||||
Read more: [BUILD.md](https://github.com/MeexReay/minceraftOS/blob/main/BUILD.md) \
|
|
||||||
Modification: [HACKING.md](https://github.com/MeexReay/minceraftOS/blob/main/HACKING.md)
|
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:
|
||||||
|
|
||||||
|
```
|
||||||
|
./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
|
## Roadmap
|
||||||
|
|
||||||
|
@ -13,8 +13,4 @@ for dir in */; do
|
|||||||
fi
|
fi
|
||||||
done
|
done
|
||||||
|
|
||||||
cd build
|
curl -o build/fabric-api.jar https://cdn.modrinth.com/data/P7dR8mSH/versions/IXeiAH6H/fabric-api-0.118.5%2B1.21.4.jar
|
||||||
|
|
||||||
### Add your extra mods here ###
|
|
||||||
|
|
||||||
wget https://cdn.modrinth.com/data/P7dR8mSH/versions/IXeiAH6H/fabric-api-0.118.5%2B1.21.4.jar
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user