Skip to content

Home

Jump to bottom
Fragmer2 edited this page Apr 27, 2026 · 1 revision

MobMoney — User Guide (Server Administrator)

Table of Contents

  1. What is MobMoney?
  2. Requirements and Installation
  3. Plugin File Structure
  4. config.yml Configuration
  5. Language Files
  6. Commands
  7. Permissions
  8. Version Compatibility
  9. Frequently Asked Questions (FAQ)

What is MobMoney?

MobMoney is a plugin for Bukkit/Spigot/Paper that grants players a monetary reward for killing mobs. The reward amount is configurable for each mob individually; the plugin supports ranges (random amounts), a global multiplier, protection against spawner farming, boss notifications, and multi-language support.

Requirements and Installation

Dependency Version Required
Spigot / Paper / Purpur / Folia 1.8 – 1.21.x ✅
Vault Any current version ✅
Economy Plugin (EssentialsX, CMI, etc.) — ✅
Java 8+ ✅

Installation Steps:

  1. Download MobMoney.jar and place it in the plugins/ folder.
  2. Ensure that Vault.jar and an economy plugin are already present in the plugins/ folder.
  3. Start (or restart) your server.
  4. The plugin will create a plugins/MobMoney/ folder containing the config.yml and lang/ files. 5. Edit config.yml to suit your needs and run /mobmoney reload.

Important: If Vault is not found, or if no economy plugin is hooked, MobMoney will automatically disable itself and print an error message to the console.

Plugin File Structure

plugins/
└── MobMoney/
├── config.yml          ← Main configuration file
└── lang/
├── ru.yml          ← Russian (Default)
├── en.yml          ← English
└── uk.yml          ← Ukrainian

config.yml Configuration

Below is an example of a complete config.yml file containing all available parameters:

settings:
# Interface language. Available values: ru, en, uk
language: ru

# Whether to display a message above the hotbar (action bar) when receiving a reward
action-bar: true

# Whether to display a full-screen title when killing a boss
title-on-boss: true

# Whether to grant rewards for mobs spawned by spawners (false = anti-farm)
spawner-mobs-reward: false

# Whether to log kills to the console
log-kills: false

# Global reward multiplier (1.0 = no change, 2.0 = double reward)
global-multiplier: 1.0

# Currency symbol displayed in messages
currency-symbol: "₴"

mobs:
# Format: MOB_NAME (uppercase, English)
#   min: minimum reward
#   max: maximum reward (if min == max, the amount is fixed)
ZOMBIE:
min: 10
max: 30
SKELETON:
min: 15
max: 40
CREEPER:
min: 20
max: 50
ENDER_DRAGON:
min: 5000
max: 10000
WITHER:
min: 3000
max: 6000
WARDEN:           # 1.19+ only
min: 1000
max: 2000
ELDER_GUARDIAN:
min: 500
max: 1000

Configuration Parameter Descriptions

Parameter Type Default Description
language string ru Language file code from the lang/ folder
action-bar boolean true Message displayed above the hotbar upon every kill
title-on-boss boss-kill-title boolean
spawner-mobs-reward boolean false Reward for mobs spawned by spawners
log-kills boolean false Log kills to the server console
global-multiplier number 1.0 Multiplier for all rewards
currency-symbol string ₴ Symbol displayed next to the amount

Supported Mob Names

Use standard Minecraft enum names in uppercase English. The plugin automatically handles name changes across versions:

Old Name (≤1.15) New Name (1.16+)
PIG_ZOMBIE ZOMBIFIED_PIGLIN
MUSHROOM_COW MOOSHROOM
EVOCATION_ILLAGER EVOKER
VINDICATION_ILLAGER VINDICATOR
ILLUSION_ILLAGER ILLUSIONER

If a mob is not available on your server version, it is simply skipped with a warning in the console; the plugin will not crash.

Bosses (trigger an additional title screen upon death): ENDER_DRAGON, WITHER, WARDEN (1.19+), ELDER_GUARDIAN.

Language Files

Files are located in plugins/MobMoney/lang/. They are generated automatically upon the first launch.

Example lang/ru.yml:

