Modkeel

Modded Minecraft: which mod crashed, where to get a mod for your version, which mods work together.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
97%
Naming quality
97%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~6,134Tokens (tool definitions)
~7.4 KBTypical response size
Significant attention impact (4.79% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "modkeel": {
      "url": "https://api.modkeel.com/mcp"
    }
  }
}

Remote endpoints

https://api.modkeel.com/mcpstreamable-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢diagnose_crash(text, url)

Find the mod most likely behind a modded Minecraft crash (Fabric, NeoForge, Forge). Use it whenever the user shares a crash report or latest.log or says the game will not start. It is the only tool that reads logs, and it adds what the file does not hold: it checks every installed mod against the Modkeel lab (pairs in the pack that clashed, jars that crashed on that Minecraft version), says how many other players hit the same crash and which fix worked for them (when 10+ did), counts lab runs of each suspect, and ranks suspects by evidence (mixin, trace, missing class) with a confidence level (NONE when nothing points at a mod). It also returns a fix guide and, when the log names the Minecraft version and loader, the build to install for the suspect and for every installed mod the lab saw crash on that version, so no follow-up call is needed. Pass the whole file as text, unedited: trimming it loses the mod list; or, when the user gave a link to a paste (mclo.gs, pastebin.com, paste.ee, gist.github.com, modkeel.com), pass url instead and Modkeel fetches it. Text with no crash in it comes back as an error to fix and retry. Up to 4 MB; read and dropped, never stored.

Input Schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The full crash report (crash-reports/crash-*.txt, from '---- Minecraft Crash Report ----') or logs/latest.log, unedited. Up to 4 MB. Give text or url."
    },
    "url": {
      "type": "string",
      "description": "A link to the crash report or log on a paste site (mclo.gs, pastebin.com, paste.ee, gist.github.com, modkeel.com), e.g. https://mclo.gs/abc123. Modkeel downloads the raw text itself. Give text or url."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "MIXIN_FAILED",
        "MISSING_CLASS",
        "OUT_OF_MEMORY",
        "MOD_LOADING",
        "GENERIC"
      ]
    },
    "confidence": {
      "type": "string",
      "enum": [
        "HIGH",
        "MEDIUM",
        "LOW",
        "NONE"
      ],
      "description": "How sure the first suspect is the cause."
    },
    "error": {
      "type": "string",
      "description": "The root exception and its message."
    },
    "description": {
      "type": "string"
    },
    "mc": {
      "type": [
        "string",
        "null"
      ]
    },
    "loader": {
      "type": [
        "string",
        "null"
      ]
    },
    "signature": {
      "type": "string",
      "description": "Stable id of this crash shape."
    },
    "suspects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "score": {
            "type": "number"
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "lab_runs": {
            "type": "integer",
            "description": "Lab runs of this mod on this MC version."
          }
        }
      },
      "description": "Most likely first; empty when no mod is implicated."
    },
    "guide": {
      "type": "string",
      "description": "How to fix this kind of crash."
    },
    "pack": {
      "type": "object",
      "description": "The installed mods checked against the lab, beyond this crash.",
      "properties": {
        "mods": {
          "type": "integer",
          "description": "Mods read from the report's mod list."
        },
        "clashes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "mods": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "runs": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "mc": {
                      "type": "string"
                    },
                    "env": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string",
                      "description": "Which lab check produced the run."
                    },
                    "detail": {
                      "type": "string",
                      "description": "What the lab saw, in words."
                    }
                  }
                }
              }
            }
          },
          "description": "Pairs in the pack that clashed in a lab run."
        },
        "crashed": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "mod": {
                "type": "string"
              },
              "runs": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "mc": {
                      "type": "string"
                    },
                    "env": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string",
                      "description": "Which lab check produced the run."
                    },
                    "detail": {
                      "type": "string",
                      "description": "What the lab saw, in words."
                    },
                    "file": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The jar that crashed."
                    },
                    "version": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "That jar's own version."
                    },
                    "loader": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "description": "Installed mods whose jar crashed in a lab run (the same version as installed, when the report names it)."
        },
        "pairs_tested": {
          "type": "integer",
          "description": "Pairs of the pack the lab ran."
        }
      }
    },
    "players": {
      "type": [
        "object",
        "null"
      ],
      "description": "What other players' reports of this same crash say (Modkeel Companion reports, monthly snapshot); null below 10 players.",
      "properties": {
        "seen": {
          "type": "string",
          "description": "How many players reported it, as a band."
        },
        "fixes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "worked": {
                "type": "string",
                "enum": [
                  "most",
                  "more than half",
                  "some",
                  "few"
                ]
              }
            }
          },
          "description": "Fixes 10+ players chose, and for how many it held."
        },
        "as_of": {
          "type": "string",
          "description": "Month of the snapshot, YYYY-MM."
        }
      }
    },
    "replace": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "mod": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "official",
              "port",
              "older_build",
              "build_from_source",
              "other_loader",
              "none"
            ]
          },
          "file": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "filename": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            }
          },
          "page": {
            "type": [
              "string",
              "null"
            ]
          },
          "next_step": {
            "type": "string"
          }
        }
      },
      "description": "The build to install for the first suspect, then for every installed mod whose jar crashed in the lab on this version (the next crash), as find_mod_download gives it; null when the version or loader is unknown or Modrinth is down."
    },
    "next_step": {
      "type": [
        "string",
        "null"
      ],
      "description": "What to replace and with what, one sentence per mod; tell the user all of it. Null when the version or loader is unknown."
    },
    "in_game": {
      "type": "string",
      "description": "The same diagnosis inside the game, for players who crash often."
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "confidence",
    "suspects",
    "guide",
    "source"
  ]
}
🟢search_mods(query, mc, limit)

