Skip to content
Kerzinator_24
Download

Attribute-Tweaker Introduction

The Attribute-Tweaker extension provides comprehensive control over Minecraft player attributes, allowing server administrators to create dynamic gameplay mechanics through Typewriter’s powerful event system.

Status: This extension is currently in development and will be available soon. A rewrite is currently in progress to migrate from sequence entries to the manifest system for better flexibility. You can apply for early access to help test and improve the extension.

What are Attributes? Minecraft attributes are core player statistics like health, movement speed, attack damage, and more that define how players interact with the world.

What is Attribute-Tweaker?

Section titled “What is Attribute-Tweaker?”

Attribute-Tweaker seamlessly integrates with Typewriter to provide fine-grained control over player attributes, enabling:

  • Dynamic Attribute Modification: Temporarily or permanently modify any player attribute
  • Conditional Attribute Changes: Apply attribute modifications based on conditions, events, or player states
  • Attribute-Based Triggers: Create events that respond to attribute changes or thresholds
  • Custom Attribute Systems: Build complex progression systems using attribute manipulation
  • Equipment-Independent Stats: Modify player capabilities without relying on item attributes

List of supported Attributes

Section titled “List of supported Attributes”

Combat Attributes

Section titled “Combat Attributes”
  • MAX_HEALTH: Player’s maximum health points
  • ATTACK_DAMAGE: Base melee attack damage
  • ATTACK_SPEED: Speed of melee attacks
  • ATTACK_KNOCKBACK: Strength of knockback when attacking
  • ARMOR: Damage reduction from armor
  • ARMOR_TOUGHNESS: Additional armor effectiveness
  • KNOCKBACK_RESISTANCE: Resistance to being knocked back
  • EXPLOSION_KNOCKBACK_RESISTANCE: Resistance to knockback from explosions
  • SWEEPING_DAMAGE_RATIO: Damage ratio for sweeping attacks

Movement Attributes

Section titled “Movement Attributes”
  • MOVEMENT_SPEED: Walking and running speed
  • FLYING_SPEED: Creative/spectator mode flying speed
  • MOVEMENT_EFFICIENCY: General movement efficiency
  • WATER_MOVEMENT_EFFICIENCY: Movement efficiency in water
  • SNEAKING_SPEED: Movement speed while sneaking
  • JUMP_STRENGTH: Power of jumps
  • STEP_HEIGHT: Maximum step height without jumping
  • FALL_DAMAGE_MULTIPLIER: Multiplier for fall damage
  • SAFE_FALL_DISTANCE: Distance a player can fall without taking damage
  • GRAVITY: Effect of gravity on the player

Interaction Attributes

Section titled “Interaction Attributes”
  • BLOCK_INTERACTION_RANGE: Distance for interacting with blocks
  • ENTITY_INTERACTION_RANGE: Distance for interacting with entities
  • BLOCK_BREAK_SPEED: Speed of breaking blocks
  • MINING_EFFICIENCY: Efficiency of mining operations
  • SUBMERGED_MINING_SPEED: Mining speed while underwater
  • TEMPT_RANGE: Range at which entities can be tempted

Special Attributes

Section titled “Special Attributes”
  • LUCK: Affects loot table outcomes
  • MAX_ABSORPTION: Maximum absorption health points
  • SCALE: Player body size
  • BURNING_TIME: Duration of burning effects
  • OXYGEN_BONUS: Additional oxygen while underwater

Key Features

Section titled “Key Features”

1. Comprehensive Attribute Control

Section titled “1. Comprehensive Attribute Control”
  • Modify all vanilla Minecraft attributes including health, speed, damage, and more
  • Support for both temporary and permanent attribute changes
  • Precise control over attribute modifiers with different operation types

2. Event-Driven Integration

Section titled “2. Event-Driven Integration”
  • Trigger attribute changes through Typewriter entries and sequences
  • Create conditional logic based on current attribute values
  • Respond to attribute changes with custom events and actions

3. Advanced Modifier System

Section titled “3. Advanced Modifier System”
  • Additive Modifiers: Add flat values to base attributes
  • Multiplicative Modifiers: Apply percentage-based modifications
  • Multiplicative Total: Modify the final calculated value
  • Custom Duration: Set temporary modifiers with automatic expiration

4. Player State Management

Section titled “4. Player State Management”
  • Track and store attribute modifications per player
  • Persist attribute changes across server restarts
  • Create complex attribute-based progression systems

Use Cases

Section titled “Use Cases”

RPG Progression Systems

Section titled “RPG Progression Systems”

Create sophisticated character progression where players gain attribute improvements through:

  • Completing quests and achievements
  • Reaching certain milestones or levels
  • Discovering hidden areas or items
  • Participating in events or challenges

Dynamic Difficulty Scaling

Section titled “Dynamic Difficulty Scaling”

Adjust player capabilities based on:

  • Current area or dungeon difficulty
  • Time of day or season
  • Player performance or skill level
  • Server events or conditions

Temporary Power-ups

Section titled “Temporary Power-ups”

Implement consumable or temporary effects such as:

  • Strength potions that increase attack damage
  • Speed boosts for racing events
  • Health bonuses for boss encounters
  • Defensive buffs for PvP scenarios

Equipment-Free Character Building

Section titled “Equipment-Free Character Building”

Design character systems that don’t rely on equipment:

  • Class-based attribute distributions
  • Skill trees that directly affect player stats
  • Achievement-based permanent improvements
  • Social or economic status affecting capabilities

Getting Started

Section titled “Getting Started”

To begin using Attribute-Tweaker:

  1. Install the Extension: Download and install the latest version compatible with your Typewriter setup
  2. Learn the Basics: Understand how attributes work and how to modify them safely
  3. Create Your First System: Start with simple attribute modifications and build complexity gradually
  4. Test Thoroughly: Always test attribute changes in a safe environment before deploying to production, since attribute modifications can significantly impact gameplay

Start building amazing attribute-based systems that will enhance your players’ experience!