Klasse ModNPC

Basisklasse zum Erstellen benutzerdefinierter NPCs, Gegner und Bosse.

ModItem | Zurück zur API-Referenz | ModTile →

Übersicht

Die Klasse ModNPC ermöglicht es Ihnen, benutzerdefinierte Nicht-Spieler-Charaktere zu erstellen, einschließlich freundlicher NPCs, Gegner und Bosse mit benutzerdefiniertem KI-Verhalten. Dies baut auf Konzepten von ModItem auf – lesen Sie das zuerst, wenn Sie neu in der tModLoader-Entwicklung sind.

Einfaches Gegner-Beispiel

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace YourMod.NPCs
{
    public class ExampleEnemy : ModNPC
    {
        public override void SetStaticDefaults()
        {
            Main.npcFrameCount[Type] = 6; // Number of animation frames
        }

        public override void SetDefaults()
        {
            NPC.width = 40;
            NPC.height = 40;
            NPC.damage = 20;
            NPC.defense = 10;
            NPC.lifeMax = 100;
            NPC.HitSound = SoundID.NPCHit1;
            NPC.DeathSound = SoundID.NPCDeath1;
            NPC.value = 100f; // Money dropped
            NPC.knockBackResist = 0.5f;
            NPC.aiStyle = NPCAIStyleID.Fighter; // Zombie-like AI
        }

        public override float SpawnChance(NPCSpawnInfo spawnInfo)
        {
            return SpawnCondition.OverworldNightMonster.Chance * 0.1f;
        }
    }
}

Einen Boss erstellen

Bosse erfordern eine komplexere Einrichtung mit benutzerdefinierter KI:

public class ExampleBoss : ModNPC
{
    public override void SetStaticDefaults()
    {
        Main.npcFrameCount[Type] = 4;
        NPCID.Sets.BossBestiaryPriority.Add(Type);
    }

    public override void SetDefaults()
    {
        NPC.width = 100;
        NPC.height = 100;
        NPC.damage = 40;
        NPC.defense = 15;
        NPC.lifeMax = 5000;
        NPC.boss = true; // Mark as boss
        NPC.npcSlots = 10f;
        NPC.value = Item.buyPrice(gold: 5);
        NPC.knockBackResist = 0f; // Immune to knockback
        NPC.noGravity = true; // Flies
        NPC.noTileCollide = true;
        Music = MusicID.Boss1;
    }

    public override void AI()
    {
        // Custom AI code here
    }
}

NPC-Eigenschaften-Leitfaden

aiStyle

Eingebaute KI-Muster:

  • • Fighter (Zombie-artig)
  • • Flying (Fledermaus-artig)
  • • Worm (segmentiert)
  • • Custom (eigene KI)

boss

NPC als Boss markieren:

  • • Zeigt Lebensbalken
  • • Verhindert Despawnen
  • • Boss-Musik wird gespielt
  • • Spezielle Todeseffekte

Mehr erfahren

Vollständige ModNPC-Dokumentation mit KI-Beispielen:

Vollständige ModNPC-Dokumentation

Vollständige ModNPC-Dokumentation:

Vollständige Dokumentation anzeigen