Turn a mod's display name or part of its id into the exact mod id the other lab tools take, and see which mods the Modkeel lab has data on. Use it first when you only have a name ("Entity Culling", "Sodium") or are unsure of the id; skip it when you already have the id. To download a mod, call find_mod_download with its name instead: it finds the mod itself. Matching ignores case, spaces and punctuation; best match first, then the mods with more lab data. An empty query lists every mod the lab tested. Returns each mod's id, the Minecraft versions it was tested on and how many runs and pairs it has, plus the total number of matches. No match means the lab has no data on that mod, not that it is broken (get_mod_info still finds it on Modrinth by slug). mc keeps only mods with a run on that exact version; limit caps the list, and total says how many matched.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Mod name or part of its id, e.g. \"Entity Culling\", \"sod\" or \"create\". Empty or omitted: list every mod the lab tested."
    },
    "mc": {
      "type": "string",
      "description": "Minecraft version to narrow the answer to, e.g. 1.21.1, 1.20.1 or 26.2. Omit it to get every version the lab ran; with it, only runs on exactly that version count."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "How many mods to return, 1 to 100. Default 25."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "mc": {
      "type": [
        "string",
        "null"
      ]
    },
    "total": {
      "type": "integer",
      "description": "Matches before the limit."
    },
    "mods": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Pass this to the other tools as mod_id."
          },
          "versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "runs": {
            "type": "integer"
          },
          "pairs": {
            "type": "integer"
          }
        }
      },
      "description": "Best match first."
    },
    "data": {
      "type": "object",
      "description": "Snapshot date and license of the lab data; attribute when quoting.",
      "properties": {
        "built": {
          "type": "string"
        },
        "license": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "query",
    "total",
    "mods",
    "data"
  ]
}
🟢get_mod_info(mod_id)

