Cliff

File Browser

Browse, upload, create, edit, and delete server files directly.

The Files panel gives you direct access to your server's file system. Browse directories, upload and create files, edit text files in place, and delete entries.

Browsing files

The file browser shows the contents of the current directory. The full path of the current folder is displayed at the top of the panel. Each entry row shows:

  • An icon — 📁 for folders, 📝 for editable text files, 📄 for non-editable files
  • Name
  • Size (for files, plus an "editable" tag when the file can be opened in the editor) or "folder"
  • Last modified date

Entries are listed with directories first, then files, sorted alphabetically by name. Use the Filter files field to narrow the list by name.

  • Click a folder row to open it
  • Click the .. (parent) row to go up one level — this row only appears when you're inside a subdirectory and a parent exists

There is no breadcrumb trail; the current folder path is shown as text at the top of the panel, and you navigate up one level at a time via the .. row.

Adding files and folders

Click the Add button in the toolbar to open a menu with three options:

  • Upload file — Opens a modal to choose a file from your machine. The file is uploaded to the current directory.
  • New folder — Opens a modal to enter a folder name. The folder is created in the current directory.
  • New file — Opens a modal to enter a file name (e.g. new-file.txt). An empty text file is created in the current directory and immediately opened in the editor.

There is no drag-and-drop upload — use the Upload file modal.

Editing files

Click any editable text file row to open it in the built-in editor. The editor is a plain text area — there is no syntax highlighting. If you click a non-editable file, Cliff shows a "Only editable text files can be opened here" message and does not open it.

The editor view shows:

  • The file name and size
  • Back to files — Return to the directory listing (you'll be prompted to save or discard if there are unsaved changes)
  • Save — Write changes to disk
  • Delete — Delete the file (with confirmation)
  • The text area with the file contents

Unsaved changes protection

If you have unsaved edits and try to:

  • Open a different file
  • Go back to the file list
  • Switch to another panel
  • Stop or restart the server

Cliff shows a confirmation dialog asking you to Save or Discard changes. The dialog's backdrop click is disabled, so you must explicitly choose one before continuing.

Tip

Use the file editor to quickly tweak server.properties, edit ops.json, or modify plugin config files without downloading and re-uploading.

Deleting files

  • Single delete — Click the Delete button on any entry row. For folders, the confirmation dialog warns that everything inside the folder is also removed.
  • Bulk delete — Tick the checkbox next to each entry (or use Select all to tick all filtered entries), then click Delete selected in the bulk action bar and confirm.

Warning

Deleting files is permanent. Cliff does not move deleted files to a trash. Take a snapshot first (see Backups) if you may need to recover the deleted files later.

There is no per-file download button in the file browser. To export the entire server folder as a zip, use the Download server button in the Backups panel.

On this page