Admin Panel & Pet Creator
The Pet System includes a full admin command suite and an in-game Pet Creator UI for server administrators.
Permission required: ks.pet.admin
Pet Creator UI
The Pet Creator is an interactive UI page that allows admins to build custom pets with full control over every parameter. Open it with:
/kspetadmin creator
or
/kspetadmin create
Creator Fields
| Field | Type | Description |
|---|---|---|
| Pet Type | Dropdown | Select from all registered pet types (shows display name, module, and rarity) |
| Level | Text field | Pet level (1-100) |
| Nickname | Text field | Custom display name (optional, defaults to type display name) |
| Target Player | Text field | Player to receive the pet (optional, defaults to self) |
| Stat Slots (x5) | Dropdown + Text fields | Up to 5 stats, each with type, base value, per-level growth, and unlock level |
Available Stat Types
The creator dropdown includes all 12 stat types:
| Stat Type | Display Name |
|---|---|
damage_bonus | Damage Bonus |
crit_chance | Crit Chance |
armor_bonus | Armor Bonus |
max_health | Max Health |
speed_bonus | Speed Bonus |
pickup_radius | Pickup Range |
xp_bonus | XP Bonus |
loot_luck | Loot Luck |
life_steal | Life Steal |
stamina_regen | Stamina Regen |
mana_regen | Mana Regen |
thorns | Thorns |
Max Stats Button
Clicking Max Stats automatically fills in optimal stat values:
- Sets level to the pet type's max level
- Sets all stat unlock levels to 1 (all stats available immediately)
- Applies maximum quality values based on the pet's rarity
- Respects combat-only stat pool for combat pets
- Uses rarity rules to determine how many stat slots are available
Create Button
Clicking Create validates all fields, creates the pet in the database, generates the summon item (egg/rune/horn) with proper metadata, and places it in the target player's inventory.
A status message appears at the bottom of the page showing success or error details.
Admin Commands Reference
All admin commands require the ks.pet.admin permission.
/kspetadmin give <player> <type>
Gives a pet egg/rune/horn to the specified player. The pet is created with default stats rolled based on rarity, and the item is placed directly into the player's inventory.
/kspetadmin give Steve wolf
/kspetadmin give Steve wolf_combat
/kspetadmin give Steve rex_cave_mount
/kspetadmin remove <player> <type>
Removes a pet from a player's data. If the pet is currently active, it is despawned first.
/kspetadmin remove Steve wolf
/kspetadmin setlevel <player> <type> <level>
Sets a pet's level directly. XP is reset to 0. Any stat unlock levels that were skipped are rolled automatically. Buffs are reapplied if the pet is active.
/kspetadmin setlevel Steve wolf 50
Type IDs with underscores can be written with spaces. The command joins all words between player name and the trailing number with underscores automatically.
/kspetadmin setlevel Steve dragon frost 30 is equivalent to /kspetadmin setlevel Steve dragon_frost 30
/kspetadmin addxp <player> <type> <amount>
Grants XP to a specific pet. Triggers level-ups and stat rolls as normal.
/kspetadmin addxp Steve wolf 5000
/kspetadmin reroll [<player> <type> | combat | collector | mount]
Clears all stats and re-rolls them from scratch based on rarity. Two usage forms:
/kspetadmin reroll Steve wolf -- Target a specific player's pet
/kspetadmin reroll combat -- Reroll your own active combat pet
/kspetadmin reroll collector -- Reroll your own active collector pet
/kspetadmin reroll -- Reroll your active pet (any type)
/kspetadmin maxout [<player> <type> | combat | collector | mount]
Sets a pet to its maximum level and ensures all stat slots are filled. Missing stats for unlock levels are rolled automatically. Two usage forms (same as reroll).
/kspetadmin maxout Steve wolf
/kspetadmin maxout combat
/kspetadmin inspect hand
Inspects the pet item currently held in the admin's hand. Shows full metadata including instance ID, type, level, XP, stats (with base values and per-level growth), filter rules, and combat mode.
/kspetadmin inspect hand
/kspetadmin inspect <player>
Inspects all pet items in a player's inventory. Lists every egg/rune/horn found across hotbar, storage, and backpack, plus the player's cached pet data (active pets, pet count).
/kspetadmin inspect Steve
/kspetadmin reload
Reloads config.json, stat-pool.json, all pet type definitions, and localization files without restarting the server.
/kspetadmin reload
/kspetadmin list
Lists all registered pet types with their ID, display name, rarity, and max level.
/kspetadmin list
/kspetadmin cleanup
Force-removes all KS-role NPC entities from the default world. Useful for cleaning up orphaned pet NPCs after crashes or bugs. Also despawns all tracked active pets.
/kspetadmin cleanup
/kspetadmin cleanworld
Scans all loaded worlds and removes orphaned KS-role NPC entities. More thorough than cleanup for multi-world servers.
/kspetadmin cleanworld
/kspetadmin despawnall
Despawns all currently active pet NPCs for all online players. Player data is preserved.
/kspetadmin despawnall
Troubleshooting Tips
| Problem | Solution |
|---|---|
| Orphaned pet NPCs after crash | Run /kspetadmin cleanup or /kspetadmin cleanworld |
| Pet data seems wrong | Use /kspetadmin inspect <player> to check metadata |
| Stats seem broken | Use /kspetadmin reroll <player> <type> to re-roll stats |
| Need to test a max-level pet | Use /kspetadmin maxout or the Pet Creator UI |
| Pet egg missing from inventory | The give command places the item directly; check hotbar/storage |