---
title: Managing Pixelmon Player Data and Pokémon Storage
description: "Learn what every setting in Pixelmon's storage.yml controls. This guide explains PC box limits, Pokémon and world data saving, asynchronous storage options, and other settings that affect how your Pixelmon server stores player and world data."
source: "https://nodecraft.com/support/games/minecraft/mods/pixelmon/managing-pixelmon-player-data-and-pokemon-storage"
image: "https://dynamic-assets.nodecraft.com/signedurl/w7vokBAexMnVlnMZ1Q/image.jpg?modifications=W3sibmFtZSI6ImdhbWVfYmciLCJpbWFnZV91cmwiOiJodHRwczovL2Ntcy1hLm5vZGVjcmFmdC5jb20vZi8xMzM5MzIvMjAwMHg1NTAvZGNiMGFkNjkzOC9jYXZlcy1hbmQtY2xpZmZzLXB0LTItMS0yLTAucG5nL20vIn0seyJuYW1lIjoiZ2FtZV9sb2dvIiwiaW1hZ2VfdXJsIjoiaHR0cHM6Ly9jbXMtYS5ub2RlY3JhZnQuY29tL2YvMTMzOTMyLzM3NXgxNTAvM2MxZGIyYmFiNS9taW5lY3JhZnQucG5nL20vIn0seyJuYW1lIjoiY3RhX3RleHQiLCJ0ZXh0IjoiQ3JlYXRlIHlvdXIgb3duIHNlcnZlciEifSx7Im5hbWUiOiJ0ZXh0IiwidGV4dCI6Ik1hbmFnaW5nIFBpeGVsbW9uIFBsYXllciBEYXRhIGFuZCBQb2vDqW1vbiBTdG9yYWdlIn1d&s=a3438f51cdec8acf58070928136a16de6a448922b583f42fc3d73f73491f5d8a"
published: "2026-08-12T17:20:22.113Z"
updated: "2026-08-12T17:20:22.113Z"
---

# Managing Pixelmon Player Data and Pokémon Storage

Learn what every setting in Pixelmon's storage.yml controls. This guide explains PC box limits, Pokémon and world data saving, asynchronous storage options, and other settings that affect how your Pixelmon server stores player and world data.

The Storage section controls how Pixelmon stores player Pokémon data, world entities, and PC contents. These options determine how many PC boxes players can access, which data is written during world saves, and how frequently queued party and PC data is saved to disk.

## Pixelmon Storage Settings

The settings below are listed in the same order as they appear in storage.yml. Three options are Boolean values, while the PC box count and asynchronous save interval use whole numbers. The Setting column shows a reader-friendly name first, followed by the matching storage.yml key for reference.

| Setting and Config Key | Default and Accepted Values | Description |
| --- | --- | --- |
| Number of PC Boxes computer-boxes | Default: 30 Values: Whole number | Sets the number of PC storage boxes available to each player. Increasing this value gives players more space to store Pokémon. |
| Save Pixelmon Entities With the World write-entities-to-world | Default: false Values: true or false | Controls whether naturally spawning Pokémon, NPC Trainers, and other Pixelmon entities are saved with the world. Enabling it increases the world save size and can make world saves take longer. |
| Save Player Pokémon Data With World Saves data-save-on-world-save | Default: true Values: true or false | Controls whether player Pokémon data is saved whenever the world is saved. When disabled, player Pokémon data must be saved manually. |
| Use Asynchronous Saving use-async-saving | Default: true Values: true or false | Controls whether party and PC data are saved off the server's main thread. Enabling it moves those save operations away from gameplay processing. |
| Asynchronous Save Interval async-interval | Default: 60 Values: Whole number of seconds | Sets how often, in seconds, the asynchronous saver writes queued party and PC data to disk. This setting applies when asynchronous saving is enabled. |

## Important Storage Setting Notes

### PC Box Capacity

The computer-boxes setting controls how many PC boxes each player can access. Raising this value provides more room for stored Pokémon, while lowering it gives players less available storage.

### World and Pokémon Data Saving

The write-entities-to-world and data-save-on-world-save settings protect different data. The first controls Pixelmon entities stored with the world, while the second controls player Pokémon data. Disabling player Pokémon saves requires a reliable manual saving process.

### Asynchronous Saving

- The use-async-saving option moves party and PC saving off the server's main thread.
- The async-interval option controls how many seconds pass between writes of queued data.
- The interval only affects the asynchronous saver while use-async-saving is enabled.

## Final Thoughts

Pixelmon's storage settings directly affect PC capacity and how Pokémon data reaches disk. Keep a current backup before changing save-related options, and avoid disabling automatic Pokémon saves unless you have a dependable manual process in place.
