Claude Code: Rate Limited

Claude Code: Rate Limited is a gameplay mod for Minecraft Java Edition that introduces a new equipment resource system based on Claude Tokens.

Items enchanted with Claude Code receive their own token pool. Using the item consumes tokens, while reaching zero causes the item to become Rate Limited until it recovers.

The system adds an additional layer of equipment management without replacing Minecraft's normal survival progression.

Claude Code Enchantment

The mod adds three enchantment levels:

• Claude Code I — 60 maximum tokens

• Claude Code II (Pro) — 150 maximum tokens

• Claude Code III (Max) — 350 maximum tokens

The enchantment supports:

• Swords

• Axes

• Pickaxes

• Shovels

• Hoes

• Armor

• Bows

• Crossbows

• Shields

Every enchanted item stores and manages its tokens independently.

Token Usage

Tokens are consumed when enchanted equipment is used.

Examples include:

• Normal attacks

• Critical attacks

• Tool usage

• Using bows and crossbows

• Blocking with shields

• Taking damage while wearing enchanted armor

While an item has available Claude Tokens, it is protected from normal durability loss.

A warning appears when an item reaches 10% of its maximum token capacity.

Rate Limited

When an item's tokens reach zero:

• The item becomes Rate Limited

• Attacks and tool actions are blocked

• Bows and crossbows cannot be used

• Shields cannot block

• Other item actions are disabled

• The player may receive temporary negative effects

The item becomes usable again after recovering at least 10% of its maximum tokens.

This mechanic encourages players to rotate and manage their equipment instead of depending permanently on one powerful item.

Passive Recovery

Claude Code items gradually recover tokens over time.

Recovery times depend on the enchantment level:

• Claude Code I: 20 minutes

• Claude Code II (Pro): 15 minutes

• Claude Code III (Max): 10 minutes

After an item becomes Rate Limited, passive recovery starts following a short delay.

Recovery continues while the item is stored in a player inventory or container.

Claude Terminal

The Claude Terminal is a custom block that restores Claude Code items significantly faster.

Place an enchanted item into the terminal and spend experience levels to begin recovery:

• Level I: 3 experience levels

• Level II: 7 experience levels

• Level III: 15 experience levels

The terminal provides a custom interface displaying:

• Current tokens

• Maximum token capacity

• Recovery progress

• Recovery status

Terminal progress is saved across world reloads, server restarts, and chunk unloads.

Loot-Based Progression

Claude Code enchanted books cannot be obtained from the normal Enchanting Table, librarian trades, or fishing.

Instead, books can be discovered in structure loot, including:

• Dungeons

• Bastions

• End Cities

• Other selected structures

Higher enchantment levels are considerably rarer.

Books can be applied to compatible equipment through an anvil. Claude Code III cannot be created by combining two Claude Code II books.

Advancements

The mod includes a dedicated advancement tree with challenges related to:

• Finding Claude Code books

• Unlocking higher enchantment levels

• Running out of tokens

• Recovering Rate Limited equipment

• Using the Claude Terminal

• Mastering the token economy

Commands

The following administrative commands are available:

/claude_refill

Restores the Claude Code item held by the player.

/claude_refill all

Restores every Claude Code item in the player's inventory.

Multiplayer

Claude Code: Rate Limited supports multiplayer and dedicated servers.

Gameplay mechanics are synchronized server-side so token counts, recovery progress, equipment restrictions, and terminal interactions remain consistent for all players.

Requirements

• Minecraft Java Edition 1.21.1

• Fabric Loader 0.16 or newer

• Fabric API

• Java 21

The mod must be installed on both the client and server when playing multiplayer.

Languages

• English

• Russian

Feedback and Bug Reports

Bug reports, feedback, and feature suggestions can be submitted through the project's GitHub repository.

Disclaimer

This is an independent, fan-made Minecraft mod inspired by modern AI tools.

It is not affiliated with, endorsed by, sponsored by, or officially connected to Anthropic. Claude and Claude Code are trademarks or product names associated with their respective owner.

FILE DISPLAY NAME

Claude Code: Rate Limited 1.0.0 — Fabric 1.21.1

FILE CHANGELOG

Claude Code: Rate Limited 1.0.0

Initial public release.

Added

• Added the Claude Code enchantment with three levels

• Added independent token storage for enchanted equipment

• Added token consumption for weapons, tools, armor, bows, crossbows, and shields

• Added Rate Limited equipment state

• Added passive token recovery

• Added low-token warnings

• Added durability protection while tokens are available

• Added the Claude Terminal block and custom interface

• Added experience-based terminal recovery

• Added recovery persistence across reloads and server restarts

• Added Claude Code enchanted books to structure loot

• Added a dedicated advancement tree

• Added administrative refill commands

• Added multiplayer and dedicated-server synchronization

• Added English and Russian localization

Claude Code: Rate Limited

Claude Code: Rate Limited is a Fabric mod for Minecraft 1.21.1 that introduces a completely new durability system based on Claude Code Tokens.

Instead of relying only on traditional durability, enchanted equipment has its own token pool. Every action consumes tokens, creating a new layer of resource management and strategy.

Features

Claude Code Enchantment

Three enchantment levels are available:

• Claude Code I
• Claude Code II (Pro)
• Claude Code III (Max)

Higher levels provide larger token capacities.

Token System

Every enchanted item stores its own amount of Claude Tokens.

Tokens are consumed while using the item.

Examples:

• Attacking enemies
• Receiving damage while wearing enchanted armor
• Using enchanted equipment

Each item tracks its own token count independently.

Rate Limited

When an item's token limit reaches zero:

• The item becomes Rate Limited
• It can no longer be used
• The player receives temporary negative effects
• The item must recover before becoming usable again

This mechanic encourages players to manage their equipment instead of relying on a single overpowered item.

Claude Terminal

The Claude Terminal is a special block used to recover Claude Tokens.

Players can restore enchanted items faster by spending experience levels.

The terminal includes a custom interface showing:

• Current tokens
• Maximum tokens
• Recovery progress
• Recovery status

Loot Progression

Claude Code books cannot be obtained from the Enchanting Table.

Instead, they are found naturally while exploring Minecraft structures.

Examples include:

• Dungeons
• Bastions
• End Cities

Higher enchantment levels are significantly rarer.

Advancements

The mod adds its own advancement tree, including achievements for:

• Obtaining Claude Code books
• Running out of tokens
• Recovering items
• Discovering advanced mechanics

Multiplayer

The mod fully supports multiplayer and dedicated servers.

All gameplay mechanics are handled server-side to ensure proper synchronization.

Compatibility

• Minecraft 1.21.1
• Fabric Loader
• Fabric API

Future Plans

This is the first public release.

Future updates may include:

• More structures
• Additional mechanics
• New progression systems
• More achievements
• Better visual effects

Thank you for trying Claude Code: Rate Limited! Feedback, bug reports, and suggestions are always appreciated.

Disclaimer

This project is a fan-made Minecraft mod inspired by modern AI tools. It is an independent community project and is not affiliated with, endorsed by, or sponsored by Anthropic.