What is MIME type "application/x-gdscript"?

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

application/x-gdscript is a MIME type assigned to files containing GDScript code. GDScript is the scripting language for the Godot Engine.

It tells software that the file is text-based source code meant for game logic. Code editors can use it for syntax highlighting and error checking.

Main use: Marking GDScript source files for Godot projects.
Other details: The prefix "x-" signals that it is a non-standard or experimental type.
Practical use: Helping servers and development tools handle code files correctly.

Files with this type typically have the extension GD.

Associated file extensions

.gd

Usage Examples

HTTP Header

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


    Content-Type: application/x-gdscript

HTML

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


    <a href="file.dat" type="application/x-gdscript">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', 'application/x-gdscript');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.gd

FAQs

How do I configure Apache or Nginx to serve .gd files correctly?

To serve these files with the correct MIME type, update your server config. For Apache, add AddType application/x-gdscript .gd to your .htaccess file. For Nginx, add application/x-gdscript gd; to your mime.types file or inside the types block.

Do web browsers execute application/x-gdscript files?

No, web browsers do not natively understand or execute GDScript. Unlike JavaScript, which runs in the browser, a file served as application/x-gdscript will usually be downloaded to the user's computer or displayed as raw text.

How can I open or edit a file with this MIME type?

Since application/x-gdscript denotes text-based source code, you can open these files in any text editor like Notepad++ or Visual Studio Code. However, using the Godot Engine editor provides the best experience with autocomplete and debugging tools.

Why is there an 'x-' prefix in this MIME type?

The x- prefix indicates that application/x-gdscript is a non-standard or experimental type not officially registered with the IANA. It is a convention used to identify formats specific to certain software, in this case, the Godot game engine.

Should I expose .gd files on my production web server?

Generally, no, unless you intend to share your project's source code. For a playable web game, Godot exports to WebAssembly (.wasm) and pack files (.pck), so serving raw .gd logic files is rarely necessary and may expose your game's logic.

Can I use text/plain instead of application/x-gdscript?

Yes, you can serve .gd files as text/plain if you want them to be easily readable in a browser for debugging purposes. However, using the specific application/x-gdscript type helps development tools and IDEs automatically recognize the file as Godot source code.

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.