EcoMobs - Advanced Mob Payout & Economy Integration!

EcoMobs integrates seamlessly with your server's economy (via the EcoBal API) to provide highly configurable cash rewards for mob kills, animal breeding, and taming! Fine-tune payouts for individual entities, apply multipliers for Spawner-farmed mobs, and enjoy a consolidated, stacking action bar feedback system.

📧 Contact Me & Support Information

💬 Primary Support Channel (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord Server. We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions.

🆘 Urgent Private Messaging (PM) Policy

While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under specific urgent circumstances:

• Allowed Reason: Your server is crashing or experiencing critical, game-breaking errors directly related to one of my mods/plugins.
• Requirement: You must be the owner of the server.
• Time Zone: I am operating in the (CET/CEST) Time Zone.
• PM Hours: Please only send private messages between 10:00 AM and 10:00 PM (Brussels Time).

I will endeavor to answer your PM as soon as I can to be helpful and see what I can do to resolve your urgent issue. However, please understand that immediate responses are not guaranteed, and private messaging is a professional courtesy, not an entitlement. Thank you for your understanding and cooperation!

---

Required Mod: EcoBal Economy API

✨ New: Non-Fixed Payout System

EcoMobs now supports randomized, non-fixed payouts to prevent simple, predictable farming.

• NONFIXED Mode: Toggle the entire mod into a randomization mode that adjusts payouts based on the base price magnitude.
• Tiered Randomization: Configure the maximum percentage reduction applied to the base price for four different price tiers:
  • Single Digit (e.g., $1.00 - $9.99)
  • Double Digit (e.g., $10.00 - $99.99)
  • Triple Digit (e.g., $100.00 - $999.99)
  • Quadruple Digit (e.g., $1000.00+)
  • Example: A $1.00 payout in Single Digit tier with a 20% randomization will result in a random payout between $0.80 and $1.00.

---

Features

Dynamic Payout Systems

• Mob Kills: Configure a distinct base payout price for nearly every vanilla mob and animal.
• Animal Breeding: Set a specific reward for successfully breeding animals.
• Animal Taming: Set a specific reward for successfully taming entities (e.g., Wolves, Horses).
• Baby Animal Multiplier: Apply a separate multiplier to the base kill price of baby animals. This can be disabled entirely.

Advanced Spawner Payout Control

• Regular Spawner Multiplier: Apply a configurable multiplier (default: 0.25) to payouts from mobs spawned by a regular Spawner block. Payouts can be disabled entirely.
• Trial Spawner Multiplier: Apply a specific multiplier (default: 0.50) to payouts from mobs spawned by the new Trial Spawner block.

Consolidated & Configurable Messaging

• Action Bar Stacking: Payouts received in quick succession for the same action (Killing, Taming, or Breeding) are visually stacked and accumulated on the action bar.
  • The stacking duration is configurable via settings.json (payoutStackingWindowMs, default 2.5 seconds).
• Per-Action Message Mode: Control how messages are sent for each action independently:
  • KILL, BREED, and TAME can each be set to CHAT, ACTIONBAR, or BOTH.
• Economy API Integration: Uses Java reflection to safely integrate with the EcoBal mod's API for silent deposits and currency symbol retrieval.

---

Commands (/ecomobs or /em)

All commands are permitted for OP users if no permission plugin is installed.

ℹ️ Info & Status Commands

These commands require the ecomobs.command.use or ecomobs.command.info permission node (Granted to everyone by default).

• /em: Opens the main help page.
• /em mob <entityId>: Show the current kill, breed, and tame payout configuration for a specific entity (read-only).
• /em <spawner|trialspawner|baby>: Show the current multiplier and enabled status for the respective feature.
• /em mode: Show the current global message mode and the new Payout Mode (FIXED or NONFIXED).
• /em nonfixed: Show the status of the NONFIXED payout mode and the current percentage settings for all four digit tiers.

🛠️ Administration Commands

These commands require the ecomobs.command.admin permission (Default: OP Level 2).

• /em mob <id> <kill/breed/tame> <price>: Set the price for a specific payout action.
• /em mob <id> <true/false>: Toggle payouts on or off for the specified entity.
• /em <type> <true/false>: Enable/Disable Spawner, Trial Spawner, or Baby multipliers.
• /em <type> multiplier <value>: Set the multiplier value (e.g., /em trialspawner multiplier 0.75).
• /em mode <CHAT/ACTIONBAR/BOTH/FIXED/NONFIXED>: Set the global message mode OR the global payout mode.
• /em nonfixed <singledigit/doubledigit/tripledigit/quadrupledigit> <percentage>: Set the percentage reduction for a specific non-fixed payout tier.

🔄 Config Reload

This command requires the ecomobs.command.reload permission (Default: OP Level 4).

• /em reload: Reload all configuration files without restarting the server.

---

Permission Nodes

Click to view all permission nodes and their default access

• ecomobs.command.use: Allows access to base /ecomobs and /em for help pages and status checks. (Default: OP Level 0 / Everyone).
• ecomobs.command.info: Allows use of /ecomobs mob <id> to view read-only payout configuration. (Default: OP Level 0 / Everyone).
• ecomobs.command.admin: Grants administrative access for setting prices, multipliers, and modes. (Default: OP Level 2).
• ecomobs.command.reload: Allows use of the /ecomobs reload command. (Default: OP Level 4).

---

Requirements

• Fabric API (Required)
• EcoBal (Required for economy functionality)
• Fabric Permissions API v0 (Optional but Recommended for advanced permission checks, e.g., LuckPerms integration)

Modpack Policy

You ARE PERMITTED to include this mod in any modpack.