More doc cleanup
This commit is contained in:
parent
4600b0956f
commit
9e9dcd47d9
6 changed files with 17 additions and 67 deletions
|
|
@ -1,17 +1,14 @@
|
||||||
# Arxcode installing help
|
# Arxcode installing help
|
||||||
|
|
||||||
## Introduction
|
|
||||||
|
|
||||||
[Arx - After the Reckoning](https://play.arxmush.org/) is a big and very popular
|
[Arx - After the Reckoning](https://play.arxmush.org/) is a big and very popular
|
||||||
[Evennia](https://www.evennia.com)-based game. Arx is heavily roleplaying-centric, relying on game
|
[Evennia](https://www.evennia.com)-based game. Arx is heavily roleplaying-centric, relying on game
|
||||||
masters to drive the story. Technically it's maybe best described as "a MUSH, but with more coded
|
masters to drive the story. Technically it's maybe best described as "a MUSH, but with more coded
|
||||||
systems". In August of 2018, the game's developer, Tehom, generously released the [source code of
|
systems". In August of 2018, the game's developer, Tehom, generously released the [source code of
|
||||||
Arx on github](https://github.com/Arx-Game/arxcode). This is a treasure-trove for developers wanting
|
Arx on github](https://github.com/Arx-Game/arxcode). This is a treasure-trove for developers wanting
|
||||||
to pick ideas or even get a starting game to build on. These instructions are based on the Arx-code
|
to pick ideas or even get a starting game to build on.
|
||||||
released as of *Aug 12, 2018*.
|
|
||||||
|
|
||||||
If you are not familiar with what Evennia is, you can read
|
> These instructions are based on the Arx-code released as of *Aug 12, 2018*. They will probably
|
||||||
[an introduction here](../Evennia-Introduction.md).
|
> not work 100% out of the box anymore. Report any differences and changes needed.
|
||||||
|
|
||||||
It's not too hard to run Arx from the sources (of course you'll start with an empty database) but
|
It's not too hard to run Arx from the sources (of course you'll start with an empty database) but
|
||||||
since part of Arx has grown organically, it doesn't follow standard Evennia paradigms everywhere.
|
since part of Arx has grown organically, it doesn't follow standard Evennia paradigms everywhere.
|
||||||
|
|
@ -5,7 +5,7 @@ This page describes how to install and run the Evennia server on an Android phon
|
||||||
installing a slew of third-party programs from the Google Play store, so make sure you are okay with
|
installing a slew of third-party programs from the Google Play store, so make sure you are okay with
|
||||||
this before starting.
|
this before starting.
|
||||||
|
|
||||||
```warning
|
```{warning}
|
||||||
Android installation is experimental and not tested with later versions of Android.
|
Android installation is experimental and not tested with later versions of Android.
|
||||||
Report your findings.
|
Report your findings.
|
||||||
```
|
```
|
||||||
|
|
|
||||||
|
|
@ -5,14 +5,9 @@ itself or have an easier time exploring the code. See the basic [Installation](.
|
||||||
a quick installation of the library. See the [troubleshooting](./Installation-Troubleshooting.md) if you run
|
a quick installation of the library. See the [troubleshooting](./Installation-Troubleshooting.md) if you run
|
||||||
into trouble.
|
into trouble.
|
||||||
|
|
||||||
- [Quick Start](#quick-start)
|
```{important}
|
||||||
- [Linux Install](#linux-install)
|
If you are converting an existing game from a previous version, [see here](./Installation-Upgrade.md).
|
||||||
- [Mac Install](#mac-install)
|
```
|
||||||
- [Windows Install](#windows-install)
|
|
||||||
- [Running in Docker](./Installation-Docker.md)
|
|
||||||
- [Where to Go Next](#where-to-go-next)
|
|
||||||
- [Troubleshooting](#troubleshooting)
|
|
||||||
- [Glossary of terms](../Glossary.md)
|
|
||||||
|
|
||||||
## Summary
|
## Summary
|
||||||
|
|
||||||
|
|
@ -30,22 +25,19 @@ more detailed instructions for your platform.
|
||||||
8. `cd mygame`
|
8. `cd mygame`
|
||||||
9. `evennia migrate`
|
9. `evennia migrate`
|
||||||
10. `evennia start` (make sure to make a superuser when asked)
|
10. `evennia start` (make sure to make a superuser when asked)
|
||||||
|
|
||||||
Evennia should now be running and you can connect to it by pointing a web browser to
|
Evennia should now be running and you can connect to it by pointing a web browser to
|
||||||
`http://localhost:4001` or a MUD telnet client to `localhost:4000` (use `127.0.0.1` if your OS does
|
`http://localhost:4001` or a MUD telnet client to `localhost:4000` (use `127.0.0.1` if your OS does
|
||||||
not recognize `localhost`).
|
not recognize `localhost`).
|
||||||
|
|
||||||
## Linux Install
|
## Linux Install
|
||||||
|
|
||||||
If you run into any issues during the installation and first start, please
|
|
||||||
check out [Linux Troubleshooting](#linux-troubleshooting).
|
|
||||||
|
|
||||||
For Debian-derived systems (like Ubuntu, Mint etc), start a terminal and
|
For Debian-derived systems (like Ubuntu, Mint etc), start a terminal and
|
||||||
install the [dependencies](#requirements):
|
install the requirements:
|
||||||
|
|
||||||
```
|
```
|
||||||
sudo apt-get update
|
sudo apt-get update
|
||||||
sudo apt-get install python3.10 python3.10-venv python3.10-dev gcc
|
sudo apt-get install python3.10 python3.10-venv python3.10-dev gcc
|
||||||
|
|
||||||
```
|
```
|
||||||
You should make sure to *not* be `root` after this step, running as `root` is a
|
You should make sure to *not* be `root` after this step, running as `root` is a
|
||||||
security risk. Now create a folder where you want to do all your Evennia
|
security risk. Now create a folder where you want to do all your Evennia
|
||||||
|
|
@ -107,8 +99,7 @@ Next you can continue initializing your game from the regular [Installation inst
|
||||||
The Evennia server is a terminal program. Open the terminal e.g. from
|
The Evennia server is a terminal program. Open the terminal e.g. from
|
||||||
*Applications->Utilities->Terminal*. [Here is an introduction to the Mac
|
*Applications->Utilities->Terminal*. [Here is an introduction to the Mac
|
||||||
terminal](https://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line)
|
terminal](https://blog.teamtreehouse.com/introduction-to-the-mac-os-x-command-line)
|
||||||
if you are unsure how it works. If you run into any issues during the
|
if you are unsure how it works.
|
||||||
installation, please check out [Mac Troubleshooting](#mac-troubleshooting).
|
|
||||||
|
|
||||||
* Python should already be installed but you must make sure it's a high enough version - go for
|
* Python should already be installed but you must make sure it's a high enough version - go for
|
||||||
3.10.
|
3.10.
|
||||||
|
|
@ -143,7 +134,6 @@ virtualenv is and why it's useful, see the [Glossary entry on virtualenv](../Glo
|
||||||
|
|
||||||
```
|
```
|
||||||
python3.10 -m venv evenv
|
python3.10 -m venv evenv
|
||||||
|
|
||||||
```
|
```
|
||||||
A new folder `evenv` will appear (we could have called it anything). This
|
A new folder `evenv` will appear (we could have called it anything). This
|
||||||
folder will hold a self-contained setup of Python packages without interfering
|
folder will hold a self-contained setup of Python packages without interfering
|
||||||
|
|
@ -232,7 +222,6 @@ virtualenv is and why it's useful, see the [Glossary entry on virtualenv](../Glo
|
||||||
|
|
||||||
```
|
```
|
||||||
python3.10 -m venv evenv
|
python3.10 -m venv evenv
|
||||||
|
|
||||||
```
|
```
|
||||||
A new folder `evenv` will appear (we could have called it anything). This
|
A new folder `evenv` will appear (we could have called it anything). This
|
||||||
folder will hold a self-contained setup of Python packages without interfering
|
folder will hold a self-contained setup of Python packages without interfering
|
||||||
|
|
@ -244,7 +233,6 @@ evenv\scripts\activate.bat
|
||||||
|
|
||||||
# If you are using a PS Shell, Git Bash, or other, you can use the following:
|
# If you are using a PS Shell, Git Bash, or other, you can use the following:
|
||||||
.\evenv\scripts\activate
|
.\evenv\scripts\activate
|
||||||
|
|
||||||
```
|
```
|
||||||
The text `(evenv)` should appear next to your prompt to show the virtual
|
The text `(evenv)` should appear next to your prompt to show the virtual
|
||||||
environment is active.
|
environment is active.
|
||||||
|
|
@ -264,39 +252,3 @@ pip install -e evennia
|
||||||
Test that you can run the `evennia` command everywhere while your virtualenv (evenv) is active.
|
Test that you can run the `evennia` command everywhere while your virtualenv (evenv) is active.
|
||||||
|
|
||||||
Next you can continue initializing your game from the regular [Installation instructions](./Installation.md).
|
Next you can continue initializing your game from the regular [Installation instructions](./Installation.md).
|
||||||
|
|
||||||
## Where to Go Next
|
|
||||||
|
|
||||||
Welcome to Evennia! Your new game is fully functioning, but empty. If you just
|
|
||||||
logged in, stand in the `Limbo` room and run
|
|
||||||
|
|
||||||
@batchcommand tutorial_world.build
|
|
||||||
|
|
||||||
to build [Evennia's tutorial world](../Howto/Starting/Part1/Tutorial-World.md) - it's a small solo quest to
|
|
||||||
explore. Only run the instructed `@batchcommand` once. You'll get a lot of text scrolling by as the
|
|
||||||
tutorial is built. Once done, the `tutorial` exit will have appeared out of Limbo - just write
|
|
||||||
`tutorial` to enter it.
|
|
||||||
|
|
||||||
Once you get back to `Limbo` from the tutorial (if you get stuck in the tutorial quest you can do
|
|
||||||
`@tel #2` to jump to Limbo), a good idea is to learn how to [start, stop and reload](Start-Stop-
|
|
||||||
Reload) the Evennia server. You may also want to familiarize yourself with some
|
|
||||||
[commonly used terms in our Glossary](../Glossary.md). After that, why not experiment with
|
|
||||||
[creating some new items and build some new rooms](../Howto/Starting/Part1/Building-Quickstart.md) out from Limbo.
|
|
||||||
|
|
||||||
From here on, you could move on to do one of our [introductory tutorials](../Howto/Howto-Overview.md) or simply dive
|
|
||||||
headlong into Evennia's comprehensive [manual](https://github.com/evennia/evennia/wiki). While
|
|
||||||
Evennia has no major game systems out of the box, we do supply a range of optional *contribs* that
|
|
||||||
you can use or borrow from. They range from dice rolling and alternative color schemes to barter and
|
|
||||||
combat systems. You can find the [growing list of contribs
|
|
||||||
here](https://github.com/evennia/evennia/blob/master/evennia/contrib/README.md).
|
|
||||||
|
|
||||||
If you have any questions, you can always ask in [the developer
|
|
||||||
chat](https://webchat.freenode.net/?channels=evennia&uio=MT1mYWxzZSY5PXRydWUmMTE9MTk1JjEyPXRydWUbb)
|
|
||||||
`#evennia` on `irc.freenode.net` or by posting to the [Evennia
|
|
||||||
forums](https://groups.google.com/forum/#%21forum/evennia). You can also join the [Discord
|
|
||||||
Server](https://discord.gg/NecFePw).
|
|
||||||
|
|
||||||
Finally, if you are itching to help out or support Evennia (awesome!) have an
|
|
||||||
issue to report or a feature to request, [see here](../Contributing.md).
|
|
||||||
|
|
||||||
Enjoy your stay!
|
|
||||||
|
|
@ -12,7 +12,7 @@ administrator or superuser.
|
||||||
```{warning}
|
```{warning}
|
||||||
pip install evennia is not yet available in develop branch. Use the [git installation](./Installation-Git.md).
|
pip install evennia is not yet available in develop branch. Use the [git installation](./Installation-Git.md).
|
||||||
```
|
```
|
||||||
```{warning}
|
```{important}
|
||||||
If you are converting an existing game from a previous version, [see here](./Installation-Upgrade.md).
|
If you are converting an existing game from a previous version, [see here](./Installation-Upgrade.md).
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -22,7 +22,7 @@ Once installed, make sure the `evennia` command works. Use `evennia -h` for usag
|
||||||
virtualenv, make sure it's active whenever you need to use the `evennia` command.
|
virtualenv, make sure it's active whenever you need to use the `evennia` command.
|
||||||
|
|
||||||
Alternatively, you can [install Evennia from github](./Installation-Git.md) or use [docker](./Installation-Docker.md).
|
Alternatively, you can [install Evennia from github](./Installation-Git.md) or use [docker](./Installation-Docker.md).
|
||||||
Check out [installation troubleshooting](./Installation-Troubleshootin.md) if you run into problems. Some
|
Check out [installation troubleshooting](./Installation-Troubleshooting.md) if you run into problems. Some
|
||||||
users have also experimented with [installing Evennia on Android](./Installation-Android.md).
|
users have also experimented with [installing Evennia on Android](./Installation-Android.md).
|
||||||
|
|
||||||
## Initialize a new game
|
## Initialize a new game
|
||||||
|
|
|
||||||
|
|
@ -504,8 +504,9 @@ COMMAND_DEFAULT_CLASS = "evennia.commands.default.muxcommand.MuxCommand"
|
||||||
# Command.arg_regex is a regular expression desribing how the arguments
|
# Command.arg_regex is a regular expression desribing how the arguments
|
||||||
# to the command must be structured for the command to match a given user
|
# to the command must be structured for the command to match a given user
|
||||||
# input. By default the command-name should end with a space or / (since the
|
# input. By default the command-name should end with a space or / (since the
|
||||||
# default commands uses MuxCommand and /switches).
|
# default commands uses MuxCommand and /switches). Note that the extra \n
|
||||||
COMMAND_DEFAULT_ARG_REGEX = r'^[ /]+.*$|$'
|
# is necessary for use with batchprocessor.
|
||||||
|
COMMAND_DEFAULT_ARG_REGEX = r'^[ /]|\n|$'
|
||||||
# By default, Command.msg will only send data to the Session calling
|
# By default, Command.msg will only send data to the Session calling
|
||||||
# the Command in the first place. If set, Command.msg will instead return
|
# the Command in the first place. If set, Command.msg will instead return
|
||||||
# data to all Sessions connected to the Account/Character associated with
|
# data to all Sessions connected to the Account/Character associated with
|
||||||
|
|
|
||||||
|
|
@ -12,7 +12,7 @@ This documentation covers how to setup and maintain the server, from first insta
|
||||||
|
|
||||||
## Installing custom game dirs
|
## Installing custom game dirs
|
||||||
|
|
||||||
- [Installing Arxcode](../Contribs/Arxcode-installing-help.md) - a custom gamedir based on the popular Evennia game [Arx](https://play.arxgame.org/)
|
- [Installing Arxcode](../Contribs/Arxcode-Installation.md) - a custom gamedir based on the popular Evennia game [Arx](https://play.arxgame.org/)
|
||||||
|
|
||||||
## Configuring
|
## Configuring
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue