HereMobby

A Paper Minecraft plugin for mob management — manage existing mobs, create custom ones with custom loot, and optionally earn "Kroins" via HereShoppy integration.

Features

• Optional Economy Integration: If HereShoppy is installed, players earn Kroins for defeating mobs. Standard mobs award 2 Kroins, while bosses award 2000.
• Custom Mobs: Create new entity types with custom equipment, display names, scale, and specific spawn conditions (biomes, time, light level, chance).
• Custom Bosses: Define static boss entities with persistent respawn timers and custom scale that survive server restarts.
• Standard Overrides: Override rewards and loot tables for vanilla Minecraft mobs and bosses via JSON.
• Information GUI: View detailed information about mobs and loot via /heremobby info.

Requirements

• Paper 1.21+ (plugin api-version: '1.21'; built against Paper 1.21.4 API)
• Java 21
• HereShoppy (Optional, for economy features)

Installation

1. Grab HereMobby-1.2.0.jar from Releases (or ./gradlew build locally).
2. Drop the JAR in plugins/.
3. Restart the server.

Building from Source

./gradlew build   # POSIX

.\gradlew.bat build   # Windows PowerShell/cmd

The compiled plugin jar is written to:

build/libs/HereMobby-1.2.0.jar

Recent Changes (v1.2.0)

• Added command alias /hm — Players can now use /hm as a short alias for /heremobby.
• Version bump & clean build — Bumped version to 1.2.0 to maintain consistency across all plugins.

Commands & Permissions

All commands can be run with /hm instead of /heremobby.

| Command | Description | Permission |
|---------|-------------|------------|
| /heremobby info (or /hm info) | Open the mob information GUI | heremobby.use |
| /heremobby spawn <id> (or /hm spawn <id>) | Spawn a custom mob or boss | heremobby.admin |
| /heremobby reload (or /hm reload) | Reload configuration files | heremobby.admin |

| Permission | Description | Default |
|------------|-------------|---------|
| heremobby.use | Allows use of player commands | true |
| heremobby.admin | Allows use of admin commands | op |

Configuration & Spells

Detailed documentation on configuration, custom mobs/bosses, and the spellcasting system can be found in DOCS.md.

Data Files

• boss_state.json: Internal persistence for last death timestamps.
• mobs.json / bosses.json: Overrides for vanilla entities.
• custom_items/: Folder for custom item definitions.
• custom_mobs/: Folder for new entity definitions.
• custom_bosses/: Folder for static boss definitions.
• mounts/: Folder for custom rideable mounts configurations.
• pets/: Folder for custom companion pets configurations.
• wild_animals/: Folder for custom wild animals configurations.

Version

Current release: 1.2.0

License

Licensed under GNU GPLv3.