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
Afterfall - Zombie Apocalypse Survival | Inspired by DeceasedCraft Afterfall - Zombie Apocalypse Survival | Inspired by DeceasedCraft Shipping Lanes Survival Pack Shipping Lanes Survival Pack Ultimate Optimization Ultimate Optimization antarchy craft antarchy craft Dark Fantasy Reborn Dark Fantasy Reborn cloudmoon cloudmoon Cobblemon AU Cobblemon AU NYLE RP inspiré de PokéRayou & Cobblemon Academy 2.0 NYLE RP inspiré de PokéRayou & Cobblemon Academy 2.0 Project 4J (Console-Remix) Project 4J (Console-Remix) SKD - Exploration SKD - Exploration CRYPTID-Old School Horror CRYPTID-Old School Horror SimplyVanilla SimplyVanilla Create: Reatomized! Create: Reatomized! Monumental Experience - NeoForge Monumental Experience - NeoForge Lucky Legends Lucky Legends Clayblock Clayblock The Obsessed Creature The Obsessed Creature Cobblemon Homestead Cobblemon Homestead PhoenixTech: Reloaded PhoenixTech: Reloaded Space Race 5 Space Race 5 Canvas | Modpack Base Template Canvas | Modpack Base Template SuperSMP Pack SuperSMP Pack Ruthless Frontiers - Grim Harvest Ruthless Frontiers - Grim Harvest PokeHub PokeHub Better & Enhanced: Client Edition Better & Enhanced: Client Edition DayCraft REVAMPED DayCraft REVAMPED Plants and Zombies SURVIVAL Plants and Zombies SURVIVAL Thaumic Horizon Thaumic Horizon World War Z - Zombie Evolution World War Z - Zombie Evolution Cobblemon Trailblazer's Modpack Cobblemon Trailblazer's Modpack Play Together | Multiplayer, Shared Life, Inventory & Progression (Multiplayer Experience with Friends) Play Together | Multiplayer, Shared Life, Inventory & Progression (Multiplayer Experience with Friends) All Roads Lead to The Void All Roads Lead to The Void Cobblemon Enclave Cobblemon Enclave Modern Revolutions Skies Modern Revolutions Skies Monumental Experience VI - Rise of the Dinosaurs Monumental Experience VI - Rise of the Dinosaurs World End Dungeon Heroes World End Dungeon Heroes Creator Academy Based on Create Creator Academy Based on Create Verity modern warfere Verity modern warfere Cobblemon Origins Cobblemon Origins Create: Lost in Space Create: Lost in Space Finally a Good Tensura Server Finally a Good Tensura Server New Worlds Polished! New Worlds Polished! Crafttomuck Crafttomuck Super Intense Create Hardcore Super Intense Create Hardcore Trash Panda Twist Trash Panda Twist Dungeons and Shuttles Evolution Dungeons and Shuttles Evolution Rizmotopia Rizmotopia MineColonies-Caos e Ordem [Unnoficial] MineColonies-Caos e Ordem [Unnoficial] WildLouna WildLouna MI:Lost Favor MI:Lost Favor Create Mod Skyblock Create Mod Skyblock SKD MineColonies SKD MineColonies AllTheMons - The Void AllTheMons - The Void Objectively Better MC Objectively Better MC VBots x Down to Earth: Summer 2026 VBots x Down to Earth: Summer 2026 All the Simple All the Simple Whim Whim SHARKSQUAD - CURSED BOYS SHARKSQUAD - CURSED BOYS Rine Time Rine Time Aruori Aruori NoodlesSMP NoodlesSMP Avatar: The Beginning Avatar: The Beginning Fight and Death Fight and Death Bosses'Rise I Excalibur Bosses'Rise I Excalibur Modustrie Modustrie Apotheosis Pack Apotheosis Pack Vanilla QOL Improved Vanilla QOL Improved Create Creative and Beyond Create Creative and Beyond Bottom of The Barrel Bottom of The Barrel Mystic Sky Mystic Sky Ascension QoL Ascension QoL FlamePack Sodium FlamePack Sodium Ultimate Create Experience - Aeronautics Ultimate Create Experience - Aeronautics Cobblemon Eclipse Cobblemon Eclipse HeroesOfMultiverse HeroesOfMultiverse TerraCraft:Confluence TerraCraft:Confluence HiveCraft HiveCraft ExileColonies ExileColonies Quality Time - Beautified and Optimized Quality Time - Beautified and Optimized CobbleMaster CobbleMaster Pixelmon E2craft Pixelmon E2craft Arcane Empires & Ancient Evils Arcane Empires & Ancient Evils EnchantVenture EnchantVenture Tensura: Luminous Tensura: Luminous Horror Aeronautics with Friends Horror Aeronautics with Friends SLG: Confluence+ SLG: Confluence+ MC Enhanced [FABRIC] MC Enhanced [FABRIC] Mechanical Horizons Aeronautics Mechanical Horizons Aeronautics InfinityCraft Ultra InfinityCraft Ultra Simple Automation 2.0 | Beginner-Friendly Tech & Automation Simple Automation 2.0 | Beginner-Friendly Tech & Automation SVC Server Modpack SVC Server Modpack Shattered Skies [LC] Shattered Skies [LC] Better Than Adventure-Forge Better Than Adventure-Forge Create chillax Create chillax Dyonizel Modpack Dyonizel Modpack Fr3shpack - TooManyMods Fr3shpack - TooManyMods DreamCraft (Dreamcore) DreamCraft (Dreamcore) Tensura Chronicles of Tempest Tensura Chronicles of Tempest Go Eevee v3 - Pixelmon/Create Go Eevee v3 - Pixelmon/Create Arcane Dragons [NEOFORGE] Arcane Dragons [NEOFORGE]

External Resources

CurseForge Modrinth Source Code Issues