Prickle
Modby DarkhaxDev
Prickle is a JSON based configuration file format brought to Minecraft.
Type
Mod
CurseForge Downloads
0
CurseForge ID
1023259
Modrinth Downloads
8,162,177
Modrinth ID
aaRl8GiW
Last Updated
Apr 27, 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!
Similar Mods
RFTools Power
RFTools addon for all power generator/storage
Tool Belt
A utility belt that holds your tools
Inventory Sorter
Simple inventory sorting tweaks
RFTools
RFTools, blocks and items to help with Redflux (dimension builder, crafter, monitor, scanner, ...)
Wawla - What Are We Looking At
Waila/Hwyla addon which adds all the info.
Inventory HUD+
Adds your main inventory, potion effects and your equipments to your HUD. And few other features.
Included in Modpacks
SuperSMP Pack
Sneykor's Cobblemon online
PURE.
PacPack Voxydized Server
PacPack Voxydized
Dark's simple QoL
Bubble Cobble Redux
Elysian Horizon
dronko's dragon survival
Socky's Create Modpack
Cyclo's Gearbound
RainbowMon 2
Tralty's Modded Adventure 2
ImmersiveMC - IMC2
DiamondFire Modpack
Create: SatisFactory
Essentials Mods
HORYZONEA
Destiny's Kitchen Sink
Farming Experience
The Solar Apocalypse
Cobblemon Eclipse
WildWorld
Sylix Cobblemon
Cobblemon Pals
Wen's Create Experience [Server-side]
Wen's Create Experience
The Panda Foundry
HugoSMP Modpack
Cobblemon: Unbound
Onyx
Cobblemon Origins
Train Yard
CobbleAnacrônico
Cobblemon Empire
LFY Experience
Project Solaris Modpack
Architecture & Automatum
The Stuff of Legend
not a dreamscape
SVC Server Modpack
Swiss Squared
Alex Modpack
cloudmoon
Aedans Vanilla Plus
MC Rebalanced
Sengoku Chronicles
Barely Modded
Clarity
Fluidity
Nayxo's Trailer Modpack
Goodfellaz Vanilla+
Quadra Isles
Haydenmon Evolved
My Biome Is So Beautiful
COBBLEPOKEMON
Dyonizel Modpack
SkyForge (Member Edition)
Create+
JPO SMP
The Iron Frontier
Just Around The Block
Crafted Chaos
CreateAbility
Weedie's Industrial Fantasy
The Living World
Cobblemon Trailblazer's Modpack
QuikPak
Vanilla QOL Improved
Cobblemon: Snackbar SMP
NVPack