BMNpcForceReload

BMNpcForceReload is a lightweight plugin for Paper designed for servers using Citizens and BetterModel.

Its purpose is simple: some Citizens NPCs can sometimes lose their BetterModel after a restart, reload, or simply over time.
This plugin allows you to automatically reapply the correct models to your configured NPCs so that they always retain their correct appearance.

Features

• Automatically reapplies BetterModel models to Citizens NPCs
• Runs automatically when the server starts
• Automatic restart at configurable intervals
• Supports multiple NPCs with their own model names
• Simple configuration in YAML
• Based on command execution for maximum compatibility
• Very useful if your BetterModel models randomly disappear from your NPCs

How it works

The plugin reads a list of NPC ID + model from the configuration file, then automatically executes the necessary command(s) to put the correct model back on each NPC.

Example of use

• NPC 50 → adventure_npc
• NPC 43 → cubee_evil
• NPC 25 → seller

When the server starts up, and then at each configured interval, the plugin automatically reapplies the models to all defined NPCs.

Why this plugin exists

On some configurations, BetterModel templates attached to NPC Citizens do not always remain applied correctly.
BMNpcForceReload acts as an automatic safety net to avoid having to reapply the templates manually.

Dependencies

• Citizens
• BetterModel

Configuration

The plugin is fully configurable:

• activation or deactivation of the automatic system
• startup delay
• interval between each restart
• delay between each NPC
• command template
• list of NPCs and models to reapply

Command

/bmnpcforcereload reload

Reloads the plugin configuration and immediately restarts the application of models on all configured NPCs.

Permission

bmnpcforcereload.admin

Notes

This plugin does not replace BetterModel or Citizens.
It is a utility plugin designed to improve the reliability of your NPCs when their models do not remain loaded correctly.

Configuration example

settings:
  enabled: true
  interval-seconds: 7200
  startup-delay-seconds: 15
  debug: true
  command-template: “npc select %npc_id% && npc model %model%”
  delay-between-npcs-ticks: 10

npcs:
  - npc-id: 50
    model: “adventure_npc”
  - npc-id: 43
    model: “cubee_evil”
  - npc-id: 25
    model: “seller”