---
title: "Minecraft Server Files Explained: Properties and Logs | ZCS"
description: "Understand the important folders and files in a Paper or Purpur server, what to back up, and which files must never be shared publicly."
url: "https://www.zcraftstudios.com/blog/minecraft-server-files-folders-explained"
updated: "2026-10-20T07:16:50.972429+00:00"
source: "ZCraft Studios"
---

> Site index for AI agents: https://www.zcraftstudios.com/llms.txt (full reference: https://www.zcraftstudios.com/llms-full.txt). Every page is available as Markdown by adding `.md` to its URL or sending `Accept: text/markdown`.

1. [Home](https://www.zcraftstudios.com/)
2. [Blog](https://www.zcraftstudios.com/blog)
3. Minecraft Server Files Explained: Properties and Logs

[ All posts](https://www.zcraftstudios.com/blog)

# Minecraft Server Files Explained: Properties and Logs

ZCraft StudiosOct 15, 2026Updated Oct 20, 2026

Understand the important folders and files in a Paper or Purpur server, what to back up, and which files must never be shared publicly.

## In this guide

- [Example directory map](#example-directory-map)
- [server.properties](#serverproperties)
- [Worlds and player progress](#worlds-and-player-progress)
- [The plugins folder](#the-plugins-folder)
- [Logs and crash reports](#logs-and-crash-reports)
- [Player identity and access files](#player-identity-and-access-files)
- [What should a backup contain?](#what-should-a-backup-contain)
- [Safe editing workflow](#safe-editing-workflow)
- [Common mistakes](#common-mistakes)
- [Related guides](#related-guides)
- [Paper-specific configuration layers](#paper-specific-configuration-layers)

## Minecraft Server Files and Folders Explained

Opening a Minecraft server directory for the first time can feel confusing. Some files control how the server starts, others store player progress, and others are disposable logs or caches. Knowing the difference prevents avoidable data loss.

This guide describes a typical Java Edition server. File layouts and additional settings vary by server version and installed plugins.

## Example directory map

```
minecraft-server/
├── server.properties
├── eula.txt
├── paper.jar
├── plugins/
├── world/
├── world_nether/
├── world_the_end/
├── logs/
├── crash-reports/
├── banned-players.json
├── ops.json
└── whitelist.json
```

Names can vary depending on the host, world configuration and server software.

## server.properties

This is the main vanilla-compatible dedicated-server configuration file. Common settings include:

| Property | Controls |

| --- | --- |

| `server-port` | Port used for player connections |

| `motd` | Description visible in the server list |

| `max-players` | Configured player capacity |

| `online-mode` | Whether official account authentication is enforced |

| `view-distance` | Maximum server view distance |

| `simulation-distance` | Distance within which various world systems are simulated |

A property existing does not mean every value is appropriate for your environment. Check version documentation and restart requirements before editing.

## Worlds and player progress

World folders contain region data, level metadata and other saved world state. Depending on software and setup, dimensions may be in separate folders or inside the main world folder.

Never assume that copying only the `region/` subfolder is a full backup. World metadata, dimensions and player-related files may be stored elsewhere.

For a recoverable snapshot, shut down cleanly or use a supported consistent-backup procedure and include all required world directories and matching plugin/database data.

## The plugins folder

For Paper and Purpur, `plugins/` typically contains plugin JAR files and plugin-specific data directories. Installing a JAR does not guarantee the plugin can enable. Check its version and dependencies.

Some plugins store important data in SQLite or MySQL/PostgreSQL databases instead of plain YAML. A folder copy alone may not capture their state.

Read [the essential plugin guide](https://www.zcraftstudios.com/blog/minecraft-plugin-essentials) before installing a large stack.

## Logs and crash reports

`logs/latest.log` is the best starting point for most startup and plugin problems. Older logs may be compressed. `crash-reports/` contains reports generated by certain kinds of crashes, but is not guaranteed to exist.

Use [our crash report walkthrough](https://www.zcraftstudios.com/blog/minecraft-server-crash-report-guide) when you need to interpret a stack trace.

## Player identity and access files

`ops.json` identifies operator accounts, `whitelist.json` stores whitelist entries, and ban JSON files track specific restrictions in vanilla-compatible setups. Plugins may replace or extend these systems.

These files are operationally sensitive. Don't paste them unreviewed into public support channels, and avoid manually changing identity files while the server runs.

Changing authentication behavior after players have joined can alter how identity-dependent data is associated with accounts. Test migrations on staging first.

## What should a backup contain?

| Data | Back it up? |

| --- | --- |

| World and dimension folders | Yes |

| Plugin configurations and storage | Yes |

| External databases used by plugins | Yes, coordinated with file backup |

| Server configuration and startup settings | Yes |

| Application JARs | Record exact versions; retain if useful |

| Temporary caches | Usually regenerable, but check documentation |

| Private secrets | Protect in encrypted/controlled backup storage |

**Important:** Never share a backup publicly if it contains passwords, tokens or player data.

## Safe editing workflow

1. Write down the setting and current value.
2. Take a backup of the relevant file or instance.
3. Stop the server for edits that require it.
4. Change only the setting you intend to test.
5. Restart and inspect startup output.
6. Join as a regular player and validate the behavior.

## Common mistakes

**Editing the wrong world:** A multiworld plugin may have a different active destination than expected.

**Deleting plugin data to reset configuration:** This can erase licenses, ranks, claims, statistics or inventories.

**Sharing logs without review:** Logs may contain private identifiers and other sensitive information.

**Assuming the jar filename controls version:** Check the actual running build from the console and official release source.

## Related guides

- [Server backup strategy](https://www.zcraftstudios.com/blog/minecraft-server-backup-strategy)
- [Creating a staging environment](https://www.zcraftstudios.com/blog/minecraft-server-staging-environment-guide)
- [MOTD and server icon setup](https://www.zcraftstudios.com/blog/minecraft-server-motd-icon-setup)

Once you know which directory owns each piece of data, troubleshooting becomes much more predictable.

## Paper-specific configuration layers

For global configuration, world defaults and per-world overrides, see [PaperMC Configuration Files Explained](https://www.zcraftstudios.com/blog/minecraft-paper-configuration-files-explained).

## Continue reading

- [PaperMC Config Files Explained: Global and Per-World](https://www.zcraftstudios.com/blog/minecraft-paper-configuration-files-explained)
- [Minecraft Staff Training Checklist: Permissions and Logs](https://www.zcraftstudios.com/blog/minecraft-server-staff-onboarding)
- [Minecraft RCON Explained: Errors and Security Checklist](https://www.zcraftstudios.com/blog/minecraft-server-rcon-security-guide)
- [Aikar's Flags Explained: Do You Need Them, and How to Check](https://www.zcraftstudios.com/blog/aikars-flags-performance-tuning)

[ Previous guide Minecraft RAM Errors: Invalid Max Heap Size and Xmx](https://www.zcraftstudios.com/blog/minecraft-java-heap-ram-errors)[ Next guide First Minecraft Server on a Hosting Panel: Checklist](https://www.zcraftstudios.com/blog/minecraft-hosting-panel-first-server-checklist)