Modscraper Modscraper Minecraft

Sort By

Type

Content

Tags

Prickle logo

Prickle

Mod

by 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.

Nodecraft Sponsorship LogoThis project is sponsored by Nodecraft. Use code DARKHAX for 30% off your first month of service!

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

LEGO Minecraft Set

LEGO Minecraft Set

Official sets that translate the building side of the game off-screen.

View on Amazon →

As an Amazon Associate I earn from qualifying purchases.

Similar Mods

Cloth Config API (Fabric/Forge/NeoForge)

Cloth Config API (Fabric/Forge/NeoForge)

Config Screen API for Minecraft

Mod 539,600,731
Mouse Tweaks

Mouse Tweaks

Enhances inventory management by adding various functions to the mouse buttons.

Mod 531,462,053
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 499,700,478
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 480,123,459
GeckoLib

GeckoLib

A 3D animation library for entities, blocks, items, armor, and more!

Mod 473,768,572
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 440,694,543

Included in Modpacks (1,549)

Show fewer
Tensura reincarnated Anime Tensura reincarnated Anime Aeronautics - Create Customised Aeronautics - Create Customised Building Tales 2 Building Tales 2 MC Vanilla 2.0 - QUALITY UPDATE! MC Vanilla 2.0 - QUALITY UPDATE! Cobblemon Freedom Frontiers Cobblemon Freedom Frontiers Create Evolution - With Create 6.0 and Quests! | +35 Create Addons Create Evolution - With Create 6.0 and Quests! | +35 Create Addons All The Forge All The Forge All Of Create All Of Create HP - Create World of Gears - Create 6.0.9 HP - Create World of Gears - Create 6.0.9 More Decorations [FABRIC] - 1.21 UPDATE! More Decorations [FABRIC] - 1.21 UPDATE! Tensura Neo Otherworld Tensura Neo Otherworld All the Mods 10 Aeronautics All the Mods 10 Aeronautics Cobblemon Apex Cobblemon Apex Kooplemon Kooplemon Create Train Create Train ChillCraft - CC1 ChillCraft - CC1 RandBlock 2 Winterize RandBlock 2 Winterize Ozone Skyblock Reborn 2 Ozone Skyblock Reborn 2 [MODIFIED] Cobblemon: OVERCLOCKED! [MODIFIED] Cobblemon: OVERCLOCKED! Kuri's Fresh (Actions & Stuffs recreation) Kuri's Fresh (Actions & Stuffs recreation) Vagrant Saga - RPG Survival Adventure Vagrant Saga - RPG Survival Adventure Beebeeblock_The_Skyhive Beebeeblock_The_Skyhive Cobblemon Rivals- Best Cobblemon Server Cobblemon Rivals- Best Cobblemon Server Arcane Dragons [FABRIC] Arcane Dragons [FABRIC] Shaders Shaders Shaders! Shaders Shaders Shaders! Create Lets Create - Official Server Create Lets Create - Official Server A Cozy Mizuno World A Cozy Mizuno World Rubius cobblemon Rubius cobblemon TechAcademy TechAcademy My Biome Is So Beautiful My Biome Is So Beautiful Mahou Tsukai Packed Mahou Tsukai Packed More Realistic [FABRIC] - 1.21 UPDATE! More Realistic [FABRIC] - 1.21 UPDATE! Prison Escape - Beginnings Prison Escape - Beginnings Cobblemon Plus+ The Top Pokemon Adventure in Cobblemon - Cobblemon 1.7.3 - Mega Cobblemon - Pokemon Legendaries - Fully Optimize Cobblemon Plus+ The Top Pokemon Adventure in Cobblemon - Cobblemon 1.7.3 - Mega Cobblemon - Pokemon Legendaries - Fully Optimize Ultra Hardcore Renewed - Do you dare to play it? | 1.21 UPDATE! Ultra Hardcore Renewed - Do you dare to play it? | 1.21 UPDATE! Attack On Titan - Awakening Of The Titans Attack On Titan - Awakening Of The Titans WinterCraft-Eternal Winter! WinterCraft-Eternal Winter! Furniture & Tech Furniture & Tech New Game 3 - Immersive RPG Adventures & RPG Quests New Game 3 - Immersive RPG Adventures & RPG Quests Cobblemon Ultimate Pokemon RPG - Cobblemon 1.7.3 - Cobblemon with Friends - Pokemon in Minecraft - Pokemon RPG & MMO Cobblemon Ultimate Pokemon RPG - Cobblemon 1.7.3 - Cobblemon with Friends - Pokemon in Minecraft - Pokemon RPG & MMO Craftoria 2 - Worlds Beyond Craftoria 2 - Worlds Beyond Mekanism: Automation Mekanism: Automation Create - Above the Horizon Create - Above the Horizon TenSura (That Time I Got Reincarnated as a Slime) TenSura (That Time I Got Reincarnated as a Slime) WT Endless Sky Adventures - Skyblock Edition WT Endless Sky Adventures - Skyblock Edition Medieval Horizons (Distant Horizons) Medieval Horizons (Distant Horizons) More Animals 2 - Exclusive Edition with Animals Quests! More Animals 2 - Exclusive Edition with Animals Quests! Take A Look GUNS Take A Look GUNS CREATE and COLONY - Better features with Create and MineColonies CREATE and COLONY - Better features with Create and MineColonies Immersive Experience - Inspired by Actions & Stuff and Other Immersive Mods Immersive Experience - Inspired by Actions & Stuff and Other Immersive Mods Danny's AOT - Titan Chronicles Danny's AOT - Titan Chronicles Shivrs' Ascendency Shivrs' Ascendency More Dungeons [FABRIC] - 1.21 UPDATE! More Dungeons [FABRIC] - 1.21 UPDATE! Create Expansion - Bigger Create+ | 6.0 UPDATE! Create Expansion - Bigger Create+ | 6.0 UPDATE! Cosmic Frontiers Cosmic Frontiers TFC Terra Draconis - Primitive Dragon Survival TFC Terra Draconis - Primitive Dragon Survival [CTM] Let's Cobble these Mons - a Cobblemon modpack [CTM] Let's Cobble these Mons - a Cobblemon modpack Builder's Paradise - Enhanced Edition (BPEE) Builder's Paradise - Enhanced Edition (BPEE) More Biomes [FABRIC] - 1.21 UPDATE! More Biomes [FABRIC] - 1.21 UPDATE! Exodus (Space Mission) | Stellaris & SPACE QUESTS! Exodus (Space Mission) | Stellaris & SPACE QUESTS! More Decorations 2 - Exclusive Edition | Decoration Mods! More Decorations 2 - Exclusive Edition | Decoration Mods! New Simple Mods [FABRIC] - Without Complex Mods! | NEW VERSION! New Simple Mods [FABRIC] - Without Complex Mods! | NEW VERSION! SharedLife - New Multiplayer Experience! SharedLife - New Multiplayer Experience! MineColonies - Cobblemon Conquest MineColonies - Cobblemon Conquest All The Dungeons | New Combat and Dungeons All The Dungeons | New Combat and Dungeons Essentials Mods Essentials Mods Better Experience (BTV) - Last Update! | The Copper Age! Better Experience (BTV) - Last Update! | The Copper Age! VERITY.BALL VERITY.BALL Ars Eclectica: an Ars Nouveau Experience Ars Eclectica: an Ars Nouveau Experience Truly Essentials - First Step (Vanilla+) Truly Essentials - First Step (Vanilla+) Fantasy RPG - RPG Quests, Bosses & Magic | Fantasy & RPG Fantasy RPG - RPG Quests, Bosses & Magic | Fantasy & RPG Better Create Aeronautics | Create Aeronautics with Create Addons & Improvements Better Create Aeronautics | Create Aeronautics with Create Addons & Improvements Essential Full Potential Essential Full Potential Cozy Time | Cozy Survival with Quests (MC Cozy 1.21.1) Cozy Time | Cozy Survival with Quests (MC Cozy 1.21.1) Cacademy - The Ultimate Cobblemon Academy Cacademy - The Ultimate Cobblemon Academy Exosphere 2 + Create (Aeronautics) Exosphere 2 + Create (Aeronautics) Alien AGF Series Alien AGF Series Oneblock Ultimate Oneblock Ultimate Cobblemon - RPG Edition | Cobblemon & RPG [Cobblemon 1.7.3] Cobblemon - RPG Edition | Cobblemon & RPG [Cobblemon 1.7.3] More Animals 2 More Animals 2 Kingdoms Of The Valley Kingdoms Of The Valley SpookyJam 2024 SpookyJam 2024 Create: Cobblemon [Cardboard Edition] Create: Cobblemon [Cardboard Edition] Origins Revolution | With Origins & Origins Addons Origins Revolution | With Origins & Origins Addons Secret Mission: Christmas Secret Mission: Christmas All The Hacks - ATH All The Hacks - ATH New Age Science and Technology New Age Science and Technology Create: Gears of History Create: Gears of History The Cobblemon Colonies The Cobblemon Colonies Monumental Experience - Creatures Across the World Monumental Experience - Creatures Across the World NeoTech Reborn NeoTech Reborn Meccha Crafteleon Together ! Meccha Crafteleon Together ! Plants vs. Zombies+ | With Plants vs Zombies & More! Plants vs. Zombies+ | With Plants vs Zombies & More! SMP | Somake Server SMP | Somake Server Create Overlord Aeronautics Update Create Overlord Aeronautics Update Farming Overloaded Farming Overloaded Factory in the Sky 4 Factory in the Sky 4 Thormen 1.21.1 - Mekanism - Spaceships - ICBMs - Force Fields - Nuclear Science - Voltz successor - Modpack server running Thormen 1.21.1 - Mekanism - Spaceships - ICBMs - Force Fields - Nuclear Science - Voltz successor - Modpack server running Immersive Cobblemon | With Distant Horizons, CobbleBrain, Cobblemon Addons & Quests (Cobblemon v1.7.3) Immersive Cobblemon | With Distant Horizons, CobbleBrain, Cobblemon Addons & Quests (Cobblemon v1.7.3) Sky Bees Reborn Sky Bees Reborn

External Resources

CurseForge Modrinth Source Code Issues