What one Minecraft mod is and where to get it: its Modrinth page (title, summary, categories, loaders, the Minecraft releases its author lists, client/server side, licence, downloads, source and issue links) next to a short Modkeel lab record (tested versions, run and pair counts). Use it for "what does this mod do?", "is it client-only?", "where do I download it?" or to link a suspect from diagnose_crash. The versions here are what the author declares; for what the lab saw run or crash, use get_mod_runs, and for two mods together, check_mod_pair. Takes a lab mod id or a Modrinth slug; from a name, call search_mods first. The project is matched by the SHA-1 of a jar the lab ran (source: jar_hash, exact), else by slug (source: slug); a mod on neither returns found: false, not an error. Asks Modrinth live on each call (nothing cached here), so it can fail when Modrinth is down: retry later.

Input Schema

{
  "type": "object",
  "properties": {
    "mod_id": {
      "type": "string",
      "description": "Lab mod id (e.g. fabric_api, ferritecore) or Modrinth slug (e.g. fabric-api, sodium-extra), lowercase. Unsure? Call search_mods first."
    }
  },
  "required": [
    "mod_id"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "mod": {
      "type": "string"
    },
    "found": {
      "type": "boolean",
      "description": "False: on neither Modrinth nor in lab jars."
    },
    "source": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "jar_hash",
        "slug",
        null
      ],
      "description": "How the Modrinth project was matched."
    },
    "modrinth": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "description": "The mod's Modrinth page: link users here."
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "loaders": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "game_versions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Minecraft releases the author lists (declared)."
        },
        "client_side": {
          "type": "string"
        },
        "server_side": {
          "type": "string"
        },
        "downloads": {
          "type": "integer"
        },
        "followers": {
          "type": "integer"
        },
        "license": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "issues_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "wiki_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "updated": {
          "type": "string"
        }
      }
    },
    "other_projects": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other Modrinth project ids for this mod id: a fork the lab also ran, or the project whose slug is this id when the lab ran a port (fabric_api on NeoForge)."
    },
    "lab": {
      "type": "object",
      "properties": {
        "tested": {
          "type": "boolean"
        },
        "versions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "runs": {
          "type": "integer"
        },
        "pairs": {
          "type": "integer"
        }
      }
    },
    "data": {
      "type": "object",
      "description": "Snapshot date and license of the lab data; attribute when quoting.",
      "properties": {
        "built": {
          "type": "string"
        },
        "license": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "mod",
    "found",
    "modrinth",
    "lab",
    "data"
  ]
}
🟢find_mod_download(mod_id, mc, loader)

The exact file to install for one mod on one Minecraft version and loader, with its download link. Use it for "where do I get X for 26.2 Fabric?", after diagnose_crash names a mod that needs another build, or when updating a pack to a new version. Checks, best first: the author's own build on Modrinth (status official: file, required mods, and lab runs of that exact file), a community port the Modkeel lab verified in one of its modpacks (port), the author's file for an earlier version that the lab ran on this one and saw start (older_build), a port the lab built from its public source and saw start but does not host (build_from_source: the repo, branch and how to build it), the loaders the author does build for that version (other_loader), else none; when that older file crashed in the lab instead, older_build says so and next_step warns against it. next_step says what the user can do in each case. For what the mod is, use get_mod_info; for whether it ran in the lab, get_mod_runs. Takes the mod's name as the user wrote it ("YUNG's Better Mineshafts"), a lab mod id or a Modrinth slug: no search_mods call needed first. Asks Modrinth live (two to five calls, nothing cached), so it can fail when Modrinth is down: retry.

Input Schema

