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
Immersed With Nature Immersed With Nature Create: Lost in Space Create: Lost in Space The Solar Apocalypse The Solar Apocalypse Farming Experience Farming Experience Protocol Zero - A Modern Zombie Apocalypse Protocol Zero - A Modern Zombie Apocalypse Aeronautics - Create Customised Aeronautics - Create Customised Immersive Pixelmon - A New Pokemon Era (with Distant Horizons, Pixelmon & Quests) Immersive Pixelmon - A New Pokemon Era (with Distant Horizons, Pixelmon & Quests) Dungeon Train Pack- A Lore-Rich Roguelite Adventure Dungeon Train Pack- A Lore-Rich Roguelite Adventure Beebeeblock_The_Skyhive Beebeeblock_The_Skyhive Marvins Minecolony Pack Marvins Minecolony Pack All Of Create All Of Create Fantasy RPG - RPG Quests, Bosses & Magic | Fantasy & RPG Fantasy RPG - RPG Quests, Bosses & Magic | Fantasy & RPG Exosphere 2 Exosphere 2 BeLoong BeLoong FNAF - Fazcraft Reimagined | Based on FNAF! FNAF - Fazcraft Reimagined | Based on FNAF! Create Evolution - With Create 6.0 and Quests! | +35 Create Addons Create Evolution - With Create 6.0 and Quests! | +35 Create Addons Shaders Shaders Shaders! Shaders Shaders Shaders! TenSura (That Time I Got Reincarnated as a Slime) TenSura (That Time I Got Reincarnated as a Slime) Fuller's PokePack: cobblemon / pokemon modpack Fuller's PokePack: cobblemon / pokemon modpack Werewolves VS Vampires SMP Werewolves VS Vampires SMP Holycube Revolution Holycube Revolution Mystic's Monstrosity Mystic's Monstrosity Create Live 6 Create Live 6 ChillCraft - CC1 ChillCraft - CC1 Ozone Skyblock Reborn 2 Ozone Skyblock Reborn 2 Cobblemon Freedom Frontiers Cobblemon Freedom Frontiers HP - Create World of Gears - Create 6.0.9 HP - Create World of Gears - Create 6.0.9 MC Vanilla 2.0 - QUALITY UPDATE! MC Vanilla 2.0 - QUALITY UPDATE! All The Forge All The Forge Building Tales 2 Building Tales 2 Kooplemon Kooplemon Cobblemon Apex Cobblemon Apex Create Train Create Train Craftoria 2 - Worlds Beyond Craftoria 2 - Worlds Beyond Danny's AOT - Titan Chronicles Danny's AOT - Titan Chronicles 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 More Decorations [FABRIC] - 1.21 UPDATE! More Decorations [FABRIC] - 1.21 UPDATE! Kuri's Fresh (Actions & Stuffs recreation) Kuri's Fresh (Actions & Stuffs recreation) StaTech Industry 2 StaTech Industry 2 Origins Revolution | With Origins & Origins Addons Origins Revolution | With Origins & Origins Addons My Biome Is So Beautiful My Biome Is So Beautiful antarchy craft antarchy craft Rubius cobblemon Rubius cobblemon RandBlock 2 Winterize RandBlock 2 Winterize 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 [MODIFIED] Cobblemon: OVERCLOCKED! [MODIFIED] Cobblemon: OVERCLOCKED! Adventure of Tech VI Adventure of Tech VI Arcane Dragons [FABRIC] Arcane Dragons [FABRIC] A Cozy Mizuno World A Cozy Mizuno World Cobblemon Rivals- Best Cobblemon Server Cobblemon Rivals- Best Cobblemon Server Create Lets Create - Official Server Create Lets Create - Official Server Cobblemon - Poke Legends Cobblemon - Poke Legends Better Create Aeronautics | Create Aeronautics with Create Addons & Improvements Better Create Aeronautics | Create Aeronautics with Create Addons & Improvements CREATE and COLONY - Better features with Create and MineColonies CREATE and COLONY - Better features with Create and MineColonies Mahou Tsukai Packed Mahou Tsukai Packed TechAcademy TechAcademy Medieval Horizons (Distant Horizons) Medieval Horizons (Distant Horizons) Cozy Time | Cozy Survival with Quests (MC Cozy 1.21.1) Cozy Time | Cozy Survival with Quests (MC Cozy 1.21.1) WinterCraft-Eternal Winter! WinterCraft-Eternal Winter! Prison Escape - Beginnings Prison Escape - Beginnings 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) More Realistic [FABRIC] - 1.21 UPDATE! More Realistic [FABRIC] - 1.21 UPDATE! Ultra Hardcore Renewed - Do you dare to play it? | 1.21 UPDATE! Ultra Hardcore Renewed - Do you dare to play it? | 1.21 UPDATE! New Game 3 - Immersive RPG Adventures & RPG Quests New Game 3 - Immersive RPG Adventures & RPG Quests Immersive Experience - Inspired by Actions & Stuff and Other Immersive Mods Immersive Experience - Inspired by Actions & Stuff and Other Immersive Mods Furniture & Tech Furniture & Tech [ Spellnomia ] - Iron's Spells 'n Spellbooks magic modpack [ Spellnomia ] - Iron's Spells 'n Spellbooks magic modpack More Animals 2 - Exclusive Edition with Animals Quests! More Animals 2 - Exclusive Edition with Animals Quests! Exodus (Space Mission) | Stellaris & SPACE QUESTS! Exodus (Space Mission) | Stellaris & SPACE QUESTS! Mekanism: Automation Mekanism: Automation Create - Above the Horizon Create - Above the Horizon WT Endless Sky Adventures - Skyblock Edition WT Endless Sky Adventures - Skyblock Edition SharedLife - New Multiplayer Experience! SharedLife - New Multiplayer Experience! MineColonies - Cobblemon Conquest MineColonies - Cobblemon Conquest Take A Look GUNS Take A Look GUNS TFC Terra Draconis - Primitive Dragon Survival TFC Terra Draconis - Primitive Dragon Survival More Decorations 2 - Exclusive Edition | Decoration Mods! More Decorations 2 - Exclusive Edition | Decoration Mods! Exosphere 2 + Create (Aeronautics) Exosphere 2 + Create (Aeronautics) Sky Frogs Sky Frogs Create Expansion - Bigger Create+ | 6.0 UPDATE! Create Expansion - Bigger Create+ | 6.0 UPDATE! Plants vs. Zombies+ | With Plants vs Zombies & More! Plants vs. Zombies+ | With Plants vs Zombies & More! Create - Plane and Simple Create - Plane and Simple Cosmic Frontiers Cosmic Frontiers BM - Exosphere 2 Lite BM - Exosphere 2 Lite The Zombie Conquest The Zombie Conquest Shivrs' Ascendency Shivrs' Ascendency [CTM] Let's Cobble these Mons - a Cobblemon modpack [CTM] Let's Cobble these Mons - a Cobblemon modpack New Simple Mods [FABRIC] - Without Complex Mods! | NEW VERSION! New Simple Mods [FABRIC] - Without Complex Mods! | NEW VERSION! All The Hacks - ATH All The Hacks - ATH Tensura All The Slime 1 Tensura All The Slime 1 More Dungeons [FABRIC] - 1.21 UPDATE! More Dungeons [FABRIC] - 1.21 UPDATE! Builder's Paradise - Enhanced Edition (BPEE) Builder's Paradise - Enhanced Edition (BPEE) Essential Full Potential Essential Full Potential Oneblock Ultimate Oneblock Ultimate New Age Science and Technology New Age Science and Technology Cobblemon - RPG Edition | Cobblemon & RPG [Cobblemon 1.7.3] Cobblemon - RPG Edition | Cobblemon & RPG [Cobblemon 1.7.3] Ars Eclectica: an Ars Nouveau Experience Ars Eclectica: an Ars Nouveau Experience Essentials Mods Essentials Mods VERITY.BALL VERITY.BALL More Biomes [FABRIC] - 1.21 UPDATE! More Biomes [FABRIC] - 1.21 UPDATE!

External Resources

CurseForge Modrinth Source Code Issues