HereMobby

# HereMobby A (https://papermc.io) 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 ```bash ./gradlew build # POSIX ``` ```powershell .\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 (LICENSE).