Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stevegrossi/sengoku
An online Risk-like game built with Elixir and Phoenix LiveView
https://github.com/stevegrossi/sengoku
elixir game phoenix-liveview
Last synced: 3 months ago
JSON representation
An online Risk-like game built with Elixir and Phoenix LiveView
- Host: GitHub
- URL: https://github.com/stevegrossi/sengoku
- Owner: stevegrossi
- Created: 2017-09-05T00:28:39.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2023-01-06T06:44:38.000Z (almost 2 years ago)
- Last Synced: 2024-05-10T23:38:18.891Z (6 months ago)
- Topics: elixir, game, phoenix-liveview
- Language: Elixir
- Homepage: https://www.playsengoku.com/
- Size: 13.7 MB
- Stars: 56
- Watchers: 6
- Forks: 3
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- open-production-web-projects - Sengoku - An online Risk-like game built with Elixir and Phoenix LiveView (Elixir / Phoenix)
README
# Sengoku
Unite feudal Japan in this Risk-like strategy game! (This is extremely alpha and in active development.)
## Gameplay
Up to 8 players: play against friends online, the computer, or both.
- Provinces are randomly divided amongst all players at the start of the game.
- Each player receives one unit for every 3 provinces they hold (with a minimum of 3) at the start of each turn.
- Receive bonus units for holding all provinces within a marked region.
- On your turn you may attack neighboring provinces (see below).
- At the end of your turn, you may move units from one of your provinces to one of its neighbors you control.
- A player is defeated when they no longer control any provinces.
- A player wins when all other players are defeated.
### Rules for Battle
- Up to 3 units will attack at once, and up to 2 units will defend. A six-sided die is rolled for each.
- Rolls are sorted from highest to lowest and paired off: e.g. the highest attacker roll with the highest defender roll. Defending units win ties. The losing unit is removed from play.
- If all defending units are removed, the attacker takes control of that province and their number of attacking units moves in.
## Development
To start your Phoenix server:
* Setup the project with `mix setup`
* Start Phoenix endpoint with `mix phx.server`
Now you can visit [`localhost:4000`](http://localhost:4000) from your browser to play!
### AI Development
Want to improve the AI? Great! Computer players implement the `Sengoku.AI` behaviour. The current AI is the `Sengoku.AI.Smart` module.
1. Copy the current AI module and its tests. From the command line:
```
cp lib/sengoku/ai/smart.ex lib/sengoku/ai/smarter.ex
cp test/sengoku/ai/smart_test.exs test/sengoku/ai/smarter_test.exs
```
2. I’d like to automate this, but with `lib/sengoku/ai/smarter.ex` manually rename `Sengoku.AI.Smart` to `Sengoku.AI.Smarter`, and within `test/sengoku/ai/smarter_test.exs` rename `Sengoku.AI.SmartTest` to `Sengoku.AI.SmarterTest`.
3. Run `mix test` to ensure everything’s working.
4. Run `mix ai.arena Sengoku.AI.Smarter` with your new AI module:
```
Starting 2000 games with Sengoku.AI.Smarter as Player 1
against Sengoku.AI.Smart as all other players
Player | Win %
--------------------------------|-------
1 (Sengoku.AI.Smarter) | 11.9%
2 (Sengoku.AI.Smart) | 11.8%
3 (Sengoku.AI.Smart) | 13.6%
4 (Sengoku.AI.Smart) | 13.7%
5 (Sengoku.AI.Smart) | 12.4%
6 (Sengoku.AI.Smart) | 12.3%
7 (Sengoku.AI.Smart) | 11.5%
8 (Sengoku.AI.Smart) | 12.8%
```
(With `mix ai.arena`, at least on the default `"westeros"` map, win percentages should be even within a few percentage points.)
5. Now change how `Sengoku.AI.Smarter` works! Continue running `mix ai.arena Sengoku.AI.Smarter` to test the impact of your changes against the default AI.
6. When you’ve made an improvement, merge your changes back into `Sengoku.AI.Smart` and consider opening a Pull Request with the improvements!