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.3z

  • R
  • Feb 21, 2026
  • 168.06 KB
  • 349
  • Early Access

File Name

AmigoNPC-1.0.3z.jar

Supported Versions

  • Early Access

AmigoNPC — Update 3 Compatibility + Loot Improvements (Changelog)

New additions / changes

1) Hytale Update 3 compatibility (pinned ServerVersion)

  • The mod is now pinned to the Update 3 server build via manifest.json:
    • "ServerVersion": "2026.02.17-255364b8e"
  • Applied to all manifest copies shipped in the ZIP (src/build/bin), keeping the same structure.

2) AutoLoot overhaul (reliable + instant on Update 3)

  • Instant pickup fix (Update 3): before processing a dropped item, the code forces pickup delay to zero (best-effort):
    • try { ic.setPickupDelay(0f); } catch (Throwable ignored) {}
  • This exists in both:
    • tryAutoLoot(...) (scan/vacuum)
    • tryPickupGroundItemIntoBackpack(...) (pickup path)
  • Radius increased + vertical tolerance:
    • AutoLoot now pulls dropped items within 5.0 blocks around the NPC
    • Vertical tolerance is also 5.0
  • Cylindrical scan kept:
    • horizontal check: (dx*dx + dz*dz) <= r2
    • vertical check: abs(dy) <= radius

3) Post-combat pickup reliability (“loot stick”)

  • After a kill, AutoLoot keeps a short post-kill window (+0.5s) to catch drops that spawn slightly late.
  • Goal: prevent missed drops caused by target switching or Update 3 timing.

4) Combat policy fix — /amigo defender OFF

When /amigo defender is OFF:

  • NPC does not auto-acquire random targets
  • NPC does not auto-assist
  • NPC only attacks:
    • (A) the aggressor that attacked the owner, or
    • (B) the aggressor that attacked the NPC
  • Attack gates were adjusted so Defender OFF does not block valid aggressor targets.

5) Rescue teleport reliability

  • Rescue teleport was fixed to reliably trigger when distance passes 35 blocks
  • Prevents the rescue logic from being overwritten by later conditions.

6) Level Up FX restored (visual)

  • Level-up particle FX restored using global spawn (not viewer-dependent):
    • POTION_MORPH_BURST on the NPC body

7) Friendly-fire protection (owner → NPC)

  • NPC is immune to damage caused by its owner (prevents accidental hits).

Notes

  • The focus of this branch is Update 3 compatibility + loot reliability with minimal behavior changes.
  • No changes were made to HUD, persistence, configs, or unrelated mechanics beyond what was required for these fixes.