Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rlesur/rcade
Games to procrastinate with RStudio
https://github.com/rlesur/rcade
games html5 r rstats rstudio
Last synced: about 1 month ago
JSON representation
Games to procrastinate with RStudio
- Host: GitHub
- URL: https://github.com/rlesur/rcade
- Owner: RLesur
- Created: 2018-04-06T01:31:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-07-03T20:36:28.000Z (over 6 years ago)
- Last Synced: 2024-08-06T03:04:35.729Z (5 months ago)
- Topics: games, html5, r, rstats, rstudio
- Language: R
- Homepage:
- Size: 14.7 MB
- Stars: 167
- Watchers: 8
- Forks: 18
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Rcade
The goal of `Rcade` is to provide access to games in order to waste some times in RStudio. You can play 2048, Tetris, Mario, Pacman, Spider Solitaire and others.
## Installation
This package will never be released on CRAN.
You can install the development version from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github('RLesur/Rcade')
```
## Usage
### List available games
``` r
Rcade::games
```
### Play a game
The first time you launch a game, you will be asked for installation.
Playing a game is quite easy. Here are some examples:
``` r
Rcade::games$`2048`
```
``` r
Rcade::games$Pacman
```
## Motivation
*I always read the `Motivation` section first. Packages should always have a `Motivation` section in their `README` files.*
So, what is the motivation behind this useless package?
My first motivation was to test the RStudio viewer and I had this stupid idea to try some `HTML5` games. Why? I don't know.
Some folks loved the idea of playing in RStudio. So, I took some times to develop this package. That's all.
## How to contribute
### Try a new game
There are hundreds of `HTML5` games on [GitHub](https://github.com/). You can try a new game with the non exported `R6` constructor `Rcade:::HTML5Game`.
Here's an example with the following repo: https://github.com/Zolmeister/pond
``` r
Pond <- Rcade:::HTML5Game$new(name = "pond",
github = "Zolmeister/pond",
need_servr = FALSE,
path = "index.html")
```
Therefore, you can try to launch the game with:
``` r
Pond
```
If you get some troubles with a game, you may try with a `HTTP` server:
``` r
Pond$play(TRUE)
```
### Do a pull request
Games metadata are stored in [`games.yml` file](https://github.com/RLesur/Rcade/blob/master/inst/games/games.yml) (under `inst/games` directory). You only have to add extra games to this file. Here's [an example](https://github.com/RLesur/Rcade/pull/2/files).
## Credits
This package includes some non exported functions of the [`webshot` package](https://github.com/wch/webshot).
`webshot` package author: Winston Chang
`webshot` package contributors: Yihui Xie, Francois Guillem, Barret Schloerke
License: GPL-2