Difference between revisions of "Savefile structure"

From Pokémon 3D Wiki
Jump to navigation Jump to search
(Updated to 0.59.2)
Line 1: Line 1:
Pokémon3D uses human-readable save file structure that everyone can open, read and edit it via any plain text editing software (like Notepad) easily. The game reads the save files when you choose save files via main menu, and writes a save file only when you perform the save feature.
Pokémon3D uses a save file structure that everyone can open, read and edit via any plain text editing software (like Notepad++) easily. The game reads the save files every time you enter the Main Menu from the title screen, and writes data to the save files when you use the save feature in the game menu.


Save files are located under a folder in directory Pokemon/Save. Usually the folder is the same name as the player name, but if you try to create a player name already existed it will have a number after it. (For example, choosing a name "Player" when a folder named "Player" already exists results in "Player0". Subsequent attempts results in "Player1", "Player2", and so on). Note that your player name is not determined by the folder name.
Save data is stored in separate folders under the "Save" folder, located where you've installed Pokémon 3D. Usually a save game folder has the same name as the name of the player, but if you try to create a player with a name that already exists, the folder will have a number after it.</br>(For example, choosing the name "Player" when a folder named "Player" already exists results in a folder named "Player0". Subsequent attempts result in "Player1", "Player2", and so on).</br>Note that your player name is not determined by the folder name.


As of 0.23, an autosave feature is added, which uses folder name "autosave". Everything else is the same. If you name a character "autosave", problem will occur to this feature.
In addition, three more files are located in the "Save" folder which contain settings that are shared betweeen save games.


In additon, three more files exists in Pokemon/Save folder.
Note: '''Edit save files at your own risk; if you're not careful you could make the game unplayable or the save files unreadable.''' It is recommended that you always back-up your save files before editing them.
 
Note: '''Edit savefile at your own risk; if you are uncareful you may make the save unwinnable or even unreadable.''' It is recommended that one always backup his/her save before doing so.


== File List ==
== File List ==
Line 16: Line 14:
! File
! File
! Data
! Data
|-
| [[achievements.dat]]
| Achievement that the player has acquired.
|-
|-
| [[Apricorns.dat]]
| [[Apricorns.dat]]
| Status of all apricorn trees.
| Status of Apricorn trees of which the Apricorn taken.
|-
|-
| [[Berries.dat]]
| [[Berries.dat]]
| Status of all berry trees.
| Status of Berries that have been planted.
|-
|-
| [[Box.dat]]
| [[Box.dat]]
| Your Pokemon boxes.
| The contents of your Pokémon Storage System boxes.
|-
| [[Daycare.dat]]
| Data of the Pokémon that you've dropped off at the Daycare.
|-
| [[HallOfFame.dat]]
| Contains up to 20 Hall of Fame entries (updates every time you defeat the Pokémon League).
|-
|-
| [[ItemData.dat]]
| [[ItemData.dat]]
| Items scattered around the maps that you have collected.
| List of items scattered around the maps that you have collected.
|-
|-
| [[Items.dat]]
| [[Items.dat]]
| Your inventory.
| The contents of your inventory/bag.
|-
|-
| [[NPC.dat]]
| [[NPC.dat]]
| How event NPCs and some event objects are manipulated.
| Contains NPCs and other entities that have been moved or removed at specific maps.
|-
|-
| [[Options.dat]]
| [[Options.dat]]
| Local options (in contrary to options.dat in base folder).
| Options specific to the player, contrary to the general Options.dat in the base "Save" folder.
|-
|-
| [[Party.dat]]
| [[Party.dat]]
Line 45: Line 46:
|-
|-
| [[Player.dat]]
| [[Player.dat]]
| Data related to gameplay.
| Save data related to gameplay and the player's properties.
|-
|-
| [[Pokedex.dat]]
| [[Pokedex.dat]]
| Pokedex record.
| Determines what Pokémon you've seen, caught and if you've caught a shiny version of that pokémon.
|-
|-
| [[Register.dat]]
| [[Register.dat]]
| Event flags.
| A list of text strings that the game uses to keep track of everything story and/or event related.
|-
| [[RoamingPokemon.dat]]
| Data about which Pokémon are currently roaming across the region.
|-
| [[SecretBase.dat]]
| Currently not used, but might be someday.
|-
| [[Statistics.dat]]
| Contains a list of things that a player has done or experienced, like the amount of steps, the amount of times certain HMs have been used etc.
|}
|}


=== Base Folder ===
=== Base "Save" Folder ===


{| class="wikitable"
{| class="wikitable"
Line 62: Line 72:
|-
|-
| [[Controls#Rebind_controls|Keyboard.dat]]
| [[Controls#Rebind_controls|Keyboard.dat]]
| Controls.
| Control bindings for the keyboard.
|-
|-
| [[options.dat]]
| [[Options.dat]]
| Global options.
| Options shared between save games.
|-
|-
| [[lastSession.id]]
| [[Server_List.dat]]
| Determine which save to load when you press the "Continue button" in main menu.
| Contains a list of all available servers.
|}
|}



Revision as of 19:14, 23 February 2023

Pokémon3D uses a save file structure that everyone can open, read and edit via any plain text editing software (like Notepad++) easily. The game reads the save files every time you enter the Main Menu from the title screen, and writes data to the save files when you use the save feature in the game menu.

Save data is stored in separate folders under the "Save" folder, located where you've installed Pokémon 3D. Usually a save game folder has the same name as the name of the player, but if you try to create a player with a name that already exists, the folder will have a number after it.
(For example, choosing the name "Player" when a folder named "Player" already exists results in a folder named "Player0". Subsequent attempts result in "Player1", "Player2", and so on).
Note that your player name is not determined by the folder name.

In addition, three more files are located in the "Save" folder which contain settings that are shared betweeen save games.

Note: Edit save files at your own risk; if you're not careful you could make the game unplayable or the save files unreadable. It is recommended that you always back-up your save files before editing them.

File List

Player Folders

File Data
Apricorns.dat Status of Apricorn trees of which the Apricorn taken.
Berries.dat Status of Berries that have been planted.
Box.dat The contents of your Pokémon Storage System boxes.
Daycare.dat Data of the Pokémon that you've dropped off at the Daycare.
HallOfFame.dat Contains up to 20 Hall of Fame entries (updates every time you defeat the Pokémon League).
ItemData.dat List of items scattered around the maps that you have collected.
Items.dat The contents of your inventory/bag.
NPC.dat Contains NPCs and other entities that have been moved or removed at specific maps.
Options.dat Options specific to the player, contrary to the general Options.dat in the base "Save" folder.
Party.dat Status of current Pokemons in your party.
Player.dat Save data related to gameplay and the player's properties.
Pokedex.dat Determines what Pokémon you've seen, caught and if you've caught a shiny version of that pokémon.
Register.dat A list of text strings that the game uses to keep track of everything story and/or event related.
RoamingPokemon.dat Data about which Pokémon are currently roaming across the region.
SecretBase.dat Currently not used, but might be someday.
Statistics.dat Contains a list of things that a player has done or experienced, like the amount of steps, the amount of times certain HMs have been used etc.

Base "Save" Folder

File Data
Keyboard.dat Control bindings for the keyboard.
Options.dat Options shared between save games.
Server_List.dat Contains a list of all available servers.



Development cycle | Version history | Future versions


Help | Controls | Launcher | Menu screen | Options | FAQ


Technical | Savefile structure | Game Mods | Content Packs