RPG Mobs for Add-On Developers
Your mobs can join the RPG Mobs level system. Add one type family to your entity file and every mob of that type spawns with a level, a badge, scaled damage, and a chance at Schmorbs, exactly like a vanilla mob.
This page is for add-on creators. If you play RPG Mobs, read the player guide instead.
Opt In With a Type Family
Section titled “Opt In With a Type Family”Add shapescape_rpgm_leveled to your entity’s minecraft:type_family component in your behavior pack.
{ "format_version": "1.21.0", "minecraft:entity": { "description": { "identifier": "my_addon:frost_wraith" }, "components": { "minecraft:type_family": { "family": [ "frost_wraith", "monster", "mob", "shapescape_rpgm_leveled" ] } } }}That is the whole integration. No script, no dependency on our pack, no load order to get right.
RPG Mobs reads the family off the live entity when it spawns or loads. Your mob keeps working normally in a world without RPG Mobs, because an unused type family does nothing on its own.
Opt In at Runtime
Section titled “Opt In at Runtime”Use the command when you cannot edit the entity file, for example when you want to level a mob from an add-on you did not write.
/shapescape_rpgm:add_mob my_addon:frost_wraith| Who can run it | Operators. Command blocks work too. |
| Cheats needed | No |
| Scope | The world it is run in |
| Persistence | Saved with the world. Run it once. |
The type family is the better option when you own the entity file. It travels with your pack, so it works in every world your add-on is installed in without anyone typing anything.
Opt Out
Section titled “Opt Out”Two entity tags turn parts of the system off. Tags work across packs, so you can set them with entity.addTag() from your own script, or with /tag, on any mob.
| Tag | Effect |
|---|---|
shapescape_rpgm_minion | The mob is never levelled at all. No level, no badge, no scaling, no Schmorbs. Use it for summons and clones your own mobs spawn. |
shapescape_rpgm_no_elite | The mob levels normally but is never converted into an Elite. Use it when you spawn a vanilla Creeper, Enderman, Piglin, Skeleton, Spider, or Zombie by script and need it to stay ordinary. |
Set the tag in the same tick you spawn the mob. RPG Mobs checks both at the end of the spawn tick, so a tag added straight after spawnEntity returns is always seen in time.
const wraith = dimension.spawnEntity("my_addon:frost_wraith", location);wraith.addTag("shapescape_rpgm_minion"); // stays completely vanillaWhat Your Mob Gets
Section titled “What Your Mob Gets”Once a mob is in the system, everything applies to it the same way it applies to a vanilla mob.
- A level from 1 to 100, rolled from the world’s average mob level plus the biome it spawned in.
- A level badge above its head and the actionbar readout when a player looks at it.
- Damage scaling. Up to about 15 flat extra damage on its hits at level 100.
- Toughness scaling. Incoming damage divided by up to 5 at level 100.
- Bonus XP on death, scaling with level.
- Schmorbs. It rolls them at spawn, runs them like any other carrier, and drops them on a player kill.
- Player interactions. Bottle o’ Enchanting raises its level. Players can fit Schmorbs onto it, and take them back if your mob is tameable.
Defaults
Section titled “Defaults”RPG Mobs keeps a table of per-mob level bands and toughness weights for vanilla mobs. Your mob is not in that table, so it gets the defaults:
| Setting | Default | What it means |
|---|---|---|
| Level range | 1 to 100 | Your mob can roll any level. |
| Level modifier | 0 | It centres on the world average, with no push up or down. |
| Toughness weight | 1 | It gets the full 5x toughness curve at level 100. |
Those defaults suit a normal-strength mob with a vanilla-sized health pool. If your mob already has a large health pool, the full 5x makes it a very long fight. If it should never appear weak or never appear strong, it needs a band of its own.
Neither of those is something you can set from your pack today. Talk to us and we can add your mob to the table.
How It Works Underneath
Section titled “How It Works Underneath”Useful when you are debugging why a mob does or does not level.
- RPG Mobs overrides no vanilla entity file. Levels, badges, and powers are applied by script on top of unmodified mobs, which is what lets it stack with other add-ons.
- Eligibility is checked on
entitySpawnand onentityLoad, in that order of preference. A mob already in the world when RPG Mobs is added levels the first time its chunk loads. - A mob is eligible if any of these is true: it is a vanilla mob, it is one of our Elites, it carries the
shapescape_rpgm_leveledfamily, or it was added withadd_mob. - Damage scaling mutates the damage on
entityHurtrather than touching health or attributes. Nothing is written to your mob’s components, so your own health and damage values stay exactly as you wrote them. - Levels are stored on the entity, not on the mob type, so two of your mobs standing next to each other can be level 12 and level 87.
What Is Not Exposed
Section titled “What Is Not Exposed”Be aware of the limits before you plan around them.
You cannot read or set a mob’s level from your own pack. Bedrock ties dynamic properties to the behavior pack that wrote them, so the level RPG Mobs stores on an entity is not readable by anyone else. There is no script event, no API, and no scoreboard mirror. If you need your mob to react to its own level, tell us what you need it for.
Elites are a closed roster. The six Elite mobs are custom entities we ship. There is no way to register your mob as an Elite or to give it an Elite variant.
Schmorbs are a closed roster. The eleven Schmorbs are defined in our pack. You cannot add a twelfth, and you cannot make your mob spawn with a specific one.
You cannot exclude a vanilla mob. Turning levels off for a mob type is a world setting, not a pack-level one.
Checklist
Section titled “Checklist”-
Add
shapescape_rpgm_leveledto your entity’sminecraft:type_familyarray. -
Tag any summons or clones your mob spawns with
shapescape_rpgm_minionso they stay vanilla. -
Tag any vanilla Creeper, Enderman, Piglin, Skeleton, Spider, or Zombie you spawn by script with
shapescape_rpgm_no_elite. -
Load a world with both packs. Spawn your mob and check for a badge above its head.
-
Look at it and read the actionbar. You should see its level, its name, and any Schmorb letters.
-
Hit it at a low level and again at a high one to confirm the toughness curve reads the way you want. Use a Bottle o’ Enchanting to raise it.
-
Kill it with a player and check that Schmorbs drop.
Reference
Section titled “Reference”| Value | |
|---|---|
| Opt-in type family | shapescape_rpgm_leveled |
| Never level this mob | Tag shapescape_rpgm_minion |
| Never make this mob an Elite | Tag shapescape_rpgm_no_elite |
| Runtime opt-in | /shapescape_rpgm:add_mob <mobId> |
| Namespace | shapescape_rpgm |
| Minimum Minecraft version | 1.26.40 |
| Script API | @minecraft/server 2.9.0 |
Building something with this? Come tell us on Discord.