Feathers Weaponry

This mod deducts feathers based on weapon usage, prevents actions at low feathers, and applies penalties like Weakness and Mining Fatigue.

File Details

Feathers Weaponry - 1.20.1 - 1.0.2

  • R
  • Oct 15, 2025
  • 24.92 KB
  • 175
  • 1.20.1
  • Forge

File Name

feathersweaponry-1.0.2.jar

Supported Versions

  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:feathers-weaponry-1213165:7108695")
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

Feathers Weaponry v1.0.2 - Changelog

New Features

0. Learning Curve System ⭐ NEW!

  • Progressive cost reduction as players gain experience
  • Uses Minecraft's built-in player statistics
  • Tracks: walking, running, swimming, flying, jumping, weapon usage, item usage
  • Minimum cost cap: 10% of original cost (configurable)
  • Fully configurable: learning rate, max stat requirement, minimum multiplier
  • Examples:
    • Walk 100,000 blocks → Walking costs only 10% feathers
    • Kill 100,000 mobs → Weapon attacks cost only 10% feathers
    • Use bow 100,000 times → Drawing bow costs only 10% feathers
  • See LEARNING_CURVE_FEATURE.md for detailed documentation

1. Enhanced Punishment System - "Rotator Cuff Tears"

  • Trigger: Activates when feathers drop below 2 during weapon/tool usage
  • Difficulty: Only active on Hard and Hardcore difficulty (configurable)
  • Damage: Weighted random damage system
    • 70% chance: 0.5-1 heart (low damage)
    • 20% chance: 1-2 hearts (medium damage)
    • 10% chance: 2-3 hearts (high damage)
  • Effects: Mining Fatigue with level and duration based on damage dealt
  • No cooldown: Can trigger repeatedly when exhausted

2. Shield Feather Costs

Dual-mode system (both modes active simultaneously):

Mode 1 - Overtime Blocking:

  • Cost: 0.5 feathers per 2 seconds while shield is raised
  • Tracks shield usage time

Mode 2 - Damage Blocking:

  • Cost formula: ceil(damage_blocked * 0.1) feathers
  • Tracks shield durability loss to determine damage blocked
  • More damage blocked = more feathers lost

3. Right-Click Item Restrictions

  • Minimum: 1 feather required (configurable)
  • Item-specific costs: Items with higher feather costs require more feathers
  • Exceptions: Does NOT affect eating or drinking
  • Block placement: Restricted to prevent ghost blocks
  • Animation cancellation: Configurable option to cancel animations when insufficient feathers

4. Left-Click Item Restrictions

  • Minimum: 0.5 feathers required (configurable)
  • Item-specific costs: Weapons/tools with higher costs require more feathers
  • Affects: All weapons, tools, and mining actions
  • Animation cancellation: Configurable option to cancel swing animations

5. Movement Feather Costs

Per-tick feather consumption based on movement type:

  • Swimming: 0.5 feathers/second (high cost)
  • Running/Sprinting: 0.2 feathers/second (moderate)
  • Flying (elytra/creative): 0.1 feathers/second (low)
  • Walking: 0.05 feathers/second (minimal)
  • Sneaking/Crawling: 0 feathers (free)

6. Activity-Specific Punishments

Each movement type has unique exhaustion punishments when feathers drop below 2:

Swimmer's Shoulder (Swimming):

  • Damage: 0.5-1.5 hearts
  • Effects: Mining Fatigue II (15s), Slowness I (10s), Hunger II (20s)
  • Triggers after 5+ seconds of continuous swimming

Runner's Fatigue (Sprinting):

  • Damage: 0.5-1 heart
  • Effects: Slowness II (20s), Weakness I (10s), Hunger III (30s)
  • Triggers after 5+ seconds of continuous sprinting

Pilot's Strain (Flying):

  • Damage: 0.5-1 heart
  • Effects: Downward Levitation (3s), Nausea (7s)
  • Triggers after 5+ seconds of continuous flying

Walker's Cramp (Walking):

  • Damage: 0.5 heart
  • Effects: Slowness I (15s), Hunger I (15s)
  • Triggers after 10+ seconds of continuous walking

Configuration

New Config Options

All new features are fully configurable in feathersweaponry-common.toml:

Punishment System:

  • rotatorCuffEnabled - Enable/disable Rotator Cuff Tears
  • rotatorCuffMinDamage - Minimum damage (default: 1.0 = 0.5 hearts)
  • rotatorCuffMaxDamage - Maximum damage (default: 6.0 = 3 hearts)
  • rotatorCuffHardModeOnly - Restrict to Hard/Hardcore only

Shield Costs:

  • shieldOvertimeEnabled - Enable overtime shield cost
  • shieldOvertimeCost - Feathers per second (default: 0.5)
  • shieldDamageEnabled - Enable damage-based shield cost
  • shieldDamageFactor - Damage multiplier (default: 0.1)

Item Restrictions:

  • rightClickMinFeathers - Min feathers for right-click items (default: 1)
  • leftClickMinFeathers - Min feathers for left-click items (default: 0.5)
  • cancelAnimations - Cancel animations when insufficient feathers

Movement Costs:

  • movementCostsEnabled - Enable movement feather costs
  • swimmingCostPerSecond - Swimming cost (default: 0.5)
  • runningCostPerSecond - Running cost (default: 0.2)
  • flyingCostPerSecond - Flying cost (default: 0.1)
  • walkingCostPerSecond - Walking cost (default: 0.05)

Activity Punishments:

  • activityPunishmentsEnabled - Enable activity punishments
  • activityPunishmentsHardModeOnly - Restrict to Hard/Hardcore only
  • swimmerShoulderMinDamage / swimmerShoulderMaxDamage
  • runnerFatigueMinDamage / runnerFatigueMaxDamage
  • pilotStrainMinDamage / pilotStrainMaxDamage
  • walkerCrampDamage

Learning Curve:

  • learningCurveEnabled - Enable learning curve system (default: true)
  • learningCurveMinMultiplier - Minimum cost after full training (default: 0.1)
  • learningCurveMaxStat - Stat value for full training (default: 100000)
  • learningCurveRate - Learning speed multiplier (default: 1.0)

Config Migration

  • Config version tracking added for future migrations
  • Existing configs will automatically receive new default values
  • Custom values from v1.0.1 are preserved