Описание
# Pokémon Editor
Pokémon Editor is a server-authoritative in-game administration addon for Cobblemon. It includes two tools with deliberately different scopes:
- **Pokémon Editor** edits one wild, party, or PC Pokémon.
- **Pokémon Data Editor** edits the shared definition of an entire species across the server.
The addon is designed for server owners, modpack and datapack developers, map makers, content creators, tournaments, and custom challenge runs. It provides localized visual interfaces, server-side validation, permissions, and recoverable configuration instead of requiring direct save-file edits.
> This is an administrative tool. Operator access is required by default.
## Individual Pokémon editing
Use the regular item on a Pokémon entity or open an online player's party/PC Pokémon through `/pokemoneditor`.
### Editable data
**General**
- Species, nickname, level, and current HP
- Friendship and fullness
- Held item, held-item model visibility, and Poké Ball
**Stats**
- Nature and minted nature
- Tera type
- Dynamax level and Gigantamax factor
- Six IVs and six EVs with calculated totals
- Perfect-IV and clear-EV actions
**Moves and ability**
- Ability and hidden-ability state
- Four moves, current PP, and PP Ups
- Move ordering and PP restoration
- Acquisition-source labels for level-up, TM, tutor, egg, evolution, form-change, legacy, and special/event moves
- Optional illegal-move editing controlled by the server
**Appearance**
- Gender, shiny state, and Cobblemon 1.8 Alpha state
- Size from 0.50× to 2.00×
- Form, appearance/skin variant, and mark/title
- Visual form and skin gallery with live models
- Appearance reset
**Origin**
- Original Trainer name and UUID
- Caught location, date, and level
- Egg origin, traded state, and whether the Pokémon is tradeable
**Evolution**
- Registered evolution options and exact synchronized requirements
- Result preview with form/aspect details
- Direct one-step evolution
- Direct one-step rollback to the previous evolution
Evolution changes are applied by the server when saving and do not play the normal evolution animation.
**Tools**
- Named local presets with Full Data, Battle Build, and Appearance Only scopes
- Full JSON and Pokémon Showdown clipboard transfer
- Automatic JSON/Showdown import detection
- Perfect IV, clear EV, physical attacker, and special attacker quick builds
- Session reset and scheduled-evolution cancellation
- Undo, redo, and up to ten restorable history snapshots
Presets are stored locally at `config/pokemon_editor/presets.json`. Showdown import changes only the fields represented by the Showdown format.
## Review, validation, and recovery
Every save opens a grouped review with full before/after values. Any changed field can be restored before confirmation.
The confirmed edit is sent as one correlated request. The server resolves the target again, rechecks permission, validates the data, and returns a result. Duplicate submissions are blocked while waiting; a rejected save leaves the editor and draft open.
Local recovery copies are written to:
```text
config/pokemon_editor/recovery/
```
To recover one, copy its JSON contents, open the intended Pokémon, and use **Tools → Transfer → Import**. Review before saving because recovery files are not automatically applied and can become stale.
The interface supports Ctrl+Z/Ctrl+Y, change-review scrolling, adaptive scaling for smaller windows, searchable catalogs, localized labels, a rotatable model, type and gender badges, shiny preview, and an HP bar.
## Individual editor commands
Give the regular editor item:
```mcfunction
/give @s pokemon_editor:pokemon_editor
```
Use it directly on a wild or spawned Pokémon.
List clickable party and PC targets belonging to an online player:
```mcfunction
/pokemoneditor
```
Open a specific stored Pokémon:
```mcfunction
/pokemoneditor party
/pokemoneditor pc
```
PC box and slot numbers start at 1. The list displays the party and up to the first 60 occupied PC slots. Because this opens a client UI, `/pokemoneditor` must be run by an authorized in-game player.
## Species-wide Data Editor
Pokémon Editor 1.6.0 adds a separate glinting Data Editor item. Use it on a Pokémon to edit the shared species definition through a localized visual screen:
- Primary and optional secondary type
- Base HP, Attack, Defense, Special Attack, Special Defense, and Speed
- Live base-stat total
- Reset to underlying Cobblemon/datapack values
The type fields use scrollable dropdowns. Base stats accept values from 1 through 255.
> **Important:** these changes affect every Pokémon of the species, including existing Pokémon. Avoid changing species data during an active battle.
Give the item with:
```mcfunction
/give @s pokemon_editor:pokemon_data_editor
```
## Complete `/pokemondata` reference
Species IDs may use either `charizard` or `cobblemon:charizard`.
Change both types:
```mcfunction
/pokemondata set charizard types dragon fire
```
Remove the secondary type with `none`:
```mcfunction
/pokemondata set charizard types fire none
```
Change individual base stats:
```mcfunction
/pokemondata set charizard stat hp 90
/pokemondata set charizard stat attack 100
/pokemondata set charizard stat defence 90
/pokemondata set charizard stat special_attack 125
/pokemondata set charizard stat special_defence 95
/pokemondata set charizard stat speed 110
```
`defense` is accepted as an alias for `defence`. Special-stat aliases include `sp_attack`, `spa`, `sp_defence`, `sp_defense`, and `spd`.
Inspect the currently loaded overrides:
```mcfunction
/pokemondata list
```
Reload JSON files from disk, apply them, and synchronize connected clients:
```mcfunction
/pokemondata reload
```
Temporarily restore underlying values without deleting files, then reapply the stored overrides:
```mcfunction
/pokemondata disable
/pokemondata enable
```
The enabled state persists across restarts.
Reset one species:
```mcfunction
/pokemondata reset charizard
```
Request a permanent reset of every override:
```mcfunction
/pokemondata reset all
```
The server returns a one-time command such as the following, which must be used within 60 seconds:
```mcfunction
/pokemondata reset all confirm-1234
```
Export all current overrides or import a pack from the exports folder:
```mcfunction
/pokemondata export challenge-team
/pokemondata import challenge-team
```
The `.peditorpack` manifest, schema, paths, species, types, and stats are validated before installation. Entries contained in the imported pack replace the corresponding species overrides; other existing overrides remain in place.
## Override storage and priority
Species JSON patches:
```text
config/pokemon-editor/data-editor/species/
```
Portable `.peditorpack` files:
```text
config/pokemon-editor/data-editor/exports/
```
Effective priority:
1. Pokémon Editor Data Editor overrides
2. Ordinary datapacks in their configured order
3. Cobblemon's built-in data
No Cobblemon or datapack source file is rewritten. Resetting a patch restores the value underneath it. Overrides are reapplied after resource reloads and synchronized from the authoritative server to clients.
Custom forms with explicit type/stat definitions may keep their own form-specific values. Existing current HP may not be proportionally recalculated immediately after editing base HP.
## Server configuration
The first launch generates `config/pokemon_editor-server.properties`:
```properties
required_permission_level=2
allow_singleplayer_owner=true
audit_log=true
allow_illegal_moves=false
```
- `required_permission_level` — operator level 0–4 required for the items and `/pokemoneditor`.
- `allow_singleplayer_owner` — grants access to the integrated-server owner.
- `audit_log` — records successful edits and relevant access events in the server log.
- `allow_illegal_moves` — exposes all registered moves and permits the server to save moves outside the selected form's normal sources.
This is a separate addon configuration file, not Minecraft's `server.properties`. Restart the server after manually changing it. `/pokemondata` commands require permission level 2.
## Compatibility
| Component | Supported version |
| --- | --- |
| Minecraft | 1.21.1 |
| Cobblemon | 1.8.0 |
| NeoForge | 21.1.235+ |
| Fabric Loader | 0.18.4+ |
| Fabric API | 0.116.15+1.21.1 |
| Java | 21 |
| Languages | English, Russian, Ukrainian |
| Environment | Matching Pokémon Editor 1.6.0 build on client and server |
Install the correct Fabric or NeoForge JAR on both sides. Do not mix Pokémon Editor versions between the client and server.
Pokémon Editor is an unofficial Cobblemon addon and is not affiliated with or endorsed by the Cobblemon team, Mojang Studios, Microsoft, Nintendo, Game Freak, or The Pokémon Company.