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

46,992,579

CurseForge ID

1023259

Modrinth Downloads

12,454,078

Modrinth ID

aaRl8GiW

Last Updated

Sep 10, 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!

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

LEGO Minecraft Set

LEGO Minecraft Set

Official sets that translate the building side of the game off-screen.

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 539,600,731
Mouse Tweaks

Mouse Tweaks

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

Mod 531,462,053
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 499,700,478
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 480,123,459
GeckoLib

GeckoLib

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

Mod 473,768,572
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 440,694,543

Included in Modpacks (1,549)

Show fewer
Vanilla Voyage - The Definitive Vanilla+ Pack Vanilla Voyage - The Definitive Vanilla+ Pack The Odyssey (Create Aeronautics & Weather mods) The Odyssey (Create Aeronautics & Weather mods) EaterSMP EaterSMP QSMP 2026 (fan made) QSMP 2026 (fan made) 2Gather [Aeronautics] 2Gather [Aeronautics] MineColonies: safe and sound MineColonies: safe and sound Lite Aeronautics Lite Aeronautics VOID-BOX2 VOID-BOX2 Magic & Mechanisms - Airborne Magic & Mechanisms - Airborne Blighted Dreams Blighted Dreams Createch 2 Createch 2 Promethium Promethium Mekacraft! Mekacraft! Homies Hangout Kingdom Homies Hangout Kingdom scc cobbelmon scc cobbelmon Cobblemon - The Temporia Region Cobblemon - The Temporia Region The Modpack of absolute all time The Modpack of absolute all time Age Of Assembly Age Of Assembly DPMon - Cobblemon Quest Pack DPMon - Cobblemon Quest Pack ATGC Meltdown 2 - The Sky ATGC Meltdown 2 - The Sky Cobblemon Trailblazers Cobblemon Trailblazers Stratum Stratum Dragons & Trolls & Pokemon, Oh My! Dragons & Trolls & Pokemon, Oh My! Arceus's Cobblemon and Create Arceus's Cobblemon and Create Faga's Cobblemon & Create Faga's Cobblemon & Create Better MC [ PACK ] Better MC [ PACK ] Beboucraft Beboucraft Karma's Cobblemon Mechanical Magic Karma's Cobblemon Mechanical Magic Fungal Engines Fungal Engines Everything from Nothing Everything from Nothing Assembly Assembled Assembly Assembled Athy's Cobbleswamp Athy's Cobbleswamp Techno Vanilla Techno Vanilla EarthMC EarthMC Luminosity Luminosity Mechanical suffering Mechanical suffering No Limits Project No Limits Project KrackherSMP Vanilla KrackherSMP Vanilla Java Overhaul Java Overhaul Jimmu's Factory 2 Jimmu's Factory 2 Ultimate Neodium Ultimate Neodium Creative Colonies - [Build, Automate, Thrive] Creative Colonies - [Build, Automate, Thrive] The Ultimate PVP Modpack The Ultimate PVP Modpack New Century Adventure New Century Adventure Ice and Firearms Ice and Firearms Buddycraft - Oneblock Buddycraft - Oneblock Beyond The Walls Beyond The Walls HT1: Velocity modpack HT1: Velocity modpack lightcraft season 2 lightcraft season 2 Astral Titans Astral Titans Explorerflotte Create Explorerflotte Create Pokeheros 2 Pokeheros 2 RotomWorks RotomWorks Motors & Rotors Motors & Rotors Cobblemon PBG Cobblemon PBG Vanilla Expansion Overhaul | veo Vanilla Expansion Overhaul | veo SC Final Adventure SC Final Adventure BeeShield Legends BeeShield Legends Cobbletheseballs Cobbletheseballs Yet Another Horror Pack Yet Another Horror Pack Dark's Trials of the Unknown Dark's Trials of the Unknown CrazyMC - A Special Apocalypse | Apocalypse with Quests! CrazyMC - A Special Apocalypse | Apocalypse with Quests! Iris Shaders with Ragdoll Reactions Iris Shaders with Ragdoll Reactions LS - Smooth View LS - Smooth View Project Solaris Modpack Project Solaris Modpack Barbtoria 2 Barbtoria 2 Pixelmon Adventures ( Server Pack ) Pixelmon Adventures ( Server Pack ) Aedans Vanilla Plus Aedans Vanilla Plus MysticalColonies MysticalColonies Femtomancy Femtomancy Kreyc's Waterworld Kreyc's Waterworld FOXY COZY LITE FOXY COZY LITE Tobinator Stream-Pack Tobinator Stream-Pack not a dreamscape not a dreamscape The Girls 2.0 The Girls 2.0 Poggersotes Poggersotes Prism Drift Prism Drift Maid Service Maid Service Prismatica Prismatica Hollycraft SMP Hollycraft SMP SC Final Adventure - Arcana SC Final Adventure - Arcana Tensura Rebirth Tensura Rebirth Decked Out Vanilla+ Decked Out Vanilla+ Leyendas de Teagarden Pyroven Leyendas de Teagarden Pyroven Cobblemon, Side by Side! (EARLY ACCESS) Cobblemon, Side by Side! (EARLY ACCESS) ChillCraft - Play Your Way Chill Your Way (Neoforge) ChillCraft - Play Your Way Chill Your Way (Neoforge) Lurker in the Fog: Herobrine’s Dominion Lurker in the Fog: Herobrine’s Dominion Wizards and Warriors RPG Wizards and Warriors RPG Royalty Cobblemon Royalty Cobblemon Hub-Craft Hub-Craft Create City 4 "The New Journey" Create City 4 "The New Journey" DonutSMP Ultimate Modpack DonutSMP Ultimate Modpack Elysium [ASCENSION] Elysium [ASCENSION] A Colony Survival A Colony Survival Create & Conquer: Last Light Create & Conquer: Last Light CloudCraft ModPack CloudCraft ModPack The Goofy Gooners MC The Goofy Gooners MC Perfect Fantasy Created Perfect Fantasy Created The Collective, The Aeronautical Edition The Collective, The Aeronautical Edition Leo's Medieval Fantasy Leo's Medieval Fantasy

External Resources

CurseForge Modrinth Source Code Issues