Skip to content

AaravVishal1/Sentient-Tools

Repository files navigation

Sentient Tools

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.


Key Features

  • 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.

How It Works

Eligible Items

Sentient traits can awaken on:

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

Trait Awakening

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.

Mood System

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 (Current)

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.

Gameplay Notes

  • 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.

Commands

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.

Multiplayer

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


Installation

  1. Install Fabric and Fabric API for Minecraft 1.20.1.
  2. Place the mod JAR into your mods folder.
  3. Launch Minecraft.

License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages