Added TutorialWorld - a small, but complete single-player quest area showing off some of Evennia's features. You can find it in contrib/tutorial_world.

Build with: @batchcommand contrib.tutorial_world.build I have tested it, but there are most likely still bugs, so report all you find (along with possible suggestions for improvements) to the bugtracker/mailing list.
2011-06-26 22:41:14 +00:00 · 2011-06-26 22:41:14 +00:00 · b2b743b0aa
commit b2b743b0aa
parent 8770a263ac
7 changed files with 3133 additions and 0 deletions
--- a/contrib/tutorial_world/README
+++ b/contrib/tutorial_world/README
@ -0,0 +1,107 @@
+
+===============================================================
+ Evennia Tutorial World
+
+ Griatch 2011
+===============================================================
+
+This is a stand-alone tutorial area for an unmodified Evennia install.
+Think of it as a sort of single-player adventure rather than a
+full-fledged multi-player game world. The various rooms and objects
+herein are designed to show off features of the engine, not to be a
+very challenging (nor long) gaming experience. As such it's of course
+only skimming the surface of what is possible.
+
+================================================================
+ Install
+================================================================
+
+Log in as superuser (#1), then run
+
+ @batchcommand contrib.tutorial_world.build
+
+Wait for building to complete. This should build the world and 
+connect it to Limbo. 
+
+Log is as a non-superuser to play the game as intended. The
+tutorial area's systems mostly ignores the prescence of a 
+superuser (so use that to examine things "under the hood" later).
+
+================================================================
+ Comments
+================================================================
+
+The tutorial world is intended for you playing around with the
+engine. It will help you learn how to accomplish some more advanced
+effects and might give some good ideas along the way.
+
+It's suggested you play it through (as a normal user, NOT as
+Superuser!) and explore it a bit, then come back here and start
+looking into the (heavily documented) source code to find out how
+things tick - that's the "tutorial" in Tutorial world after all.
+
+Please report bugs in the tutorial to the Evennia issue tracker. 
+
+
+
+* Spoilers below - don't read on unless you already played the
+tutorial game. *
+
+
+
+
+
+===============================================================
+ Tutorial World Room map
+===============================================================
+
+     ?
+     |
+ +---+----+    +-------------------+    +--------+   +--------+
+ |        |    |                   |    |gate    |   |corner  |
+ | cliff  +----+      bridge       +----+        +---+        |
+ |        |    |                   |    |        |   |        |
+ +---+---\+    +---------------+---+    +---+----+   +---+----+
+     |    \                    |            |   castle   |
+     |     \  +--------+  +----+---+    +---+----+   +---+----+
+     |      \ |under-  |  |ledge   |    |along   |   |court-  |
+     |       \|ground  +--+        |    |wall    +---+yard    |
+     |        \        |  |        |    |        |   |        |
+     |        +------\-+  +--------+    +--------+   +---+----+
+     |                \                                  |
+    ++---------+       \  +--------+    +--------+   +---+----+
+    |intro     |        \ |cell    |    |trap    |   |temple  |
+ o--+          |         \|        +----+        |   |        |
+    |          |          \        |   /|        |   |        |
+    +----+-----+          +--------+  / ---+-+-+-+   +---+----+
+         |                           /     | | |         |
+    +----+-----+          +--------+/   +--+-+-+---------+----+
+    |outro     |          |tomb    |    |antechamber          |
+ o--+          +----------+        |    |                     |
+    |          |          |        |    |                     |
+    +----------+          +--------+    +---------------------+
+
+Notes: 
+
+o-- connections to/from Limbo
+intro/outro areas are rooms that automatically sets/cleans the 
+            Character of any settings incured upon it during the
+            tutorial game. 
+The Cliff is a good place to get an overview of the surroundings.
+The Bridge may seem like a big room, but it is really only one
+           room with custom move commands to make it take longer
+           to cross. You can also fall off the bridge if you
+           are unlucky or take your time to take in the view too
+           long.  
+In the Castle areas an aggressive mob is patrolling. It implements
+           rudimentary AI but packs quite a punch unless you have 
+           found yourself a weapon that can harm it. Combat is only 
+           possible once you find a weapon.
+The Catacombs feature a puzzle for finding the correct Grave 
+              chamber. 
+The Cell  is your reward if you fail in various ways. Finding a 
+          way out of it is a small puzzle of its own. 
+The Tomb  is a nice place to find a weapon that can hurt the 
+          castle guardian. This is infact the goal of the tutorial.
+          Explore on, or take the exit to finish the tutorial. 
+?  - look into the code if you cannot find this bonus area!