promotional bannermobile promotional banner

AmigoNPC

A smart companion NPC that supports players in combat, gathering, and progression with a configurable UI.

File Details

AmigoNPC 1.0.3

  • R
  • Feb 12, 2026
  • 829.88 KB
  • 427
  • Early Access

File Name

AmigoNPC-1.0.3.jar

Supported Versions

  • Early Access

New additions

1) Cave/underground mode (closer follow)

  • The NPC now follows the owner closer (~4–5 blocks) when the owner is in a cave/underground.
  • Implemented via Role SubState:
    • .Default (surface)
    • .Cave (underground)
  • Added the .Cave SubState to Amigo_Follow.json (both copies: normal and _Core).

2) Shorter teleport distance underground

  • In cave/underground mode, the hard teleport distance is reduced to 10 blocks.
  • On the surface, it goes back to normal (35 blocks).
  • Applied to followHard and shouldRescue using:
    • hardTeleportDist = caveMode ? 10.0 : 35.0;

3) Cave/underground detection (best-effort)

  • Simple “nearby ceiling” heuristic above the owner:
    • checks blocks 2 to 8 blocks above.
  • Tries to avoid false positives from trees:
    • ignores IDs containing leaf/leaves/foliage/vine.
  • Cache/controls:
    • reevaluates every ~500ms
    • simple debounce to avoid constant state switching.

4) Level Up audio fix (reliable)

  • Level up sound now:
    • tries 2D on the owner
    • if it fails (build/ref variation), falls back to 3D at the owner’s position;
    • if the owner position can’t be resolved, falls back to the NPC position;
    • Level up volume set to 10 dB.
    • Helper created/updated