Prickle
Modby DarkhaxDev
Prickle is a JSON based configuration file format brought to Minecraft.
Type
Mod
CurseForge Downloads
52,906,346
CurseForge ID
Modrinth Downloads
14,144,795
Modrinth ID
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.
This project is sponsored by Nodecraft. Use code DARKHAX for 30% off your first month of service!
Compatibility
Mod Loaders
Game Versions
Recommended Gear
AffiliateHardware and extras that pair well with this mod.
As an Amazon Associate I earn from qualifying purchases.
Similar Mods
Cloth Config API (Fabric/Forge/NeoForge)
Config Screen API for Minecraft
Mouse Tweaks
Enhances inventory management by adding various functions to the mouse buttons.
Fabric API
Core API library for the Fabric toolchain
AppleSkin
Adds some useful information about food/hunger to the HUD
GeckoLib
A 3D animation library for entities, blocks, items, armor, and more!
Architectury API
An intermediary api aimed to ease developing multiplatform mods.
Included in Modpacks (1,819)
Show fewer
Cobblemon Adventure V2
Terra by Sexy Crew
Da Boys Craft - DBC
The aether of create
Assembly Assembled
MuratCraft v2
DonutSMP Ultimate Modpack
Kinetic Origins
Opticraft - Improve performance and experience
Mustard Virus NeoForged
LUI BATTLE PACK
Erstwhile Journey 2
Project Obscura
UnstableCraft SMP
RW's Cobblemon Create
Beta Decay
YeSMP
Whiteout Survival - Hardcore Winter Survival
Farmageddon
Zenavia Cobblemon Academy
Cobblemon histories
VCCP - Vanilla-Compatible Client Pack (NeoForge)
Impostor Syndrome - Reimagined
Stargates, Colonies, And Ridiculous Tech
![The Pond Edition [NEOFORGE]](https://media.forgecdn.net/avatars/815/255/638191205312486625.png)
The Pond Edition [NEOFORGE]
CobbleStories - A Create Adventure
GameGarden Ultimate
New Age 1
Redstoner's Paradise
Odysseum
A Lll Modpark
DPMon - Cobblemon Quest Pack
Rusty's Create
PokeWild Cobblemon
Protocol Zero-(HARDCORE EDITION)
Cobblemon.RPG
Rob's Cobblemon Academy
MITE Underworld
Arcadia Unlimited
Return Of The Ancients
Java Overhaul
Vanilla Ventures
Dwarfz 5
NameIT
Stormdal Cobblemon journey's 2
AestheticCraft - Cozy Adventure | MC Cozy 1.21.1
Homies Hangout Kingdom
Rustic Craft 2
LS - Smooth View
Re-Orespawned
NotPack - Performance
Cogglemon Modpack
EarthMC
MCA Reborn Modpack
Steam and Stardust
Create City 4 "The New Journey"
Magic & Mechanisms - Airborne
Towny Cobblemon
Hollycraft SMP
Da Boys Craft - Create Edition
Mostly Just Cobblemon
BACKPORT LOVERNITE
All Cobblemon in your world
Ancient Worlds
Antarchy - Ascension
Cabinmod 5
StupiClient
Cobblemon SMP: Trainer's Journey
Cobblemon: Unbound
Fajita's Enhanced Minecraft
World of Minecolonies
Vampiric Realms
WindCrest War SMP
RepYS - Engine of Creation
introverts island Server
Lite Aeronautics
Tensura Waka Edition
QSMP 2026 (fan made)
CraftToMuck: Sky
V-Cube
COBBLEPOKEMON
Bubble Cobble Redux
not a dreamscape
Sengoku Jidai - Samurai Legends
SL Quantum Factory
Grinding and industrialization GANDI 1
Cobblemon Irisian Edition
Fungal Engines
Arcane or Alloy
Nostalgized
Plants Vs Zombies - JavaEdition
Var's Just Create+ SMP
John Hall CEu Pack
Cobblemon Origins - Road to Champion
Gänseteich
A Lightweight Skyblock
Lurker in the Fog: Herobrine’s Dominion
The Girls 2.0
Aedans Vanilla Plus
Through the Seasons