# Stamina Attributes<\/p>\n
This API adds a stamina system controlled by entity attributes.<\/p>\n
## Default implementation<\/p>\n
LivingEntities can have up to **_staminaattributes:max_stamina_** amounts of stamina. Stamina is regenerated by **_staminaattributes:stamina_regeneration_** every **_staminaattributes:stamina_tick_threshold_** ticks.<\/p>\n
When stamina is reduced, regeneration is stopped for **_staminaattributes:stamina_regeneration_delay_threshold_** ticks.<\/p>\n
When stamina is <= 0, regeneration is stopped for **_staminaattributes:depleted_stamina_regeneration_delay_threshold_** ticks.\n\n**_staminaattributes:reserved_stamina_** describes the percentage amount of maximum stamina that is currently not available.\n\n**_staminaattributes:item_use_stamina_cost_** is the amount of stamina that is reduced when using an item with a stamina cost.\nThere are two ways to give an item a stamina cost:\n\n1. Items in the \"staminaattributes:using_costs_stamina\" item tag reduce stamina by **_staminaattributes:item_use_stamina_cost_**\n when they are used once. When stamina is < 0 the use action is not performed. In that case the item gets a cooldown,\n configured in the server config.\n2. Items in the \"staminaattributes:continuous_using_costs_stamina\" item tag reduce stamina by **_staminaattributes:item_use_stamina_cost_** every tick while they are used. When stamina is < 0, the usage is cancelled. In\n that case the item gets a cooldown, configured in the server config.\n\nThe different **_staminaattributes:*_tick_stamina_cost_** attributes describe the stamina cost for the corresponding activity. This cost is\napplied every tick (20x per second). This includes the following activities:\n\n- sprinting\n- sneaking\n- walking\n- swimming\n- walking underwater\n- walking in water\n- climbing\n\nThe different **_staminaattributes:*_action_stamina_cost_** attributes describe the stamina cost for the corresponding actions. This cost is\napplied once every time the action is performed. This includes the following actions:\n\n- jumping\n- sprint jumping\n- attack blocking\n- attacking\n- block breaking\n\nSeveral activities and actions can be configured to require stamina. If stamina is 0 or lower, they can't be performed.\nThis includes:\n\n- jumping\n- sprinting\n- swimming\n- attacking\n- block breaking\n- attacking\n- attack blocking\n\nBlocks that can be broken instantly by hand (blocks with a \"destroyTime\" of 0) can be excluded from the stamina\nrequirement.\n\n### Exhaustion\n\nIf a player has 0 or less stamina, they are exhausted, which means that a status effect is applied. This status effect\nis defined in the server config.\n\nThis feature can be enabled in the server config, but it's disabled by default.\n\n### Default attribute values\n\n- **_staminaattributes:max_stamina_**: 10 (10 for players)\n- **_staminaattributes:stamina_regeneration_**: 0 (1 for players)\n- **_staminaattributes:stamina_tick_threshold_**: 20\n- **_staminaattributes:stamina_regeneration_delay_threshold_**: 20\n- **_staminaattributes:depleted_stamina_regeneration_delay_threshold_**: 60\n- **_staminaattributes:reserved_stamina_**: 0\n- **_staminaattributes:item_use_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:sprinting_tick_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:sneaking_tick_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:walking_tick_stamina_cost_**: 0\n- **_staminaattributes:swimming_tick_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:walking_underwater_tick_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:walking_in_water_tick_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:climbing_tick_stamina_cost_**: 0 (0.05 for players)\n- **_staminaattributes:jumping_action_stamina_cost_**: 0 (1 for players)\n- **_staminaattributes:sprint_jumping_action_stamina_cost_**: 0 (1 for players)\n- **_staminaattributes:attack_blocking_action_stamina_cost_**: 0 (1 for players)\n- **_staminaattributes:attacking_action_stamina_cost_**: 0 (1 for players)\n- **_staminaattributes:block_breaking_action_stamina_cost_**: 0 (1 for players)\n\nAll default values for players can be set in the server config.\n\n### Default item tags\n\n\"staminaattributes:using_costs_stamina\":\n\n```json\n{\n\t\"values\": [\n\t\t\"minecraft:snowball\"\n\t]\n}\n```\n\n\"staminaattributes:continuous_using_costs_stamina\":\n\n```json\n{\n\t\"values\": [\n\t\t\"minecraft:bow\",\n\t\t\"minecraft:crossbow\",\n\t\t\"minecraft:shield\"\n\t]\n}\n```\n\n## Customization\n\nThe client config allows customizing the HUD element.\n\n## Using the stamina system\n\n### Java\n\nCasting a \"LivingEntity\" to the \"StaminaUsingEntity\" interface gives access to all relevant methods.\n\n### Data packs\n\nStamina Attributes implements several data driven methods to interact with the current stamina value of an entity.\n\n- the \"staminaattributes:add_stamina\" enchantment effect allows adding a defined amount to the current stamina\n- the \"staminaattributes:stamina_using_entity\" entity sub predicate passes when the current stamina of an entity matches\n the defined range\n\n#### Example\n\nThis enchantment reduces stamina of the attacker by 2, as long as the attacker has at least 5 stamina:\n\n```json\n{\n\t\"anvil_cost\": 1,\n\t\"description\": {\n\t\t\"translate\": \"enchantment.staminaattributes.test\"\n\t},\n\t\"effects\": {\n\t\t\"minecraft:post_attack\": [\n\t\t\t{\n\t\t\t\t\"affected\": \"attacker\",\n\t\t\t\t\"effect\": {\n\t\t\t\t\t\"type\": \"staminaattributes:add_stamina\",\n\t\t\t\t\t\"amount\": {\n\t\t\t\t\t\t\"type\": \"minecraft:linear\",\n\t\t\t\t\t\t\"base\": -2.0,\n\t\t\t\t\t\t\"per_level_above_first\": -2.0\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t\"enchanted\": \"attacker\",\n\t\t\t\t\"requirements\": {\n\t\t\t\t\t\"condition\": \"minecraft:entity_properties\",\n\t\t\t\t\t\"entity\": \"direct_attacker\",\n\t\t\t\t\t\"predicate\": {\n\t\t\t\t\t\t\"type_specific\": {\n\t\t\t\t\t\t\t\"type\": \"staminaattributes:stamina_using_entity\",\n\t\t\t\t\t\t\t\"stamina_amount\": {\n\t\t\t\t\t\t\t\t\"min\": 5.0\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t]\n\t},\n\t\"max_cost\": {\n\t\t\"base\": 25,\n\t\t\"per_level_above_first\": 8\n\t},\n\t\"max_level\": 1,\n\t\"min_cost\": {\n\t\t\"base\": 5,\n\t\t\"per_level_above_first\": 8\n\t},\n\t\"slots\": [\n\t\t\"hand\"\n\t],\n\t\"supported_items\": \"#minecraft:swords\",\n\t\"weight\": 5\n}\n```\n<\/p>\n","protected":false},"excerpt":{"rendered":"
A small API that adds a stamina system controlled by entity attributes.<\/p>\n","protected":false},"featured_media":147942,"template":"","meta":{"_minecraft_slug":"stamina-attributes","_minecraft_project_id":"QKOE26gD","_minecraft_author":"TheRedBrain","_minecraft_license":"MIT","_minecraft_downloads":32609,"_minecraft_follows":26,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"stamina-attributes.zip","_minecraft_size_bytes":1857695,"_minecraft_version_count":28,"_minecraft_updated_at":"2026-05-16T15:35:51.602353Z","_minecraft_date_created":"2024-05-06T04:35:35.616855Z","_minecraft_date_modified":"2026-04-16T15:01:14.006403Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/stamina-attributes","_minecraft_icon_attachment_id":147942,"_minecraft_imported_at":"2026-06-08T21:10:44+00:00","_minecraft_import_hash":"9dffd42787e3667355454b36f82b7275","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,97,89,873],"mod_loader":[99],"minecraft_version":[36,62,37,40,41,83,167,163],"class_list":["post-147941","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-fabric","mod_category-game-mechanics","mod_category-library","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n