File Structure

Understanding the server file structure helps you manage mods, worlds, and configuration.

Server Directory

Path	Description
`.cache/`	Cache for optimized files
`logs/`	Server log files
`mods/`	Installed mods (packs and plugins)
`universe/`	World and player save data
`bans.json`	Banned players
`config.json`	Server configuration
`permissions.json`	Permission configuration
`whitelist.json`	Whitelisted players

Mods Folder

Place your mods in the mods/ folder:

Packs - .zip files containing data assets
Plugins - .jar files (Java plugins)

Both types coexist in the same folder.

Universe Structure

The universe/ directory contains all world data:

universe/
└── worlds/
    ├── world1/
    │   ├── config.json
    │   └── [chunk data]
    └── world2/
        ├── config.json
        └── [chunk data]

World Threading

Each world runs on its own main thread and off-loads parallel work into a shared thread pool. This means:

Multiple worlds can run simultaneously
Each world’s performance is somewhat isolated
Heavy operations in one world won’t completely block others

Cache Directory

The .cache/ directory stores:

Optimized asset files
Pre-compiled data

You can safely delete this folder to force regeneration, though it may increase startup time.

Log Files

Server logs are stored in logs/:

Review for errors and warnings
Debug plugin issues
Track player activity

Backup Recommendations

Important directories to backup:

Priority	Path	Contents
Critical	`universe/`	All world and player data
Important	`mods/`	Your installed mods
Important	`*.json`	Server configuration