Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nuxy/aurelia-slot-machine-gen
:file_folder: The / slot-machine-gen / plugin Aurelia component wrapper.
https://github.com/nuxy/aurelia-slot-machine-gen
3d-cylinder aureliajs components games slots wrapper-library
Last synced: 5 days ago
JSON representation
:file_folder: The / slot-machine-gen / plugin Aurelia component wrapper.
- Host: GitHub
- URL: https://github.com/nuxy/aurelia-slot-machine-gen
- Owner: nuxy
- License: mit
- Created: 2024-03-19T23:08:34.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-07-20T20:40:46.000Z (4 months ago)
- Last Synced: 2024-11-13T16:25:06.083Z (7 days ago)
- Topics: 3d-cylinder, aureliajs, components, games, slots, wrapper-library
- Language: JavaScript
- Homepage: https://slot-machine-gen.nuxy.dev
- Size: 109 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Aurelia Slot Machine Generator
[](https://badge.fury.io/js/aurelia-slot-machine-gen) [](https://www.npmjs.com/package/aurelia-slot-machine-gen) [](https://packagephobia.com/result?p=aurelia-slot-machine-gen) [](https://github.com/nuxy/aurelia-slot-machine-gen/releases)
Create an extremely biased, web-based slot machine game.
## Features
- Faux-panoramic reel animations (without ``)
- Support for single/multi-line reels and pay-lines.
- Pseudo-random selections by configured weight.
- Configurable RNG (to make it less biased)
- Configurable sound clips for reel animations.
- Easy to set-up and customize.
Checkout the [demo](https://nuxy.github.io/slot-machine-gen) for examples of use.
## Dependencies
- [Node.js](https://nodejs.org)
## Installation
Add to an existing [Aurelia](https://aurelia.io) project using [YARN](https://yarnpkg.com).
$ yarn add aurelia-slot-machine-gen
## Usage
### `main.js`
```javascript
const {PLATFORM} = 'aurelia-framework';
export async function configure(aurelia) {
aurelia.use
.standardConfiguration()
.globalResources([
PLATFORM.moduleName('aurelia-slot-machine-gen')
]);
```
### Model
```javascript
const reels = [
{
imageSrc: 'path/to/image.png',
symbols: [
{
title: 'cherry',
position: 100,
weight: 2
},
{
title: 'plum',
position: 300,
weight: 6
},
{
title: 'orange',
position: 500,
weight: 5
},
{
title: 'bell',
position: 700,
weight: 1
},
{
title: 'cherry',
position: 900,
weight: 3
},
{
title: 'plum',
position: 1100,
weight: 5
}
}
},
// add more reels ...
];
export class App {
constructor() {
this.reels = reels;
}
playEvent() {
this.play = !this.play;
}
}
```
### View
```html
```
## Component Props
| Name | Type | Description |
|----------|----------|---------------------------|
| reels | Array | Symbols configuration. |
| play | Boolean | Spins the reels if `true` |
| callback | Function | Returns winning symbols. |
| options | Object | Override game [defaults](https://github.com/nuxy/slot-machine-gen#reels-configuration). |
## Documentation
- [Methods](https://github.com/nuxy/slot-machine-gen#methods)
- [Reels configuration](https://github.com/nuxy/slot-machine-gen#reels-configuration)
- [Game options](https://github.com/nuxy/slot-machine-gen#game-options)
- [Callback](https://github.com/nuxy/slot-machine-gen#callback)
- [Customizing symbols](https://github.com/nuxy/slot-machine-gen#customizing-symbols)
## Developers
### CLI options
Run [ESLint](https://eslint.org) on project sources:
$ npm run lint
Transpile ES6 sources (using [Babel](https://babeljs.io)) and minify to a distribution:
$ npm run build
Bundle [demo](https://github.com/nuxy/aurelia-slot-machine-gen/tree/master/demo) sources (using [Webpack](https://webpack.js.org)):
$ npm run webpack
## Contributions
If you fix a bug, or have a code you want to contribute, please send a pull-request with your changes. (Note: Before committing your code please ensure that you are following the [Node.js style guide](https://github.com/felixge/node-style-guide))
## Versioning
This package is maintained under the [Semantic Versioning](https://semver.org) guidelines.
## License and Warranty
This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.
_aurelia-slot-machine-gen_ is provided under the terms of the [MIT license](http://www.opensource.org/licenses/mit-license.php)
## Author
[Marc S. Brooks](https://github.com/nuxy)