Skip to content

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.

AI Generated This wiki page was generated with AI assistance. If you spot an inaccuracy, log in to suggest an edit, or let us know on Discord.

Add shapescape_rpgm_leveled to your entity’s minecraft:type_family component in your behavior pack.

my_addon/entities/frost_wraith.behavior.json
{
"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.

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 itOperators. Command blocks work too.
Cheats neededNo
ScopeThe world it is run in
PersistenceSaved 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.

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.

TagEffect
shapescape_rpgm_minionThe 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_eliteThe 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 vanilla

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.

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:

SettingDefaultWhat it means
Level range1 to 100Your mob can roll any level.
Level modifier0It centres on the world average, with no push up or down.
Toughness weight1It 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.

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 entitySpawn and on entityLoad, 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_leveled family, or it was added with add_mob.
  • Damage scaling mutates the damage on entityHurt rather 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.

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.

  1. Add shapescape_rpgm_leveled to your entity’s minecraft:type_family array.

  2. Tag any summons or clones your mob spawns with shapescape_rpgm_minion so they stay vanilla.

  3. Tag any vanilla Creeper, Enderman, Piglin, Skeleton, Spider, or Zombie you spawn by script with shapescape_rpgm_no_elite.

  4. Load a world with both packs. Spawn your mob and check for a badge above its head.

  5. Look at it and read the actionbar. You should see its level, its name, and any Schmorb letters.

  6. 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.

  7. Kill it with a player and check that Schmorbs drop.

Value
Opt-in type familyshapescape_rpgm_leveled
Never level this mobTag shapescape_rpgm_minion
Never make this mob an EliteTag shapescape_rpgm_no_elite
Runtime opt-in/shapescape_rpgm:add_mob <mobId>
Namespaceshapescape_rpgm
Minimum Minecraft version1.26.40
Script API@minecraft/server 2.9.0

Building something with this? Come tell us on Discord.