# Connect Evennia channels to Grapevine¶

Grapevine is a new chat network for MU**** games. By connecting an in-game channel to the grapevine network, players on your game can chat with players in other games, also non-Evennia ones.

## Configuring Grapevine¶

To use Grapevine, you first need the pyopenssl module. Install it into your Evennia python environment with

pip install pyopenssl


To configure Grapevine, you’ll need to activate it in your settings file.

    GRAPEVINE_ENABLED = True


Next, register an account at https://grapevine.haus. When you have logged in, go to your Settings/Profile and to the Games sub menu. Here you register your new game by filling in its information. At the end of registration you are going to get a Client ID and a Client Secret. These should not be shared.

Open/create the file mygame/server/conf/secret_settings.py and add the following:

  GRAPEVINE_CLIENT_ID = "<client ID>"
GRAPEVINE_CLIENT_SECRET = "<client_secret>"


You can also customize the Grapevine channels you are allowed to connect to. This is added to the GRAPEVINE_CHANNELS setting. You can see which channels are available by going to the Grapevine online chat here: https://grapevine.haus/chat.

Start/reload Evennia and log in as a privileged user. You should now have a new command available: @grapevine2chan. This command is called like this:

 @grapevine2chan[/switches] <evennia_channel> = <grapevine_channel>


Here, the evennia_channel must be the name of an existing Evennia channel and grapevine_channel one of the supported channels in GRAPEVINE_CHANNELS.

At the time of writing, the Grapevine network only has two channels: testing and gossip. Evennia defaults to allowing connecting to both. Use testing for trying your connection.

## Setting up Grapevine, step by step¶

You can connect Grapevine to any Evennia channel (so you could connect it to the default public channel if you like), but for testing, let’s set up a new channel gw.

 @ccreate gw = This is connected to an gw channel!


You will automatically join the new channel.

Next we will create a connection to the Grapevine network.

 @grapevine2chan gw = gossip


Evennia will now create a new connection and connect it to Grapevine. Connect to https://grapevine.haus/chat to check.

Write something in the Evennia channel gw and check so a message appears in the Grapevine chat. Write a reply in the chat and the grapevine bot should echo it to your channel in-game.

Your Evennia gamers can now chat with users on external Grapevine channels!