{
  "type": "object",
  "properties": {
    "mod_id": {
      "type": "string",
      "description": "The mod's name as the user wrote it (e.g. Entity Culling), a lab mod id (e.g. sodium, fabric_api) or a Modrinth slug (e.g. fabric-api)."
    },
    "mc": {
      "type": "string",
      "description": "Minecraft version to install on, exactly, e.g. 1.21.1 or 26.2."
    },
    "loader": {
      "type": "string",
      "enum": [
        "fabric",
        "neoforge",
        "forge",
        "quilt"
      ],
      "description": "Mod loader of the instance: fabric, neoforge, forge or quilt."
    }
  },
  "required": [
    "mod_id",
    "mc",
    "loader"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "mod": {
      "type": "string"
    },
    "mc": {
      "type": "string"
    },
    "loader": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "official",
        "port",
        "older_build",
        "build_from_source",
        "other_loader",
        "none"
      ]
    },
    "project": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "matched_by": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "description": "The mod's Modrinth project; null when none matches."
    },
    "official": {
      "type": [
        "object",
        "null"
      ],
      "description": "The author's build for this version and loader (a release when any).",
      "properties": {
        "version": {
          "type": "string"
        },
        "version_type": {
          "type": "string"
        },
        "published": {
          "type": "string"
        },
        "page": {
          "type": "string"
        },
        "file": {
          "type": "object",
          "properties": {
            "filename": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "sha1": {
              "type": "string"
            },
            "size": {
              "type": "integer"
            }
          }
        },
        "requires": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "slug": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            }
          },
          "description": "Mods this file needs installed too."
        },
        "lab_runs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "mc": {
                "type": "string"
              },
              "env": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "detail": {
                "type": "string"
              }
            }
          },
          "description": "Lab runs of this exact file (same SHA-1)."
        }
      }
    },
    "ports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "file": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "sha1": {
                "type": "string"
              },
              "size": {
                "type": "integer"
              }
            }
          },
          "fork": {
            "type": "string",
            "description": "GitHub owner/repo of the port's source."
          },
          "license": {
            "type": [
              "string",
              "null"
            ]
          },
          "hosted_by": {
            "type": "string",
            "enum": [
              "modkeel_ports",
              "fork_release"
            ]
          },
          "verified_in": {
            "type": "object",
            "properties": {
              "pack": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "requires": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "port": {
                  "type": "boolean"
                }
              }
            },
            "description": "Mods this port needs installed too (port: true when that one is a lab port as well, its url the jar)."
          }
        }
      },
      "description": "Ports verified by the lab; only when there is no official build."
    },
    "older_build": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "result": {
          "type": "string",
          "enum": [
            "ran",
            "crashed"
          ]
        },
        "env": {
          "type": [
            "string",
            "null"
          ]
        },
        "file": {
          "type": [
            "string",
            "null"
          ]
        },
        "version": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": [
            "string",
            "null"
          ]
        },
        "page": {
          "type": "string"
        },
        "detail": {
          "type": "string"
        }
      },
      "description": "The author's file for an earlier version, as the Modkeel lab ran it on this one (only when there is no official build or port): ran (started on env) or crashed (detail says how)."
    },
    "source_build": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "repo": {
          "type": "string"
        },
        "branch": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": "string"
        },
        "env": {
          "type": "string"
        }
      },
      "description": "A port the Modkeel lab built from this GitHub repo and branch and saw start on env; Modkeel does not host its jar, so the player builds it (next_step says how). Only when nothing published fits."
    },
    "other_loaders": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Loaders the author builds this version for."
    },
    "declared_versions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Newest Minecraft releases the author lists."
    },
    "next_step": {
      "type": "string",
      "description": "What the user can do now, one sentence."
    },
    "data": {
      "type": "object",
      "description": "Snapshot date and license of the lab data; attribute when quoting.",
      "properties": {
        "built": {
          "type": "string"
        },
        "license": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "mod",
    "mc",
    "loader",
    "status",
    "official",
    "ports",
    "next_step",
    "data"
  ]
}
🟢get_mod_runs(mod_id, mc)

Everything the Modkeel lab saw one Minecraft mod do: each Minecraft version where it ran on a server or a client, or crashed, and every mod it ran with or clashed with. Use it for "does this mod work on 1.21.1?", "which versions was it tested on?" or to check a suspect from diagnose_crash. For one specific pair of mods, check_mod_pair gives a direct verdict; for what the mod is and where to get it, get_mod_info. Takes a mod id; from a name, call search_mods first. A mod the lab never ran returns tested: false with empty lists, not an error. Returns every matching row, unpaginated: a few dozen at most per mod.

