cf8bb24e71
Data (teams and prefs) are now always stored in localStorage in the `https://play.pokemonshowdown.com` origin. Data storage at a low level has been mostly rewritten for this, and moved to storage.js. Tools.prefs has been renamed Storage.prefs, although the API Tools.prefs(prefName) is still available, and recommended for battle.js (because storage.js isn't available in replays). All other pref functionality, such as setting prefs and saving prefs, should only be used in Storage.prefs. If the browser blocks third-party cookies in a detectable way, data is instead stored in the local origin. As a final safety measure, prefs/teams are mirrored in the local origin in case third-party cookies are blocked in an undetectable way. This refactor also replaces the 'init:loadprefs' and 'init:loadteams' events with a new load tracking system that's basically a simplified implementation of Promises, documented in the comments for Tools.makeLoadTracker().
Pokémon Showdown Client
Navigation: Website | Server repository | Client 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 everything necessary to run a full Pokémon Showdown client.
In particular, it doesn't include a login/authentication server, nor does it
include the database abstraction library used by the ladder library (although
it's similar enough to mysqli that you can use that with minimal changes).
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 to rewrite some things). 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.