Vanilla crafting, controlled progression
Tool progression for Paper servers.
CoreToolsX adds a server-owned path from wood to diamond or gold, protects direct crafting where needed, and gives netherite tools configurable visual skins without databases, GUIs, economy hooks, or a mandatory resource pack.
- Paper 1.21.11+
- Java 21+
- YAML driven
- Optional pack
Core feature set
Tool progression with clean vanilla behavior.
CoreToolsX keeps normal upgraded tools clean, stores plugin identity only where it is needed, and uses runtime recipe validation to make crafting predictable for real servers.
Controlled Tool Progression
Default recipes move tools through Wood, Stone, Copper, Iron, and Diamond, with Gold as an optional endpoint branch from Iron.
Runtime-Safe Recipes
YAML recipes support ingredient groups, one-item-slot matching, recipe book discovery, and safe reloads without duplicated CoreToolsX recipes.
Netherite Visual Skins
Netherite tools can look like wood, stone, copper, iron, gold, or diamond while keeping netherite-equivalent tool behavior.
Metadata Preservation
Names, original lore, enchants, damage, trims, flags, unbreakable state, compatible custom data, and non-CoreToolsX PDC are preserved.
Inventory Model Modes
Skinned tools can use no-pack VISUAL_SKIN mode or resource-pack-backed REAL_TIER inventory models.
Supported Tool Types
Swords, pickaxes, axes, shovels, hoes, and spears share the same upgrade and skin cost model.
Configurable Lore
skins.lore.generated-lines controls generated lore and places saved original lore through {item_lore}.
Skin Removal
Skinned tools can be crafted with the configured tool, shears by default, to restore clean netherite tools.
Fire and Lava Rules
Dropped skinned tools can be protected from fire and lava or stripped back to clean netherite instead of being destroyed.
Permission Progression
Optional locks use permissions for upgrades, skins, tool usage, and global bypass. CoreToolsX stores no player unlock database.
Custom Item Protection
Foreign PDC/custom item data can block transformations to avoid corrupting items from other systems.
Admin Commands
/coretoolsx reload, inspect, and fixitem cover normal production operations.
Why CoreToolsX
Progression control without turning tools into a database system.
The plugin is designed for owners who want a stronger crafting path and cosmetic netherite skins, but still want vanilla items, vanilla crafting, and simple YAML operations.
Normal Upgrades Stay Clean
Upgraded tools use Bukkit material as the source of truth and do not receive CoreToolsX PDC.
Skins Carry Explicit Identity
Only skinned tools store clean material, skin identity, lore snapshot, model mode, and optional durability state.
No Heavy Integrations Required
Vault, PlaceholderAPI, databases, custom GUIs, CoreArmorX, custom item plugins, and mandatory resource packs are not required.
Setup and compatibility
Built for modern Paper servers.
Install the jar on Paper, let the default YAML files generate, then tune recipes, skins, progression locks, and lore in the plugin data folder.
Paper 1.21.11+
CoreToolsX is Paper-only and targets Java 21+. It does not ship proxy, web, or database modules.
- Paper server plugin
- Java 21+
- Vanilla crafting table flow
Four YAML surfaces
Global behavior, upgrade paths, skins, and messages are split into focused files under plugins/CoreToolsX/.
config.ymltool-upgrades.ymltool-skins.ymlmessages.yml
Resources
Docs for setup, configuration, and production checks.
Documentation Hub
Entry point for setup, feature overview, configuration reference, FAQ, and operational checks.
ProductProduct Overview
Detailed view of upgrade recipes, netherite skins, metadata handling, permissions, and scope.
SetupInstallation Guide
Requirements, generated files, reload boundaries, first tests, and validation sequence.
ConfigConfiguration Reference
YAML file map, runtime model, permissions, troubleshooting, and production checklist.
FAQComplete FAQ
Short answers for requirements, skins, PDC, permissions, lore, fire/lava behavior, and custom items.
OpsTroubleshooting
Recipe discovery, permissions, stale lore, skin durability, usage locks, and reload checks.
FAQ preview
Answers before opening the config files.
These are short operational answers. Use the configuration reference when you need exact keys and reload rules.
Does CoreToolsX require a resource pack?
No. The default VISUAL_SKIN mode uses vanilla tool materials and vanilla crafting behavior. The pack is only for REAL_TIER inventory models.
Does it store player unlock data?
No. Progression locks are permission-based. Use a permission plugin such as LuckPerms when locks are enabled.
Do normal upgraded items get CoreToolsX PDC?
No. Normal upgraded tools stay clean; CoreToolsX PDC is used for skinned tools and internal skin state.
Can skinned tools be returned to netherite?
Yes. The default removal recipe uses a skinned tool plus shears to restore a clean netherite tool.
Also try
More CoreX plugins for the same server stack.
Each project stays focused, so you can add only the systems your Paper server actually needs.
CoreArmorX
Vanilla+ armor upgrade paths, netherite skins, metadata-safe conversions, and YAML control.
CoreCaseX
Structured player reports, staff triage, evidence, replies, notes, and resolution workflows.
CoreChatX
Channels, private messages, pings, ChatItems, moderation, bridges, locales, and Velocity support.
CoreExtractionX
YAML-driven block extraction, block replacement, natural drops, and configurable extra item drops.
Ready to test the progression path?
Install CoreToolsX, generate defaults, and craft through the chain.
Start with the setup guide, then tune recipes, skins, lore, and permission locks from YAML.