HMCL-dev/HMCL · error · JsonParseException

McbbsModpackManifest.manifestType must be 'minecraftModpack'

Error message

McbbsModpackManifest.manifestType must be 'minecraftModpack'

What it means

Post-deserialization validation of an MCBBS modpack manifest: the manifestType field must equal 'minecraftModpack'. A different value means the archive is either not an MCBBS Minecraft modpack or a different manifest kind, so import is aborted.

Solutions

  1. Verify the archive is a valid MCBBS Minecraft modpack (mcbbs.packmeta with manifestType minecraftModpack)
  2. Check that the manifest file is not truncated or edited incorrectly
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/mcbbs/McbbsModpackManifest.java:159 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HMCL-dev/HMCL@24702dc5a0 (2026-09-10). Data as JSON: /api/errors/76042d74b1e0a1c5. Report an issue: GitHub.

Appendix: source

Thrown at HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/mcbbs/McbbsModpackManifest.java:159

@Override
public void validate() throws JsonParseException, TolerableValidationException {
    if (!MANIFEST_TYPE.equals(manifestType))
        throw new JsonParseException("McbbsModpackManifest.manifestType must be 'minecraftModpack'");
    if (files == null)
        throw new JsonParseException("McbbsModpackManifest.files cannot be null");
    if (addons == null)
        throw new JsonParseException("McbbsModpackManifest.addons cannot be null");
}

View on GitHub (pinned to 24702dc5a0)