File Manager - McDis-RCON

McDis-RCON includes a comprehensive file management system that allows you to browse, edit, upload, download, and manage server files directly through Discord—no SSH or FTP required. File Manager Interface

Accessing the File Manager

Click the Files button in the Discord panel to open the file manager interface. The file manager displays:

Current directory path
Navigation controls
Dropdown menu with up to 25 items
File/folder selection interface

The file manager is restricted to the McDis directory (where md_config.yml is located). You cannot navigate outside this directory.

The file manager interface includes several control buttons:

⬅️ Back

Return to the previous directory level

🔄 Reload

Refresh the current view

📌 Go To Path

Jump to a specific directory path

Terminal

Open advanced file operations terminal

The dropdown menu shows the first 25 items in the current directory:

Folders are listed first
Files are listed after folders
Select an item to navigate (folders) or view options (files)

In directories with more than 25 items, use the Terminal for full access or the 📌 Go To Path button to navigate directly.

File Operations

When you select a file (not a folder), additional buttons appear: File Operations

Request (Download)

Download files to your device: For files ≤ 5MB:

File is attached directly to Discord message
Instant download

For files > 5MB:

Requires Flask server to be enabled
Generates a download link
Link can be single-use or multi-use
Link can be temporary or persistent
Download tracked in Console Flask thread

Discord has a 5MB attachment limit for most servers. For larger files, you must configure the Flask server in md_config.yml.

Edit (Rename)

Rename files and folders:

Click Edit button
Enter new name in modal
File/folder is renamed instantly

Renaming preserves file extensions automatically. Just enter the new base name.

Delete

Permanently delete files or folders:

Click Delete button
Confirm deletion
File/folder is removed immediately

Deletion is permanent! There is no recycle bin. Ensure you have backups before deleting important files.

Text File Editor

Text files get special treatment with a built-in editor: Text File Preview

Preview Mode

For all text files:

First 1024 characters are displayed in the embed
Syntax highlighting via Markdown code blocks
Full file available via Request button

Edit Mode

For files < 4000 characters: Text File Editor

Click Edit button
Discord modal opens with file contents
Make changes in the text box
Submit to save changes

The 4000 character limit is due to Discord modal text input constraints. For larger files, download, edit locally, and re-upload.

Supported text file types:

.txt, .log
.yml, .yaml, .json, .toml
.properties, .cfg, .conf
.sh, .bat, .cmd
.py, .js, .java, .kt
.md, .html, .css
And more…

Predefined Commands System

Each process folder contains a .mdcommands subfolder for storing predefined command sequences: Commands Interface

Accessing Commands

Navigate to any process folder (e.g., McDis/my_server/.mdcommands):

📦 Toggle View - Switch between commands view and files view
Dropdown - Select existing command or create new one

Command Structure

Commands are stored as YAML files:

# McDis/my_server/.mdcommands/mobswitch.yml

Reset:
  - gamerule doMobSpawning false
  - kill @e[type=!player]
  - say Mobs cleared and spawning disabled

Enable:
  - gamerule doMobSpawning true
  - say Mob spawning enabled

Nether:
  - execute in minecraft:the_nether run gamerule doMobSpawning false
  - execute in minecraft:the_nether run kill @e[type=!player]

Using Commands

When viewing a command:

Execute - Run the selected action’s commands
Edit - Open YAML file for editing
Delete - Remove the command file
Dropdown - Select which action to execute

Predefined commands are excellent for complex multi-step operations like world resets, backups, or configuration changes.

Backup Management

Navigate to McDis/.mdbackups/<process_name> to access backup tools: Backup Interface

Creating Backups

Navigate to Backup Folder

Go to .mdbackups/<your_process_name>

Select Create Backup

Choose “Create new backup” from the dropdown

Stop Process

McDis will prompt you to stop the process if it’s running

Wait for Completion

Backup is created as a ZIP archive

Backups can only be created when the process is stopped to ensure file consistency and prevent corruption.

Backup Retention

Backups are automatically managed:

Backups: 3  # Keep 3 most recent backups

When a new backup is created:

Existing backups are renamed (numbered)
New backup becomes backup #1
Backups exceeding the limit are automatically deleted

Restoring Backups

Select Backup

Choose the backup version from dropdown

Confirm Restoration

Confirm you want to restore (will delete current files)

Wait for Extraction

Backup is extracted to the process folder

Start Process

Restart your server to use restored files

Restoration deletes all current files in the process folder before extracting the backup. This action cannot be undone!

File Manager Terminal

For advanced operations, use the integrated terminal: File Manager Terminal

Click the Terminal button to access advanced file operations.

Available Terminal Commands

The terminal supports various file operations:

Navigation: cd, ls, pwd
File operations: cp, mv, rm, touch
Directory operations: mkdir, rmdir
Viewing: cat, head, tail
Compression: zip, unzip, tar
Search: find, grep
Permissions: chmod (Linux only)

All terminal operations are restricted to the McDis directory. You cannot access files outside this location.

Terminal Best Practices

Use Absolute Paths

Prefix paths with McDis/ to avoid confusion

Test Before Deleting

Use ls to verify paths before running rm commands

Quote Spaces

Use quotes for paths with spaces: "McDis/My Server"

Compress Large Transfers

ZIP folders before downloading to reduce size

File Upload System

Upload files to your server through the Discord panel:

Enabling Uploader

Click Tools Button

In the main panel, click Tools

