Entity Spawning Commands (DM-Only)

[FirebrickRed]

Summary

Create DM-only commands for spawning, managing, and controlling entities in the world. Includes single entity spawning, group spawning, teleportation, removal, and listing.

Phase: 1 - Foundation
Systems: Entity System, DM Tools, Commands

Prerequisites

• Unified Entity System Foundation #72 - Unified Entity System Foundation (MUST be completed first)

Goals

• /dmentity spawn <id> [name] [location] - Spawn single entity
• /dmentity spawngroup <group_id> - Spawn entity group from YAML
• /dmentity list - List all spawned entities with locations
• /dmentity remove <entity> - Despawn entity
• /dmentity teleport <entity> <location> - Move entity
• Tab completion for all entity IDs, group IDs, entity names
• Persistence system (save spawned entities across server restarts)

Cleanup Tasks

• Delete CustomNPCs/NpcCommands.java - Replace with new /dmentity commands
• Update plugin.yml - Remove old /spawnnpc command, add /dmentity commands

Command Examples

# Spawn with auto-generated name from pool
/dmentity spawn kobold
> Spawned "Skrix" at your location

# Spawn with custom name
/dmentity spawn town_guard "Marcus the Brave"
> Spawned "Marcus the Brave" at your location

# Spawn at coordinates
/dmentity spawn owlbear ~10 ~0 ~5
> Spawned "Owlbear" at (X, Y, Z)

# Spawn entire group
/dmentity spawngroup kobold_warband
> Spawned 5 entities from group "kobold_warband"

# List all entities
/dmentity list
> 1. Skrix (kobold) at (100, 64, -200)
> 2. Marcus the Brave (town_guard) at (50, 65, 30)
> 3. Owlbear at (110, 64, -195)

# Remove entity
/dmentity remove Skrix
> Removed "Skrix" from the world

# Teleport entity
/dmentity teleport "Marcus the Brave" ~0 ~0 ~10
> Teleported "Marcus the Brave" 10 blocks forward

Tab Completion

• /dmentity spawn <TAB> → Shows all entity IDs
• /dmentity spawngroup <TAB> → Shows all group IDs
• /dmentity remove <TAB> → Shows all spawned entity names
• /dmentity teleport <TAB> → Shows all spawned entity names

Persistence

• Save spawned entities to plugins/jkvttplugin/SpawnedEntities/
• Auto-load on server start
• Track: entity ID, custom name, location, current HP, shop adjustments

Technical Details

• Permission node: jkvtt.dm (DM-only commands)
• Entity tracking: In-memory map + YAML persistence
• Name conflicts: Handle multiple entities with same name ("Marcus TICKET-001: Implement Player Choice Handler #1", "Marcus TICKET-002: Implement Ability Allocation Handler #2")

Next Steps

After completing this issue, tackle:

• Entity Stat Block Display #74: Stat Block Display (view spawned entities)
• Native Villager Trade GUI Shop System #75: Shop System (interact with spawned merchants)
• Dual Interaction System (Commands + Right-Click) #85: Dual Interaction System (right-click alternative)

Related Issues

• Unified Entity System Foundation #72 - Unified Entity System Foundation (prerequisite)
• Entity Stat Block Display #74 - Entity Stat Block Display
• Native Villager Trade GUI Shop System #75 - Shop System
• DM Entity Possession System #78 - DM Possession System
• Entity Group Management System #79 - Group Management