anuken/mindustryhjsonvscode

Mindustry HJSON (VSCode extension) is a plugin for the popular VSCode text editor that makes it much easier to write mods for the game Mindustry. When you create mods for this game, you describe new items, blocks, units, and weapons using a specific file format called HJSON. Without this tool, you basically have to memorize the exact field names the game expects or constantly look them up. This extension gives you autocomplete suggestions, warns you when you mistype a field name, and shows helpful documentation right when you hover over text, saving you from trial-and-error crashes inside the game. When you open a mod folder in VSCode, the extension automatically figures out what kind of object you are editing based on where the file is located. For example, if your file is inside a "units" folder, it knows you are defining a flying or ground unit and offers the relevant fields. It also understands how Mindustry organizes nested objects, like a list of weapons attached to a unit, and provides the correct suggestions for each layer. Additionally, it scans your entire mod project so that when you reference another custom item or block by name, it can autocomplete that name and even let you jump directly to the file where it was defined. This tool is designed for Mindustry modders who want a smoother, faster workflow. If you are building a mod that adds a new factory block that processes custom liquids and produces new items, this extension guides you through writing each of those definitions correctly. Instead of alt-tabbing to a wiki to check whether a field is called "health" or "maxHealth," the hover tooltips and autocompletion handle that for you. The project is notably built with an AI code generator, which the author openly acknowledges. It handles the basics very well but has some known gaps, like not resolving certain complex types or vanilla game effects. It uses a custom parser tailored specifically to Mindustry's relaxed version of HJSON, supporting things like optional commas and quoteless text, which standard tools often cannot handle.