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
Cody's Cobblemon Adventure Cody's Cobblemon Adventure Tarrincraft [Create x Cobblemon] Tarrincraft [Create x Cobblemon] Inquisition Perfected Inquisition Perfected Fatifers Cobblemon Fatifers Cobblemon riley is a furry riley is a furry Honey Line 2 Honey Line 2 Crimson Valley Crimson Valley The House Diablo Cobblemon Experience The House Diablo Cobblemon Experience TechBit TechBit Quadra Isles Quadra Isles ATMIL - All The Mods I Love ATMIL - All The Mods I Love Magic Expeditions Magic Expeditions Stormdal Colonies Stormdal Colonies CatzyCraft CatzyCraft Cobblemon Cosmos Cobblemon Cosmos Create: Endless Industry Create: Endless Industry Extra [Modified] Cobblemon Plus Extra [Modified] Cobblemon Plus SharkSquad - True Survivors SharkSquad - True Survivors Ooc Cobblemon Plus Expanded Ooc Cobblemon Plus Expanded WMI Experience WMI Experience Blue Skies & Black Smoke Blue Skies & Black Smoke Basically Bare Bones Basically Bare Bones Assembly Assembled | Server Assembly Assembled | Server Arney Palmy Frozen Winter Experience Arney Palmy Frozen Winter Experience AeroGelica AeroGelica Civilization Isolaria Civilization Isolaria Time To Work Time To Work Digital Dreamers Digital Dreamers Trambiquecraft Trambiquecraft Schnoozleville Schnoozleville Better Cobblemon Adventure with friends Better Cobblemon Adventure with friends Tensura New Era Tensura New Era Dimmas91 Pixelmon 2 Dimmas91 Pixelmon 2 Cobbled RPG Cobbled RPG Shroomcraft 2 Cobblemon Edition Shroomcraft 2 Cobblemon Edition Breio Breio CobblemonEvolution CobblemonEvolution Unchanging SMP Unchanging SMP Banquito Banquito Azeris Azeris HeliosGamesCZSK HeliosGamesCZSK Rural Factory Rural Factory Pillcraft Pillcraft Just Enough Mods (Brass and Cinders Edition) Just Enough Mods (Brass and Cinders Edition) 💎 Legend Infinity Project 💎 Legend Infinity Project Bitz Spoon Create Season 1 Bitz Spoon Create Season 1 Cobblemon Pick Your Poison Cobblemon Pick Your Poison Clarity Clarity Atom & Dragon Atom & Dragon Cobblemoncolonies Cobblemoncolonies SKY-LESS's Modpack SKY-LESS's Modpack KillManiac's modpack KillManiac's modpack HoopieSMP HoopieSMP Runeforge Chronicles Runeforge Chronicles Horrify+ Horrify+ MonkTech 3 MonkTech 3 HypeCraft - Saison 3 HypeCraft - Saison 3 AdvoTech Aeronautic AdvoTech Aeronautic Xinex's simple adventure pack Xinex's simple adventure pack Bizarre Craft (A Homage To Crazy Craft) Bizarre Craft (A Homage To Crazy Craft) Martinj Realistico Martinj Realistico Cobblemon Union Cobblemon Union Cobblemon Down The Kitchen Sink Cobblemon Down The Kitchen Sink Cobblemon: Snackbar SMP Cobblemon: Snackbar SMP NeoAdventure NeoAdventure Realistic Weather & Colonies (R.W.C) (ARCHIVED) Realistic Weather & Colonies (R.W.C) (ARCHIVED) Create UNSC version Create UNSC version Better Survival (BSurvival2) Better Survival (BSurvival2) Cobblemon - Vapeur & Constellation Cobblemon - Vapeur & Constellation Duckemon Duckemon Create-Acsended Create-Acsended MarchewkaSMP MarchewkaSMP Elysian Horizon Elysian Horizon Pvp Optimized Pack Pvp Optimized Pack Wtalom (Wow Thats A LOta Mods) Wtalom (Wow Thats A LOta Mods) Create: The Age of the Sky Create: The Age of the Sky Exodream Exodream Create Skyward Odyssey Create Skyward Odyssey Create and Devastate Create and Devastate Potato Optimizer Potato Optimizer Ascended Gear SMP Ascended Gear SMP Vanilla Expanse BetterVanilla SMP ModPack BetterVanilla SMP ModPack Just Create Pluss Just Create Pluss Eclipse Studio's Cobblemon Eclipse Studio's Cobblemon Jannes Modpack Jannes Modpack The Dawn of the Twisters The Dawn of the Twisters SK33 - CreateFull SK33 - CreateFull Just Essential Survival modpack Just Essential Survival modpack ZooTech ZooTech IsekaiANewWorld IsekaiANewWorld The Real New World The Real New World Journey in Motion Journey in Motion Milkman of Walnuts Regrowth Milkman of Walnuts Regrowth Visually Vibrant - [FABRIC] Visually Vibrant - [FABRIC] Overclock - Tech Automation with Quests | Create, Aeronautics, AE2, Modern Industrialization & More Overclock - Tech Automation with Quests | Create, Aeronautics, AE2, Modern Industrialization & More L'Etang L'Etang TKS SMP TKS SMP Vanilla Essencia Vanilla Essencia Optimized Magic RPG Optimized Magic RPG

External Resources

CurseForge Modrinth Source Code Issues