Sentient Tools is a vanilla‑adjacent Minecraft mod where tools and weapons slowly develop personalities based on how you play. The goal is subtle, atmospheric feedback—not loud events or constant buffs. Your tools feel alive, but never intrusive.

Over time, each eligible tool awakens with a personality trait. Traits react to combat, mining, right‑click use, and time‑based moods. Effects are low‑frequency and lightweight, designed for long survival worlds.

• Hidden traits that shape how a tool behaves.
• Mood system that shifts with your activity.
• Subtle reactions (particles, short buffs, small bonuses) instead of loud mechanics.
• Server‑side logic with optional client tooltip support.

Sentient traits can awaken on:

• Tools (pickaxes, axes, shovels, hoes)
• Weapons (swords, tridents)
• Ranged weapons (bows, crossbows)

When you first use a valid tool, it receives a random trait. Traits are stored in the item’s NBT data and persist across sessions.

Each tool tracks recent activity to determine mood:

• Alert — very recent action
• Restless — active but not constant
• Calm — long lull
• Dormant — unused for a long time

Moods subtly adjust cooldowns and flavor text. Some traits react differently based on mood.

Traits are designed to be light and situational, not power‑creep. All effects are intentionally modest.

• Aggressive — Combat streaks can trigger extra damage; sneak + right‑click to surge.
• Adaptive — Reacts to mood; sneak + right‑click grants a mood‑based buff.
• Artisan — Careful tuning restores small durability or grants minor boosts.
• Brave — Grants resistance/strength when danger rises.
• Cautious — Slows in danger; defensive brace on use.
• Curious — Studies blocks and reveals observations.
• Focused — Mining streaks trigger haste.
• Greedy — Ores can grant extra XP; luck burst on use.
• Lazy — Sometimes refuses to work; can be coaxed to cooperate.
• Luminous — Glows in darkness; night vision on use.
• Meticulous — Preserves durability; self‑tunes on use.
• Nervous — Jittery boosts in danger; escape burst on use.
• Protective — Shields you when hostiles are near.
• Reckless — Risky bonus damage with a trade‑off.
• Siphoning — Sometimes heals on hit; regen + absorption on use.
• Stoic — Steadies you when low on health.
• Swift — Mining rhythm triggers haste bursts.
• Talkative — Whispers about weather, biome, and nearby threats.
• Zealous — Chase‑focused speed bursts.

• Sneak + right‑click is used by many traits to trigger active effects.
• Most reactions are chance‑based with cooldowns.
• Effects are tuned to be subtle, not dominant.

Requires OP level 2.

• /sentienttools reroll — Randomizes the current tool’s trait and clears stats.
• /sentienttools info — Shows trait and usage stats for the held tool.

The core logic runs server‑side, so it works on multiplayer servers. Clients only need the mod for tooltip UI support.

This project is licensed under the MIT License.