WIKI:
MaxGraves
MaxGraves 是一款面向现代 Minecraft 服务器的轻量级墓碑插件。当玩家死亡时,该插件可以在死亡位置或其附近创建一个临时墓碑来存储玩家的物品和经验,在玩家重生后提供一张定位地图,并允许他们安全地取回这些内容。
功能
- 玩家死亡时创建墓碑,并存储其掉落的物品和经验。
- 防止在创建墓碑后原始死亡掉落物和经验值重复。
- 为拥有者提供定位地图(针对每个尚未在玩家背包中有定位地图的有效墓碑)。
- 当玩家拥有权限时,可以通过右键点击定位地图传送到关联的墓碑。
- 支持每个玩家拥有多个有效墓碑,并在信息菜单中按剩余存活时间排序。
- 通过
/maxgraves info打开包含玩家有效墓碑的 GUI。 - 在信息菜单中显示每个墓碑所在的维度、坐标、剩余时间和内部墓碑 ID。
- 当对应的装备槽为空时,自动装备回收的盔甲和副手物品。
- 当玩家背包已满时,将溢出的回收物品掉落给玩家。
- 在认领墓碑时存储并返还经验值。
- 在配置的寿命到期后自动移除过期的墓碑。
- 在关联的墓碑被认领或过期时移除拥有者的定位地图。
- 当确切的死亡位置被阻挡时,搜索附近的方块以寻找安全的墓碑位置。
- 支持世界黑名单,在这些世界中永远不会创建墓碑。
- 尊重
keepInventory设置;当死亡事件保留玩家背包时,不会创建墓碑。 - 默认支持私人墓碑。
- 可通过
grave.access.public-player-kill选择性地使由玩家击杀产生的墓碑变为公开状态。 - 检测玩家击杀者、投射物击杀者、驯服实体所有者、命名生物和环境伤害,以用于全息图占位符。
- 支持两种墓碑标记模式:玩家头颅墓碑和箱子墓碑。
- 保护墓碑方块免受正常破坏、爆炸、火焰、流动方块、活塞和漏斗式物品移动的影响。
- 支持带有占位符的可配置全息图。
- 支持头颅墓碑的可配置粒子效果和环境音效。
- 支持带有视觉闪电和声音的可配置认领动画。
- 通过
general.language(捆绑了en和es)支持双语消息文件。 - 自动将捆绑 YAML 文件中缺少的键添加到现有的配置文件和语言文件中。
- 支持运行时重新加载设置、消息、墓碑视觉效果、更新检查和 bStats 状态。
- 包括可选的更新检查和新版本检测时的管理员加入通知。
- 包括可选的匿名 bStats 指标。
- 包括死亡事件调试日志记录,用于排查掉落物或经验冲突问题。
要求
- Java 21。
- 一个 API 版本为
1.21的现代 Paper/Spigot 兼容服务器。 - 目标 Paper API
26.1.2.build.53-stable。
请务必查阅 WIKI 以获取有关权限和命令的最新信息
命令
主命令是 /maxgraves。
别名:
/maxgrave/mg/graves
| 命令 | 权限 | 默认值 | 描述 |
|---|---|---|---|
/maxgraves |
无 | 所有人 | 显示命令用法信息。 |
/maxgraves info |
maxgrave.info |
所有人 | 打开包含玩家有效墓碑的菜单。仅限玩家使用的命令。 |
/maxgraves reload |
maxgrave.admin |
操作员 | 重新加载配置、消息、墓碑设置、更新检查和 bStats 状态。 |
所有别名都支持相同的子命令,例如 /mg info 和 /mg reload。
权限
| 权限 | 默认值 | 用途 |
|---|---|---|
maxgrave.admin |
op |
允许使用 /maxgraves reload,在加入时接收更新通知,并继承 maxgrave.tp 和 maxgrave.info。 |
maxgrave.info |
true |
允许使用 /maxgraves info。 |
maxgrave.tp |
false |
允许拥有者通过右键点击 MaxGrave 定位地图传送到自己的墓碑。 |
墓碑认领不由 Bukkit 权限控制。它由所有权和配置访问策略控制:
- 拥有者可以认领或打开自己的墓碑。
- 非拥有者无法认领私人墓碑。
- 如果启用了
grave.access.public-player-kill,由玩家击杀创建的墓碑可以被其他玩家打开或掠夺。 - 即使授予了传送权限,定位地图也只能由关联墓碑的拥有者使用。
墓碑标记模式
头颅模式
grave.marker.type: "HEAD"
头颅墓碑放置一个玩家头颅标记。此模式支持:
- 全息图。
- 粒子效果。
- 环境墓碑音效。
- 通过右键点击或破坏墓碑标记进行一键认领。
- 在返还奖励前的认领动画。
箱子模式
grave.marker.type: "CHEST"
箱子墓碑放置一个箱子标记并打开一个墓碑库存界面。此模式支持:
- 全息图。
- 从墓碑库存中逐个取走物品。
- 当箱子库存变空时自动完成墓碑。
- 清空墓碑的玩家获得经验奖励。
- 溢出处理:如果存储超过 54 组物品堆,额外的物品堆将掉落在墓碑位置。
箱子模式故意不使用粒子效果或认领动画。
配置
主要设置位于 plugins/MaxGraves/config.yml 中。
| 路径 | 默认值 | 描述 |
|---|---|---|
general.language |
en |
选择语言文件。内置选项为 en 和 es。 |
general.update-check |
true |
启用启动时及定期更新检查。 |
general.bstats |
true |
启用匿名 bStats 指标统计。 |
general.prefix |
MaxGraves 前缀 | 插件消息中使用的前缀。 |
grave.despawn-time |
3600 |
墓碑过期前的秒数。 |
grave.blacklisted-worlds |
示例 PvP 世界 | 不会生成墓碑的世界列表。 |
grave.search-max-radius |
6 |
用于寻找安全墓碑位置的最大水平半径。 |
grave.debug-death-events |
false |
记录详细的死亡事件追踪日志,用于故障排除。 |
grave.create-on-death |
true |
启用或禁用死亡时自动创建墓碑。 |
grave.marker.type |
HEAD |
墓碑标记模式。可用值:HEAD、CHEST。 |
grave.access.public-player-kill |
false |
允许公开访问由玩家击杀产生的墓碑。 |
grave.info-menu.item.material |
PAPER |
信息菜单中每个条目使用的材质。 |
grave.hologram.enabled |
true |
启用墓碑全息投影。 |
grave.hologram.update-inticks |
20 |
全息投影文本刷新的频率(以刻为单位)。 |
grave.hologram.base-height |
0.3 |
从标记到第一行全息文本的高度偏移量。 |
grave.hologram.line-spacing |
0.25 |
全息文本行之间的间距。 |
grave.hologram.lines |
配置列表 | 显示在墓碑上方的文本行。 |
grave.claim-animation.enabled |
true |
启用头颅类墓碑的领取动画。 |
grave.claim-animation.delay-ticks |
20 |
领取后返还奖励前的延迟时间(以刻为单位)。 |
grave.claim-animation.lightning.enabled |
true |
在领取动画期间播放闪电视觉效果。 |
grave.claim-animation.sound.type |
ITEM_TOTEM_USE |
领取时播放的声音。 |
grave.claim-animation.sound.volume |
1.0 |
领取声音的音量。 |
grave.claim-animation.sound.pitch |
0.75 |
领取声音的音调。 |
grave.effects.enabled |
true |
启用心头类墓碑的粒子效果。 |
grave.effects.update-interval-ticks |
5 |
粒子刷新间隔(以刻为单位)。 |
grave.effects.primary-particle |
SOUL |
主螺旋粒子。 |
grave.effects.secondary-particle |
SMOKE |
次要环境粒子。 |
grave.effects.primary-count |
4 |
每刻生成的主粒子数量。 |
grave.effects.secondary-count |
2 |
每刻生成的次要粒子数量。 |
grave.effects.spiral-radius |
0.7 |
螺旋半径。 |
grave.effects.spiral-height |
1.3 |
螺旋高度。 |
grave.effects.vertical-speed |
0.05 |
粒子垂直移动速度。 |
grave.effects.ambient-sound.enabled |
true |
在头颅类墓碑附近启用随机环境音效。 |
grave.effects.ambient-sound.type |
BLOCK_SOUL_SAND_HIT |
环境音效类型。 |
grave.effects.ambient-sound.volume |
0.45 |
环境音效音量。 |
grave.effects.ambient-sound.pitch |
0.7 |
环境音效音调。 |
全息占位符
以下占位符可在 grave.hologram.lines 中使用:
| 占位符 | 描述 |
|---|---|
{player} |
墓碑所有者的名称。 |
{player_level} |
死者死亡时的等级。 |
{killer} |
击杀者名称或配置的“未知击杀者”文本。 |
{time_left} |
墓碑过期前的剩余时间。 |
{x} |
墓碑 X 坐标。 |
{y} |
墓碑 Y 坐标。 |
{z} |
墓碑 Z 坐标。 |
信息菜单占位符
以下占位符可在 messages.info-menu-item-name 和 messages.info-menu-item-lore 中使用:
| 占位符 | 描述 |
|---|---|
{index} |
菜单中的墓碑编号。 |
{world} |
墓碑所在世界的名称。 |
{x} |
墓碑 X 坐标。 |
{y} |
墓碑 Y 坐标。 |
{z} |
墓碑 Z 坐标。 |
{time_left} |
墓碑过期前的剩余时间。 |
{id} |
内部墓碑 UUID。 |
消息
消息文件存储在:
plugins/MaxGraves/lang/messages_en.ymlplugins/MaxGraves/lang/messages_es.yml
活动文件通过 general.language 进行选择。
该插件支持在消息中使用传统颜色代码和十六进制颜色。
运行时说明
- 活跃的墓碑在服务器运行时存储于内存中。
- 服务器关闭或插件禁用会移除活跃的墓碑方块和视觉效果。
/maxgraves reload命令会在不禁用插件的情况下重新加载设置。- 现有的配置文件和语言文件会自动使用内置的缺失键进行更新。
- 无效的标记类型将回退到
HEAD。 - 无效的信息菜单材质将回退到
PAPER。 - 无效的粒子或声音将回退到安全默认值并记录警告日志。
支持
如有问题、Bug、想法或建议,请加入支持 Discord:
WIKI:
MaxGraves
MaxGraves is a lightweight graves plugin for modern Minecraft servers. When a player dies, the plugin can store their items and experience in a temporary grave at or near the death location, give the player a locator map after respawn, and let them recover their contents safely.
Features
- Creates a grave when a player dies and stores their dropped items and experience.
- Prevents the original death drops and dropped experience from duplicating after a grave is created.
- Gives the owner a locator map after respawn for every active grave that does not already have a locator in the player's inventory.
- Lets players right click their locator map to teleport to the linked grave when they have permission.
- Supports multiple active graves per player, sorted by remaining lifetime in the info menu.
- Opens a GUI with the player's active graves through
/maxgraves info. - Shows each grave's world, coordinates, remaining time, and internal grave ID in the info menu.
- Automatically equips recovered armor and off-hand items when the matching equipment slot is empty.
- Drops recovered overflow items at the player when their inventory is full.
- Stores and returns experience when the grave is claimed.
- Removes expired graves automatically after the configured lifetime.
- Removes the owner's locator when the linked grave is claimed or expires.
- Searches nearby blocks for a safe grave position when the exact death location is blocked.
- Supports world blacklists where graves should never be created.
- Respects
keepInventory; no grave is created when the death event keeps the player's inventory. - Supports private graves by default.
- Can optionally make graves from player kills public through
grave.access.public-player-kill. - Detects player killers, projectile killers, tamed entity owners, named mobs, and environmental deaths for hologram placeholders.
- Supports two grave marker modes: player head graves and chest graves.
- Protects grave blocks from normal breaking, explosions, fire, flowing blocks, pistons, and hopper-style item movement.
- Supports configurable holograms with placeholders.
- Supports configurable particles and ambient sounds for head graves.
- Supports configurable claim animations with visual lightning and sound.
- Supports bilingual message files through
general.language(enandesare bundled). - Automatically adds missing keys from bundled YAML files to existing config and language files.
- Supports runtime reload of settings, messages, grave visuals, update checks, and bStats state.
- Includes optional update checks and admin join notifications when a new version is detected.
- Includes optional anonymous bStats metrics.
- Includes death-event debug logging for troubleshooting drop or experience conflicts.
Requirements
- Java 21.
- A modern Paper/Spigot-compatible server with API version
1.21. - Targets Paper API
26.1.2.build.53-stable.
REMEMBER TO CHECK THE WIKI TO STAY UP-TO-DATE ON PERMISSIONS AND COMMANDS
Commands
The main command is /maxgraves.
Aliases:
/maxgrave/mg/graves
| Command | Permission | Default | Description |
|---|---|---|---|
/maxgraves |
None | Everyone | Shows the command usage message. |
/maxgraves info |
maxgrave.info |
Everyone | Opens a menu with the player's active graves. Player-only command. |
/maxgraves reload |
maxgrave.admin |
Operators | Reloads configuration, messages, grave settings, update checks, and bStats state. |
All aliases support the same subcommands, for example /mg info and /mg reload.
Permissions
| Permission | Default | Used for |
|---|---|---|
maxgrave.admin |
op |
Allows /maxgraves reload, receives update notifications on join, and inherits maxgrave.tp and maxgrave.info. |
maxgrave.info |
true |
Allows /maxgraves info. |
maxgrave.tp |
false |
Allows the owner to teleport to their grave by right clicking a MaxGrave locator map. |
Grave claiming is not controlled by a Bukkit permission. It is controlled by ownership and the configured access policy:
- Owners can claim or open their own graves.
- Non-owners cannot claim private graves.
- If
grave.access.public-player-killis enabled, graves created by player kills can be opened or looted by other players. - Locator maps can only be used by the owner of the linked grave, even when teleport permission is granted.
Grave Marker Modes
Head Mode
grave.marker.type: "HEAD"
Head graves place a player head marker. This mode supports:
- Holograms.
- Particle effects.
- Ambient grave sound.
- One-click claiming by right clicking or breaking the grave marker.
- Claim animation before rewards are returned.
Chest Mode
grave.marker.type: "CHEST"
Chest graves place a chest marker and open a grave inventory. This mode supports:
- Holograms.
- Taking items one by one from the grave inventory.
- Automatic grave completion when the chest inventory becomes empty.
- Experience reward for the player who empties the grave.
- Overflow handling: if more than 54 item stacks would be stored, extra stacks are dropped at the grave location.
Chest mode intentionally does not use particles or claim animations.
Configuration
Main settings live in plugins/MaxGraves/config.yml.
| Path | Default | Description |
|---|---|---|
general.language |
en |
Selects the language file. Bundled options are en and es. |
general.update-check |
true |
Enables startup and periodic update checks. |
general.bstats |
true |
Enables anonymous bStats metrics. |
general.prefix |
MaxGraves prefix |
Prefix used in plugin messages. |
grave.despawn-time |
3600 |
Seconds before a grave expires. |
grave.blacklisted-worlds |
Example PvP worlds | Worlds where graves will not be created. |
grave.search-max-radius |
6 |
Maximum horizontal radius used to find a safe grave location. |
grave.debug-death-events |
false |
Logs detailed death-event traces for troubleshooting. |
grave.create-on-death |
true |
Enables or disables automatic grave creation on death. |
grave.marker.type |
HEAD |
Grave marker mode. Available values: HEAD, CHEST. |
grave.access.public-player-kill |
false |
Allows public access to graves created by player kills. |
grave.info-menu.item.material |
PAPER |
Material used for each entry in the info menu. |
grave.hologram.enabled |
true |
Enables grave holograms. |
grave.hologram.update-interval-ticks |
20 |
How often hologram text refreshes. |
grave.hologram.base-height |
0.3 |
Height offset from the marker to the first hologram line. |
grave.hologram.line-spacing |
0.25 |
Spacing between hologram lines. |
grave.hologram.lines |
Configured list | Lines shown above graves. |
grave.claim-animation.enabled |
true |
Enables the claim animation for head graves. |
grave.claim-animation.delay-ticks |
20 |
Delay before rewards are returned after claiming. |
grave.claim-animation.lightning.enabled |
true |
Plays visual lightning during the claim animation. |
grave.claim-animation.sound.type |
ITEM_TOTEM_USE |
Sound played when claiming. |
grave.claim-animation.sound.volume |
1.0 |
Claim sound volume. |
grave.claim-animation.sound.pitch |
0.75 |
Claim sound pitch. |
grave.effects.enabled |
true |
Enables particle effects for head graves. |
grave.effects.update-interval-ticks |
5 |
Particle update interval. |
grave.effects.primary-particle |
SOUL |
Primary spiral particle. |
grave.effects.secondary-particle |
SMOKE |
Secondary ambient particle. |
grave.effects.primary-count |
4 |
Primary particle amount per tick. |
grave.effects.secondary-count |
2 |
Secondary particle amount per tick. |
grave.effects.spiral-radius |
0.7 |
Spiral radius. |
grave.effects.spiral-height |
1.3 |
Spiral height. |
grave.effects.vertical-speed |
0.05 |
Vertical particle movement speed. |
grave.effects.ambient-sound.enabled |
true |
Enables random ambient sounds near head graves. |
grave.effects.ambient-sound.type |
BLOCK_SOUL_SAND_HIT |
Ambient sound type. |
grave.effects.ambient-sound.volume |
0.45 |
Ambient sound volume. |
grave.effects.ambient-sound.pitch |
0.7 |
Ambient sound pitch. |
Hologram Placeholders
The following placeholders can be used in grave.hologram.lines:
| Placeholder | Description |
|---|---|
{player} |
Grave owner's name. |
{player_level} |
Grave owner's level at death. |
{killer} |
Killer name or configured unknown-killer text. |
{time_left} |
Remaining time before the grave expires. |
{x} |
Grave X coordinate. |
{y} |
Grave Y coordinate. |
{z} |
Grave Z coordinate. |
Info Menu Placeholders
The following placeholders can be used in messages.info-menu-item-name and messages.info-menu-item-lore:
| Placeholder | Description |
|---|---|
{index} |
Grave number in the menu. |
{world} |
Grave world name. |
{x} |
Grave X coordinate. |
{y} |
Grave Y coordinate. |
{z} |
Grave Z coordinate. |
{time_left} |
Remaining time before the grave expires. |
{id} |
Internal grave UUID. |
Messages
Message files are stored in:
plugins/MaxGraves/lang/messages_en.ymlplugins/MaxGraves/lang/messages_es.yml
The active file is selected with general.language.
The plugin supports legacy color codes and hex colors in messages.
Runtime Notes
- Active graves are stored in memory while the server is running.
- Server shutdown or plugin disable removes active grave blocks and visuals.
/maxgraves reloadreloads settings without disabling the plugin.- Existing config and language files are automatically updated with missing bundled keys.
- Invalid marker types fall back to
HEAD. - Invalid info menu materials fall back to
PAPER. - Invalid particles or sounds fall back to safe defaults and log a warning.
Support
For questions, bugs, ideas, or suggestions, join the support Discord:
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxGraves
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 插件更新消息已更改;现在更简短了。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持

评论 0
登录后参与评分
还没有评论,来抢沙发吧