Changelog — CobbleBetterNPC 1.1.1

Fixed Resolved the issue where NPCs were deleted from the registry after server restart.

Changelog — CobbleBetterNPC 1.1.0

Fixed Resolved the lag issue that occurred when loading NPC skins.

Changed NPC skins are now loaded directly from the configuration folder. Do you need a texture pack? No, it is no longer required.

Added You can now place skin files in the following path:

config/CobbleBetterNPC/skins/<subfolder>/<skin_name>.png

The system will automatically detect and load skins from these folders.

Example

config
 └─ CobbleBetterNPC
     └─ skins
         └─ trainers
             └─ brock.png

A texture pack is no longer required, simply place the .png skin file inside any subfolder and run:

/cbn reload

Additional Example

You can generate a ready-to-use example NPC that showcases the battle reward system with:

/cbn create example battle

Changelog — CobbleBetterNPC 1.0.9

Added Introduced the new battle_rewards behaviour, a modern reward system powered by Cobblelibs that allows fully customizable win and lose battle rewards.

Rewards now support messages, titles, sounds, commands, delays, chance, and random reward selection directly from NPC JSON.

Example You can generate a ready-to-use example NPC showcasing this system with:

/cbn create example battle

This example demonstrates best practices and the full reward customization supported by Cobblelibs.

Changelog — CobbleBetterNPC 1.0.8

Added

• Added an NPC reward system, allowing NPCs to give rewards both after being defeated in battle or without requiring combat, one of the most requested features.
• Full implementation and compatibility with behaviours, enabling much more advanced and modular NPC behavior control.
• Introduced new configuration subfolders, significantly improving file organization and overall scalability.

Behaviour Highlights

• player_textured Allows dynamically applying any player’s skin to an NPC, replacing legacy skin systems.
• npc_scale_configuration NPC visual size and hitbox can now be configured independently.
• battle_commands Allows executing different commands when the player wins or loses a battle against an NPC.
• wanders / wanders_water NPCs can freely move on land and in water.
• stationary Keeps the NPC within a defined radius and ensures it always returns to its configured coordinates.
• core / looks_at_players / panics / avoids_water / floats Enhance NPC realism with base behavior, player interaction, fleeing, floating, and water avoidance.

Changed

• When using behaviours, the set skin command has been removed, as a dedicated skin behaviour now exists.
• Removed maxDistanceFromSpawn. This is now fully handled by movement behaviours, allowing NPCs to walk freely while always returning to their configured position.

Fixed

• Fixed TPS drops when interacting with NPCs, significantly improving server performance.
• General optimization of interaction handling and behaviour execution.

CobbleBetterNPC 1.0.7

Changes

• Fixed an issue with NPC command rewards where delay could not be used correctly.

• Added support for gibber, allowing customization of dialogue text speed and appearance for both NPCs and players.

• Improved /cbn reload behavior: the command now reloads only NPCs with actual changes, reducing unnecessary lag caused by full reloads.

• All these changes can be previewed in the autogenerated examples using:

  /cbn create example command
  /cbn create example dialogue
  /cbn create example battle
  

Changelog — CobbleBetterNPC 1.0.6

Requeriments CobbleLibs 1.0.4

General Changes

• Added new commands to create example NPCs of type command, dialogue, or battle.
• Fixed NPC loading to prevent errors when registering classes and presets.
• Implemented RGB colors and fancy text support for names and dialogues, allowing more stylized and colorful messages.
• Replaced {username} placeholders with in dialogues to improve readability and consistency

Commands

• New command: /cbn example <type> Creates an example NPC based on the specified type (command, dialogue, or battle).

  • Example: /cbn example dialogue will generate a sample dialogue NPC, along with its corresponding NPC JSON and Dialogue JSON files.

Debug

Some bugs with battle-type NPCs were fixed

Changelog — CobbleBetterNPC 1.0.4

General Changes

• The built-in UI editor has been removed. This enables greater customization freedom through JSON files, eliminating restrictions previously imposed by the visual interface.

Commands

• /cbn reload now works correctly: it reloads presets, dialogues, and NPC classes, and automatically respawns all registered NPCs while preserving their UUID, position, and skin (if previously assigned).

• New command:
  /cbn set skin player <name>
  Applies and persists the skin of a player (by username) to the NPC currently being looked at by the executor.

• The /cbn editor command has been removed.

JSON File Format

NPC Files (config/CobbleBetterNPC/NPC/*.json)

• Required field:
  "id" must be present and globally unique. Example:
  "id": "cobblebetternpc:command"
  If missing or duplicated, the NPC will not load.

• resourceIdentifier is required for custom skins:
  Must be one of the following to ensure proper skin and model compatibility:

  • "resourceIdentifier": "cobblemon:standard"
  • "resourceIdentifier": "cobblemon:pikachu"
    Other values may cause model or skin loading failures.

• Optional — Presets:

  "presets": [
    "cobblebetternpc:looks_around"
  ]
  

• Optional — Maximum distance from spawn:

  "maxDistanceFromSpawn": 20
  

  If the NPC moves farther than this distance (in blocks), it is removed and respawned at its original spawn position. Default value: 30.0.

• Default values (no need to include unless overriding):

  "isMovable": false,
  "canDespawn": false,
  "isInvulnerable": true,
  "isLeashable": false,
  "allowProjectileHits": false,
  "hideNameTag": false
  

Dialogue Files (config/CobbleBetterNPC/Dialogues/*.json)

• The faces block has been removed:
  It is no longer required or processed. Obsolete example:

  "faces": {
    "npc": "cobblemon:red_02",
    "player": "player.face()"
  }
  

  To apply a specific player’s skin to an NPC, use the command:
  /cbn set skin player <player_name>.