reward:
action-bar:    "&a+{amount} {symbol} &8» &7{mob}"
boss-title:    "&6&lBOSS KILLED!" 
boss-subtitle: "&e+{amount} {symbol} &7for &f{mob}"
boss-chat:     "&6[MobMoney] &eYou received &a{amount} {symbol} &efor killing &f{mob}&e!"

cmd:
reload-success:  "&a[MobMoney] Config reloaded." 
reload-fail:     "&c[MobMoney] Reload failed. Check the console." 
no-permission:   "&c[MobMoney] You do not have permission." 
info-header:     "&8&m-------&r &6MobMoney &ev{version} &8&m-------"
info-platform:   " &8» &7Platform: &f{platform}"
info-lang:       " &8» &7Language: &f{lang}"
info-mobs:       " &8» &7Mobs loaded: &f{count}"
info-multiplier: " &8» &7Multiplier: &a{mult}x"
mob-reward:      " &8» &f{mob}: &a{min}&8-&a{max} &f{symbol}"
mob-unknown:     "&c[MobMoney] Unknown mob: &f{mob}"
usage:           "&7Usage: &f/mobmoney <reload | info [mob]>"

mobs:
zombie:          "Zombie"
skeleton:        "Skeleton"
creeper:         "Creeper"
ender_dragon:    "Ender Dragon"
wither:          "Wither"
warden:          "Warden"
elder_guardian:  "Elder Guardian"

Placeholders

Placeholder Value
{amount} Reward amount (format: 1,234,567)
{symbol} Currency symbol from the config
{mob} Localized mob name
{version} Plugin version
{platform} Server platform (Paper, Spigot, etc.)
{lang} Current language
{count} Number of loaded mobs
{mult} Global multiplier value
{min} / {max} Reward range for the mob

For color formatting, use standard Minecraft color codes with the & symbol (e.g., &a for green, &6 for gold, &l for bold).

To add your own language, create a lang/XX.yml file modeled after ru.yml and set language: xx in config.yml.

Commands

All commands start with /mobmoney (alias: /mm).

Command Permission Description
/mobmoney reload mobmoney.admin Reloads config.yml and language files without restarting the server
/mobmoney info mobmoney.admin Displays general information: platform, language, mob count, multiplier
/mobmoney info <mob> mobmoney.admin Displays the reward range for a specific mob

Permissions

Permission Description Default
mobmoney.receive Receive money for killing mobs true (all players)
mobmoney.admin Access to /mobmoney reload and /mobmoney info commands op

Example configuration using LuckPerms:

/lp group default permission set mobmoney.receive true
/lp group admin permission set mobmoney.admin true

Version Compatibility

Platform Versions Status
CraftBukkit 1.8 – 1.21.x ✅
Spigot 1.8 – 1.21.x ✅
Paper 1.8 – 1.21.x ✅
Purpur / Pufferfish / Leaves Any ✅ (detected as Paper)
Folia 1.20+ ✅ (detected separately)

The plugin automatically detects the platform and version upon startup and outputs this information to the console:

[MobMoney] Platform: Paper  MC 1.21.4

FAQ

Q: The plugin disables itself immediately after startup. A: Vault is not installed, or no economy plugin (EssentialsX, CMI, etc.) is present. Ensure that both plugins load before MobMoney.

Q: Mobs from spawners do not drop money. A: By default, this is disabled (spawner-mobs-reward: false) to prevent farming. Set the value to true if you wish to award rewards for such mobs.

Q: A mob listed in the config is skipped with a warning. A: Most likely, this mob type does not exist in your specific version of Minecraft. For example, the WARDEN was only introduced in version 1.19. This is not an error — The plugin simply ignores unavailable types.

Q: How do I add a new language? A: Copy lang/en.yml to lang/XX.yml, translate all the lines, and set language: xx in config.yml. Afterward, run /mobmoney reload.

Q: How do I set a fixed reward (without randomness)? A: Set the min and max values ​​to be identical:

ZOMBIE:
min: 25
max: 25

Q: How do I temporarily double all rewards? A: Change global-multiplier: 2.0 in config.yml and run /mobmoney reload. To revert, set it to 1.0.

Clone this wiki locally