An open API service indexing awesome lists of open source software.

https://github.com/paradigmmc/mc-schemas

Repository for documenting all sorts of Minecraft configuration files
https://github.com/paradigmmc/mc-schemas

Last synced: 4 months ago
JSON representation

Repository for documenting all sorts of Minecraft configuration files

Awesome Lists containing this project

README

          

# mc-schemas

This repository contains schemas for all sorts of Minecraft related formats and configuration files.

> [!NOTE]
> Calling all developers! PR your mod/plugin/etc's config schemas here!

## Folder Structure

Basically: `{type}/[{owner}/{name}]/{side}/**/*.json`

Side is either `client`, `server` or `both`

### Types

- `minecraft`: The base game
- `minecraft/config/{SIDE}/*`
- `modloader`: Mod loaders
- `modloader/{fabric,quilt,forge}/{SIDE}/*`
- `servers`: bukkit, paper, etc
- `servers/{platform}/*`
- `proxies`
- `proxies/{velocity,bungeecord,...}/*`
- `mods`: Config files for mods
- `mods/{modloader}/{author}/{name}/{version}/{SIDE}/*`
- `plugins`: Config files for plugins
- `plugins/{platform}/{author}/{name}/{version}/*`
- `dev`: Formats for developing things
- `dev/modpacks/`: Modpack formats (mrpack/packwiz/cf etc)
- `dev/mods/{loader}/`: quilt.mod.json etc
- `dev/plugins/{platform}/`: plugin.yml etc
- `dev/resource_packs/` Resource pack formats
- `dev/datapacks/`

### Schema Format

- Schemas must use the `https://json-schema.org/draft/2020-12/schema` draft
- File names should be the real file name + `.json`, for example `options.txt`'s schema file would be `options.txt.json`

## Why?

- More accessible information/better documentation
- Editors can have nice features such as autocomplete, validation, hover info, etc.

Any ideas? Feel free to open an issue or a PR!