Common Toolkit

🧩 Common Toolkit

A NeoForge library mod providing shared developer utilities: declarative config, networking helpers, dynamic JSON-driven registries with client sync, weighted gear/brewing-mix systems, and creative tab filling.

✨ Overview

Common Toolkit is not a gameplay mod by itself — it is a library that other mods depend on. It bundles a set of infrastructure pieces that are tedious to rebuild from scratch for every mod: config declaration, network payload plumbing, JSON/datapack-driven registries that stay in sync between server and client, and a couple of ready-made registries (gear sets, brewing mixes) built on top of that infrastructure. If you were told to install this mod, it's because another mod on the pack depends on it — it adds no content on its own.

🎯 Features

⚙️ Configuration

Declarative common/client/server config definitions with an in-game config screen, without the boilerplate of hand-rolling a ModConfigSpec for every value.

🔄 Dynamic Registries

JSON-driven registries that reload with datapacks and automatically sync their contents from server to client over the network — both weighted (for random-selection use cases) and unweighted variants.

📡 Networking Helper

A thin layer over NeoForge's payload API that removes the repetitive registration/handling boilerplate for custom network packets.

🎯 Gear Sets & Brewing Mixes

Two ready-made dynamic registries built on the framework above: weighted, JSON-configurable equipment sets and custom brewing recipes, meant to be consumed by other mods' game logic.

📦 Creative Tab Filling

Declarative registry to inject items into existing creative tabs (vanilla or modded) without writing an event handler per mod.

🌈 Color & Codec Utilities

Gradient color helpers and common Codec/StreamCodec building blocks shared across the utilities above.

📄 Requirements

🎮 How to Use

1. Install as a dependency of another mod that requires it, on both client and server.
2. No configuration is needed to simply run it — it only exposes APIs and registries for other mods to build on.

🙏 Credits

Common Toolkit is a rewritten, independently branded port of Placebo by Shadows_of_Fire (MIT License), retargeted to Minecraft 26.2 under a new mod id, package and API. The original Patreon-gated cosmetic system was removed. See the repository's NOTICE.md for full attribution, including an embedded LGPL-2.1 portion originally from Minecraft Forge's configuration system.

Developed by Stalking Dragons.

https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft Modding