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
Singularity Create
PokeSMP
dronko's dragon survival
NinjaCraft - Official Server
Born in Chaos: The Dawn of Chaos
Better & Enhanced
Cobblemon Adventure - Pokemon modpack
Arkanis Terceira Temporada - FANMADE
Tensura Roguelike
SF Integrated Modpack
CordCraft Season 5
Antique Runes: Medieval RPG
Danny's Aot with FTB quests (Fan made)
Tensura Resurrection
Harvista
Rizmotopia - Barebones
TechCraftBrasil - Servidor Brasileiro - ONLINE
Volormon
Qearioz's Optimized PvP & SMP
Spectrum_11.jar
363帆的原版美化
BeetleKnight's Beyond
Cold Soul
PixelGO - Isekai (Pixelmon)
RockTown Tech World Sky Block
Multiplayer Essential
Adventure of Tech V
The Stuff of Legend
Over the Sky | Floating Islands, Mobs and Many Secrets!
MM3
Everwild
FTB Unstable 6
Create Aeronautics Expanded
Jurassic lost
Xomaps 2
Custom BattleRoyale Complete
BottomlessThought's Realism
Travelers Reborn
Cozy
More Perfect Minecraft
FNAF - Fazcraft Reimagined | Based on FNAF!
Kota Craft
Shiner's Mushoku Tensei/Jobless Reincarnation
Cobblemon - Pokekingdoms
Better Survival (BSurvival)
Vanilla Optimised
Create: Stratus Terra
VisionSteps
Over the Sea | Underwater Adventures!
tensura exploration
Cobblemon CobbleLocke - Nuzlocke Randomlocke Server
Squibbin Hangout
Heartful Memories
The Rise of Newstone Hollow
(Danny's AOT) Age of Titans
Cobblemon Vulkan
Explorer's Feast | 探索者的盛宴
FriendsCraft - Designed for Multiplayer | Vanilla-Friendly
Actium
The OneBlock 1
TNT Titans
Chronicles of Magic | The First Magician
All About Horror - Survival Fear & Terror Experience
Tensura Reemerged
Ultra Optimized
Artifice & Industry
SMARTCRAFT
Cultivator's Legacy
Clockwork Skies
Create Echoes of the Great Derailment
Generations (Fabric) (Cobblemon)
Dieselpunkery
CHERRYMON: Cozy Cobblemon Adventures
Neon
OPKoffee Infused
Friends United 2.1
BM - Exosphere 2 Lite
Create and colony - Create Aeronautics version!
Who Am I - Not Me
Tech Town
VAMPACK
Clockwork Engineers-3
OceanBlock - Skyblock Reinvented
Essentials:Create
Aeronautics - Across the Horizon
Aerophagia (Aeronautics)
Architecture & Automatum
Matti's Skyblock
Beyond Survival (BYSL)
KOTD
New Age Science and Technology Easy
A Toca da Coruja
Fiction Friction Gaming
Vampirism Extra
Create Evo Era
Horizon (New Dawn)
Rede Moby FPS+ Turbo Boost Utilits
Nilsa's Vanilla Plus
Kuri's FreshVanilla
Super III