GraveEcho v1.0.0

Overview​

Features​

• Echo mob spawns on death — a named, glowing zombie (or skeleton) appears at your death location, guarding your items.
• Gear-scaled difficulty — the Echo's health and attack power increase based on the armor and weapon you had when you died.
• Boss bar — a proximity bossbar shows the Echo's remaining health when you are within range.
• Particles and sounds — configurable visual and audio effects on spawn and death.
• Fire immunity — the Echo cannot burn in sunlight, preventing accidental daytime loss.
• No despawn — the Echo is protected from natural despawning and chunk unload issues while the server is running.
• Expiry system — the Echo automatically disappears after a configurable time limit, optionally dropping items.
• Owner-only or public mode — restrict damage to the owner only, or let any player chip in.
• Full item capture — main inventory, all four armor slots, and the off-hand slot are all saved and returned.
• Multi-language support — English and Hungarian included; add any custom language file.
• Built-in update checker — notifies admins in-game and in the console when a newer version is available.
• Complete admin toolkit — list, remove, teleport to, and clear all active Echoes from any player.
• Zero NMS — built entirely on the public Paper 1.21 API. Compatible with future minor updates.

How GraveEcho Works​

• The player's full inventory, armor, and off-hand are captured and stored.
• Vanilla item drops are suppressed — nothing scatters on the ground.
• A named Echo mob spawns at the exact death location.

• The Echo pursues and attacks its owner (or nearby players in public mode).
• The Echo glows and displays the owner's name above it.
• A bossbar appears when the owner comes within range.
• The Echo cannot burn, cannot despawn, and resets fire ticks every tick.

• Kill the Echo → all saved items drop at the Echo's location.
• Echo expires → items drop automatically (if drop-items-on-expire: true).
• Admin removes Echo → items drop at the Echo's current position.

Commands​

Permissions​

Configuration Highlights​

settings:
  language: "en"                  # Language file (en, hu, or your own)

  echo-mob-type: ZOMBIE           # ZOMBIE (recommended) or SKELETON
  echo-health: 40.0               # Base health in half-hearts
  echo-damage: 6.0                # Base attack damage
  echo-speed: 0.32                # Movement speed
  echo-follow-range: 32.0         # Detection and chase range (blocks)
  echo-knockback-resistance: 0.4  # Knockback resistance (0.0 – 1.0)

  echo-glowing: true              # Enable glow effect on the Echo
  echo-drop-items-on-kill: true   # Drop items when the Echo is killed
  echo-expire-minutes: 60         # Minutes until the Echo automatically expires
  drop-items-on-expire: true      # Drop items when the Echo expires

  # true  → only the owner can damage the Echo; Echo only attacks the owner.
  # false → anyone can damage the Echo; Echo prefers the owner, then nearest player.
  allow-only-owner-to-damage: true

  scale-echo-by-gear: true        # Scale Echo stats by the player's gear at death

  fix-echo-ai: true               # Enable retarget task for stable mob AI
  retarget-interval-ticks: 40     # Target refresh rate (20 ticks = 1 second)

  bossbar-enabled: true           # Show bossbar to owner when within range
  bossbar-range: 20.0             # Range in blocks for the bossbar
  bossbar-color: PURPLE           # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE

effects:
  spawn-particles: true
  death-particles: true
  spawn-sound: true
  death-sound: true

debug:
  enabled: false                  # Set true for verbose logging

startup-banner:
  enabled: true                   # Set false to suppress the ASCII banner

builtbybit:
  enabled: true
  resource-id: 110138
  token: ""                       # Your BuiltByBit Shared API token (never logged)
                                  # Scopes: resources.creator.updates.view,
                                  #         resources.creator.versions.view,
                                  #         resources.embed.latest
  update-checker: true
  check-on-startup: true
  notify-admins: true
  check-timeout-seconds: 10

• allow-only-owner-to-damage — switch between private and server-wide PvPvE mode.
• scale-echo-by-gear — disable if you want a flat difficulty regardless of gear.
• echo-expire-minutes — set the time window for item recovery (default: 60 minutes).
• drop-items-on-expire — set to false to permanently lose items on expiry (hardcore mode).
• bossbar-color — choose from PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE.

Language Support​

1. Open plugins/GraveEcho/config.yml.
2. Set settings.language: "hu" (or your language code).
3. Run /graveecho reload.

1. Copy plugins/GraveEcho/messages/en.yml to messages/de.yml (or any code).
2. Translate all message values. Do not change the YAML keys.
3. Set settings.language: "de" and run /graveecho reload.

Requirements​

Installation​

1. Download GraveEcho-1.0.0.jar from the resource page.
2. Place the file in your server's plugins/ folder.
3. Start or restart the server.
4. All configuration files are generated automatically in plugins/GraveEcho/.
5. Edit config.yml to your preferences.
6. Run /graveecho reload to apply any changes without restarting.

Developer Website​

Support​

• Before reporting an issue: set debug.enabled: true in config.yml, run /graveecho reload, reproduce the problem, and include the relevant console output in your message.
• Bug reports and feature requests: use the Discussion tab on this resource page.
• Configuration help: consult the annotated config.yml above or the TESTING.md file included in the repository.