phaser/README.md

179 lines
11 KiB
Markdown
Raw Normal View History

2016-06-16 11:33:09 +00:00
# Phaser - HTML5 Game Framework
2015-01-05 16:30:22 +00:00
2018-02-13 05:25:25 +00:00
![Phaser Header](https://phaser.io/images/github/300/phaser-header.png "Phaser 3 Header Banner")
2015-01-06 02:26:03 +00:00
2018-02-13 05:25:25 +00:00
Phaser is a fast, free, and fun open source HTML5 game framework. It offers WebGL and Canvas rendering across desktop and mobile web browsers. Games can be compiled to iOS, Android and native apps via 3rd party tools. You can use JavaScript or TypeScript for development.
Phaser is available in two versions: Phaser 3 and the [Phaser CE - The Community Edition](https://github.com/photonstorm/phaser-ce). Phaser CE is a community-lead continuation of the Phaser v2 codebase. Phaser 3 is the bleeding-edge next generation of the Phaser framework.
2015-01-05 16:30:22 +00:00
2016-06-16 11:22:42 +00:00
Along with the fantastic open source community, Phaser is actively developed and maintained by [Photon Storm](http://www.photonstorm.com). As a result of rapid support, and a developer friendly API, Phaser is currently one of the [most starred](https://github.com/showcases/javascript-game-engines) game frameworks on GitHub.
2015-01-06 05:47:51 +00:00
Thousands of developers worldwide use Phaser. From indies and multi-national digital agencies, to schools and Universities. Each creating their own incredible [games](https://phaser.io/games/).
2015-01-06 06:20:46 +00:00
2018-02-13 05:25:25 +00:00
**Visit:** The [Phaser website](https://phaser.io) and follow on [Twitter](https://twitter.com/phaser_) (#phaserjs)<br />
**Learn:** [API Docs](https://phaser.io/docs), [Support Forum][forum] and [StackOverflow](https://stackoverflow.com/questions/tagged/phaser-framework)<br />
**Code:** 700+ [Examples](https://phaser.io/examples) (source available in this [repo][examples])<br />
2016-06-16 13:31:26 +00:00
**Read:** Weekly [Phaser World](#newsletter) Newsletter<br />
**Chat:** [Slack](https://phaser.io/community/slack) and [Discord](https://phaser.io/community/discord)<br />
**Extend:** With [Phaser Plugins](https://phaser.io/shop/plugins)<br />
2016-06-16 11:40:04 +00:00
**Be awesome:** [Support](#support) the future of Phaser<br />
2015-01-05 16:30:22 +00:00
2016-06-16 11:40:04 +00:00
Grab the source and join in the fun!
2016-06-16 11:33:09 +00:00
![What's New](https://phaser.io/images/github/div-whats-new.png "What's New")
2015-01-05 21:26:59 +00:00
<div align="center"><img src="https://phaser.io/images/github/news.jpg"></div>
2015-01-06 02:26:03 +00:00
2018-02-13 05:25:25 +00:00
> 12th February 2018
After 1.5 years in the making, tens of thousands of lines of code, hundreds of examples and countless hours of relentless work: Phaser 3 is finally out and it has been a real labor of love.
2018-02-13 05:25:25 +00:00
Please understand this is a bleeding-edge and brand new release. There are features we've had to leave out, areas of the documentation that need completing and so many cool new things we wanted to add. But we had to draw a line in the sand somewhere and 3.0.0 represents that.
2016-07-11 09:07:56 +00:00
2018-02-13 05:25:25 +00:00
For us this is just the start of a new chapter in Phaser's life. We will be jumping on bug reports as quickly as we can and releasing new versions rapidly. We've structured v3 in such a way that we can push out point releases as fast needed.
2018-02-13 05:25:25 +00:00
We will continue to publish our [Dev Logs](https://phaser.io/phaser3/devlog) in our weekly newsletter [Phaser World](https://phaser.io/community/newsletter) so please subscribe to stay in touch and get all the latest news from us and the wider Phaser community.
2018-02-13 05:25:25 +00:00
You can also follow Phaser on [Twitter](https://twitter.com/photonstorm) and chat with fellow devs in our [Slack](https://phaser.io/community/slack) and [Discord](https://phaser.io/community/discord) channels.
2016-06-17 00:11:24 +00:00
2018-02-13 05:25:25 +00:00
Phaser 3 wouldn't have been possible without the fantastic support of the community and Patreon. Thank you to everyone who supports our development, who shares our belief in the future of HTML5 gaming, and Phasers role in that.
2015-03-26 02:22:05 +00:00
Happy coding everyone!
2015-03-26 02:10:57 +00:00
2015-03-26 02:22:05 +00:00
Cheers,
2015-03-26 02:10:57 +00:00
2015-03-26 02:37:31 +00:00
Rich - [@photonstorm](https://twitter.com/photonstorm)
![boogie](https://www.phaser.io/images/spacedancer.gif)
2013-05-16 01:36:58 +00:00
![Support Phaser](https://phaser.io/images/github/div-support-phaser.png "Support Phaser")
2015-07-29 14:01:04 +00:00
2018-02-13 05:25:25 +00:00
Developing Phaser takes a lot of time, effort and money. There are monthly running costs as well as countless hours of development time, community support, and assistance resolving issues.
2016-06-16 11:14:27 +00:00
2018-02-13 05:25:25 +00:00
If you have found Phaser useful in your development life or have made income as a result of it please support our work via:
2016-06-16 11:14:27 +00:00
2018-02-13 05:25:25 +00:00
* A monthly contribution on [Patreon](https://www.patreon.com/photonstorm).
* A [one-off donation](https://phaser.io/community/donate) with PayPal.
* Purchase any of our [plugins or books](https://phaser.io/shop).
2018-02-13 05:25:25 +00:00
It all helps and genuinely contributes towards future development.
2018-02-13 05:25:25 +00:00
Extra special thanks to our top-tier sponsors: [Orange Games](http://orangegames.com) and [CrossInstall](https://crossinstall.com).
2018-02-13 05:25:25 +00:00
![Sponsors](https://phaser.io/images/github/patreon-sponsors-2018-1.png "Top Patreon Sponsors")
2016-06-16 11:14:27 +00:00
![Weekly Newsletter](https://phaser.io/images/github/div-newsletter.png "Weekly Newsletter")
2016-02-17 13:27:09 +00:00
<div align="center"><img src="https://phaser.io/images/github/phaser-world.png"></div>
2016-02-17 13:27:09 +00:00
Every Monday we publish the [Phaser World](https://phaser.io/community/newsletter) newsletter. It's packed full of the latest Phaser games, tutorials, videos, meet-ups, talks, and more. It also contains our weekly Development Progress updates, where you can read about what new features we've been working on.
2016-06-16 11:14:27 +00:00
2018-02-13 05:25:25 +00:00
Over 100 previous editions can found on our [Back Issues](http://phaser.io/community/backissues) page.
2016-02-17 13:27:09 +00:00
![Download Phaser](https://phaser.io/images/github/div-download.png "Download Phaser")
2015-03-26 02:10:57 +00:00
<a name="download"></a>
2018-02-13 05:25:25 +00:00
Phaser 3 is available via GitHub, npm and CDNs:
2015-03-26 02:10:57 +00:00
* Clone the git repository via [https][clone-http], [ssh][clone-ssh] or with the Github [Windows][clone-ghwin] or [Mac][clone-ghmac] clients.
2018-02-13 05:25:25 +00:00
* Download as [zip](https://github.com/photonstorm/phaser/archive/master.zip)
* Download the build files: [phaser.js][get-js] and [phaser.min.js][get-minjs]
### NPM
2015-03-26 02:10:57 +00:00
2018-02-13 05:25:25 +00:00
Install via [npm](https://www.npmjs.com):
2018-02-13 05:25:25 +00:00
```bash
npm install phaser
```
### CDN
2015-03-26 02:10:57 +00:00
2018-02-13 05:25:25 +00:00
[Phaser is on jsDelivr](http://www.jsdelivr.com/projects/phaser), a "super-fast CDN for developers". Include the following in your html:
```html
<script src="//cdn.jsdelivr.net/npm/phaser@3.0.0/dist/phaser.js"></script>
```
or the minified version:
```html
<script src="//cdn.jsdelivr.net/npm/phaser@3.0.0"></script>
```
2015-03-26 02:10:57 +00:00
### License
Phaser is released under the [MIT License](https://opensource.org/licenses/MIT).
2015-03-26 02:10:57 +00:00
![Getting Started](https://phaser.io/images/github/div-getting-started.png "Getting Started")
2015-03-26 02:10:57 +00:00
<a name="getting-started"></a>
<img src="https://phaser.io/images/github/learn.jpg" align="right">
2015-03-26 02:10:57 +00:00
2018-02-13 05:25:25 +00:00
Phaser 3 is so brand new the paint is still wet. As such we don't yet have any guides or tutorials! This will change in the coming weeks and we'll update this area as they emerge. For now, please subscribe to the [Phaser World](https://phaser.io/community/newsletter) newsletter as we'll publish them in there first.
2016-03-01 23:24:43 +00:00
2015-03-26 02:10:57 +00:00
### Source Code Examples
2018-02-13 05:25:25 +00:00
During our development of Phaser 3 we created hundreds of examples, with the full source code and assets available. Until these are fully integrated with the Phaser web site you can browser them in the [Phaser 3 Labs](http://labs.phaser.io), or clone the [examples repo][examples]. Note: Not all examples work, sorry! We're tidying them up as fast as we can.
2015-03-26 02:10:57 +00:00
![Building Phaser](https://phaser.io/images/github/div-building-phaser.png "Building Phaser")
2015-03-26 02:10:57 +00:00
2018-02-13 05:25:25 +00:00
Phaser is provided ready compiled in the `dist` folder of the repository. There are both plain and minified versions. The plain version is for use during development, and the minified version for production. You can also create your own builds.
2015-03-26 02:10:57 +00:00
### Custom Builds
2018-02-13 05:25:25 +00:00
Phaser 3 has to be built using Webpack. We take advantage of a number of Webpack features and plugins to allow us to properly tailor the build process. You can also elect exactly which features are bundled into your version of Phaser. We will release a tutorial covering the process shortly, but for now please look at our webpack config files to get an idea of the settings required.
2015-03-26 02:10:57 +00:00
### Building from source
2018-02-13 05:25:25 +00:00
Should you wish to build Phaser 3 from source ensure you have the required packages by cloning the repository and then running `npm install`.
2015-03-26 02:10:57 +00:00
2018-02-13 05:25:25 +00:00
You can then run `webpack` to perform a dev build to the `build` folder, including source maps for local testing, or run `npm run dist` to create a minified packaged build into the `dist` folder.
2015-03-26 02:10:57 +00:00
![Change Log](https://phaser.io/images/github/div-change-log.png "Change Log")
2013-09-15 19:45:00 +00:00
2018-02-13 05:25:25 +00:00
We have always been meticulous in recording changes to the Phaser code base, and where relevant, giving attribution to those in the community who helped. This is something we'll continue with Phaser 3 and you'll see this section expand as we push through the 3.0.0 releases.
2018-02-13 05:25:25 +00:00
Looking for a v2 change? Check out the [Phaser CE Change Log](https://github.com/photonstorm/phaser-ce/blob/master/CHANGELOG.md)
2015-01-05 21:26:59 +00:00
![Contributing](https://phaser.io/images/github/div-contributing.png "Contributing")
<a name="contributing"></a>
2013-04-12 16:19:56 +00:00
The [Contributors Guide][contribute] contains full details on how to help with Phaser development. The main points are:
2013-04-12 16:19:56 +00:00
- Found a bug? Report it on [GitHub Issues][issues] and include a code sample. Please state which version of Phaser you are using! This is vitally important.
2013-04-12 16:19:56 +00:00
2018-02-13 05:25:25 +00:00
- Before submitting a Pull Request run your code through [ES Lint](https://eslint.org/) using our [config](https://github.com/photonstorm/phaser/blob/master/.eslintrc.json) and respect our [Editor Config](https://github.com/photonstorm/phaser/blob/master/.editorconfig).
2018-02-13 05:25:25 +00:00
- Before contributing read the [code of conduct](https://github.com/photonstorm/phaser/blob/master/.github/CODE_OF_CONDUCT.md).
2015-01-03 01:31:42 +00:00
Written something cool in Phaser? Please tell us about it in the [forum][forum], or email support@phaser.io
2013-04-12 16:19:56 +00:00
![Created by](https://phaser.io/images/github/div-created-by.png "Created by")
2013-04-12 16:38:44 +00:00
Phaser is a [Photon Storm](http://www.photonstorm.com) production.
![storm](https://www.phaser.io/images/github/photonstorm-x2.png)
2013-04-12 16:19:56 +00:00
2015-01-06 06:56:59 +00:00
Created by [Richard Davey](mailto:rich@photonstorm.com). Powered by coffee, anime, pixels and love.
2015-01-06 06:20:46 +00:00
2018-01-09 22:27:14 +00:00
The Phaser logo and characters are &copy; 2018 Photon Storm Limited.
2015-01-06 06:20:46 +00:00
2015-01-06 05:47:51 +00:00
All rights reserved.
2013-04-12 16:19:56 +00:00
"Above all, video games are meant to be just one thing: fun. Fun for everyone." - Satoru Iwata
2015-01-05 21:26:59 +00:00
[![Analytics](https://ga-beacon.appspot.com/UA-44006568-2/phaser/index)](https://github.com/igrigorik/ga-beacon)
2018-02-13 05:25:25 +00:00
[get-js]: https://github.com/photonstorm/phaser/releases/download/v3.0.0/phaser.js
[get-minjs]: https://github.com/photonstorm/phaser/releases/download/v3.0.0/phaser.min.js
2015-01-05 21:26:59 +00:00
[clone-http]: https://github.com/photonstorm/phaser.git
[clone-ssh]: git@github.com:photonstorm/phaser.git
2015-01-06 01:55:27 +00:00
[clone-ghwin]: github-windows://openRepo/https://github.com/photonstorm/phaser
[clone-ghmac]: github-mac://openRepo/https://github.com/photonstorm/phaser
2015-01-05 21:26:59 +00:00
[phaser]: https://github.com/photonstorm/phaser
2014-01-08 01:53:28 +00:00
[issues]: https://github.com/photonstorm/phaser/issues
2018-02-13 05:25:25 +00:00
[examples]: https://github.com/photonstorm/phaser3-examples
2016-05-07 04:43:13 +00:00
[contribute]: https://github.com/photonstorm/phaser/blob/master/.github/CONTRIBUTING.md
2014-01-08 01:53:28 +00:00
[forum]: http://www.html5gamedevs.com/forum/14-phaser/