ChessToTheDeath


NameChessToTheDeath JSON
Version 0.1.2 PyPI version JSON
download
home_page
SummaryA simple chess variant where pieces have damage and health values.
upload_time2024-01-20 15:30:15
maintainer
docs_urlNone
author
requires_python>=3.7
license
keywords python chess pygame
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div id="top"></div>

<p>
   <a href="https://pypi.org/project/ChessToTheDeath/" alt="Downloads">
      <img src="https://static.pepy.tech/personalized-badge/chesstothedeath?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads" align="right">
   </a>
   <a href="https://pypi.org/project/ChessToTheDeath/" alt="Visitors">
      <img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FSilenZcience%2FChessToTheDeath&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=Visitors&edge_flat=false" align="right">
   </a>
</p>

[![OS-Windows]][OS-Windows]
[![OS-Linux]][OS-Linux]
[![OS-MacOS]][OS-MacOS]

<br/>
<div align="center">
<h2 align="center">ChessToTheDeath</h2>
   <p align="center">
      A simple chess variant where pieces have damage and health values.
      <br/>
      <a href="https://github.com/SilenZcience/ChessToTheDeath/blob/main/chess_to_the_death/util/gui.py">
         <strong>Explore the code »</strong>
      </a>
      <br/>
      <br/>
      <a href="https://github.com/SilenZcience/ChessToTheDeath/issues">Report Bug</a>
      ·
      <a href="https://github.com/SilenZcience/ChessToTheDeath/issues">Request Feature</a>
   </p>
</div>


<details>
   <summary>Table of Contents</summary>
   <ol>
      <li>
         <a href="#about-the-project">About The Project</a>
         <ul>
            <li><a href="#made-with">Made With</a></li>
         </ul>
      </li>
      <li>
         <a href="#getting-started">Getting Started</a>
         <ul>
            <li><a href="#installation">Installation</a></li>
         </ul>
      </li>
      <li><a href="#usage">Usage</a>
         <ul>
         <li><a href="#help">Help</a></li>
         <li><a href="#examples">Examples</a></li>
         </ul>
      </li>
      <li><a href="#license">License</a></li>
      <li><a href="#contact">Contact</a></li>
   </ol>
</details>

<div id="about-the-project"></div>

## About The Project

This project simply contains a custom chess variant in which every chess piece has it's own
health and damage values. Therefor simply taking an enemy piece is not an option. Instead
you have to fight it multiple times. The game ends when one of the Kings has no healthpoints
left.

<div id="made-with"></div>

