Wooah, a new plugin! 
This one is a little less serious, though. 
Discourse Frotz
Itâs no longer necessary to @ mention the bot every step of the way. Once in play, just reply to it.
What is it
Itâs a âbotâ with which to play interactive fiction aka classic text adventure games on your Discourse forum and is essentially an adaptor to the standard and amazing Z-machine interpreter called âfrotzâ at David Griffith / frotz · GitLab
How to use it
The setup adds two games, you can add more in settings.
Each entry contains a Title and the name of the story file.
To kick off the interaction you need to @ mention the bot set in settings. After that, replying to a post of theirs is enough.
To list the available games, you first need to mention the bot and ask:
@mybot list games
This will give you the range of options
To start a game type:
start game x substituting x for the option number.
If you want to switch to another game you can do so; the plugin saves your progress on every move so you can return to the first story at any time. The plugin maintains a save for every story for every user that tries it.
To continue an existing game type:
continue game x substituting x for the option number.
NB A full rebuild will destroy all save files. This is a necessary compromise.
How do I play an IF game?
Many âMetaâsâ will have grown up with these things. For those less familiar, check out this cheatsheet: Play Some Interactive Fiction
Setup
Create the Bot User
(apologies, automating this is on my list!)
In an ssh session, enter your container and the rails console:
./launcher enter app
rails c
Then do this:
u = User.create!(username: "Frotz", name: "FrotzBot", id:-5, email: "not@really.valid")
u.activate
Your new bot will then be available to set up in the UI. Go to the userâs settings in the UI via the admin button and turn off all emailing. Update the avatar to taste.
Install Discourse Frotz
Update your app.yml
This is a little more invasive than a usual plugin.
add this to app.yml:
hooks:
after_code:
- exec:
cd: $home
cmd:
- git clone https://gitlab.com/DavidGriffith/frotz
- exec:
cd: $home/frotz
cmd:
- make dfrotz
- exec:
cd: $home/frotz
cmd:
- mkdir savegames
- exec:
cd: $home/frotz
cmd:
- mkdir stories
- exec:
cd: $home/frotz/stories
cmd:
- wget -O zork1.z3 https://eblong.com/infocom/gamefiles/zork1-r119-s880429.z3
- exec:
cd: $home/frotz/stories
cmd:
- wget --no-check-certificate http://www.douglasadams.com/creations/hhgg.z3
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/merefield/discourse-frotz
before your other plugin entries.
You now also need to add the Discourse BBCode plugin!!
Rebuild with the usual ./launcher rebuild app
Now go to the plugin settings and select the bot user you added earlier:
Stories
You will note Iâve included a couple of stories. You can find more at https://ifdb.tads.org/.
However, watch rate limits here! Getting too many stories from the same location may cause an error.
Also note that the stories are not sitting on https protected servers (tut tut).
If you insist on loading more add them to app.yml. You could also add them manually from the command prompt, but realise these will be wiped on the next full rebuild.
Enable FrotzBot for private messages (caution advised)
Allows users to play in private, but usage will be less transparent. If you have a big enough server this may not be an issue for you. In any case be aware of implications for capacity. As an alternative, encourage users to play in a designated Category.
default: OFF
If (s)he is not enabled there, the user will get a polite message:
Restrict FrotzBot by Category
You can restrict the bot to a (list of) Category to avoid filling up other areas:
Keyboard shortcuts!
This is really important to improve the âgamingâ experience. And you really only need to remember two:
-
Shift-R to reply to the bot
-
Ctrl-Enter to submit your next move
Limitations and considerations
Not all story formats and games are yet supported nor are likely to be supported. There are many games that donât work because of the nature of their call and response protocols. Because of the way we are interacting post by post we have to ask Frotz to save state after each move. If one step of the game doesnât lead to a prompt at which the system can can save (ignoring press any key or More prompts which should be handled), then the story wonât work. e.g. in Act of Murder (great game!) the lady at the door asks if you are a policeman. Unfortunately this is a state of the game thatâs unsaveable so fails this requirement and I canât see a way we would get that to work.
NB Mailing list mode is a disaster with this, so make sure this is not something you use before attempting to use this plugin!
It is arguably a bit wasteful of forum resources as it requires at least two posts for every âmoveâ. It is obviously often more appropriate to play these kind of games using a chat interface, rather than a forum, but you might argue this could be used to create Walkthroughs? 
For a less invasive solution, consider: Turning a topic into interactive fiction ;)
Feedback
All feedback is welcome!
Credits
This plugin exploits David Griffith / frotz · GitLab the Frotz Z-Interpreter which is cloned and âmadeâ by the setup script
Thanks to @P16 for allowing me to use excerpts of code from a closed source chatbot we worked on together.
)
, thatâs an adventure inside an adventureâŠ!
