Prickle
Modby 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.
This project is sponsored by Nodecraft. Use code DARKHAX for 30% off your first month of service!
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.
AppleSkin
Adds some useful information about food/hunger to the HUD
Fabric API
Core API library for the Fabric toolchain
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,549)
Show fewer
Lunaria the Creater
Homestead Horizon
DracoNeo - Council of Wyrms
TensuraNewWorld
The lads on tour
hardcore-pvz
Pocky's Vanilla
Echoes of Kaepora
Only Create It
Sky Ground Next Level
Minemon -- A cobbleverse spinoff
Arcane or Alloy
Aetheris QoL
Pixelmon Adventure and RPG
Cozy Time For My Friends
Gearfall
This Land of ours
CobblemonOrigins
Cobblemon: Age Of Industry
Leo's Military Factions
Family Friendly Pack
Camp Cobblemon - Lightly Modded Cobblemon + Builder Tools
Create: Whiskers and Wonders
SVA Dragonfall
Socky's Create Modpack
Tiny Takeover Pack
Create Aeronautics (& Stuff)
The One And Only Mania
All In 1
Create & Conquer
IkeTech 2.0
PureMash Tech
NVPack
PossessedArmor's Random Starters Cobblemon
Create Vanilla+ (THEO)
FluxEngine - Ultra Performance & Ultimate FPS Boost
Tensura Industries
E4MC GAMER
Peaceful Adventures
Classic Evolved Zero
Aqua Cobblemon
Valley Land
The Colony Network S2
SauroLab Create Official Pack
Tensura Abyssal Reincarnation
Attack of the new B-Team
The Goons Lagoon
SimplyFellas
Evocraft cobblemon X create V2
RatProject
Goodfellaz Vanilla+
PacPack Voxydized
project Moa.
Vanilla+ (w Cobblemon)
Snorland Cobblemon
Wyrmfell
Random House - Interestelar
Through the Seasons
All About Alchemy - Magic & Potions
AVP Tech
Enigmatica 10 - Bosses Unleashed
Alex's Pack 1.21.1
Cobblemon Quest made by Tuan
CAC Cobblemon Ars Create
Mitte-Erde
Glowstone Galaxy Create Edition
Rustic Craft 2
Freaky Pack - Cute vs Horror
Aussie Create 6
Eden Factory
Lumin Origins
Holdy's Chronicle
Goon Crew Collection
LFY Experience
Cobblemon Champions
StealthCraft Season 2
Triforce's Cobblemon Academy
Crops And Cuisine
Tensura Abyss
Dreams and Nightmares
Cups & Wine
Createmon Cindoria
Most the Mods official Mod pack
Create Woensdag - Aeronautics
New Age Branch Line
MayraLand
Cobblemon aBunchaMods
Eevee Isles
StormCore
Absolute Industrialization
VtubersPlayCobblemon
Comfycraft
Elden Witchcraft
Create: Up and Away
Zenith+
Crafted Chaos
Create Aeronautics Survival
Cobblemon Perfected
HugoSMP Modpack
Tanehu's Beyond The End