flora-search-aurora/README.md
Jaidyn Ann 262ba039b1 Bulk non-functional-change commit
Some minor edits that I’ve yet to shove into a
bigger commit. No functional changes, I promise!
Just shoving some stuff around, is all.
Seriously, this is a meaningless commit. Nothing
suspicious or worthy of scrutiny going on here!
Ha ha. Ha. <w<"
(Seriously though, nothing’s effectively chagned.)
2023-07-07 19:31:18 -05:00

38 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Flora Search Aurora
_Flora Search Aurora_ is a game about destiny-making, peace-making, and (most importantly) bouquet-making.
## Installation
You can run the game through a pre-built binary, available under Releases of this repository.
If youd rather (or have to) run the game from source, you can set up the game like so:
1. Install a Common Lisp implementation. Id recommend [Steel Bank Common Lisp](http://www.sbcl.org/), which is robust and available on many *nixes under the package-name `sbcl`.
2. Set up [Quicklisp](https://quicklisp.org/), which is a “package-manager” for Common Lisp libraries.
3. Clone this repo into your Quicklisp projects path.
4. Run or build the game with `make run` or `make build`.
To do so, you can run the following commands, replacing `guix` with your package-manager of choice:
```
$ guix install sbcl
$ wget https://beta.quicklisp.org/quicklisp.lisp
$ sbcl --load quicklisp.lisp \
--eval '(quicklisp-quickstart:install :path "~/.local/share/quicklisp/)' \
--eval '(ql:add-to-init-file)'
$ rm quicklisp.lisp
$ cd ~/.local/share/quicklisp/local-projects/
$ git clone https://notabug.org/jadedctrl/flora-search-aurora
$ cd flora-search-aurora/
$ make build
$ ./flora-search-aurora
```
For development, so that you can connect to the games REPL with (i.e.) [SLIME](https://slime.common-lisp.dev/), you might want to run the game like so:
`$ USE_SWANK=yes SWANK=… make run`
… where SWANK is the path to SLIMEs `swank-loader.lisp` file, probably at `~/.config/emacs/elpa/slime-*/swank-loader.lisp`.
The game has been tested with both [Embeddable Common Lisp](https://ecl.common-lisp.dev/) and SBCL. It runs perfectly on both, but building a binary isnt working on ECL at the moment.