Prickle
Modby DarkhaxDev
Prickle is a JSON based configuration file format brought to Minecraft.
Type
Mod
CurseForge Downloads
52,902,101
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
Ancient Cobblemon - Mega Evolutions - Breeding - Quests - Spawn Legendary - MMO RPG - All Pokemons (Cobblemon v1.8)
MM3
Custom BattleRoyale Complete
Everwild
Vanilla Optimised
TNT Titans
Cobblemon Eclipse
Immersive Pixelmon
Explorer's Feast | 探索者的盛宴
Over the Sea | Underwater Adventures!
tensura exploration
Cobblemon CobbleLocke - Nuzlocke Randomlocke Server
Essentials:Create
Neon
Create Echoes of the Great Derailment
Cultivator's Legacy
FriendsCraft - Designed for Multiplayer | Vanilla-Friendly
Dieselpunkery
Jurassic lost
Play Together | Multiplayer, Shared Life, Inventory & Progression (Multiplayer Experience with Friends)
Tensura Reemerged
Cobblemon Vulkan
Actium
Ultimate Create Experience - Aeronautics
VisionSteps
Heartful Memories
Squibbin Hangout
Ultra Optimized
Bosses'Rise I Excalibur
Create: Stratus Terra
Kota Craft
All About Horror - Survival Fear & Terror Experience
The OneBlock 1
Clockwork Engineers-3
CHERRYMON: Cozy Cobblemon Adventures
The Obsessed Creature
Clockwork Skies
Happy Sandwich
Ultimate Optimization
![BadLands [Survie/Semi-RP]](https://media.forgecdn.net/avatars/1077/664/638615811839527044.png)
BadLands [Survie/Semi-RP]
VAMPACK
The Panda Foundry
The Rise of Newstone Hollow
Cobblemon Origins
Void Nomad
CRYPTID-Old School Horror
SMARTCRAFT
Tensura Reincarnated Life In Another World
Fight and Death 2.0 Reforged
CobbleMaster
SuperSMP Pack
Aerophagia (Aeronautics)
Vampirism Extra
Artifice & Industry
Fiction Friction Gaming
Quality Of Voxy
Create Mod Skyblock
Cobblemon Trailblazer's Modpack
Friends United 2.1
Tech Town
Fabric-reinforced Lucky OneBlock
Horizon (New Dawn)
Tensura Pandemonium Official
Cobblemon Homestead
Nilsa's Vanilla Plus
Monumental Experience - NeoForge
Forge of Eternity
Matti's Skyblock
Create: Reatomized!
Super III
Dark Fantasy Reborn
All the Simple
OPKoffee Infused
Create: Physics And Aeronautics
DreamCraft (Dreamcore)
cloudmoon
World War Z - Zombie Evolution
InfinityCraft Ultra
HeroesOfMultiverse
MI:Lost Favor
NYLE RP inspiré de PokéRayou & Cobblemon Academy 2.0
You Like Food? 2!
World End Dungeon Heroes
Vanilla QOL Improved
Plants and Zombies SURVIVAL
FlamePack Sodium
Asai Integrated Modpack
Crazy Holloween - The Darkest & Craziest Horror Adventure!
Space Race 5
Canvas | Modpack Base Template
Chill
Shipping Lanes Survival Pack
SVC Server Modpack
SKD - Exploration
Backtanked
SHARKSQUAD - CURSED BOYS
KOTD
Vibrant N' Visuals
Ages Reimagined
Super Intense Create Hardcore