diff --git a/README.md b/README.md index b23beea..43c9298 100644 --- a/README.md +++ b/README.md @@ -1 +1,52 @@ -# onecommand-hs +# OneCommand + +![capsule](https://capsule-render.vercel.app/api?type=waving&height=300&color=gradient&text=One%20Command) + +Simple Minecraft one command generator written in Haskell + +![overview](./docs/image0.png) + +## Installation + +### Prerequisites + +- Stack +- Cabal +- Glasgow Haskell Compiler + +### Installation Guide + +Run the following command. + +```bash +stack build +``` + +## Usage + +### MCF Format + +`.mcf` is a simple format to define minecraft command blocks. A single `.mcf` file corresponds to a single impulse/repeating command block, which is chained by multiple chain command blocks. The format is consisted with commands delimited by lines. The first line is chain type identifier, which can be one of `!IMPULSE` or `!REPEATING`. + +Example of MCF + +```plain +!IMPULSE +command1 +command2 +# comment +``` + +### Generating + +To generate the one command, put all `.mcf` files in a directory. And run the executable with path pointing at the directory. + +```bash +ocmd ~/my-commands +``` + +There's also a sample commands directory at `/sample-cmd` + +### Making Structure + +Put generated command into a impulse command block on a flat surface, in _always active_ mode. The command structure will appear immediately. diff --git a/docs/image0.png b/docs/image0.png new file mode 100644 index 0000000..9e7ac77 Binary files /dev/null and b/docs/image0.png differ diff --git a/test-cmd/say1.mcf b/sample-cmd/say1.mcf similarity index 100% rename from test-cmd/say1.mcf rename to sample-cmd/say1.mcf diff --git a/test-cmd/say2.mcf b/sample-cmd/say2.mcf similarity index 100% rename from test-cmd/say2.mcf rename to sample-cmd/say2.mcf diff --git a/test-cmd/say3.mcf b/sample-cmd/say3.mcf similarity index 100% rename from test-cmd/say3.mcf rename to sample-cmd/say3.mcf