For too long, ntbb-session and ntbb-database have been maintained outside of this repo, but no longer! All these files are now part of the repository, making it significantly more self-contained. If I had to say why it took this long, I think it was mostly inertia. It was easier leaving them where they were than having to audit them for private keys in the wrong places, etc. I'm starting to think of PS more as sim first, website secondary than the other way around, now. Especially now that we don't have a forum, the website itself isn't really important... Maybe one day I'll get rid of the landing page and make the sim itself the first thing you see when you hit pokemonshowdown.com... but today is not that day! The repo is still not "batteries-included" since I am not going to teach anyone how to set up PHP and MySQL or even get the config files working. But for anyone who wanted their own client, well, it gets a lot easier to do now. |
||
|---|---|---|
| config | ||
| data | ||
| desktop | ||
| fx | ||
| githooks | ||
| graphics-src | ||
| js | ||
| lib | ||
| style | ||
| swf | ||
| .eslintignore | ||
| .eslintrc.js | ||
| .gitignore | ||
| .htaccess | ||
| .travis.yml | ||
| action.php | ||
| apple-touch-icon.png | ||
| cache.manifest | ||
| crossdomain.php | ||
| crossprotocol.html | ||
| customcss.php | ||
| favicon-16.png | ||
| favicon-32.png | ||
| favicon-48.png | ||
| favicon-128.png | ||
| favicon-256.png | ||
| favicon-notify.ico | ||
| favicon.ico | ||
| index.template.html | ||
| ladder.php | ||
| news-embed.php | ||
| package.json | ||
| pokemonshowdown.png | ||
| pokemonshowdown.psd | ||
| pokemonshowdownbeta.png | ||
| pokemonshowdownbeta@2x.png | ||
| README.md | ||
| robots.txt | ||
| showdown.crx | ||
| showdown.webapp | ||
| testclient.html | ||
Pokémon Showdown Client
Navigation: Website | Server repository | Client repository | Dex repository
Introduction
This is a repository for most of the client code for Pokémon Showdown.
This is what runs play.pokemonshowdown.com.
WARNING: You probably want the Pokémon Showdown server, if you're setting up a server.
Testing
You can make and test client changes simply by opening testclient.html.
This will allow you to test changes to the client without setting up your
own login server.
You can connect to an arbitrary server by navigating to
testclient.html?~~host:port. For example, to connect to a server running
locally on port 8000, you can navigate to testclient.html?~~localhost:8000.
The following things will fail in testclient.html:
- Registering
- Changing name to a registered name other than the one you are currently logged in with (however, changing to an unregistered name will work, and you can even change back to your original registered name afterward)
Everything else can be tested, though.
Warning
This repository is not "batteries included". It does NOT include instructions to run a full Pokémon Showdown client, and we will not provide them. Please do not ask for help on this; you will be turned away.
It also doesn't include several resource files (namely, the /audio/ and
/sprites/ directories) for size reasons.
In other words, this repository is incomplete and NOT intended for people who wish to serve their own Pokémon Showdown client (you can, but it'll require you figure it out yourself). Rather, it's intended for people who wish to contribute and submit pull requests to Pokémon Showdown's client.
License
Pokémon Showdown's client is distributed under the terms of the AGPLv3.
WARNING: This is NOT the same license as Pokémon Showdown's server.