# Durability Ping

## Commands

<table><thead><tr><th width="306" align="right">Command</th><th>Info</th></tr></thead><tbody><tr><td align="right">/durabilityping config</td><td><strong>Permission:</strong> vanillatweaks.durabilityping.config<br><strong>Description:</strong> Configure personal durability ping settings</td></tr><tr><td align="right">/durabilityping config reset</td><td><strong>Permission:</strong> vanillatweaks.durabilityping.config<br><strong>Description:</strong> Reset personal settings to their defaults</td></tr><tr><td align="right">/durabilityping admin config</td><td><strong>Permission:</strong> vanillatweaks.durabilityping.admin.config<br><strong>Description:</strong> Configure global durability ping settings</td></tr><tr><td align="right">/durabilityping admin config reset</td><td><strong>Permission:</strong> vanillatweaks.durabilityping.admin.config<br><strong>Description:</strong> Reset global durability ping settings to their defaults</td></tr></tbody></table>

## Permissions

<table><thead><tr><th width="360" align="right">Permission</th><th>Info</th></tr></thead><tbody><tr><td align="right">vanillatweaks.durabilityping.config</td><td><strong>Default:</strong> <mark style="color:green;">true</mark><br><strong>Description:</strong> Use both /dp config commands</td></tr><tr><td align="right">vanillatweaks.durabilityping.notification</td><td><strong>Default:</strong> <mark style="color:green;">true</mark><br><strong>Description:</strong> Allows a notification to be shown</td></tr><tr><td align="right">vanillatweaks.durabilityping.admin.config</td><td><strong>Default:</strong> <mark style="color:orange;">op</mark><br><strong>Description:</strong> Use both /dp admin config commands</td></tr></tbody></table>

## Configuration

```yaml
# The amount of uses left a piece of equipment should have left before notifying the player
uses-left: 10
# Cooldown in seconds between notifications to limit spam
notification-cooldown-seconds: 10
defaults:
  # Default setting for notifying players when their main/off hand tools get low
  hand-ping: true
  # Default setting for notifying players when their equipped armor gets low
  armor-ping: true
  # Default setting for playing a sound upon a notification
  play-sound: true
  # Default setting for displaying the notification to the player. Can be one of: TITLE, SUBTITLE, CHAT, ACTION_BAR, HIDDEN
  display: "SUBTITLE"
# Enable the durability ping by default for new players
enabled-by-default: true
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://papertweaks.machinemaker.me/modules/durability-ping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.