Skip to main content

A framework for playing the Diplomacy board game over a network.

Project description

============================
Parlance Diplomacy Framework
============================

--------------
About Parlance
--------------

Parlance is a framework for playing the `Diplomacy`_ board game over a network,
using the protocol and message syntax developed by the `Diplomacy AI
Development Environment`_ (DAIDE) community.

The Parlance server differs from the official DAIDE server in that it can serve
multiple games (consecutively or concurrently), is more configurable, can be
managed remotely through admin commands, and accepts a slightly broader message
syntax.

Parlance also includes a framework for clients, including a command-line game
observer, and can be used as a library for computer players (bots).

Parlance may be used, modified, and/or redistributed under the terms of
the `Artistic License 2.0`_, as published by the Perl Foundation.

.. _Diplomacy: http://en.wikipedia.org/wiki/Diplomacy_(game)
.. _Diplomacy AI Development Environment: http://www.daide.org.uk/index.xml
.. _Artistic License 2.0: http://www.perlfoundation.org/artistic_license_2_0


--------
Commands
--------

Parlance installs the following commands:

parlance-server
Starts a game server

parlance-holdbot
Starts one or more HoldBots

parlance-chatty
Starts a game observer

parlance-config
Prints out an example configuration file

parlance-raw-client
Connects to a server, translating network messages to and from DAIDE message
syntax on standard input and output.

parlance-raw-server:
Listens for clients, translating network messages to and from DAIDE message
syntax on standard input and output.


------------
Installation
------------

Parlance can be installed with `Easy Install`_ from a command prompt::

> easy_install parlance

Alternatively, once you have downloaded and unpacked a source distribution, you
can install it with::

> python setup.py install

.. _Easy Install: http://peak.telecommunity.com/DevCenter/EasyInstall

-------
Credits
-------

* Daniel Loeb started the `Diplomacy Programming Project`_ in 1990, developing
a language for communication between computer players and a GM.

* Andrew Rose developed the `network protocol`_ used to connect clients to the
server, and wrote a DLL implementation of it.

* David Norman extended the DPP communication language into the `DAIDE message
syntax`_, translated several variant maps into it, and wrote the first
full-featured server, bot, and graphical player interface to use the DAIDE
protocols.

* Eric Wald wrote the first versions of Parlance to extend the DAIDE
environment to non-Windows platforms, particularly Linux.

.. _Diplomacy Programming Project: http://www.diplom.org/Zine/S1995M/Loeb/Project.html
.. _DAIDE message syntax: http://www.ellought.demon.co.uk/dipai/dpp_syntax.rtf
.. _network protocol: http://www.daide.org.uk/external/comproto.html

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
Parlance-1.4.0-py2.5.egg (294.5 kB) Copy SHA256 hash SHA256 Egg 2.5
Parlance-1.4.0.tar.bz2 (153.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page