71 lines
2.1 KiB
Markdown
71 lines
2.1 KiB
Markdown
# FOSS-VG (FOSS Voxel Generator)
|
||
|
||
This is a WIP Minecraft clone.
|
||
|
||
For now, we target feature parity with 1.18.2.
|
||
|
||
Immediate goals:
|
||
|
||
- Networking library
|
||
- [ ] build a dummy server that Minecraft clients can detect
|
||
- [ ] get Minecraft to connect to the dummy server
|
||
- Dummy server
|
||
- [ ] send an empty void
|
||
- [ ] send a surface to stand on
|
||
- [ ] handle chat
|
||
- NBT library
|
||
- [ ] parse NBT
|
||
- [ ] decode and encode data
|
||
|
||
|
||
## Project Setup Instructions
|
||
|
||
### Prerequisites:
|
||
|
||
This project requires bash and a C++20 compiler.
|
||
|
||
The project setup requires wget or curl, gzip, and tar.
|
||
|
||
**For people using other shells than bash:** You need to at least have bash
|
||
installed to use the scripts, but using it as your shell while working on
|
||
this project also allows you to use the provided aliases.
|
||
|
||
If you don’t want to use bash as your shell, not even temporarily for this
|
||
project, you can use the scripts by running them from the project's base
|
||
directory and run any generated executables with `LD_LIBRARY_PATH` set to
|
||
point to `bin/lib`.
|
||
|
||
|
||
### Setup
|
||
|
||
- `git clone` this repository
|
||
- if using bash:
|
||
- `source` the file `setupenv.bashrc` from the project's base directory
|
||
to load the provided shell environment
|
||
- `setup_project`
|
||
- if not using bash or not using the provided environment:
|
||
- `cd` to the project's base directory
|
||
- `scripts/setup_project.sh`
|
||
|
||
This will download the following dependenceis:
|
||
- [tiny-utf8](https://github.com/DuffsDevice/tiny-utf8)
|
||
|
||
### Building
|
||
|
||
To build the project, just use the `build` alias or invoke the `build.sh`
|
||
script from the project's base directory.
|
||
|
||
`build` and `build.sh` accept the environment variables `CXX`, `CXXFLAGS`, and `SINGLE`.
|
||
|
||
- `CXXFLAGS` must at least specify the C++ version.
|
||
- Set `SINGLE` to `yes` to run the build script in single-threaded mode.
|
||
|
||
To clean out the build or dependency directories, use `clean` and
|
||
`clean_dependencies` or their corresponding scripts respectively.
|
||
`setup_project` will clean out both before doing its thing.
|
||
|
||
|
||
## Copyright / License
|
||
|
||
See the file [`COPYING`](./COPYING) for copyright information.
|