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 571,005,080
Mouse Tweaks

Mouse Tweaks

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

Mod 550,375,362
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 525,714,625
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 520,882,628
GeckoLib

GeckoLib

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

Mod 505,418,317 354.7K this week
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 461,802,040

Included in Modpacks (1,819)

Show fewer
Rede Moby FPS+ Turbo Boost Utilits Rede Moby FPS+ Turbo Boost Utilits Modern Revolutions Skies Modern Revolutions Skies Ruthless Frontiers - Grim Harvest Ruthless Frontiers - Grim Harvest Project 4J (Console-Remix) Project 4J (Console-Remix) Creator Academy Based on Create Creator Academy Based on Create NoodlesSMP NoodlesSMP Clayblock Clayblock Bogwood Matcha Flavoured Bogwood Matcha Flavoured All Roads Lead to The Void All Roads Lead to The Void Pixelmon E2craft Pixelmon E2craft Apotheosis Pack Apotheosis Pack Secure Contain Profit Secure Contain Profit PokeHub PokeHub Project AZOTH Cobblemon Modpack Project AZOTH Cobblemon Modpack Avatar: The Beginning Avatar: The Beginning Rizmotopia Rizmotopia Shadow Dragoons Shadow Dragoons Aruori Aruori SKD MineColonies SKD MineColonies Trash Panda Twist Trash Panda Twist Thaumic Horizon Thaumic Horizon Tensura Rise of Tempest (Tensura Reincarnated) Tensura Rise of Tempest (Tensura Reincarnated) SauroLab Create Official Pack SauroLab Create Official Pack DayCraft REVAMPED DayCraft REVAMPED Tensura Chronicles of Tempest Tensura Chronicles of Tempest Crafttomuck Crafttomuck PhoenixTech: Reloaded PhoenixTech: Reloaded Finally a Good Tensura Server Finally a Good Tensura Server Arcane Dragons [NEOFORGE] Arcane Dragons [NEOFORGE] Rine Time Rine Time Better & Enhanced: Client Edition Better & Enhanced: Client Edition Cobblemon Enclave Cobblemon Enclave WildLouna WildLouna Dungeons and Shuttles Evolution Dungeons and Shuttles Evolution Banjo's Lightly Salted Banjo's Lightly Salted MineColonies-Caos e Ordem [Unnoficial] MineColonies-Caos e Ordem [Unnoficial] Electricity Generation Integration Package Electricity Generation Integration Package Iris Shaders with Ragdoll Reactions Iris Shaders with Ragdoll Reactions Trials of Terra Trials of Terra ExileColonies ExileColonies VBots x Down to Earth: Summer 2026 VBots x Down to Earth: Summer 2026 World at war World at war Modustrie Modustrie EVON'S BETTER CRAFT EVON'S BETTER CRAFT Bottom of The Barrel Bottom of The Barrel Virtues of Life Virtues of Life Usefully Optimized Usefully Optimized Quality Time - Beautified and Optimized Quality Time - Beautified and Optimized Ascension QoL Ascension QoL Simple Automation 2.0 | Beginner-Friendly Tech & Automation Simple Automation 2.0 | Beginner-Friendly Tech & Automation New Worlds Polished! New Worlds Polished! Create: Constructs of the Wild Create: Constructs of the Wild TerraCraft:Confluence TerraCraft:Confluence Horror Aeronautics with Friends Horror Aeronautics with Friends Create: SatisFactory Create: SatisFactory Replication Issues Replication Issues Cobblemon Unbound Cobblemon Unbound Better look Better look Savaru IV - Kohtalon Mies Savaru IV - Kohtalon Mies Createch 2 Createch 2 Objectively Better MC Objectively Better MC StoneBlock Project Matter StoneBlock Project Matter Create_Craft&Quiet Create_Craft&Quiet Mystical Realms - A Modded Server Mystical Realms - A Modded Server Smooth Journey Smooth Journey Dyonizel Modpack Dyonizel Modpack Vanilla Reimagined by jhovem Vanilla Reimagined by jhovem HCT - Hexandcube's Client Tweaks HCT - Hexandcube's Client Tweaks Pvp Optimizer Pvp Optimizer Minecolonies - Order and Chaos Minecolonies - Order and Chaos ES CRAFT ES CRAFT HiveCraft HiveCraft Create Creative and Beyond Create Creative and Beyond TerraFirmaKingdoms Season 1 TerraFirmaKingdoms Season 1 SMP Aesthia SMP Aesthia Create: Aloft Create: Aloft Mystic Sky Mystic Sky Cobblemon Dimensions Cobblemon Dimensions Velkaris Velkaris The Ultimate PVP Modpack The Ultimate PVP Modpack Echoes of Volkrune - Rebirth of Order Echoes of Volkrune - Rebirth of Order Dungeons & Crafting Dungeons & Crafting Random Chunks! Random Chunks! Wrath of Herobrine Wrath of Herobrine A Bit o' Everything A Bit o' Everything SimpleSurvival SimpleSurvival Professional PVP Professional PVP Whim Whim SLG: Confluence+ SLG: Confluence+ AllTheMons - The Void AllTheMons - The Void Better Than Adventure-Forge Better Than Adventure-Forge Mechanical Horizons Aeronautics Mechanical Horizons Aeronautics Kestramon Kestramon Cook in Skyland Recaked Cook in Skyland Recaked Go Eevee v3 - Pixelmon/Create Go Eevee v3 - Pixelmon/Create Cobblemon Sky Adventure Cobblemon Sky Adventure ReCraft S8 Project infinity 0.1 ReCraft S8 Project infinity 0.1 Sleepymon [COBBLEMON] Sleepymon [COBBLEMON] Modern Beta Modern Beta Pony Pony Panic Pony Pony Panic

External Resources

CurseForge Modrinth Source Code Issues