Modscraper Modscraper Minecraft

Sort By

Type

Content

Tags

Prickle logo

Prickle

Mod

by DarkhaxDev

Prickle is a JSON based configuration file format brought to Minecraft.

Type

Mod

CurseForge Downloads

52,906,346

CurseForge ID

1023259

Modrinth Downloads

14,144,795

Modrinth ID

aaRl8GiW

Last Updated

Nov 7, 2026

Description

Prickle is a JSON based config format. This mod allows other mods to use Prickle for their config files! For technical documentation please see the GitHub page.

 

FaQ

Why is this called Prickle?
Prickle is the collective noun for a group of hedgehogs. Hedgehogs are one of my favourite animals and I think they are a fitting metaphor for config files. For example, they both may seem intimidating at first but can be nice once you get to know and understand them.

Why not use an existing format?
In the past I used standard JSON for my config files but there were several issues such as the lack of comments and default values. Prickle adds these features to JSON while remaining 100% backwards compatible. I have tried several other formats like TOML but I was disappointed with a lot of their Java implementations. They often lack features I found important, has serious bugs, and were no longer being maintained. Minecraft also uses JSON for datapacks and commands, making it a familiar choice for most players.

Format Specifications

In Prickle property values are wrapped in a JSON object. This allows metadata and other properties to be attributed to that property. The actual value that the user edits is held by the value property.

For example in standard JSON a file would look like this.

{
  "database_host": "192.168.1.222"
}

The same JSON as a Prickle file would look like this.

{
  "database_host": {
    "value": "192.168.1.222"
  }
}

Comments

The // key is reserved for comments. Comments are only used to provide additional context to the reader and should never influence how the file is parsed. Comments can be a JSON string or an array of JSON strings for multiline comments.

{
  "database_host": {
    "//": "The IP address of the database to connect to.",
    "value": "192.168.1.0"
  }
  "database_host_backup": {
    "//": [
      "A backup IP address to connect to. This is only",
      "used if the default host can not be reached    "
    ],
    "value": "192.168.1.0"
  }
}

Decorators

Decorators are named comments that convey a specific attribute of the property to the reader. A common example of a decorator is //default which declares the default value for the reader. Like comments, decorators never influence how the file is parsed, they are purely descriptive.

You may encounter some of the following decorators in prickle files.

  • //default - The default value of the property.
  • //reference - A resource that can be used to learn more, like a wiki/docs page.
  • //range - The acceptable range for a numeric value.
  • //regex - A regex pattern that the value must match.
  • //empty-allowed - If the value can be empty or not.

Nodecraft Sponsorship LogoThis project is sponsored by Nodecraft. Use code DARKHAX for 30% off your first month of service!

Compatibility

Mod Loaders

Client Neoforge Server

Game Versions

26.3

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

Mini PC for self-hosting

Mini PC for Self-Hosting

A low-power box that can sit in a cupboard and run a modded server around the clock.

View on Amazon →

As an Amazon Associate I earn from qualifying purchases.

Similar Mods

Cloth Config API (Fabric/Forge/NeoForge)

Cloth Config API (Fabric/Forge/NeoForge)

Config Screen API for Minecraft

Mod 571,005,080
Mouse Tweaks

Mouse Tweaks

Enhances inventory management by adding various functions to the mouse buttons.

Mod 550,375,362
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 525,714,625
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 520,882,628
GeckoLib

GeckoLib

A 3D animation library for entities, blocks, items, armor, and more!

Mod 505,418,317 354.7K this week
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 461,802,040

Included in Modpacks (1,819)

