Add XYZgrid contrib api files, prepare for merge

This commit is contained in:
Griatch 2021-07-23 00:19:28 +02:00
parent 38b1209259
commit 466f07eca4
21 changed files with 247 additions and 106 deletions

View file

@ -1,33 +1,33 @@
# Contrib modules
Contribs are found in [evennia/contrib/](api:evennia.contrib) and are optional game-specific code-snippets
or even full systems you can use for your game. They are contributed by the Evennia community and
released under the same license as Evennia itself. Each contrib has its own installation instructions.
Contribs are found in [evennia/contrib/](api:evennia.contrib) and are optional game-specific code-snippets
or even full systems you can use for your game. They are contributed by the Evennia community and
released under the same license as Evennia itself. Each contrib has its own installation instructions.
Bugs are reported to the Evennia [issue tracker](github:issue) as usual.
## Character-related
## Character-related
Contribs related to characters and character displays.
### CharGen
### CharGen
*Griatch 2011*
A simple Character creator for OOC mode. Meant as a starting point for a more fleshed-out system.
### Clothing
### Clothing
*FlutterSprite 2017*
A layered clothing system with slots for different types of garments auto-showing in description.
### Health Bar
### Health Bar
*Tim Ashley Jenkins 2017*
Tool to create colorful bars/meters.
### Multidescer
### Multidescer
*Griatch 2016*
@ -39,13 +39,22 @@ Advanced descriptions combined from many separate description components, inspir
Contribs modifying locations, movement or helping to creating rooms.
### Extended Room
### XYZGrid
*Griatch 2021*
Adds an XYZgrid to Evennia, with map-display and pathfinding. Created via map
strings and maintained outside of the game via Evennia launch commands.
- [XYZGrid documentation](./XYZGrid)
### Extended Room
*Griatch 2012*
An expanded Room typeclass with multiple descriptions for time and season as well as details.
### Map Builder
### Map Builder
*CloudKeeper 2016*
@ -53,19 +62,19 @@ Build a game area based on a 2D "graphical" unicode map. Supports asymmetric exi
- [Static in-game map](./Static-In-Game-Map)
### Simple Door
### Simple Door
*Griatch 2014*
Example of an exit that can be opened and closed from both sides.
### Slow exit
### Slow exit
*Griatch 2014*
Custom Exit class that takes different time to pass depending on if you are walking/running etc.
### Wilderness
### Wilderness
*titeuf87 2017*
@ -79,7 +88,7 @@ Make infinitely large wilderness areas with dynamically created locations.
Contribs supporting roleplay and in-game roleplaying actions.
### Barter system
### Barter system
*Griatch 2012*
@ -95,25 +104,25 @@ A full, extendable crafting system.
- [Crafting API documentation](api:evennia.contrib.crafting.crafting)
- [Example of a sword crafting tree](api:evennia.contrib.crafting.example_recipes)
### Dice
### Dice
*Griatch 2012*
A fully featured dice rolling system.
### Mail
### Mail
*grungies1138 2016*
An in-game mail system for communication.
### Puzzles
### Puzzles
*Hendher 2019*
Combine objects to create new items, adventure-game style
### RP System
### RP System
*Griatch 2015*
@ -125,7 +134,7 @@ Full director-style emoting system replacing names with sdescs/recogs. Supports
Dynamic obfuscation of emotes when speaking unfamiliar languages. Also obfuscates whispers.
### Turnbattle
### Turnbattle
*FlutterSprite 2017*
@ -142,7 +151,7 @@ and includes optional expansions for equipment and combat movement, magic and ra
An `@edit` command for modifying objects using a generated menu. Customizable for different games.
### Field Fill
### Field Fill
*FlutterSprite 2018*
@ -159,18 +168,18 @@ Allow Builders to add Python-scripted events to their objects (OBS-not for untru
### Menu-builder
A tool for building using an in-game menu instead of the normal build commands. Meant to
A tool for building using an in-game menu instead of the normal build commands. Meant to
be expanded for the needs of your game.
- [Building Menus](./Building-menus)
### Security/Auditing
### Security/Auditing
*Johhny 2018*
Log server input/output for debug/security.
### Tree Select
### Tree Select
*FlutterSprite 2017*
@ -183,13 +192,13 @@ multi-line string.
Contribs meant to be used as part of other code, or as replacements for default settings.
### Color-markups
### Color-markups
*Griatch, 2017*
Alternative in-game color markups.
### Custom gametime
### Custom gametime
*Griatch, vlgeoff 2017*
@ -203,19 +212,19 @@ Implements Evennia's gametime module but for custom game world-specific calendar
A variant of the standard login system that requires an email to login rather then just name+password.
#### Menu login
#### Menu login
*Griatch 2011, 2019, Vincent-lg 2016*
A login system using menus asking for name/password rather than giving them as one command.
### Random String Generator
### Random String Generator
*Vincent Le Goff 2017*
Simple pseudo-random generator of strings with rules, avoiding repetitions.
### UnixCommand
### UnixCommand
*Vincent Le Geoff 2017*
@ -227,19 +236,19 @@ Add commands with UNIX-style syntax.
Contribs not meant to be used as-is, but just as examples to learn from.
### GenderSub
### GenderSub
*Griatch 2015*
Simple example (only) of storing gender on a character and access it in an emote with a custom marker.
### Talking NPC
### Talking NPC
*Griatch 2011*
A talking NPC object that offers a menu-driven conversation tree.
### Tutorial examples
### Tutorial examples
*Griatch 2011, 2015*
@ -259,12 +268,12 @@ The Evennia single-player sole quest. Made to be analyzed to learn.
Full game-dir replacement systems.
### Ainneve
### Ainneve
*Evennia community 2015-?*
This is a community attempt to make an Evennia 'example game' using good practices. It is also a good
place to jump in if you want to help in another project rather than run it alone. Development of this
This is a community attempt to make an Evennia 'example game' using good practices. It is also a good
place to jump in if you want to help in another project rather than run it alone. Development of this
has stalled a bit so we are looking for enthusiastic people to lead the charge.
- [evennia/ainneve repository](https://github.com/evennia/ainneve)
@ -274,26 +283,26 @@ has stalled a bit so we are looking for enthusiastic people to lead the charge.
*Tehom 2019*
Open source code release of the popular Evennia-based [Arx, after the reckoning](https://play.arxgame.org/).
This is a fantasy game with a focus on roleplay and code-supported political intrigue. This code-release
Open source code release of the popular Evennia-based [Arx, after the reckoning](https://play.arxgame.org/).
This is a fantasy game with a focus on roleplay and code-supported political intrigue. This code-release
is maintained by Tehom in its own repository so bug reports should be directed there.
- [Arxcode repository on github](https://github.com/Arx-Game/arxcode)
- [Arxcode issue tracker](https://github.com/Arx-Game/arxcode/issues)
- [Arxcode installation help](./Arxcode-installing-help) - this may not always be fully up-to-date with
- [Arxcode installation help](./Arxcode-installing-help) - this may not always be fully up-to-date with
latest Evennia. Report your findings!
### Evscaperoom
### Evscaperoom
*Griatch 2019*
A full engine for making multiplayer 'escape-rooms' completely in code.
This is based on the 2019 MUD Game jam winner *Evscaperoom*.
A full engine for making multiplayer 'escape-rooms' completely in code.
This is based on the 2019 MUD Game jam winner *Evscaperoom*.
- [contrib/evscaperoom](api:evennia.contrib.evscaperoom) - game engine to make your own escape rooms.
- [https://demo.evennia.com](https://demo.evennia.com) - a full installation of the original game can
- [https://demo.evennia.com](https://demo.evennia.com) - a full installation of the original game can
be played by entering the *evscaperoom* exit in the first Limbo room.
- https://github.com/Griatch/evscaperoom - the original game's source code (warning for spoilers if you
- https://github.com/Griatch/evscaperoom - the original game's source code (warning for spoilers if you
want to solve the puzzles and mystery yourself).
@ -303,7 +312,7 @@ This is based on the 2019 MUD Game jam winner *Evscaperoom*.
:hidden:
./Crafting
../api/evennia.contrib.crafting.crafting
../api/evennia.contrib.crafting.crafting
../api/evennia.contrib.crafting.example_recipes
./A-voice-operated-elevator-using-events
./Dialogues-in-events