Input Schema

{
  "type": "object",
  "properties": {
    "mod_id": {
      "type": "string",
      "description": "Lowercase mod id as the loader knows it (the Modrinth/Fabric/NeoForge id, e.g. sodium, create, entityculling), not the display name. Unsure of the id? Call search_mods first."
    },
    "mc": {
      "type": "string",
      "description": "Minecraft version to narrow the answer to, e.g. 1.21.1, 1.20.1 or 26.2. Omit it to get every version the lab ran; with it, only runs on exactly that version count."
    }
  },
  "required": [
    "mod_id"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "mod": {
      "type": "string"
    },
    "mc": {
      "type": [
        "string",
        "null"
      ]
    },
    "tested": {
      "type": "boolean",
      "description": "False: the lab never ran this mod."
    },
    "runs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mc": {
            "type": "string"
          },
          "env": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "Which lab check produced the run."
          },
          "detail": {
            "type": "string",
            "description": "What the lab saw, in words."
          },
          "sha1": {
            "type": "string",
            "description": "SHA-1 of the jar run."
          },
          "file": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "loader": {
            "type": "string"
          },
          "repo": {
            "type": "string",
            "description": "For a ported build: the GitHub repo (owner/name) the lab built it from."
          },
          "branch": {
            "type": "string"
          },
          "how_to_get": {
            "type": "string",
            "description": "For a ported build: the jar is not hosted; the command that builds it, and whether the lab ran it on a client. Relay it."
          }
        }
      },
      "description": "One per jar the lab ran; env: server, client or crashes."
    },
    "pairs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "with": {
            "type": "string"
          },
          "mc": {
            "type": "string"
          },
          "env": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "Which lab check produced the run."
          },
          "detail": {
            "type": "string",
            "description": "What the lab saw, in words."
          }
        }
      },
      "description": "Mods it shared a run with; env: server, client or clash."
    },
    "data": {
      "type": "object",
      "description": "Snapshot date and license of the lab data; attribute when quoting.",
      "properties": {
        "built": {
          "type": "string"
        },
        "license": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "mod",
    "tested",
    "runs",
    "pairs",
    "data"
  ]
}
🟢check_mod_pair(mod_a, mod_b, mc)

Whether two Minecraft mods ran together in the Modkeel lab, clashed, or were never tested together. Use it for "can I use X with Y?" or to check two suspects from diagnose_crash; for one mod's whole record, use get_mod_runs. Takes two mod ids in any order (from names, call search_mods first). Unknown ids are not an error: the verdict is untested, meaning no lab run, never a known conflict. With mc, only runs on that version count. clash wins if any run clashed. Returns the verdict and the runs behind it.

Input Schema

{
  "type": "object",
  "properties": {
    "mod_a": {
      "type": "string",
      "description": "First mod. Lowercase mod id as the loader knows it (the Modrinth/Fabric/NeoForge id, e.g. sodium, create, entityculling), not the display name. Unsure of the id? Call search_mods first."
    },
    "mod_b": {
      "type": "string",
      "description": "Second mod, same format, e.g. iris."
    },
    "mc": {
      "type": "string",
      "description": "Minecraft version to narrow the answer to, e.g. 1.21.1, 1.20.1 or 26.2. Omit it to get every version the lab ran; with it, only runs on exactly that version count."
    }
  },
  "required": [
    "mod_a",
    "mod_b"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "mods": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "mc": {
      "type": [
        "string",
        "null"
      ]
    },
    "verdict": {
      "type": "string",
      "enum": [
        "ran_together",
        "clash",
        "untested"
      ],
      "description": "untested: no lab run, not a known conflict."
    },
    "runs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mc": {
            "type": "string"
          },
          "env": {
            "type": "string"
          },
          "source": {
            "type": "string",
            "description": "Which lab check produced the run."
          },
          "detail": {
            "type": "string",
            "description": "What the lab saw, in words."
          }
        }
      },
      "description": "The runs behind the verdict; env: server, client or clash."
    },
    "data": {
      "type": "object",
      "description": "Snapshot date and license of the lab data; attribute when quoting.",
      "properties": {
        "built": {
          "type": "string"
        },
        "license": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "mods",
    "verdict",
    "runs",
    "data"
  ]
}
🟢check_mod_list(mod_ids, mc)

