<h1>Grapevine<aclass="headerlink"href="#grapevine"title="Permalink to this headline">¶</a></h1>
<p><aclass="reference external"href="https://grapevine.haus">Grapevine</a> is a new chat network for <codeclass="docutils literal notranslate"><spanclass="pre">MU*</span></code>*** 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.</p>
<sectionid="configuring-grapevine">
<h2>Configuring Grapevine<aclass="headerlink"href="#configuring-grapevine"title="Permalink to this headline">¶</a></h2>
<p>To use Grapevine, you first need the <codeclass="docutils literal notranslate"><spanclass="pre">pyopenssl</span></code> module. Install it into your
<p>Next, register an account at <aclass="reference external"href="https://grapevine.haus">https://grapevine.haus</a>. When you have logged in,
go to your Settings/Profile and to the <codeclass="docutils literal notranslate"><spanclass="pre">Games</span></code> sub menu. Here you register your
new game by filling in its information. At the end of registration you are going
to get a <codeclass="docutils literal notranslate"><spanclass="pre">Client</span><spanclass="pre">ID</span></code> and a <codeclass="docutils literal notranslate"><spanclass="pre">Client</span><spanclass="pre">Secret</span></code>. These should not be shared.</p>
<p>Open/create the file <codeclass="docutils literal notranslate"><spanclass="pre">mygame/server/conf/secret_settings.py</span></code> and add the following:</p>
<p>You can also customize the Grapevine channels you are allowed to connect to. This
is added to the <codeclass="docutils literal notranslate"><spanclass="pre">GRAPEVINE_CHANNELS</span></code> setting. You can see which channels are available
by going to the Grapevine online chat here: <aclass="reference external"href="https://grapevine.haus/chat">https://grapevine.haus/chat</a>.</p>
<p>Start/reload Evennia and log in as a privileged user. You should now have a new
command available: <codeclass="docutils literal notranslate"><spanclass="pre">@grapevine2chan</span></code>. This command is called like this:</p>
<p>Here, the <codeclass="docutils literal notranslate"><spanclass="pre">evennia_channel</span></code> must be the name of an existing Evennia channel and
<codeclass="docutils literal notranslate"><spanclass="pre">grapevine_channel</span></code> one of the supported channels in <codeclass="docutils literal notranslate"><spanclass="pre">GRAPEVINE_CHANNELS</span></code>.</p>
<blockquote>
<div><p>At the time of writing, the Grapevine network only has two channels:
<codeclass="docutils literal notranslate"><spanclass="pre">testing</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">gossip</span></code>. Evennia defaults to allowing connecting to both. Use
<codeclass="docutils literal notranslate"><spanclass="pre">testing</span></code> for trying your connection.</p>
</div></blockquote>
</section>
<sectionid="setting-up-grapevine-step-by-step">
<h2>Setting up Grapevine, step by step<aclass="headerlink"href="#setting-up-grapevine-step-by-step"title="Permalink to this headline">¶</a></h2>
<p>You can connect Grapevine to any Evennia channel (so you could connect it to
the default <em>public</em> channel if you like), but for testing, let’s set up a
new channel <codeclass="docutils literal notranslate"><spanclass="pre">gw</span></code>.</p>
<divclass="highlight-none notranslate"><divclass="highlight"><pre><span></span> @ccreate gw = This is connected to an gw channel!
</pre></div>
</div>
<p>You will automatically join the new channel.</p>
<p>Next we will create a connection to the Grapevine network.</p>
