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,910,401

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 571,027,298
Mouse Tweaks

Mouse Tweaks

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

Mod 550,390,492
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 525,743,158
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 520,901,995
GeckoLib

GeckoLib

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

Mod 505,444,873 354.7K this week
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 461,819,940

Included in Modpacks (1,819)

Show fewer
Overcrafto Overcrafto Azelie Azelie CPBR's Create & Collaborate CPBR's Create & Collaborate Create - New Age Survival Create - New Age Survival Maniac's Adventure Maniac's Adventure The Basin: Skies the Limit! The Basin: Skies the Limit! SKY-LESS's Modpack SKY-LESS's Modpack Holy Magical Création Holy Magical Création Jannes Modpack Jannes Modpack Nayxo's Trailer Modpack Nayxo's Trailer Modpack GearFactory Lite GearFactory Lite Create-Metin Forge Create-Metin Forge Almost Pure Vanilla Almost Pure Vanilla Syntex Gaming Community Syntex Gaming Community cobblemon & create cobblemon & create vilmiComfort vilmiComfort Create Brassline Create Brassline capybara’s play oritech capybara’s play oritech Motions and Smooth Motions and Smooth PureMash Tech Lite PureMash Tech Lite NovaCraft - Rap Geek NovaCraft - Rap Geek The Ultimate Vanilla Experience The Ultimate Vanilla Experience Save My PC Save My PC Create Flightworks Create Flightworks Cody's Cobblemon Adventure Cody's Cobblemon Adventure Atumni Infinitum Atumni Infinitum Cogwork Genesis Cogwork Genesis Projekt 2025 Projekt 2025 Cherry Cobblemon Modpack Cherry Cobblemon Modpack Field of Ruin Field of Ruin ASCENSION - Iron's Spells 'n Spellbooks & Magic Overhauled [Magic & Spells Addons] ASCENSION - Iron's Spells 'n Spellbooks & Magic Overhauled [Magic & Spells Addons] Yggdrasil 2 New Age Yggdrasil 2 New Age Neos Colony Neos Colony Create Gurizes Aeronautic - [NeoForge] Create Gurizes Aeronautic - [NeoForge] Optimized Magic RPG Optimized Magic RPG BellatorGaming - Community Pack BellatorGaming - Community Pack Golden Hearth Golden Hearth our_shattered_moon.jar our_shattered_moon.jar The Guild: Create+ SMP The Guild: Create+ SMP Tensura New Era Tensura New Era Just Essential Survival modpack Just Essential Survival modpack Create: Nations & Frontiers Create: Nations & Frontiers Llohgun's Lodgings Llohgun's Lodgings Best of Create & Co. Best of Create & Co. Coasters, Airships and Magic, Oh My! Coasters, Airships and Magic, Oh My! Progress - Selects Progress - Selects KillManiac's modpack KillManiac's modpack The Better Pokeblocks Modpack The Better Pokeblocks Modpack Neroland 2 Neroland 2 Create Mons n Machines Create Mons n Machines Xinex's simple adventure pack Xinex's simple adventure pack BlockClover SMP BlockClover SMP Ribiz family S4 Ribiz family S4 JustCreate2 + JustCreate2 + Cobblemon Cosmos Cobblemon Cosmos OneDay 2.0 OneDay 2.0 Create - Technomancy 2 Create - Technomancy 2 The Dawn of the Twisters The Dawn of the Twisters Vekithis SMP Vekithis SMP MironMC - Cobblemon MironMC - Cobblemon Ferguson Expeditions Ferguson Expeditions ProhlisCraft 4: Return of the Prohlisgang! ProhlisCraft 4: Return of the Prohlisgang! Create: Full Steam Create: Full Steam Cosmic Carrot Craft Cosmic Carrot Craft Realistic Weather & Colonies (R.W.C) (ARCHIVED) Realistic Weather & Colonies (R.W.C) (ARCHIVED) The Cozy Artificer The Cozy Artificer Emberwild Journey Emberwild Journey Serenor Serenor Neutron7ix-Pokemon-Unbound Neutron7ix-Pokemon-Unbound Exlandia 5 Exlandia 5 Scoobyland - Create and Friends Scoobyland - Create and Friends Jiromon Reborn Jiromon Reborn Mire 2077 Mire 2077 Properly Optimized // [1.3.2] Properly Optimized // [1.3.2] Tuchebander Wonderland Tuchebander Wonderland IM - Industrial Magic IM - Industrial Magic Pillcraft Pillcraft MC Resonance Horizons MC Resonance Horizons Little Lattes Cafémon Little Lattes Cafémon Create and Devastate Create and Devastate Vanilla&Tech Vanilla&Tech Hig Hig Create: Airborne Industry Create: Airborne Industry Unchanging SMP Unchanging SMP Braincells Magical Creation Braincells Magical Creation Doghouse Tales Doghouse Tales evocraft FR evocraft FR CreateVillage CreateVillage Project: Goliath Re-Crafted 3 Re-Crafted 3 Forever Superflat Survival Official Pack Forever Superflat Survival Official Pack Arney Palmy Frozen Winter Experience Arney Palmy Frozen Winter Experience EdonMe Survival EdonMe Survival Wild Frontiers Wild Frontiers Tarrincraft [Create x Cobblemon] Tarrincraft [Create x Cobblemon] Farmer Academy Farmer Academy Cobblemoncolonies Cobblemoncolonies CobbledMon CobbledMon Tuned Tuned Why Not Create Why Not Create

External Resources

CurseForge Modrinth Source Code Issues