/Mobzy

Config-driven custom mobs for Spigot using ECS

Primary LanguageKotlinMIT LicenseMIT

Mobzy

Java CI with Gradle Maven Wiki Contribute

Mobzy is a Paper plugin for creating custom mobs with config files. We use Geary to break down complex entities into small components. We provide many components to modify vanilla behaviour, for new game features check out Geary-addons.

Features

  • Extend any existing entity (including NMS entities if registered by another plugin)
  • Simple ModelEngine support
  • Customize pathfinder goals
  • Our own custom spawning system

Example

plugins/Geary/mineinabyss/mobs/hostile/kuongatari.yml

- !<geary:inherit> # Inherits components from another prefab
  from: [mineinabyss:hostile]
- !<mobzy:type> # Tells Minecraft which entity to use under the hood. You may register a custom type with NMS.
  baseClass: minecraft:zombie
  creatureType: MONSTER
- !<geary:display_name> "<#1FB53D>Kuongatari" # Sets a colored display name
- !<mobzy:modelengine> # Uses a ModelEngine model
  modelId: kuongatari
- !<mobzy:pathfinders> # Sets some pathfinder goals
  targets:
    1: !<mobzy:target.attacker>
      range: 200
    2: !<mobzy:target.nearby_player>
      range: 10
  goals:
    1: !<minecraft:behavior.melee_attack>
      seeThroughWalls: true
    2: !<minecraft:behavior.leap_at_target>
      jumpHeight: 0.6
    4: !<minecraft:behavior.random_stroll_land>

Project Wiki

We have an old wiki that we want to update soon. For now, you can ask us questions in #plugin-dev on our Discord server, or come help with development there!

You may also find our generated docs useful