# Shibumi Games [![Build Badge]][build] [![Coverage Badge]][codecov] [![PyPI Badge]][pypi]
### Simple board games hiding complexity
[Build Badge]: https://github.com/donkirkby/shibumi-games/actions/workflows/py-build.yml/badge.svg?branch=master
[build]: https://github.com/donkirkby/shibumi-games/actions
[Coverage Badge]: https://codecov.io/github/donkirkby/shibumi-games/coverage.svg?branch=master
[codecov]: https://codecov.io/github/donkirkby/shibumi-games?branch=master
[PyPI Badge]: https://badge.fury.io/py/shibumi.svg
[pypi]: https://badge.fury.io/py/shibumi
[screenshot]: https://donkirkby.github.io/shibumi-games/images/demo.png
[journal]: https://donkirkby.github.io/shibumi-games/journal
Play board games that use the [Shibumi] game system of marbles stacked on a 4x4
board, build computer opponents for those games, learn strategy, and analyse the
structure of the games.
![screenshot]
## Installing Shibumi Games
Even though Shibumi Games has a graphical display, it is a regular Python package,
so you can install it with `pip install shibumi`. If you haven't installed
Python packages before, read Brett Cannon's [quick-and-dirty guide].
Then run it with the `shibumi` command.
The default installation generates some errors about `bdist_wheel` that don't
seem to actually cause any problems. You can either ignore them, or install
`wheel` before installing Shibumi Games.
pip install wheel
pip install shibumi
shibumi
Known bug on Ubuntu 20.04:
> qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though
> it was found.
This is a [PySide2 bug] that is missing some dependencies. You can work around
it by installing those dependencies like this:
sudo apt install libxcb-xinerama0
[quick-and-dirty guide]: https://snarky.ca/a-quick-and-dirty-guide-on-how-to-install-packages-for-python/
[PySide2 bug]: https://bugreports.qt.io/browse/QTBUG-84749
### Game Credits
The Shibumi game system was designed by Cameron Browne and Néstor Romeral
Andrés. The complete set of game rules are available on the
[nestorgames web site], and the games used in this project are used with the
generous permission of the designers. There are more games in a [BGG list].
* Spaiji was designed by Néstor Romeral Andrés.
* Spargo and Margo were designed by Cameron Browne.
* Spire was designed by Dieter Stein, and took second place in the Shibumi
Challenge.
* Spline was designed by Néstor Romeral Andrés.
* Sploof was designed by Matt Green, and took first place in the Shibumi
Challenge.
* Spook was designed by Dieter Stein.
[nestorgames web site]: https://nestorgames.com/shibumibook_detail.html
[BGG list]: https://boardgamegeek.com/boardgamefamily/13434/series-shibumi/linkeditems/boardgamefamily?pageid=1&sort=usersrated
### Image Credits
The marble and board graphics were designed by Cameron Browne, and are used with
permission.
Some of the buttons combine Cameron's POV-Ray graphics with icons from the
[Open Iconic] project.
[Open Iconic]: https://useiconic.com/open
## More Information
If you'd like to help out with the project, or add your own games, see the
`CONTRIBUTING.md` file in the source code. For all the details, look through the
design [journal] for the project.
Shibumi games are built on top of the [Zero Play library] that you can use to
build your own games.
[Shibumi]: https://boardgamegeek.com/boardgame/135270/shibumi
[Zero Play library]: https://donkirkby.github.io/zero-play/
Raw data
{
"_id": null,
"home_page": "https://donkirkby.github.io/shibumi-games/",
"name": "shibumi",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "boardgames alphazero machine learning mcts shibumi",
"author": "Don Kirkby",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/e0/fe/e6dea18b2fff6f5f82d4d3490f04731a7ee9d40246e873a01ca72737f1df/shibumi-0.5.0.tar.gz",
"platform": null,
"description": "# Shibumi Games [![Build Badge]][build] [![Coverage Badge]][codecov] [![PyPI Badge]][pypi]\n### Simple board games hiding complexity\n\n[Build Badge]: https://github.com/donkirkby/shibumi-games/actions/workflows/py-build.yml/badge.svg?branch=master\n[build]: https://github.com/donkirkby/shibumi-games/actions\n[Coverage Badge]: https://codecov.io/github/donkirkby/shibumi-games/coverage.svg?branch=master\n[codecov]: https://codecov.io/github/donkirkby/shibumi-games?branch=master\n[PyPI Badge]: https://badge.fury.io/py/shibumi.svg\n[pypi]: https://badge.fury.io/py/shibumi\n[screenshot]: https://donkirkby.github.io/shibumi-games/images/demo.png\n[journal]: https://donkirkby.github.io/shibumi-games/journal\n\nPlay board games that use the [Shibumi] game system of marbles stacked on a 4x4\nboard, build computer opponents for those games, learn strategy, and analyse the\nstructure of the games.\n\n![screenshot]\n\n## Installing Shibumi Games\nEven though Shibumi Games has a graphical display, it is a regular Python package,\nso you can install it with `pip install shibumi`. If you haven't installed\nPython packages before, read Brett Cannon's [quick-and-dirty guide].\n\nThen run it with the `shibumi` command.\n\nThe default installation generates some errors about `bdist_wheel` that don't\nseem to actually cause any problems. You can either ignore them, or install\n`wheel` before installing Shibumi Games.\n\n pip install wheel\n pip install shibumi\n shibumi\n\nKnown bug on Ubuntu 20.04:\n\n> qt.qpa.plugin: Could not load the Qt platform plugin \"xcb\" in \"\" even though\n> it was found.\n\nThis is a [PySide2 bug] that is missing some dependencies. You can work around\nit by installing those dependencies like this:\n\n sudo apt install libxcb-xinerama0\n\n[quick-and-dirty guide]: https://snarky.ca/a-quick-and-dirty-guide-on-how-to-install-packages-for-python/\n[PySide2 bug]: https://bugreports.qt.io/browse/QTBUG-84749\n\n### Game Credits\nThe Shibumi game system was designed by Cameron Browne and N\u00e9stor Romeral\nAndr\u00e9s. The complete set of game rules are available on the\n[nestorgames web site], and the games used in this project are used with the\ngenerous permission of the designers. There are more games in a [BGG list].\n* Spaiji was designed by N\u00e9stor Romeral Andr\u00e9s.\n* Spargo and Margo were designed by Cameron Browne.\n* Spire was designed by Dieter Stein, and took second place in the Shibumi\nChallenge.\n* Spline was designed by N\u00e9stor Romeral Andr\u00e9s.\n* Sploof was designed by Matt Green, and took first place in the Shibumi\nChallenge.\n* Spook was designed by Dieter Stein.\n\n[nestorgames web site]: https://nestorgames.com/shibumibook_detail.html\n[BGG list]: https://boardgamegeek.com/boardgamefamily/13434/series-shibumi/linkeditems/boardgamefamily?pageid=1&sort=usersrated\n\n### Image Credits\nThe marble and board graphics were designed by Cameron Browne, and are used with\npermission.\n\nSome of the buttons combine Cameron's POV-Ray graphics with icons from the\n[Open Iconic] project.\n\n[Open Iconic]: https://useiconic.com/open\n\n## More Information\nIf you'd like to help out with the project, or add your own games, see the\n`CONTRIBUTING.md` file in the source code. For all the details, look through the\ndesign [journal] for the project.\n\nShibumi games are built on top of the [Zero Play library] that you can use to\nbuild your own games.\n\n[Shibumi]: https://boardgamegeek.com/boardgame/135270/shibumi\n[Zero Play library]: https://donkirkby.github.io/zero-play/\n",
"bugtrack_url": null,
"license": "",
"summary": "Simple board games hiding complexity",
"version": "0.5.0",
"project_urls": {
"Bug Reports": "https://github.com/donkirkby/shibumi-games/issues",
"Homepage": "https://donkirkby.github.io/shibumi-games/",
"Source": "https://github.com/donkirkby/shibumi-games"
},
"split_keywords": [
"boardgames",
"alphazero",
"machine",
"learning",
"mcts",
"shibumi"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6c1c508bb88b53ccaa26f86e3b01d04f3312874a33fd953e29f4c08ebb21a52f",
"md5": "3930747185080bfe66a9e8d448f8315d",
"sha256": "0f0ae4053df9688232a9213646d214c53c1152e2eb259e244c66099d9a0aadce"
},
"downloads": -1,
"filename": "shibumi-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3930747185080bfe66a9e8d448f8315d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 1238576,
"upload_time": "2023-05-06T22:59:42",
"upload_time_iso_8601": "2023-05-06T22:59:42.035397Z",
"url": "https://files.pythonhosted.org/packages/6c/1c/508bb88b53ccaa26f86e3b01d04f3312874a33fd953e29f4c08ebb21a52f/shibumi-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e0fee6dea18b2fff6f5f82d4d3490f04731a7ee9d40246e873a01ca72737f1df",
"md5": "468e951145eb00a4842eaed5b5a5cea2",
"sha256": "4c44f4349bb8cf23ab42994e71fa5d9abcfe1255b6009599be64d6936182912f"
},
"downloads": -1,
"filename": "shibumi-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "468e951145eb00a4842eaed5b5a5cea2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1191193,
"upload_time": "2023-05-06T22:59:44",
"upload_time_iso_8601": "2023-05-06T22:59:44.531466Z",
"url": "https://files.pythonhosted.org/packages/e0/fe/e6dea18b2fff6f5f82d4d3490f04731a7ee9d40246e873a01ca72737f1df/shibumi-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-06 22:59:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "donkirkby",
"github_project": "shibumi-games",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "shibumi"
}
JSON
