What is MIME type "text/mcfunction"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

text/mcfunction is a MIME type for plain text files that store a series of Minecraft commands. These files let the game execute multiple commands in order without user intervention. They are used in Minecraft datapacks to design custom actions and automate tasks.

Main use: Automate in-game actions by chaining commands.
Other uses: Organize complex command sequences, set up custom events, and streamline server operations.

A typical file using this MIME type is the MCFUNCTION file. Commands in these files are executed by Minecraft’s engine to create dynamic game behavior.
Find more details on how these function in the game at the Minecraft Wiki - Functions.

Associated file extensions

.mcfunction

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: text/mcfunction

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="text/mcfunction">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'text/mcfunction');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.mcfunction

FAQs

How do I configure Apache to serve .mcfunction files correctly?

To ensure Apache serves these files with the correct text/mcfunction MIME type, add the following line to your .htaccess file or main configuration: AddType text/mcfunction .mcfunction. Alternatively, if you want browsers to render them natively as plain text, you can use AddType text/plain .mcfunction.

How do I add text/mcfunction support to Nginx?

You can add the MIME type to your nginx.conf file or the mime.types file included by it. Inside the types { } block, add the line: text/mcfunction mcfunction;. Reload Nginx to apply the changes.

Why does my browser download .mcfunction files instead of displaying them?

This happens if the web server sends the file as application/octet-stream (the default for unknown extensions). To fix this, configure your server to send the text/mcfunction or text/plain header, which tells the browser the file is safe to display as text.

Are files with the text/mcfunction MIME type safe to open?

Yes, text/mcfunction files are plain text and cannot execute code on your operating system. However, they contain commands for the Minecraft game engine; running a malicious function file inside a game server could damage the game world (e.g., by destroying blocks or killing entities).

What software should I use to edit text/mcfunction files?

Since the content is plain text, you can use any text editor like Notepad or TextEdit. for a better experience, developers recommend advanced editors like Visual Studio Code or Sublime Text with Minecraft-specific plugins to provide syntax highlighting for commands.

Is text/mcfunction an official IANA MIME type?

No, text/mcfunction is not registered with the IANA. It is a convention used by web servers and developers to identify Minecraft function files. Because it falls under the text/* category, it indicates the content is human-readable.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.