evennia/README.md

47 lines
3.7 KiB
Markdown
Raw Normal View History

2015-02-10 16:28:17 +01:00
# Evennia MUD/MU\* Creation System ![evennia logo][logo]
2015-03-16 15:52:17 +01:00
[![Build Status][travisimg]][travislink]
2015-02-10 16:31:49 +01:00
*Evennia* is a modern library for creating [online multiplayer text
games][wikimudpage] (MUD, MUSH, MUX, MUCK, MOO etc) in pure Python. It allows game
creators to design and flesh out their ideas with great freedom.
2015-02-10 16:28:17 +01:00
Evennia is made available under the very friendly [BSD license][license].
http://www.evennia.com is the main hub tracking all things Evennia.
## Features and Philosophy
The Evennia library aims for you to have a fully functioning, if empty, online game up and running in minutes. Rather than impose a particular style or genre of game we offer a framework on which you build the game of your dreams. There are easy ways to handl persistent objects, time-dependent scripting and all the other low-level features needed to create an online text-based game. The idea is to allow the mud-coder to concentrate on designing the bits that make their game unique.
Coding in Evennia is done by normal Python modules imported into the server at runtime. All code is heavily documented and you use Python classes to represent your objects, scripts and players. The database layer is abstracted away. This makes it possible to create the game using modern code practices using the full flexibility and power of Python.
2015-02-10 16:28:17 +01:00
![screenshot][screenshot]
Evennia offers extensive connectivity options. A single server instance may offer connections over Telnet, SSH and SSL. Evennia is also its own web server: A default website as well as a browser-based mud client (html5 websockets, with fallback to AJAX) is available from the the first start. Due to our Django and Twisted foundations, web integration is easy since the same code that powers the game is also used to run its web presence.
Whereas Evennia is intentionally empty of game content from the onset, we *do* offer some defaults you can build from. The code base comes with basic classes for objects, exits, rooms and characters. There is also a default command set for handling administration, building, chat channels, poses and so on. This is enough to run a 'Talker' or some other social-style game out of the box. You won't find any AI codes, mobs, skill systems, races or combat stats in the core library (we will gradually offer more optional plugins in the future though).
## Current Status
The codebase is currently in **Beta**. While development continues, Evennia is already stable enough to be suitable for prototyping and development of your own games.
2015-02-10 16:31:49 +01:00
2015-02-10 16:28:17 +01:00
## Where to go from here
If this piqued your interest, there is a [lengthier introduction][introduction] to read.
To learn how to get your hands on the code base, the [Getting started][gettingstarted] page is the way to go. Otherwise you could browse the [Documentation][wiki] or why not come join the [Evennia Community forum][group] or join us in our [development chat][chat]. Welcome!
2015-02-10 16:28:17 +01:00
[homepage]: http://www.evennia.com
2015-02-10 16:31:49 +01:00
[gettingstarted]: http://github.com/evennia/evennia/wiki/Getting-Started
2015-02-10 16:28:17 +01:00
[wiki]: https://github.com/evennia/evennia/wiki
2015-02-27 10:57:19 +01:00
[screenshot]: https://raw.githubusercontent.com/wiki/evennia/evennia/images/evennia_screenshot3.png
2015-03-16 15:52:17 +01:00
[logo]: https://github.com/evennia/evennia/blob/master/evennia/web/static/evennia_general/images/evennia_logo.png
[travisimg]: https://travis-ci.org/evennia/evennia.svg?branch=master
[travislink]: https://travis-ci.org/evennia/evennia
2015-02-10 16:28:17 +01:00
[introduction]: https://github.com/evennia/evennia/wiki/Evennia-Introduction
[license]: https://github.com/evennia/evennia/wiki/Licensing
[group]: https://groups.google.com/forum/#!forum/evennia
[chat]: http://webchat.freenode.net/?channels=evennia&uio=MT1mYWxzZSY5PXRydWUmMTE9MTk1JjEyPXRydWUbb
2015-02-10 16:31:49 +01:00
[wikimudpage]: http://en.wikipedia.org/wiki/MUD