Skip to content

System Files

While Easter Eggs provides several configuration files for customization, it also manages internal data files that act as the plugin’s “memory.” These files are structured specifically for machine reading and high-speed data access.


File PathPrimary FunctionManagement Method
locations.ymlStores the precise location of every placed Easter Egg in the world.Managed via /eastereggs commands and menu.
data.ymlStores individual player statistics (collected eggs).Used only when database: flat is selected.


This is the most critical system file for your world setup. It contains the exact coordinate, world name, and assigned ID for every single Easter Egg you have placed on your server.

  • Why you shouldn’t touch it: A single missing comma or an incorrectly formatted coordinate will prevent the eggs from loading properly, meaning players won’t be able to find or interact with them.
  • How to update: Always place the eggs physically in-game, and use the /eastereggs removeall command or the /eastereggs menu interface to delete locations safely.

When your server is configured to use the flat database mode, all player statistics and their collection progress are recorded here.

  • Why you shouldn’t touch it: The plugin keeps a live cache of player data in the server’s memory to maintain high performance. If you modify this file while the server is running, the plugin will eventually overwrite your changes with its own cached data, causing your manual edits to be lost forever.
  • How to update: If you absolutely must edit this file manually, you must shut down the server completely first. After the server is offline, you can make your changes and then start it back up. Alternatively, use the /eastereggs resetstats command to manage player data safely while the server is running.