Metadata-Version: 2.1
Name: sc2gameLobby
Version: 1.1.3
Summary: An interface to request SC2 matches and launch the client for human and/or AI/bot play
Home-page: https://github.com/ttinies/sc2gameLobby
Author: ttinies
Author-email: help.fool@versentiedge.com
License: Apache License 2.0
Description: 
        [![PyPI](https://img.shields.io/pypi/v/sc2gameLobby.svg)](https://pypi.org/project/sc2gameLobby/)
        [![Build Status](https://travis-ci.org/ttinies/sc2gameLobby.svg?branch=master)](https://travis-ci.org/ttinies/sc2gameLobby)
        [![Coverage Status](https://coveralls.io/repos/github/ttinies/sc2gameLobby/badge.svg?branch=master)](https://coveralls.io/github/ttinies/sc2gameLobby?branch=master)
        ![Crates.io](https://img.shields.io/crates/l/rustc-serialize.svg)
        
        # Play Starcraft 2 on a ladder as a human or AI against other human AI
        
        ## About
        
        The objective of this repository is enable casual Starcraft 2 players, AI developers and proficient coders to all create
        a player that competes against others in a Starcraft 2 match.  The strategy is to create an increasingly user-friendly
        interface so that most anybody can readily set up matches and play against
        
        #### Rationale: Why Create this Repository?
        
        There is an existing ladder for AI-only developers, [sc2ai.net](https://sc2ai.net/).  While that project is under active
        development as of July 6, 2018, its roadmap doesn't support several critical features which impedes developers' efforts
        (such as ours) to create AI that is publicly visible.  Here are several features which this ladder supports that
        sc2ai.net may not.
        
        * Play on your own machine against others on their own machines.  You're no longer limited by some other person's
        machine who is sharing system resources with other players in the game.
        * Support AI vs AI, AI vs human and human vs human play.
        * AI developers aren't required to share their source code or any executable.
        * Fast, user-friendly setup that non-programmers or programmers with lower proficiency in a specific language can set
        up.  No need to hunt + edit files by hand.
        
        #### Brief Functional Overview
        
        This sc2gameLobby package's primary functions are as follows:
        1. Issue match requests such that other available players or static bots can be matched against you. When being matched
        against opponents, if no valid opponents are available for a match with you in the queue, you are automatically matched
        instead against other publicly available bot algorithms or Blizzard's built-in bots depending on your estimated
        proficiency.
        2. Launch a Starcraft 2 client that will automatically manage the match along with other Starcraft 2 clients (as
        needed).  The match is played until its finished.
        3. Each player using sc2gameLobby reports results back to the ladder. The ladder verifies each player's reported results
        against its own intimate knowledge of the match to accurately determine the proper match result and update the ladder
        accordingly.
        
        Communication with the ladder server occurs via TCP connection with a django server available on the internet.  It is
        possible to communicate with [alternative ladders](https://github.com/ttinies/sc2ladderMgmt), but we've established this
        server form normal sc2gameLobby gameplay.
        
        ## Installation
        
        #### System Requirements
        
        * sc2gameLobby is proven using both Linux (using wine) and Windows.  While untested on OSX, because OSX is also widely
        tested using pysc2, sc2gameLobby is also expected to work without issue.  NOTE: Linux is not a platform officially
        supported by Blizzard for Starcraft 2, but it does work, both using headless and regular setups using full graphics.
        * As a human, your own system must be able to support a Starcraft 2 client application (the window that actually plays
        the game).  Reference standard [Starcraft 2 game requirements](https://us.battle.net/support/en/article/27575) for details.
        * As an AI, in addition to the requirements for human play,  as well as any other resources your AI may require.  If
        your AI architecture can run, it is allowed on this ladder.
        
        #### Instructions
        
        1. Install Starcraft 2 normally.  If you use an install destination path other than the default, ensure it's specified
        using an environment variable called SC2PATH.
        2. Install any(?) version of [python](https://www.python.org/downloads/) that is compatible with your system.
        3. Use conda **or** pip via instructions below to install sc2gameLobby.
        > NOTE: you can also install this package via other means, but you may have to manage your environment to ensure all
        dependencies are available on your system.  If you're not familiar with these utilities, follow the installation
        instructions provided by their authors available on the internet.
        
        ##### Conda
        
        From a command line, enter a standard [conda](https://conda.io/docs/user-guide/index.html) install command that's 
        compatible with your system setup.  Be sure you're targeting the intended environment!
        
        > `EXAMPLE: conda install sc2gameLobby -n <your development environment name>`
        
        ##### Pip
        
        From a command line, enter a standard [pip](http://pip.pypa.io/en/stable/user_guide/) install command that's compatible 
        with your system setup.
        
        > `EXAMPLE: pip install sc2gameLobby`
        
        #### Dependencies
        
        This sc2gameLobby package is indended to run with python version >= 3.5. Package dependencies are defined in
         [requirements.txt](https://github.com/ttinies/sc2gameLobby/blob/master/requirements.txt).
        Dependencies are installed automatically when using the installation methods above.
        
        #### Verification of Valid Installation
        
        If your setup is fully successful, the following test commands should work as follows:
        
        test command: `python -m sc2gameLobby --help`
        
        ```
        usage: __main__.py [-h] [--nogui] [--search PLAYERS] [--history] [-l] [-p]
        ...
        PURPOSE: front-end interface to easily and reliably match against opponents
        and run Starcraft2 opponents.
        ...
        version: 1.0.0
        ```
        
        test command: `> python -m sc2gameLobby --versions`
        
        ```
        ...
        4.4.0
           base-version: 65895
              data-hash: BF41339C22AE2EDEBEEADC8C75028F7D
             fixed-hash:
                  label: 4.4.0
            replay-hash:
                version: 65895
        ```
        
        test command: `python -m sc2gameLobby --search mapexplorer`
        
        ```
        <PlayerRecord mapexplorer ai>
                   type : <PlayerDesigns ai>
             difficulty : None
                initCmd : sc2ai.agents.newExplorer
                 rating : 0
                created : 2018-05-28
        ```
        
        #### Troubleshooting
        
        ```
        ERROR: A connection could not be made. <Ladder versentiedge> may not be available or you may not be connected to the internet.
        ```
        
        This means that the ladder server instance you are attempting to communicate with could not be reached.  It may not be
        online or your connection to the internet may be compromised.
        
        **<reserved for additional issues if/when such are reported>**
        
        ## Recommended Usage
        
        Great, now you're set to rock ladder matches versus humans and AI opponents!  Refer to [python](https://github.com/ttinies/sc2gameLobby/blob/master/USAGE_PYTHON.md)-specific or [non python](https://github.com/ttinies/sc2gameLobby/blob/master/USAGE_NON_PYTHON.md)-specific usage documents.  Good luck!
        
        ## Further Development and Augmentation
        
        #### Add New Features to the Code?
        
        This is an open-use repository.  Feel free to fork and issue pull requests. Feature enhancements, especially for
        to-be-developed features, and bug fixes are especially appreciated.
        
        ###### Anticipated Useful, To-Be-Developed Features
        
        * User-friendly GUI front end that abstracts the command-line utilities.
        * Web browser integration to perform match requests.
        * Publicly available web page statistics from data mining match results.
        * Additional game modes beyond 1v1.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Games/Entertainment :: Real Time Strategy
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >3.4
Description-Content-Type: text/markdown
