whatisgithub

What is mindustryhjsonvscode?

anuken/mindustryhjsonvscode — explained in plain English

Analysis updated 2026-08-09 · repo last pushed 2026-08-08

TypeScriptAudience · vibe coderComplexity · 2/5ActiveSetup · easy

In one sentence

A VSCode extension that adds autocomplete, error checking, and hover tooltips for writing Mindustry game mods in the HJSON file format.

Mindmap

mindmap
  root((repo))
    What it does
      Autocomplete suggestions
      Error warnings
      Hover tooltips
    Key features
      Folder-aware context
      Cross-file references
      Custom HJSON parser
    Use cases
      Add custom units
      Create factory blocks
      Define new weapons
    Tech stack
      TypeScript
      VSCode Extension API
    Audience
      Mindustry modders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Write Mindustry mod definitions with autocomplete so you do not have to memorize field names.

USE CASE 2

Catch mistyped field names before launching the game and triggering crash errors.

USE CASE 3

Jump directly to a custom item or block definition referenced from another file.

USE CASE 4

Get hover tooltips explaining what each field does while editing unit and weapon stats.

What is it built with?

TypeScriptVSCode Extension API

How does it compare?

anuken/mindustryhjsonvscode000madz000/rfid-attendance0xdevalias/sparkle
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-08-082024-07-222022-06-29
MaintenanceActiveDormantDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Install the extension into VSCode and open a Mindustry mod folder, no external dependencies or infrastructure required.

No license information was provided in the explanation, so usage rights are unknown.

So what is it?

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.

Copy-paste prompts

Prompt 1
Help me write a Mindustry HJSON mod file for a new flying unit that has two custom weapons, using the correct field names for health, speed, and weapons.
Prompt 2
I am creating a Mindustry mod with a custom factory block that processes a custom liquid and outputs a new item. Write the HJSON definitions for the block, liquid, and item.
Prompt 3
Check this Mindustry HJSON mod file for common mistakes like wrong field names or missing required fields, and suggest corrections: [paste your file]
Prompt 4
Generate a complete Mindustry mod folder structure with example HJSON files for a new ground unit, a new weapon, and a new item, using proper nesting and cross-references.

Frequently asked questions

What is mindustryhjsonvscode?

A VSCode extension that adds autocomplete, error checking, and hover tooltips for writing Mindustry game mods in the HJSON file format.

What language is mindustryhjsonvscode written in?

Mainly TypeScript. The stack also includes TypeScript, VSCode Extension API.

Is mindustryhjsonvscode actively maintained?

Active — commit in last 30 days (last push 2026-08-08).

What license does mindustryhjsonvscode use?

No license information was provided in the explanation, so usage rights are unknown.

How hard is mindustryhjsonvscode to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mindustryhjsonvscode for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.