### Made With
[![Python][MadeWith-Python]](https://www.python.org/)
[![Numpy][MadeWith-Numpy]](https://numpy.org/)

<p align="right">(<a href="#top">back to top</a>)</p>
<div id="getting-started"></div>

## Getting Started

<div id="installation"></div>

### Installation

Choose one of the options below:
```console
pip install ChessToTheDeath
```
```console
pip install git+https://github.com/SilenZcience/ChessToTheDeath.git
```
```console
git clone git@github.com:SilenZcience/ChessToTheDeath.git
cd ./ChessToTheDeath
```

<p align="right">(<a href="#top">back to top</a>)</p>
<div id="usage"></div>

## Usage

```console
python -m chess_to_the_death [-h] [-v] ...
```

| Argument               | Description                                          |
|------------------------|------------------------------------------------------|
| -h, --help             | show help message and exit                           |
| -v, --version          | show program's version number and exit               |
| -fps FPS, --fps FPS    | set max fps (a lower value will improve performance) |
| -nohighlight           | disable cell-highlighting on mouse hover             |
| -noflip                | disable board flipping                               |
| -random                | randomize the health and damage values of all pieces |
| -default               | play the default chess variant                       |
| -crazy                 | play the crazyhouse chess variant                    |
| -pos POSITION          | FEN starting position                                |

- ***leftclick*** a piece to select it
- ***leftclick*** a tile to move/attack with your selected piece
- ***rightclick*** a tile to mark it with a circle
- ***rightclick*** a circled tile to mark it with a square
- ***rightclick*** drag & drop across different tiles to draw an arrow
- ***middleclick*** an empty tile to crazyplace a piece (only with `-crazy` parameter enabled)

<div id="help"></div>

### Help

> **Q: Why am i seeing weird characters like `r `in the console?**

> A: This project uses `ANSI-Escape Codes` to display colors in the Terminal. If you see these weird characters, then your Terminal does not support these Codes.

> ⚠️If you are using the Command Prompt on Windows 10 you can most likely solve this issue by going in the Registry under `Computer\HKEY_CURRENT_USER\Console` and adding/editing the `DWORD` value `VirtualTerminalLevel` and setting it to `1`.

- - - -

> **Q: Is it possible to have a different board size/shape?**

> A: Yes, the `-pos POSITION` parameter supports different board widths and heights. Simply expand the notation with additional rows or columns.

<div id="examples"></div>

### Examples

```console
python -m chess_to_the_death
```
<p float="left">
   <img src="https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example1.png" width="30%"/>
   <img src="https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example2.png" width="30%"/>
   <img src="https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example3.png" width="30%"/>
</p>

```console
python -m chess_to_the_death -default -pos "5Q/3k2/1p4/1Pp2p/2Pp1P/3P1K b" -noflip
```
<p float="left">
   <img src="https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example4.png" width="30%"/>
   <img src="https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example5.png" width="30%"/>
   <img src="https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example6.png" width="30%"/>
</p>


<p align="right">(<a href="#top">back to top</a>)</p>
<div id="license"></div>

## License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/SilenZcience/ChessToTheDeath/blob/main/LICENSE) file for details

<div id="contact"></div>

## Contact

> **SilenZcience** <br/>
[![GitHub-SilenZcience][GitHub-SilenZcience]](https://github.com/SilenZcience)

[OS-Windows]: https://img.shields.io/badge/os-windows-green
[OS-Linux]: https://img.shields.io/badge/os-linux-green
[OS-MacOS]: https://img.shields.io/badge/os-macOS-green

[MadeWith-Python]: https://img.shields.io/badge/Made%20with-Python-brightgreen
[MadeWith-Numpy]: https://img.shields.io/badge/Made%20with-Numpy-brightgreen

[GitHub-SilenZcience]: https://img.shields.io/badge/GitHub-SilenZcience-orange

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "ChessToTheDeath",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "python,chess,pygame",
    "author": "",
    "author_email": "\"Silas A. Kraume\" <silas.kraume1552@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/af/58/5d1fc4e1df3ec61f59efd2d7967fe37cbd30f8ffe187b5fa07175dd5aaf1/chesstothedeath-0.1.2.tar.gz",
    "platform": null,
    "description": "<div id=\"top\"></div>\n\n<p>\n   <a href=\"https://pypi.org/project/ChessToTheDeath/\" alt=\"Downloads\">\n      <img src=\"https://static.pepy.tech/personalized-badge/chesstothedeath?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads\" align=\"right\">\n   </a>\n   <a href=\"https://pypi.org/project/ChessToTheDeath/\" alt=\"Visitors\">\n      <img src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FSilenZcience%2FChessToTheDeath&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=Visitors&edge_flat=false\" align=\"right\">\n   </a>\n</p>\n\n[![OS-Windows]][OS-Windows]\n[![OS-Linux]][OS-Linux]\n[![OS-MacOS]][OS-MacOS]\n\n<br/>\n<div align=\"center\">\n<h2 align=\"center\">ChessToTheDeath</h2>\n   <p align=\"center\">\n      A simple chess variant where pieces have damage and health values.\n      <br/>\n      <a href=\"https://github.com/SilenZcience/ChessToTheDeath/blob/main/chess_to_the_death/util/gui.py\">\n         <strong>Explore the code \u00bb</strong>\n      </a>\n      <br/>\n      <br/>\n      <a href=\"https://github.com/SilenZcience/ChessToTheDeath/issues\">Report Bug</a>\n      \u00b7\n      <a href=\"https://github.com/SilenZcience/ChessToTheDeath/issues\">Request Feature</a>\n   </p>\n</div>\n\n\n<details>\n   <summary>Table of Contents</summary>\n   <ol>\n      <li>\n         <a href=\"#about-the-project\">About The Project</a>\n         <ul>\n            <li><a href=\"#made-with\">Made With</a></li>\n         </ul>\n      </li>\n      <li>\n         <a href=\"#getting-started\">Getting Started</a>\n         <ul>\n            <li><a href=\"#installation\">Installation</a></li>\n         </ul>\n      </li>\n      <li><a href=\"#usage\">Usage</a>\n         <ul>\n         <li><a href=\"#help\">Help</a></li>\n         <li><a href=\"#examples\">Examples</a></li>\n         </ul>\n      </li>\n      <li><a href=\"#license\">License</a></li>\n      <li><a href=\"#contact\">Contact</a></li>\n   </ol>\n</details>\n\n<div id=\"about-the-project\"></div>\n\n## About The Project\n\nThis project simply contains a custom chess variant in which every chess piece has it's own\nhealth and damage values. Therefor simply taking an enemy piece is not an option. Instead\nyou have to fight it multiple times. The game ends when one of the Kings has no healthpoints\nleft.\n\n<div id=\"made-with\"></div>\n\n### Made With\n[![Python][MadeWith-Python]](https://www.python.org/)\n[![Numpy][MadeWith-Numpy]](https://numpy.org/)\n\n<p align=\"right\">(<a href=\"#top\">back to top</a>)</p>\n<div id=\"getting-started\"></div>\n\n## Getting Started\n\n<div id=\"installation\"></div>\n\n### Installation\n\nChoose one of the options below:\n```console\npip install ChessToTheDeath\n```\n```console\npip install git+https://github.com/SilenZcience/ChessToTheDeath.git\n```\n```console\ngit clone git@github.com:SilenZcience/ChessToTheDeath.git\ncd ./ChessToTheDeath\n```\n\n<p align=\"right\">(<a href=\"#top\">back to top</a>)</p>\n<div id=\"usage\"></div>\n\n## Usage\n\n```console\npython -m chess_to_the_death [-h] [-v] ...\n```\n\n| Argument               | Description                                          |\n|------------------------|------------------------------------------------------|\n| -h, --help             | show help message and exit                           |\n| -v, --version          | show program's version number and exit               |\n| -fps FPS, --fps FPS    | set max fps (a lower value will improve performance) |\n| -nohighlight           | disable cell-highlighting on mouse hover             |\n| -noflip                | disable board flipping                               |\n| -random                | randomize the health and damage values of all pieces |\n| -default               | play the default chess variant                       |\n| -crazy                 | play the crazyhouse chess variant                    |\n| -pos POSITION          | FEN starting position                                |\n\n- ***leftclick*** a piece to select it\n- ***leftclick*** a tile to move/attack with your selected piece\n- ***rightclick*** a tile to mark it with a circle\n- ***rightclick*** a circled tile to mark it with a square\n- ***rightclick*** drag & drop across different tiles to draw an arrow\n- ***middleclick*** an empty tile to crazyplace a piece (only with `-crazy` parameter enabled)\n\n<div id=\"help\"></div>\n\n### Help\n\n> **Q: Why am i seeing weird characters like `\u001b[31;1mr\u001b[0m `in the console?**\n\n> A: This project uses `ANSI-Escape Codes` to display colors in the Terminal. If you see these weird characters, then your Terminal does not support these Codes.\n\n> \u26a0\ufe0fIf you are using the Command Prompt on Windows 10 you can most likely solve this issue by going in the Registry under `Computer\\HKEY_CURRENT_USER\\Console` and adding/editing the `DWORD` value `VirtualTerminalLevel` and setting it to `1`.\n\n- - - -\n\n> **Q: Is it possible to have a different board size/shape?**\n\n> A: Yes, the `-pos POSITION` parameter supports different board widths and heights. Simply expand the notation with additional rows or columns.\n\n<div id=\"examples\"></div>\n\n### Examples\n\n```console\npython -m chess_to_the_death\n```\n<p float=\"left\">\n   <img src=\"https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example1.png\" width=\"30%\"/>\n   <img src=\"https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example2.png\" width=\"30%\"/>\n   <img src=\"https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example3.png\" width=\"30%\"/>\n</p>\n\n```console\npython -m chess_to_the_death -default -pos \"5Q/3k2/1p4/1Pp2p/2Pp1P/3P1K b\" -noflip\n```\n<p float=\"left\">\n   <img src=\"https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example4.png\" width=\"30%\"/>\n   <img src=\"https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example5.png\" width=\"30%\"/>\n   <img src=\"https://raw.githubusercontent.com/SilenZcience/ChessToTheDeath/main/img/example6.png\" width=\"30%\"/>\n</p>\n\n\n<p align=\"right\">(<a href=\"#top\">back to top</a>)</p>\n<div id=\"license\"></div>\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/SilenZcience/ChessToTheDeath/blob/main/LICENSE) file for details\n\n<div id=\"contact\"></div>\n\n## Contact\n\n> **SilenZcience** <br/>\n[![GitHub-SilenZcience][GitHub-SilenZcience]](https://github.com/SilenZcience)\n\n[OS-Windows]: https://img.shields.io/badge/os-windows-green\n[OS-Linux]: https://img.shields.io/badge/os-linux-green\n[OS-MacOS]: https://img.shields.io/badge/os-macOS-green\n\n[MadeWith-Python]: https://img.shields.io/badge/Made%20with-Python-brightgreen\n[MadeWith-Numpy]: https://img.shields.io/badge/Made%20with-Numpy-brightgreen\n\n[GitHub-SilenZcience]: https://img.shields.io/badge/GitHub-SilenZcience-orange\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "A simple chess variant where pieces have damage and health values.",
    "version": "0.1.2",
    "project_urls": {
        "Download": "https://github.com/SilenZcience/ChessToTheDeath/tarball/master",
        "Github": "https://github.com/SilenZcience/ChessToTheDeath",
        "Tracker": "https://github.com/SilenZcience/ChessToTheDeath/issues"
    },
    "split_keywords": [
        "python",
        "chess",
        "pygame"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7b28a8c1e489c44389033fda82c6d46b7f79f93eabd0c01bbf49f572f2857e6a",
                "md5": "f7312f039f8cf27394156da6d07eaf92",
                "sha256": "34583921a8f6019ebb94f679fd02fcbad840a2ebeb7674d4fc32b2fe186098ea"
            },
            "downloads": -1,
            "filename": "chesstothedeath-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f7312f039f8cf27394156da6d07eaf92",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 706626,
            "upload_time": "2024-01-20T15:30:13",
            "upload_time_iso_8601": "2024-01-20T15:30:13.076999Z",
            "url": "https://files.pythonhosted.org/packages/7b/28/a8c1e489c44389033fda82c6d46b7f79f93eabd0c01bbf49f572f2857e6a/chesstothedeath-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "af585d1fc4e1df3ec61f59efd2d7967fe37cbd30f8ffe187b5fa07175dd5aaf1",
                "md5": "121f29d2a9f0e36c877e807e31737f0b",
                "sha256": "15bedf5c9d5799a6763c7c24ce24df0ea9f0b17bc2a1df7a7e86ce70a9fdba93"
            },
            "downloads": -1,
            "filename": "chesstothedeath-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "121f29d2a9f0e36c877e807e31737f0b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 705232,
            "upload_time": "2024-01-20T15:30:15",
            "upload_time_iso_8601": "2024-01-20T15:30:15.260507Z",
            "url": "https://files.pythonhosted.org/packages/af/58/5d1fc4e1df3ec61f59efd2d7967fe37cbd30f8ffe187b5fa07175dd5aaf1/chesstothedeath-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-20 15:30:15",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "SilenZcience",
    "github_project": "ChessToTheDeath",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "chesstothedeath"
}
        
Elapsed time: 0.16883s