townforge/README-binaries.md
2021-06-03 07:40:20 +00:00

70 lines
2.2 KiB
Markdown

# Townforge
Townforge is a blockchain based game based on the Monero source. Buy land, create buildings and research new technologies.
Copyright (c) 2019-2020 Crypto City
Copyright (c) 2014-2020 The Monero Project.
Portions Copyright (c) 2012-2013 The Cryptonote developers.
# TL;DR
Run this program:
```bash
townforge
```
This will run the game. You will have to wait for the game to sync with the network, which may take a while
on your first start, or if you've not played in a while.
- Web: [www.townforge.net](https://www.townforge.net)
- Git: [https://git.townforge.net/townforge/townforge](https://git.townforge.net/townforge/townforge)
- Forum: [forum.townforge.net](https://forum.townforge.net)
- IRC: [##townforge on Freenode](https://webchat.freenode.net/?randomnick=1&channels=%23%23townforge&prompt=1&uio=d4)
## License
See [LICENSE](LICENSE).
## Running Townforge
In order to run, both the node and the game need to run.
THe node (townforged) handles the blockchain and connection to the Townforge
network, while the game uses the node.
Normally, the game will run the node automatically, but you may wish to run it
manually if you have particular settings you want to use.
To run the node:
```bash
./townforged
```
To list all available options, run `./townforged --help`. Options can be
specified either on the command line or in a configuration file passed by the
`--config-file` argument. To specify an option in the configuration file, add
a line with the syntax `argumentname=value`, where `argumentname` is the name
of the argument without the leading dashes, for example `log-level=1`.
To run in background:
```bash
./townforged --log-file townforged.log --detach
```
To run as a systemd service, copy
[townforged.service](utils/systemd/townforged.service) to `/etc/systemd/system/` and
[townforged.conf](utils/conf/townforged.conf) to `/etc/`. The [example
service](utils/systemd/townforged.service) assumes that the user `townforge` exists
and its home is the data directory specified in the [example
config](utils/conf/townforged.conf).
If you're on Mac, you may need to add the `--max-concurrency 1` option to
townforge-wallet-cli, and possibly townforged, if you get crashes refreshing.
# running the game
```bash
./townforge
```