Part 3: How We Get There (Example Game)

Warning

The tutorial game is under development and is not yet complete, nor tested. Use the existing lessons as inspiration and to help get you going, but don’t expect out-of-the-box perfection from it at this time.

Beginner Tutorial Parts

• Introduction
  Getting set up.

• Part 1: What We Have
  A tour of Evennia and how to use the tools, including an introduction to Python.

• Part 2: What We Want
  Planning our tutorial game and what to consider when planning your own.

• Part 3: How We Get There
  Getting down to the meat of extending Evennia to make your game.

• Part 4: Using What We Created
  Building a tech-demo and world content to go with our code.

• Part 5: Showing the World
  Taking our new game online and letting players try it out.

In part three of the Evennia Beginner tutorial we will go through the actual creation of our tutorial game EvAdventure, based on the Knave RPG ruleset.

If you followed the previous parts of this tutorial series you will have some notions about Python and where to find and make use of things in Evennia. We also have a good idea of the type of game we will create.

Even if this is not the game-style you are interested in, following along will give you a lot of experience using Evennia and be really helpful for doing your own thing later! The EvAdventure game code is also built to easily be expanded upon.

Fully coded examples of all code we make in this part can be found in the evennia/contrib/tutorials/evadventure package. There are three common ways to learn from this:

1. Follow the tutorial lessons in sequence and use it to write your own code, referring to the ready-made code as extra help, context, or as a ‘facit’ to check yourself.

2. Read through the code in the package and refer to the tutorial lesson for each part for more information on what you see.

3. Some mix of the two.

Which approach you choose is individual - we all learn in different ways.

Either way, this is a big part. You’ll be seeing a lot of code and there are plenty of lessons to go through. We are making a whole game from scratch after all. Take your time!

Lessons

• 1. Code Structure and Utilities
  • 1.1. Folder Structure
  • 1.2. Enums
  • 1.3. Utility Module
  • 1.4. Testing
  • 1.5. Summary
• 2. Rules and dice rolling
  • 2.1. Summary of Knave rules
  • 2.2. Making a rule module
  • 2.3. Rolling dice
  • 2.4. Testing
  • 2.5. Summary
• 3. Player Characters
  • 3.1. Inheritance structure
  • 3.2. Living mixin class
  • 3.3. Character class
  • 3.4. Connecting the Character with Evennia
  • 3.5. Unit Testing
  • 3.6. About races and classes
  • 3.7. Summary
• 4. In-game Objects and items
  • 4.1. New Enums
  • 4.2. The base object
  • 4.3. Other object types
  • 4.4. Consumables
  • 4.5. Weapons
  • 4.6. Magic
  • 4.7. Armor
  • 4.8. Your Bare hands
  • 4.9. Testing and Extra credits
• 5. Handling Equipment
  • 5.1. EquipmentHandler that saves
  • 5.2. Connecting the EquipmentHandler
  • 5.3. Expanding the Equipmenthandler
  • 5.4. .validate_slot_usage
  • 5.5. .add and .remove
  • 5.6. Moving things around
  • 5.7. Get everything
  • 5.8. Weapon and armor
  • 5.9. Extra credits
  • 5.10. Unit Testing
  • 5.11. Summary
• 6. Character Generation
  • 6.1. How it will work
  • 6.2. Random tables
  • 6.3. Storing state of the menu
  • 6.4. Initializing EvMenu
  • 6.5. Main Node: Choosing what to do
  • 6.6. Node: Changing your name
  • 6.7. Node: Swapping Abilities around
  • 6.8. Node: Creating the Character
  • 6.9. Tying the nodes together
  • 6.10. Conclusions
• 7. In-game Rooms
  • 7.1. The base room
  • 7.2. PvP room
  • 7.3. Adding a room map
  • 7.4. Adding life to a room
  • 7.5. Testing
  • 7.6. Conclusion
• 8. Non-Player-Characters
  • 8.1. The NPC base class
  • 8.2. Testing
  • 8.3. Conclusions
• 9. Combat base framework
  • 9.1. CombatHandler
  • 9.2. Actions
  • 9.3. Action dicts
  • 9.4. Action classes
  • 9.5. Testing
  • 9.6. Conclusions
• 10. Twitch Combat
  • 10.1. General principle
  • 10.2. Twitch combat handler
  • 10.3. Commands
  • 10.4. Grouping Commands for use
  • 10.5. Unit Testing
  • 10.6. A small combat test
  • 10.7. Conclusions
• 11. Turnbased Combat
  • 11.1. General Principle
  • 11.2. Turnbased combat handler
  • 11.3. Using EvMenu for the combat menu
  • 11.4. Menu for Turnbased combat
  • 11.5. Attack Command
  • 11.6. Making sure the menu stops
  • 11.7. Testing
  • 11.8. A small combat test
  • 11.9. Conclusions
• 12. NPC and monster AI
  • 12.1. Our requirements
  • 12.2. The AIHandler
  • 12.3. Adding AI to an entity
  • 12.4. Unit Testing
  • 12.5. Conclusions
• 13. Procedurally generated Dungeon
  • 13.1. Design Concept
  • 13.2. Start Implementation
  • 13.3. Basic Dungeon rooms
  • 13.4. Dungeon exits
  • 13.5. Dungeon Branch and the xy grid
  • 13.6. Back to the dungeon exit class
  • 13.7. Starting room exits
  • 13.8. Utility scripts
  • 13.9. Starting room
  • 13.10. Testing
  • 13.11. Conclusions
• 14. Game Quests
  • 14.1. The Quest Handler
  • 14.2. The Quest class
  • 14.3. Testing
  • 14.4. Conclusions
• 15. In-game Shops
• 16. In-game Commands