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,833,839

CurseForge ID

1023259

Modrinth Downloads

14,127,401

Modrinth ID

aaRl8GiW

Last Updated

Nov 6, 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,608,694
Mouse Tweaks

Mouse Tweaks

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

Mod 550,150,519
Fabric API

Fabric API

Core API library for the Fabric toolchain

Mod 525,171,075
AppleSkin

AppleSkin

Adds some useful information about food/hunger to the HUD

Mod 520,631,185
GeckoLib

GeckoLib

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

Mod 505,036,428 397.9K this week
Architectury API

Architectury API

An intermediary api aimed to ease developing multiplatform mods.

Mod 461,548,810

Included in Modpacks (1,815)

Show fewer
All the Mods 10 - ATM10 All the Mods 10 - ATM10 Cobblemon Official Modpack [Fabric] Cobblemon Official Modpack [Fabric] Immersed With Shaders Immersed With Shaders All the Mods 10: To the Sky ATM10SKY All the Mods 10: To the Sky ATM10SKY Better MC [NEOFORGE] BMC5 Better MC [NEOFORGE] BMC5 Craftoria Craftoria FTB StoneBlock 4 FTB StoneBlock 4 All the Mons - ATMons All the Mons - ATMons Dungeon Heroes (RPG Series) Dungeon Heroes (RPG Series) Fantasy MC Fabric Fantasy MC Fabric Better MC [FABRIC] BMC3 Better MC [FABRIC] BMC3 All of Create All of Create Solo Leveling - Reawakening Solo Leveling - Reawakening Cobblemon Official Modpack [NeoForge] Cobblemon Official Modpack [NeoForge] FTB OceanBlock 2 FTB OceanBlock 2 Create+ Create+ MineColonies: Dimensional Adventure MineColonies: Dimensional Adventure All the Mods 11 - ATM11 All the Mods 11 - ATM11 New Game - An Improved Experience | 1.21 UPDATE! New Game - An Improved Experience | 1.21 UPDATE! All of Create - Aeronautics All of Create - Aeronautics Create Chronicles: The Endventure Create Chronicles: The Endventure Breakneck: Optimized | FPS Boost, Shaders & QoL Breakneck: Optimized | FPS Boost, Shaders & QoL OriginsSMP OriginsSMP FTB Skies 2 FTB Skies 2 Essentials Mods [FORGE] - 1.21 RELEASE! Essentials Mods [FORGE] - 1.21 RELEASE! Cobblemon Academy 2.0 Cobblemon Academy 2.0 Techopolis 3 Techopolis 3 New Simple Mods - Easy to Understand | 1.21 UPDATE! New Simple Mods - Easy to Understand | 1.21 UPDATE! More Animals [FORGE] - 1.21 UPDATE! More Animals [FORGE] - 1.21 UPDATE! All in one: Create All in one: Create FTB Evolution FTB Evolution The Cobblemon SMP - Pokemon in Minecraft The Cobblemon SMP - Pokemon in Minecraft Cobblemon Academy (Legacy) Cobblemon Academy (Legacy) Medieval MC [FABRIC] MMC3 Medieval MC [FABRIC] MMC3 Tensura Neo Otherworld Tensura Neo Otherworld Ultimate Lucky Oneblock Ultimate Lucky Oneblock MineField Mods MineField Mods Cobblemon.gg - Ultimate Pokemon Experience Cobblemon.gg - Ultimate Pokemon Experience Pixelmon Plus+ The Top Pokemon Experience in Pixelmon - Fully Optimized - Best Pixelmon Server - All Pokemon Pixelmon Plus+ The Top Pokemon Experience in Pixelmon - Fully Optimized - Best Pixelmon Server - All Pokemon TNP Limitless 8 - LL8 TNP Limitless 8 - LL8 Official Tensura: Reincarnated Survival Server Official Tensura: Reincarnated Survival Server Dreamcraft [FABRIC] Dreamcraft [FABRIC] KEO RPG optimized KEO RPG optimized Medieval MC [NEOFORGE] MMC5 Medieval MC [NEOFORGE] MMC5 Create: Stranded at Sea Create: Stranded at Sea More Decorations [FORGE] - 1.21 UPDATE! More Decorations [FORGE] - 1.21 UPDATE! Farmopolis Farmopolis [MODIFIED] Cobblemon: PLUS [MODIFIED] Cobblemon: PLUS FTB Skies 2 Aero FTB Skies 2 Aero ZS Pack (Tensura) ZS Pack (Tensura) Create on a Potato PC: Ultimate Create on a Potato PC: Ultimate All the Mods 10 Aeronautics All the Mods 10 Aeronautics Create Aeronautics - Skybound | Create Aeronautics & Create Addons with Quests Create Aeronautics - Skybound | Create Aeronautics & Create Addons with Quests MYTHCRAFT 5 MYTHCRAFT 5 BETTER FANTASY - Overture BETTER FANTASY - Overture Horrorland 2 - Psychological and Classic Horror Modpack (with Horror Quests) Horrorland 2 - Psychological and Classic Horror Modpack (with Horror Quests) New Revolution - An Improved Vanilla Experience | 1.21 UPDATE! New Revolution - An Improved Vanilla Experience | 1.21 UPDATE! All the Magic - Arcana All the Magic - Arcana Confluence: Journey's Start (Terraria ModPack) Confluence: Journey's Start (Terraria ModPack) Vanilla+ Lightweight | MC Vanilla+ 1.21.11 Vanilla+ Lightweight | MC Vanilla+ 1.21.11 All Of Farmer's Delight : Farming Agriculture & Cooking All Of Farmer's Delight : Farming Agriculture & Cooking Contained Opolis (A Space Adventure) Contained Opolis (A Space Adventure) FTB Presents: Direwolf20 - Season 14 FTB Presents: Direwolf20 - Season 14 Cobblemon Eternal: The Minecraft Pokémon Experience Cobblemon Eternal: The Minecraft Pokémon Experience Seaopolis Submerged 2 Seaopolis Submerged 2 Mayview (with Cobblemon!) Mayview (with Cobblemon!) Create Stellar Create Stellar More Realistic [FORGE] - 1.21 UPDATE! More Realistic [FORGE] - 1.21 UPDATE! Sensible MC Sensible MC Planeta Vegetta (Unofficial) Planeta Vegetta (Unofficial) Better Realism MC | Vanilla+ & Realism (Based on RealismCraft) Better Realism MC | Vanilla+ & Realism (Based on RealismCraft) Cobblemon Realms Cobblemon Realms Vagrant Saga - RPG Survival Adventure Vagrant Saga - RPG Survival Adventure Attack On Titan - Awakening Of The Titans Attack On Titan - Awakening Of The Titans Skyopolis: Evolved Skyopolis: Evolved More Biomes [FORGE] - 1.21 UPDATE! More Biomes [FORGE] - 1.21 UPDATE! Dragoncraft Dragoncraft Cobblemon Cobbletwo X MegaShowdown [1.7.3] (Pokemon Modpack) Cobblemon Cobbletwo X MegaShowdown [1.7.3] (Pokemon Modpack) All the Mods 10 Lite All the Mods 10 Lite Chosen's Create: Integrated Chosen's Create: Integrated Reimagined Reimagined Guild Adventures Guild Adventures Opolis Inc Opolis Inc Essentials Mods [FABRIC] - 1.21 RELEASE! Essentials Mods [FABRIC] - 1.21 RELEASE! Modded Together Modded Together Better MC [BMC6] Better MC [BMC6] From Magic To Tech From Magic To Tech TerraFirma: Rebirth TerraFirma: Rebirth VR experience | Immersion plus | [FABRIC] - [ 1.21.5!!] VR experience | Immersion plus | [FABRIC] - [ 1.21.5!!] NeoTech Reborn NeoTech Reborn Zombie Apocalypse: Last Days in the Wasteland | Survive Hordes of Zombies Zombie Apocalypse: Last Days in the Wasteland | Survive Hordes of Zombies The Best of Twilight Forest The Best of Twilight Forest More Dungeons [FORGE] - QUALITY UPDATE! More Dungeons [FORGE] - QUALITY UPDATE! Create and Guns Create and Guns Frozen Apocalypse | Survive the Ice Age Apocalypse Frozen Apocalypse | Survive the Ice Age Apocalypse More Animals [FABRIC] - 1.21 UPDATE! More Animals [FABRIC] - 1.21 UPDATE! The Zombie Conquest - Zombie Apocalypse (New Version) The Zombie Conquest - Zombie Apocalypse (New Version) Fractured Opolis Fractured Opolis Tensura reincarnated Anime Tensura reincarnated Anime Bountiful Farming - (formerly A Farmer's Delight) Bountiful Farming - (formerly A Farmer's Delight)

External Resources

CurseForge Modrinth Source Code Issues