Mod Limits

Mod Limits

Every package is treated as untrusted input: the game, the launcher and servers check it against these limits before using it, and refuse it with the reason. The same limits apply to a mod, a map, a gamemode and a server resource.

A package

What	At most
one file	512 MiB
the whole package	2 GiB
files and folders	65 536
folder depth	32
a path	512 bytes
resource.toml	256 KiB
entries in [add], [override], [patch]	16 384 each
patterns in a [scripts] or [files] list; names in authors, require, request	1 024
a data record or patch file (.toml)	4 MiB
TOML nesting	32

Names use A-Z a-z 0-9 _ . + - only. Links, devices, pipes, Windows reparse points, Windows device names (con, aux, nul, com1 …), a name ending in . and two spellings of one path (Textures/ beside textures/) are refused. Packages carry your own work, never the game's files.

A .zip

Plain zip archives, stored or deflated, as any zip tool makes them. The package is at the archive's root or in its only top folder.

What	Refused
entries	more than 65 534 (65 535 marks a ZIP64 archive)
expansion	an entry above 1 MiB that expands more than 100 times
encryption, ZIP64, BZIP2, LZMA, Zstandard …	always
paths that leave the folder (../), absolute paths, drive letters, \	always
links, special files, a self-extractor's prefix, bytes between or after the entries, spanned archives	always

Files

Kind	Limit
textures	a file 256 MiB; at most 4 096 × 4 096; 256 MiB decoded with its mip levels
models (.glb, .gltf)	a file 256 MiB; 4 194 304 vertices and as many triangles (all LODs and the collision); 8 LODs; 4 096 meshes, nodes, materials …; images at most 4 096 × 4 096
the packages' objects placed on one track, together	4 194 304 vertices and as many triangles
fonts	a file 32 MiB; 65 535 glyphs; 16 384 characters mapped
strings	16 384 a table; a key 128 bytes; a text 4 096 bytes and 64 lines
scripts	256 files a side, 1 MiB each, 4 MiB in all (Scripting Overview)
maps	see Making a Map
gamemodes	256 maps

On a server

A server runs at most 256 resources with 65 536 files and 8 GiB in all, and refuses a resource with shaders or Flash movies (Server Resources). Players choose how much one server may make them download (2 GiB by default).