RecoverMobs

A Minecraft plugin that automatically saves mob data and allows recovery of dead mobs with comprehensive entity information preservation.

## Features

• Automatic Mob Saving: Saves all mobs in loaded chunks at configurable intervals
• World-Specific Files: Each world gets its own JSON file (e.g., `world_mobs.json`, `the_end_mobs.json`)
• Whitelist/Blacklist System: Configure which mobs to save or exclude
• Individual Mob Recovery: Each mob gets a unique ID for selective spawning
• Multiple Recovery Commands:
• - `/recovermobs` - Recover all mobs in a world
• - `/recovermob spawn ` - Spawn specific mob by ID at custom location
• - `/recovermob recover ` - Recover specific mob to original location
• - `/recovermob listmobs` - List all saved mobs with IDs
• - `/recovermob reload` - Reload plugin configuration and mob data
• Permission System: Control who can use the recovery commands
• Enhanced Mob Data: Saves and restores comprehensive mob information, including:
• - Equipment: Armor, weapons, and items with enchantments and metadata
• - Entity Properties: Health, custom names, glowing effects, etc.
• - Villager Data: Profession, level, and experience
• - NBT Data: Persistent data container information

## Requirements - JAR: Java 21 or newer - Version: 1. 19. 4 or newer ## Installation

1. Download the plugin JAR file 2. Place it in your server's `plugins` folder 3. Restart your server 4. Configure the plugin in `plugins/RecoverMobs/config.yml`

## Commands

### `/recovermobs `

Recovers all saved mobs for a specific world.

Usage: - `/recovermobs` - Shows available worlds with saved data - `/recovermobs ` - Recovers mobs in the specified world

Examples: - `/recovermobs world` - Recovers mobs in the "world" dimension - `/recovermobs the_end` - Recovers mobs in the End dimension - `/recovermobs world_nether` - Recovers mobs in the Nether dimension

### `/recovermob `

Manages individual mobs with various subcommands.

#### `/recovermob spawn `

Spawns a specific mob by its unique ID at a custom location.

Usage: - `/recovermob spawn ` - Spawns a mob at your current location - `/recovermob spawn ` - Spawns mob at specified coordinates - `/recovermob spawn ` - Spawns mob at coordinates in specific world

Examples: - `/recovermob spawn abc123-def456` - Spawns a mob at your location - `/recovermob spawn abc123-def456 100 64 -200` - Spawns mob at coordinates - `/recovermob spawn abc123-def456 100 64 -200 world_nether` - Spawns in Nether

#### `/recovermob recover `

Recovers a specific mob to its original saved location.

Usage: - `/recovermob recover ` - Recovers mob to its original location

Examples: - `/recovermob recover abc123-def456` - Recovers mob to where it was originally saved

#### `/recovermob listmobs `

Lists all saved mobs with their IDs and information.

Usage: - `/recovermob listmobs` - Shows first page of saved mobs - `/recovermob listmobs ` - Shows specific page of saved mobs

Examples: - `/recovermob listmobs` - Shows first 10 mobs - `/recovermob listmobs 2` - Shows mobs 11-20

#### `/recovermob reload `

Reloads plugin configuration and/or mob data without restarting the server.

Usage: - `/recovermob reload config` - Reloads only the configuration file - `/recovermob reload mobsdata` - Reloads only the saved mob data from files - `/recovermob reload all` - Reloads both configuration and mob data

Examples: - `/recovermob reload config` - Reloads config.yml changes - `/recovermob reload mobsdata` - Reloads mob data if files were modified externally - `/recovermob reload all` - Reloads everything

## Permissions

• `recovermobs.recover` - Allows players to use the `/recovermobs` command (default: op)
• `recovermobs.spawn` - Allows players to use the `/recovermob` command (default: op)
• `recovermobs.list` - Allows players to use the `/recovermob listmobs` subcommand (default: op)
• `recovermobs.reload` - Allows players to use the `/recovermob reload` subcommand (default: op)

## Configuration

### config.yml

```yaml # How often to save mob data (in seconds) save-interval: 25

# Whitelist of mobs to save (leave empty to save all mobs) whitelist: - ZOMBIE - SKELETON - CREEPER # Add more mob types as needed

# Blacklist of mobs to NOT save blacklist: - PLAYER - ARMOR_STAND - ITEM_FRAME # Add more mob types as needed

# Debug mode (set to true for more detailed logging) debug: false ```

### Whitelist vs Blacklist

• Whitelist: If not empty, only mobs in this list will be saved
• Blacklist: Mobs in this list will never be saved, regardless of whitelist
• Empty Whitelist: All mobs will be saved (except those in blacklist)

## Troubleshooting

1. No mobs being saved: Check your whitelist/blacklist config