A whole mod list or modpack checked against the Modkeel lab at once: every pair in it that clashed, the mods whose jar crashed, the pairs that ran together, and the mods the lab has no data on. Use it for "will these mods work together?" or before updating a pack; for two mods, check_mod_pair is enough. Takes up to 300 mod ids (from names, search_mods first; unknown ids just land in untested_mods). With mc, only runs on that version count, and each crashed mod also gets the author's current build for it, since the crash is about the exact file the lab ran. verdict is problems_found when anything clashed or crashed, else no_known_problem, which is not a guarantee: pairs.tested out of pairs.total says how much of the list the lab covered.

Input Schema

{
  "type": "object",
  "properties": {
    "mod_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 300,
      "description": "Lowercase mod ids as the loader knows them, e.g. [\"sodium\", \"iris\", \"create\"]. The ids of a mods folder's jars work."
    },
    "mc": {
      "type": "string",
      "description": "Minecraft version to narrow the answer to, e.g. 1.21.1, 1.20.1 or 26.2. Omit it to get every version the lab ran; with it, only runs on exactly that version count."
    }
  },
  "required": [
    "mod_ids"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "mc": {
      "type": [
        "string",
        "null"
      ]
    },
    "mods": {
      "type": "integer",
      "description": "Distinct ids checked."
    },
    "verdict": {
      "type": "string",
      "enum": [
        "problems_found",
        "no_known_problem"
      ]
    },
    "clashes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mods": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "runs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "mc": {
                  "type": "string"
                },
                "env": {
                  "type": "string"
                },
                "source": {
                  "type": "string",
                  "description": "Which lab check produced the run."
                },
                "detail": {
                  "type": "string",
                  "description": "What the lab saw, in words."
                }
              }
            }
          }
        }
      },
      "description": "Pairs in the list that clashed in a lab run."
    },
    "crashed": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mod": {
            "type": "string"
          },
          "runs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "mc": {
                  "type": "string"
                },
                "env": {
                  "type": "string"
                },
                "source": {
                  "type": "string",
                  "description": "Which lab check produced the run."
                },
                "detail": {
                  "type": "string",
                  "description": "What the lab saw, in words."
                },
                "file": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The jar that crashed."
                },
                "version": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "That jar's own version."
                },
                "loader": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "current": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "crashed",
                  "newer_build"
                ]
              },
              "filename": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "published": {
                "type": "string"
              }
            },
            "description": "With mc: the author's current build for it. newer_build: another file than the one that crashed, not run by the lab yet."
          },
          "next_step": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "description": "Mods whose jar crashed in a lab run: that exact file (runs[].file)."
    },
    "ran_together": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "description": "Pairs in the list seen working together."
    },
    "untested_mods": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "No lab data: unknown, not broken."
    },
    "pairs": {
      "type": "object",
      "properties": {
        "total": {
          "type": "integer"
        },
        "tested": {
          "type": "integer"
        }
      }
    },
    "next_step": {
      "type": [
        "string",
        "null"
      ],
      "description": "With mc and crashed mods: what to install or leave out, for the player."
    },
    "data": {
      "type": "object",
      "description": "Snapshot date and license of the lab data; attribute when quoting.",
      "properties": {
        "built": {
          "type": "string"
        },
        "license": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "mods",
    "verdict",
    "clashes",
    "crashed",
    "untested_mods",
    "pairs",
    "data"
  ]
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools
verifiedversion not recorded3 tools