Show fewer
Sengoku Chronicles Sengoku Chronicles Crafted Chaos Crafted Chaos Everything from Nothing Everything from Nothing Dreams and Nightmares Dreams and Nightmares Explorerflotte Create Explorerflotte Create Cobblemon - The Temporia Region Cobblemon - The Temporia Region Pokeheros 2 Pokeheros 2 Cobblemon Trailblazers Cobblemon Trailblazers Gun Isekai Gun Isekai ATGC Meltdown 2 - The Sky ATGC Meltdown 2 - The Sky Buddycraft - Oneblock Buddycraft - Oneblock Dreamy Hollow - A Wonderful Cozy Experience Dreamy Hollow - A Wonderful Cozy Experience Motors & Rotors Motors & Rotors GoldenApple Optimized GoldenApple Optimized Create - Tamed Frontiers Create - Tamed Frontiers Dragons & Trolls & Pokemon, Oh My! Dragons & Trolls & Pokemon, Oh My! Astral Titans Astral Titans Faga's Cobblemon & Create Faga's Cobblemon & Create Create Areo Naughts Create Areo Naughts Winter Leveling Winter Leveling Lively Craft Lively Craft Attack of the new B-Team Attack of the new B-Team Luminosity Luminosity Sneykor's Cobblemon online Sneykor's Cobblemon online Apotelesmatic Neoforge Apotelesmatic Neoforge Alex Modpack Alex Modpack Leo's Medieval Fantasy Leo's Medieval Fantasy Ice and Firearms Ice and Firearms Founding Realms - Millénaire + MineColonies Town Building Adventure Founding Realms - Millénaire + MineColonies Town Building Adventure Jimmu's Factory 2 Jimmu's Factory 2 project Moa. project Moa. Perfect Fantasy Created Perfect Fantasy Created Pink Castle Pink Castle All In 1 All In 1 Leo's Military Factions Leo's Military Factions Poggersotes Poggersotes New Century Adventure New Century Adventure Sibo`s Vanilla Enhanced Sibo`s Vanilla Enhanced Peps SMP Season 4 Continents and Colonies Peps SMP Season 4 Continents and Colonies KrackherSMP Vanilla KrackherSMP Vanilla The Collective, The Aeronautical Edition The Collective, The Aeronautical Edition Peaceful Adventures Peaceful Adventures Leyendas de Teagarden Pyroven Leyendas de Teagarden Pyroven Aetherbound RPG Aetherbound RPG The Old Kitchen The Old Kitchen Create: Endless Industry Create: Endless Industry Create Boundary Engineer Create Boundary Engineer Cobblemon: Age Of Industry Cobblemon: Age Of Industry PacPack Voxydized PacPack Voxydized Beboucraft Beboucraft BeeShield Legends BeeShield Legends Immersive Factory - Create and Immersive Petroleum Immersive Factory - Create and Immersive Petroleum Star Wars Aeronautics and superheroes Star Wars Aeronautics and superheroes Havenfall Reimagined Havenfall Reimagined Evocraft cobblemon X create V2 Evocraft cobblemon X create V2 E4MC GAMER E4MC GAMER Aerium Aerium ComboTech 4 Sky High ComboTech 4 Sky High Family Friendly Pack Family Friendly Pack Elden Witchcraft Elden Witchcraft Create Woensdag - Aeronautics Create Woensdag - Aeronautics Aeronautics: Cogs and Clouds Aeronautics: Cogs and Clouds Create OneBlock | by Saurier.xyz Create OneBlock | by Saurier.xyz Dark's Trials of the Unknown Dark's Trials of the Unknown Verbesserung Verbesserung Tiny Takeover Pack Tiny Takeover Pack The Goofy Gooners MC The Goofy Gooners MC Prism Drift Prism Drift CobblemonOrigins CobblemonOrigins Cozy Time For My Friends Cozy Time For My Friends MCB Create Live MCB Create Live Tensura Abyssal Reincarnation Tensura Abyssal Reincarnation Nova's Toku Craft Server Pack Nova's Toku Craft Server Pack Athy's Cobbleswamp Athy's Cobbleswamp Corroxin's optimizations Corroxin's optimizations TensuraNewWorld TensuraNewWorld Kreyc's Overgrown Pack Kreyc's Overgrown Pack One Block to Rule Them All One Block to Rule Them All Vanilla Reinvented Vanilla Reinvented Absolute Industrialization Absolute Industrialization Very Optimised Very Optimised Most the Mods official Mod pack Most the Mods official Mod pack Barbtoria 2 Barbtoria 2 Brother's RPG Brother's RPG Dynasty Craft [RPG] Dynasty Craft [RPG] Create: Whiskers and Wonders Create: Whiskers and Wonders Optimized Utilities Optimized Utilities Tensura Abyss Tensura Abyss Create Aeronautics (& Stuff) Create Aeronautics (& Stuff) Create Cracking Contraptions 5: Aeronautics Create Cracking Contraptions 5: Aeronautics Nat's Cozy Creations Nat's Cozy Creations SimplyFellas SimplyFellas Cobblemon, Side by Side! (EARLY ACCESS) Cobblemon, Side by Side! (EARLY ACCESS) Create Aeronautics Sky Islands Create Aeronautics Sky Islands Polished Survival Polished Survival Minemon -- A cobbleverse spinoff Minemon -- A cobbleverse spinoff Better Survival (BSurvival2) Better Survival (BSurvival2) Wizards and Warriors RPG Wizards and Warriors RPG Daniel's AOT Daniel's AOT Create Industrial Village Create Industrial Village

External Resources

CurseForge Modrinth Source Code Issues