Configuration

plugins/AnimatedBB/config.yml. Run /abb reload after changing it (and /abb models reload for the models section).

License

license-key: "CHANGE_ME"

One key per server; it binds to the first machine it runs on. The console prints that machine's id if you need it reset: ask in Discord.

General

settings:
  debug: false                         # more messages in the console
  default-interaction-cooldown: 1000   # milliseconds between clicks
  save-interval: 300                   # seconds between auto-saves; 0 to turn off
  despawn-on-chunk-unload: true

Models

models:
  render-mode: heads      # heads or quads, see Models
  update-interval: 1      # ticks between pose updates; 1 is the smoothest
  sheet-thickness: 0.3    # thinnest box that can still be a head
  alpha-tolerance: 0.1    # see-through share a head may swallow
  shadow-strength: 1.0    # how dark ground shadows are
  double-sided: true      # quads drawn both ways, seen from behind too

update-interval at 1 samples the animation every tick and is the smoothest. Raising it sends fewer packets, but quick movements start to look low framerate; raise it only if bandwidth is a problem. Parts that do not move send nothing either way.

double-sided doubles the entity count of quads; turn it off for solid models where no face is seen from inside.

MineSkin

mineskin:
  api-key: ""   # free at https://account.mineskin.org/keys

See Models.

Bedrock

bedrock:
  fallback: true

See Bedrock players.

Defaults for new NPCs

defaults:
  animation:
    idle: "idle"          # animation looped when nothing happens
    interact: "interact"  # animation played when clicked
    loop-idle: true
    speed: 1.0
  interaction:
    left-click-enabled: true
    right-click-enabled: true
    cancel-damage: true   # a left click does not hurt it
  hologram:               # see Holograms over NPCs
    enabled: false
    offset-y: 2.5

messages.yml

Every message, in MiniMessage. Change words, colours or language freely.