DeathPing Mod

DeathPing is a Minecraft Fabric mod that automatically sends your coordinates to chat or a private message when you die, press a keybind, or disconnect from a server. Customize the message format and behavior through an in-game configuration screen.

Overview

• Mod ID: deathping
• Type: Client-side utility mod
• Supported Version: Minecraft 1.21
• Features:
  • Sends coordinates on death, keybind press (default: ESCAPE), or disconnection.
  • Supports private messaging with a configurable recipient.
  • Customizable message formats using placeholders (e.g., {x}, {y}, {z}, {player}, {dimension}, {death_cause}).
  • Accessible configuration screen via ModMenu (optional).

Installation

1. Ensure you have Fabric Loader and Fabric API installed for your Minecraft version.
2. Download the latest version of DeathPing
3. Place the .jar file in your Minecraft mods folder.
4. (Optional) Install ModMenu for an in-game configuration screen.
5. Launch Minecraft and enjoy!

Configuration

• Access: Open the configuration screen by pressing O (default keybind) or through ModMenu if installed.
• Options:
  • Use Private Message: Toggle to send coordinates privately (default: false).
  • Private Message Recipient: Enter the username to send private messages to (required if private messaging is enabled).
  • Keybind Message Format: Customize the message sent on keybind press (default: "[DeathPing] {player}'s coords: X: {x}, Y: {y}, Z: {z} in {dimension}").
  • Death Message Format: Customize the message sent on death (default: "[DeathPing] {player} died at X: {x}, Y: {y}, Z: {z} in {dimension} ({death_cause})").
  • Disconnect Message Format: Customize the message sent on disconnect (default: "[DeathPing] {player} disconnected at X: {x}, Y: {y}, Z: {z} in {dimension}").

Usage

• Send Coordinates: Press ESCAPE (default) to manually send your current coordinates.
• Death Detection: Automatically sends coordinates when you die, including the death cause.
• Disconnect Notification: Sends coordinates when you disconnect from a server via the "Disconnect" button.
• Messages are sent to chat unless private messaging is enabled with a recipient.

Keybinds

• Send Coordinates: ESCAPE (customizable via controls menu).
• Open Config Screen: O (customizable via controls menu).

Building from Source

1. Clone the repository: git clone [insert repository URL].
2. Set up the project with Gradle: ./gradlew genSources.
3. Build the mod: ./gradlew build.
4. Find the .jar file in the build/libs folder.

Dependencies

• Fabric Loader
• Fabric API
• Cloth Config API (for configuration)
• ModMenu (optional, for configuration screen)

Contributing

Feel free to submit issues or pull requests on the GitHub repository. Contributions are welcome!

License

This mod is licensed under the MIT License. See the LICENSE file for details.

Modrinth and GitHub repository