Anuken/Mindustry · error · RuntimeException

Unknown mesh type

Error message

Unknown mesh type: ${tname}

What it means

parseMesh() switches on the mesh config's "type" string to instantiate the right mesh class (SunMesh, HexSkyMesh, MultiMesh, MatMesh, etc.). An unrecognized type name hits the default branch and throws, since the mesh cannot be constructed.

Solutions

1. Use a mesh type name that exists as a case in parseMesh() (SunMesh, HexSkyMesh, MultiMesh, MatMesh, and others listed in ContentParser.java around line 1100-1155).
2. Check the spelling and capitalization exactly.
3. For custom meshes, build them in code rather than JSON.

Example fix

// before
{ "type": "sun-mesh", "divisions": 2 }
// after
{ "type": "SunMesh", "divisions": 2 }

// Whitelist mesh type names before constructing mesh configs.
Set<String> meshTypes = Set.of("SunMesh","HexSkyMesh","MultiMesh","MatMesh" /* + others in parseMesh() */);
String mt = meshObject.getString("type", "");
if(!meshTypes.contains(mt)) throw new IllegalStateException("Unknown mesh type '" + mt + "'");

When it happens

Trigger: A planet "mesh" (or "cloudMesh") object specifies "type": "<unknown>" where <unknown> is not one of the cases in parseMesh().

Common situations: Typo in the mesh type name; using a mesh class from a newer/older build; referencing a custom mesh not registered for JSON parsing.

Related errors

• Meshes must be objects.
• Planet ' ' not found.
• Blocks cannot be larger than
• Content JSON must be an object, not a single value.
• Invalid unit type: ' '. Must be…

AI-assisted analysis of Anuken/Mindustry@f695ad7e60 (2026-08-14). Data as JSON: /api/errors/a00ee90135135eda. Report an issue: GitHub.

Appendix: source

Thrown at core/src/mindustry/mod/ContentParser.java:1155

                data.getFloat("colorThreshold", 0.5f));
            case "SunMesh" -> {
                var cvals = data.get("colors").asStringArray();
                var colors = new Color[cvals.length];
                for(int i=0; i<cvals.length; i++){
                    colors[i] = Color.valueOf(cvals[i]);
                }

                yield new SunMesh(planet, data.getInt("divisions", 1), data.getInt("octaves", 1), data.getFloat("persistence", 0.5f),
                data.getFloat("scl", 1f), data.getFloat("pow", 1f), data.getFloat("mag", 0.5f),
                data.getFloat("colorScale", 1f), colors);
            }
            case "HexSkyMesh" -> new HexSkyMesh(planet,
                data.getInt("seed", 0), data.getFloat("speed", 0), data.getFloat("radius", 1f),
                data.getInt("divisions", 3), Color.valueOf(data.getString("color", "ffffff")), data.getInt("octaves", 1),
                data.getFloat("persistence", 0.5f), data.getFloat("scale", 1f), data.getFloat("thresh", 0.5f));
            case "MultiMesh" -> new MultiMesh(parseMeshes(planet, data.get("meshes")));
            case "MatMesh" -> new MatMesh(parseMesh(planet, data.get("mesh")), parser.readValue(Mat3D.class, data.get("mat")));
            default -> throw new RuntimeException("Unknown mesh type: " + tname);
        };
    }

    private PartProgress parseProgressOp(PartProgress base, String op, JsonValue data){
        //I have to hard-code this, no easy way of getting parameter names, unfortunately
        return switch(op){
            case "inv" -> base.inv();
            case "slope" -> base.slope();
            case "clamp" -> base.clamp();
            case "delay" -> base.delay(data.getFloat("amount"));
            case "sustain" -> base.sustain(data.getFloat("offset", 0f), data.getFloat("grow", 0f), data.getFloat("sustain"));
            case "shorten" -> base.shorten(data.getFloat("amount"));
            case "compress" -> base.compress(data.getFloat("start"), data.getFloat("end"));
            case "add" -> data.has("amount") ? base.add(data.getFloat("amount")) : base.add(parser.readValue(PartProgress.class, data.get("other")));
            case "blend" -> base.blend(parser.readValue(PartProgress.class, data.get("other")), data.getFloat("amount"));
            case "mul" -> data.has("amount") ? base.mul(data.getFloat("amount")) : base.mul(parser.readValue(PartProgress.class, data.get("other")));
            case "min" -> base.min(parser.readValue(PartProgress.class, data.get("other")));
            case "sin" -> base.sin(data.has("offset") ? data.getFloat("offset") : 0f, data.getFloat("scl"), data.getFloat("mag"));

View on GitHub (pinned to f695ad7e60)