Document Sim.Teams for NPM package

This commit is contained in:
Guangcong Luo 2021-06-06 10:28:11 -05:00
parent 2bc1f032c1
commit da8f77ee4f

View File

@ -160,6 +160,46 @@ Packed format looks like this:
Articuno||leftovers|pressure|icebeam,hurricane,substitute,roost|Modest|252,,,252,4,||,,,30,30,|||]Ludicolo||lifeorb|swiftswim|surf,gigadrain,icebeam,raindance|Modest|4,,,252,,252|||||]Volbeat||damprock|prankster|tailglow,batonpass,encore,raindance|Bold|248,,252,,8,|M||||]Seismitoad||lifeorb|swiftswim|hydropump,earthpower,stealthrock,raindance|Modest|,,,252,4,252|||||]Alomomola||damprock|regenerator|wish,protect,toxic,raindance|Bold|252,,252,,4,|||||]Armaldo||leftovers|swiftswim|xscissor,stoneedge,aquatail,rapidspin|Adamant|128,252,4,,,124|||||
```
Converting between formats
--------------------------
API:
`Sim.Teams.unpack(packedTeam: string): PokemonSet[]`
- Converts a packed team to a JSON team
`Sim.Teams.pack(team: PokemonSet[]): string`
- Converts a JSON team to a packed team
`Sim.Teams.export(team: PokemonSet[]): string`
- Converts a JSON team to an export team
`Sim.Teams.exportSet(set: PokemonSet): string`
- Converts a JSON set to export format
`Sim.Teams.generate(format: Format | string, options?: {seed: number[4]}): PokemonSet`
- Generate a team for a random format
(Import is not available in this version; we'll add it to a future version.)
Example use:
```js
const Sim = require('pokemon-showdown');
console.log(JSON.stringify(Sim.Teams.unpack(
`Articuno||leftovers|pressure|icebeam,hurricane,substitute,roost|Modest|252,,,252,4,||,,,30,30,|||]Ludicolo||lifeorb|swiftswim|surf,gigadrain,icebeam,raindance|Modest|4,,,252,,252|||||]Volbeat||damprock|prankster|tailglow,batonpass,encore,raindance|Bold|248,,252,,8,|M||||]Seismitoad||lifeorb|swiftswim|hydropump,earthpower,stealthrock,raindance|Modest|,,,252,4,252|||||]Alomomola||damprock|regenerator|wish,protect,toxic,raindance|Bold|252,,252,,4,|||||]Armaldo||leftovers|swiftswim|xscissor,stoneedge,aquatail,rapidspin|Adamant|128,252,4,,,124|||||`
)));
// will log the team to console in JSON format
```
Team validator
--------------
@ -173,69 +213,11 @@ const Sim = require('pokemon-showdown');
const validator = new Sim.TeamValidator('gen6nu');
const output = validator.validateTeam([
{
"name": "",
"species": "Articuno",
"gender": "",
"item": "Leftovers",
"ability": "Pressure",
"evs": {"hp": 252, "atk": 0, "def": 0, "spa": 252, "spd": 4, "spe": 0},
"nature": "Modest",
"ivs": {"hp": 31, "atk": 31, "def": 31, "spa": 30, "spd": 30, "spe": 31},
"moves": ["Ice Beam", "Hurricane", "Substitute", "Roost"]
},
{
"name": "",
"species": "Ludicolo",
"gender": "",
"item": "Life Orb",
"ability": "Swift Swim",
"evs": {"hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252},
"nature": "Modest",
"moves": ["Surf", "Giga Drain", "Ice Beam", "Rain Dance"]
},
{
"name": "",
"species": "Volbeat",
"gender": "M",
"item": "Damp Rock",
"ability": "Prankster",
"evs": {"hp": 248, "atk": 0, "def": 252, "spa": 0, "spd": 8, "spe": 0},
"nature": "Bold",
"moves": ["Tail Glow", "Baton Pass", "Encore", "Rain Dance"]
},
{
"name": "",
"species": "Seismitoad",
"gender": "",
"item": "Life Orb",
"ability": "Swift Swim",
"evs": {"hp": 0, "atk": 0, "def": 0, "spa": 252, "spd": 4, "spe": 252},
"nature": "Modest",
"moves": ["Hydro Pump", "Earth Power", "Stealth Rock", "Rain Dance"]
},
{
"name": "",
"species": "Alomomola",
"gender": "",
"item": "Damp Rock",
"ability": "Regenerator",
"evs": {"hp": 252, "atk": 0, "def": 252, "spa": 0, "spd": 4, "spe": 0},
"nature": "Bold",
"moves": ["Wish", "Protect", "Toxic", "Rain Dance"]
},
{
"name": "",
"species": "Armaldo",
"gender": "",
"item": "Leftovers",
"ability": "Swift Swim",
"evs": {"hp": 128, "atk": 252, "def": 4, "spa": 0, "spd": 0, "spe": 124},
"nature": "Adamant",
"moves": ["X-Scissor", "Stone Edge", "Aqua Tail", "Rapid Spin"]
}
]);
const output = validator.validateTeam(
Sim.Teams.unpack(
`Articuno||leftovers|pressure|icebeam,hurricane,substitute,roost|Modest|252,,,252,4,||,,,30,30,|||]Ludicolo||lifeorb|swiftswim|surf,gigadrain,icebeam,raindance|Modest|4,,,252,,252|||||]Volbeat||damprock|prankster|tailglow,batonpass,encore,raindance|Bold|248,,252,,8,|M||||]Seismitoad||lifeorb|swiftswim|hydropump,earthpower,stealthrock,raindance|Modest|,,,252,4,252|||||]Alomomola||damprock|regenerator|wish,protect,toxic,raindance|Bold|252,,252,,4,|||||]Armaldo||leftovers|swiftswim|xscissor,stoneedge,aquatail,rapidspin|Adamant|128,252,4,,,124|||||`
)
);
```
`output` will be an array of problems, if it's not a legal team, or `null`, if it's a legal team.