Click Uploader

Select the Uploader option

Set Target Path

Click 📌 and enter the destination directory

Configure Overwrite

Toggle between “Overwrite” and “Do Not Overwrite”

Activate Uploader

Click Run to enable upload mode

Uploading Files

Once the uploader is active:

Drag and drop files into the panel channel
Or use Discord’s file attachment button
Files are automatically saved to the configured path
Progress is shown in the channel
Original message is deleted after upload

Overwrite Modes:

Do Not Overwrite: Existing files are skipped with a warning
Overwrite: Existing files are replaced without warning

When uploader is active, all files sent to the panel channel are captured and uploaded. Disable it when not needed.

Disabling Uploader

Click the Close button to deactivate upload mode.

Flask Download Server

For files larger than 5MB, configure the Flask server:

Configuration

Edit md_config.yml:

Flask:
  Allow: true
  IP: '0.0.0.0'      # Your public IP address
  Port: 8000          # Port to listen on

Security Notice:

Use your public IP, not internal (127.0.0.1)
Ensure the port is open in your firewall
Consider using a reverse proxy for production
Links can be configured as single-use for security

Flask Controls

Access Flask settings in Tools → Flask: Flask Controls

Run/Close - Start or stop the Flask server
Single Use/Multi-Use - Link usage policy
Temporary/Persistent - Link expiration policy

Download Tracking

All Flask downloads are logged in the Console Flask thread:

[12:34:56] User @Admin requested download: server.jar
[12:35:12] Download link used: server.jar
[12:40:00] Download link expired: server.jar

Directory Structure

McDis-RCON automatically creates several directories:

McDis/
├── md_config.yml
├── banner.png (optional)
├── .mdbackups/
│   ├── server1/
│   │   ├── server1 1.zip
│   │   ├── server1 2.zip
│   │   └── server1 3.zip
│   └── server2/
├── .mdaddons/
│   ├── addon1.py
│   └── addon2.py
├── server1/
│   ├── .mdplugins/
│   │   └── plugin1.py
│   ├── .mdcommands/
│   │   └── backup.yml
│   ├── server.jar
│   └── ...
└── server2/
    └── ...

Folders starting with .md are McDis-RCON system folders and should not be manually modified unless you know what you’re doing.

File Manager Permissions

Linux Users: The file manager may not function properly if McDis-RCON doesn’t have permission to read/write files in the directory. Ensure proper ownership:

chown -R your_user:your_group /path/to/mcdis/

Troubleshooting

File manager shows 'Permission denied'

Linux: Ensure McDis-RCON has read/write permissions on the directory.

ls -la /path/to/mcdis/
chmod -R 755 /path/to/mcdis/
chown -R user:group /path/to/mcdis/

Can't download files larger than 5MB

You must enable the Flask server:

Configure Flask in md_config.yml
Open the required port in your firewall
Restart McDis-RCON
Enable Flask in Tools → Flask

Uploaded files not appearing

Verify uploader is enabled (green “Run” button)
Check target path is correct
Ensure you have write permissions
Check Discord for error messages

Text editor won't open

File may be binary (not text)
File may exceed 4000 characters
Use Request to download and edit locally

Backup creation fails

Ensure process is stopped first
Check disk space availability
Verify write permissions on .mdbackups/
Look for errors in console thread

Best Practices

Regular Backups

Create backups before major changes or updates

Clean Up Old Files

Periodically delete old logs and unused files

Use Terminal for Bulk

Terminal is faster for operations on many files

Test Restores

Occasionally test backup restoration to ensure they work

Backup System

Detailed backup management guide

Discord Panel

Master the panel interface

Configuration

Configure Flask and backup settings

Process Control

Manage server lifecycle

Get Started

Core Features

Configuration

​Accessing the File Manager

​Navigation Controls

⬅️ Back

🔄 Reload

📌 Go To Path

Terminal

​Using the Dropdown

​File Operations

​Request (Download)

​Edit (Rename)

​Delete

​Text File Editor

​Preview Mode

​Edit Mode

​Predefined Commands System

​Accessing Commands

​Command Structure

​Using Commands

​Backup Management

​Creating Backups

​Backup Retention

​Restoring Backups

​File Manager Terminal

​Available Terminal Commands

​Terminal Best Practices

Use Absolute Paths

Test Before Deleting

Quote Spaces

Compress Large Transfers

​File Upload System

​Enabling Uploader

​Uploading Files

​Disabling Uploader

​Flask Download Server

​Configuration

​Flask Controls

​Download Tracking

​Directory Structure

​File Manager Permissions

​Troubleshooting

​Best Practices

Regular Backups

Clean Up Old Files

Use Terminal for Bulk

Test Restores

​Related Features

Backup System

Discord Panel

Configuration

Process Control

Build docs developers (and LLMs) love

Accessing the File Manager

Navigation Controls

Using the Dropdown

File Operations

Request (Download)

Edit (Rename)

Delete

Text File Editor

Preview Mode

Edit Mode

Predefined Commands System

Accessing Commands

Command Structure

Using Commands

Backup Management

Creating Backups

Backup Retention

Restoring Backups

File Manager Terminal

Available Terminal Commands

Terminal Best Practices

File Upload System

Enabling Uploader

Uploading Files

Disabling Uploader

Flask Download Server

Configuration

Flask Controls

Download Tracking

Directory Structure

File Manager Permissions

Troubleshooting

Best Practices

Related Features