{"record":{"id":"bbdc6c7b34a7217e","repo":"HMCL-dev/HMCL","slug":"mcbbsmodpackmanifest-files-cannot-be-null","errorCode":null,"errorMessage":"McbbsModpackManifest.files cannot be null","messagePattern":"McbbsModpackManifest\\.files cannot be null","errorType":"validation","errorClass":"JsonParseException","httpStatus":null,"severity":"error","filePath":"HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/mcbbs/McbbsModpackManifest.java","lineNumber":163,"sourceCode":"@Override\npublic void validate() throws JsonParseException, TolerableValidationException {\n    if (!MANIFEST_TYPE.equals(manifestType))\n        throw new JsonParseException(\"McbbsModpackManifest.manifestType must be 'minecraftModpack'\");\n    if (files == null)\n        throw new JsonParseException(\"McbbsModpackManifest.files cannot be null\");\n    if (addons == null)\n        throw new JsonParseException(\"McbbsModpackManifest.addons cannot be null\");\n}","sourceCodeStart":145,"sourceCodeEnd":181,"githubUrl":"https://github.com/HMCL-dev/HMCL/blob/24702dc5a0214034f4c27166d5fd30cad08cec19/HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/mcbbs/McbbsModpackManifest.java#L145-L181","documentation":"Thrown during deserialization of a MCBBS modpack manifest.json when the required top-level `files` array is absent. validate() is a mandatory-field check invoked after Jackson binds the JSON; a manifest that omits `files` (the list of modpack entries to install) is structurally invalid for MCBBS modpack format, so parsing is aborted rather than proceeding with an undefined file list.","triggerScenarios":"Thrown at HMCLCore/src/main/java/org/jackhuang/hmcl/modpack/mcbbs/McbbsModpackManifest.java:163 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Re-download the modpack archive; it may be corrupted or incomplete","Check that mcbbs.packmeta includes a non-null files array"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"24702dc5a0214034f4c27166d5fd30cad08cec19","analyzedAt":"2026-09-10T12:36:46.680Z","contentChangedAt":"2026-09-10T12:36:46.680Z","schemaVersion":2},"datasetVersion":"2026-09-15T23:17:13.987Z"}