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
Generations (Forge) (Cobblemon) Generations (Forge) (Cobblemon) World Of Dragons World Of Dragons Gambling Craft Gambling Craft Afterfall - Zombie Apocalypse Survival | Inspired by DeceasedCraft Afterfall - Zombie Apocalypse Survival | Inspired by DeceasedCraft Creative Mode: A Create Experience Creative Mode: A Create Experience Optimized Client - Boost FPS Optimized Client - Boost FPS Cobblemon Realms Lite Cobblemon Realms Lite Morning Brew Morning Brew Absurdo! Absurdo! Nexus client Nexus client All The Neoforge All The Neoforge Lucky World Invasion - Survivor Lucky World Invasion - Survivor Stargate: ReLeveled Stargate: ReLeveled Kuri's FreshVanilla Kuri's FreshVanilla Beyond Survival (BYSL) Beyond Survival (BYSL) Better Survival (BSurvival) Better Survival (BSurvival) Folklore SMP Folklore SMP All About Decoration - Building & Furniture All About Decoration - Building & Furniture Tensura Tomfoolery Tensura Tomfoolery Unaltered+ Unaltered+ The Modded Rizoma MC The Modded Rizoma MC Dark TFC - UltraHardcore Dark TFC - UltraHardcore Cobblemon Guapisimo Cobblemon Guapisimo Tinker's Tavern: Cobblemon Tinker's Tavern: Cobblemon Minecolonies Create - Aeronautics Colonies Minecolonies Create - Aeronautics Colonies [Cobblemon] BlockeMon [Cobblemon] BlockeMon FTB Unstable 6 FTB Unstable 6 Tensura Resurrection Tensura Resurrection Oritech+ | Oritech & Create Addons and Create Aeronautics Oritech+ | Oritech & Create Addons and Create Aeronautics LifeOre Create S1 LifeOre Create S1 MCreative SMP MCreative SMP Rizmotopia - Barebones Rizmotopia - Barebones Revelations 3 - just Tech N' building! Revelations 3 - just Tech N' building! Antique Runes: Medieval RPG Antique Runes: Medieval RPG KyuSekai KyuSekai Qearioz's Optimized PvP & SMP Qearioz's Optimized PvP & SMP Multiplayer Essential Multiplayer Essential PocketSMP (OFFICIAL) PocketSMP (OFFICIAL) Volormon Volormon Essentials Mods - Halloween Edition [CurseForge Server] Essentials Mods - Halloween Edition [CurseForge Server] Cobblemon Apex Worlds Cobblemon Apex Worlds Prison Escape - Beginnings (reborn) Prison Escape - Beginnings (reborn) Fight and Death Fight and Death Tensura Roguelike Tensura Roguelike 363帆的原版美化 363帆的原版美化 Architecture & Automatum Architecture & Automatum Cobblemon AU Cobblemon AU Inferno - Better Hardcore Inferno - Better Hardcore Verity modern warfere Verity modern warfere Born in Chaos: The Dawn of Chaos Born in Chaos: The Dawn of Chaos BUILDTECH 3 BUILDTECH 3 Cobblemon Enhanced (Pokemon) Cobblemon Enhanced (Pokemon) dronko's dragon survival dronko's dragon survival FOXY COZY LITE FOXY COZY LITE GSZYpack GSZYpack Monumental Experience VI - Rise of the Dinosaurs Monumental Experience VI - Rise of the Dinosaurs Create Flight Create Flight Randoms Packs Randoms Packs WolfCraft Colonies - Season 5! WolfCraft Colonies - Season 5! Singularity Create Singularity Create Cozy Cozy Aeronautics - Across the Horizon Aeronautics - Across the Horizon TechCraftBrasil - Servidor Brasileiro - ONLINE TechCraftBrasil - Servidor Brasileiro - ONLINE OceanBlock - Skyblock Reinvented OceanBlock - Skyblock Reinvented Cobblemon Adventure - Pokemon modpack Cobblemon Adventure - Pokemon modpack SpookyJam 2025 SpookyJam 2025 Arkanis Terceira Temporada - FANMADE Arkanis Terceira Temporada - FANMADE PokeSMP PokeSMP All Ultimate Selection All Ultimate Selection BeetleKnight's Beyond BeetleKnight's Beyond SimplyVanilla SimplyVanilla BottomlessThought's Realism BottomlessThought's Realism Better & Enhanced Better & Enhanced A Toca da Coruja A Toca da Coruja Performatic Performatic Cobblemon + Create - Pokemon meets Industrial Revolution! Cobblemon + Create - Pokemon meets Industrial Revolution! Spectrum_11.jar Spectrum_11.jar The Stuff of Legend The Stuff of Legend Travelers Reborn Travelers Reborn Xomaps Potato Sky Xomaps Potato Sky Over the Sky | Floating Islands, Mobs and Many Secrets! Over the Sky | Floating Islands, Mobs and Many Secrets! Shiner's Mushoku Tensei/Jobless Reincarnation Shiner's Mushoku Tensei/Jobless Reincarnation Adventure of Tech V Adventure of Tech V RockTown Tech World Sky Block RockTown Tech World Sky Block Create Evo Era Create Evo Era Create and colony - Create Aeronautics version! Create and colony - Create Aeronautics version! Cold Soul Cold Soul NinjaCraft - Official Server NinjaCraft - Official Server EnchantVenture EnchantVenture Lucky Legends Lucky Legends CordCraft Season 5 CordCraft Season 5 Mirabilis - Vanilla Plus Plus! Mirabilis - Vanilla Plus Plus! Who Am I - Not Me Who Am I - Not Me PixelGO - Isekai (Pixelmon) PixelGO - Isekai (Pixelmon) Cobblemon - Pokekingdoms Cobblemon - Pokekingdoms Chronicles of Magic | The First Magician Chronicles of Magic | The First Magician More Perfect Minecraft More Perfect Minecraft Harvista Harvista Xomaps 2 Xomaps 2 Emberspark Cobblemon Emberspark Cobblemon

External Resources

CurseForge Modrinth Source Code Issues