Start by Locating the Crash Boundary
A useful diagnosis starts with the last screen Minecraft reached. A launcher that exits before the title screen points toward the Java profile, loader, game version, mod file or a dependency. A title screen that works but crashes while entering one world can involve that save, a world-specific state or a conflict that appears only after mods initialize. A world that opens normally while Verity fails to answer is a different problem: an AI provider or network response cannot usually explain a crash that happens before the world loads.
Write down the exact stage and time of the failure before changing anything. Note whether the game exits by itself, freezes, returns to the launcher or displays a Minecraft error. Save the full latest log and crash report outside the game folder before trying a fix. That simple record makes it possible to compare one controlled change at a time instead of repeating downloads and losing the original evidence.
The checked Verity JE release is a Java mod for Minecraft 1.20.1 and Forge. Do not use a Java .jar in Bedrock, and do not assume a file made for a different Minecraft version will work because the project name matches. See the Verity Java guide for the source and edition boundary, and the install guide for the standard setup path.
| What you see | First area to check | Next step |
|---|---|---|
| Launcher exits before the title screen | Java profile, Forge version, mod file or dependency | Compare the profile to the current Modrinth version metadata |
| Title screen opens, but a world crashes | World load, duplicate mods or a mod conflict | Keep the save, then test a new disposable world in a clean profile |
| World opens, but Verity is missing | File discovery, loader profile or required library | Check the log and the dependency guide |
| Verity appears, but AI does not answer | Provider key, model, authorization or network | Use the AI setup guide; this is not a startup crash |
| Text interaction works, but microphone or speech fails | Microphone permission, speech input or TTS | Use the voice setup guide |
| Only multiplayer crashes or differs | Client/server mod list and loader match | Use the multiplayer guide |