Home

BetterMob

BetterMob is a Paper plugin for registering custom mobs in YAML and giving them 3D models through BetterModel or ModelEngine. The file format follows MythicMobs, but BetterMob only implements a subset of it. Anything unsupported is logged as a warning and skipped, it never breaks the rest of a skill.

Start here

Page	What's in it
Installation	Requirements, installing, folder layout, first mob
Commands	All /bettermob commands and their permissions
Mobs	The mob file format and every option
Spawners	Spawners and natural spawn rules
Skills	Triggers, mechanics, conditions and targeters
Drop tables	What mobs drop, Drops: and droptables/
Items	Custom items, ~onUse skills, /bettermob give
Pack compatibility	Which MythicMobs packs were tried and how far they run
Packs	Content packs, importing MythicMobs packs
Developer API	Events, custom mechanics, Maven dependency
Development	Building, tests, code layout, how to add a mechanic
Troubleshooting	"I only see a pig", warnings in the console, and more

Features

• One mob per file or many mobs per file, nested folders allowed
• BetterModel or ModelEngine models, including rideable seats
• Skill engine with triggers, delay, cd and inline ?condition
• Custom items with model data and right-click skills
• Armor-stand style display mobs (invisible, floating, item on the head)
• Content packs with a one-line disable switch
• Factions, auras, totems, projectiles and more MythicMobs skill mechanics
• Message files in English and German, add your own
• PlaceholderAPI placeholders, debug output, per-command permissions
• Boss bars with live health, /bettermob stats with optional skill timing
• /bettermob reload updates living mobs, /bettermob killall cleans up
• Developer API for your own plugins, Folia supported

Source code and releases: https://github.com/HyperGaming99/bettermob