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

52,902,101

CurseForge ID

1023259

Modrinth Downloads

14,144,795

Modrinth ID

aaRl8GiW

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.

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

Compatibility

Mod Loaders

Client Neoforge Server

Game Versions

26.3

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

Mini PC for self-hosting

Mini PC for Self-Hosting

A low-power box that can sit in a cupboard and run a modded server around the clock.

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 570,982,654
Mouse Tweaks

Mouse Tweaks

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

Mod 550,364,463
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 525,687,367
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 520,874,831
GeckoLib

GeckoLib

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

Mod 505,394,618 354.7K this week
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 461,790,402

Included in Modpacks (1,819)

Show fewer
Better Experience (BTV) - Last Update! | The Copper Age! Better Experience (BTV) - Last Update! | The Copper Age! All The Dungeons | New Combat and Dungeons All The Dungeons | New Combat and Dungeons Truly Essentials - First Step (Vanilla+) Truly Essentials - First Step (Vanilla+) Cacademy - The Ultimate Cobblemon Academy Cacademy - The Ultimate Cobblemon Academy Ascension of Ages Ascension of Ages Monumental Experience - Creatures Across the World Monumental Experience - Creatures Across the World Official Invincible Incorporated Server Official Invincible Incorporated Server More Animals 2 More Animals 2 Kingdoms Of The Valley Kingdoms Of The Valley Alien AGF Series Alien AGF Series Tensura: New World [Tensura RPG] Tensura: New World [Tensura RPG] Farming Crossing 6 Dinner Party Farming Crossing 6 Dinner Party Mechanomania Mechanomania Create: Cobblemon [Cardboard Edition] Create: Cobblemon [Cardboard Edition] Create: Gears of History Create: Gears of History Plants vs Zombies Overgrowth Plants vs Zombies Overgrowth The Cobblemon Colonies The Cobblemon Colonies VaniX VaniX SpookyJam 2024 SpookyJam 2024 Farming Overloaded Farming Overloaded Meccha Crafteleon Together ! Meccha Crafteleon Together ! SmashMC Cobblemon SmashMC Cobblemon Secret Mission: Christmas Secret Mission: Christmas Mystical Block Reloaded Mystical Block Reloaded New Age Science and Technology Easy New Age Science and Technology Easy Sky Bees Reborn Sky Bees Reborn Kawaii Craftia Kawaii Craftia VampireReborn VampireReborn Create Overlord Aeronautics Update Create Overlord Aeronautics Update Factory in the Sky 4 Factory in the Sky 4 SMP | Somake Server SMP | Somake Server Industrial Upgrade Horizon Industrial Upgrade Horizon Elite Tensura Elite Tensura 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 Cobblemon - Master Mon Cobblemon - Master Mon Danny's Aot with FTB quests (Fan made) Danny's Aot with FTB quests (Fan made) Improved Oritech | Oritech, Technology & Quests (Oritech 1.21.1) Improved Oritech | Oritech, Technology & Quests (Oritech 1.21.1) Keo Create Optimized Keo Create Optimized Gobba's Crystal PVP Modpack Gobba's Crystal PVP Modpack Neuroshroud: The Abandoned Neuroshroud: The Abandoned Mechanical Infinity Mechanical Infinity TJP - Endless Sky TJP - Endless Sky MC Rebalanced MC Rebalanced Ultimate Tensura Reincarnated Ultimate Tensura Reincarnated Cozy Experience - with Cute & Cozy Items! Cozy Experience - with Cute & Cozy Items! CobblemonOneBlock CobblemonOneBlock Reverie Foundry Reverie Foundry Keo Create Optimized Keo Create Optimized CobbleVerse + (For servers with friends) CobbleVerse + (For servers with friends) [MODIFIED] Cobblemon: Essentials [MODIFIED] Cobblemon: Essentials Servidor Magnatas Servidor Magnatas Project Minecolonies United Project Minecolonies United Chaos OneBlock Chaos OneBlock Create: Basically Everything Create: Basically Everything New Age Science and Technology hard New Age Science and Technology hard EMC & FE +++ EMC & FE +++ Replay Lite Replay Lite Invincible: Overdrive Invincible: Overdrive Isabel's Aeroscapes [for Create: Aeronautics] Isabel's Aeroscapes [for Create: Aeronautics] Train Yard Train Yard Progressionistic Progressionistic Truly Essentials [FABRIC] - First Step Truly Essentials [FABRIC] - First Step It Takes a Journey It Takes a Journey Generations (Fabric) (Cobblemon) Generations (Fabric) (Cobblemon) The Zombie Conquest - Easy Mode | You Can Revive! The Zombie Conquest - Easy Mode | You Can Revive! Creative Drawers Producer 2 Creative Drawers Producer 2 Cobblemon & Origins SMP Cobblemon & Origins SMP Poppy Playtime Pack Poppy Playtime Pack OneBlock OneLife OneBlock OneLife Mythic: Spellbound Mythic: Spellbound Volormon Volormon Twilight Twilight space, fight and simulation space, fight and simulation (Danny's AOT) Age of Titans (Danny's AOT) Age of Titans CoreCraft CoreCraft Soulheart Cobblemon Soulheart Cobblemon Create Aeronautics Expanded Create Aeronautics Expanded Elden Kingdom Elden Kingdom Kingdom of Elchea Kingdom of Elchea DexMasters [Cobblemon] DexMasters [Cobblemon] PikaVerse MC PikaVerse MC Avali/Furry Floofpack 2025 Avali/Furry Floofpack 2025 The Warborn Realms SMP The Warborn Realms SMP Dimensional Cultivation Dimensional Cultivation Delta's Just Give Me Features Delta's Just Give Me Features Aetherion - The Aether II Expanded Aetherion - The Aether II Expanded Aeronautics Dream Aeronautics Dream DivineRPG Server pack DivineRPG Server pack SF Integrated Modpack SF Integrated Modpack Create: End Times (Apocalypse) - With Create 6.0! Create: End Times (Apocalypse) - With Create 6.0! WitchHazel Halloween Magic WitchHazel Halloween Magic PixelGO - To the Sky 2 PixelGO - To the Sky 2 PROJECT: Keyblade - An Oath to Return PROJECT: Keyblade - An Oath to Return The Skies of Newstone Hollow The Skies of Newstone Hollow Ars Expeditions Ars Expeditions Cobblemon Stellar Cobblemon Stellar TerraKeo TerraKeo Vanilla Voyage - The Definitive Vanilla+ Pack Vanilla Voyage - The Definitive Vanilla+ Pack MHAC - My Hero Academia Craft MHAC - My Hero Academia Craft Fungle flavour Fungle flavour

External Resources

CurseForge Modrinth Source Code Issues