UPets+
Modernized companion pets plugin with an interactive in-game UI
Click to Expand
Modernized RocketMod companion pets plugin with an interactive in-game UI, async JSON/MySQL storage, auto-spawn on join/respawn, virtual pack mule bags, and configurable passive perks — evolved from RestoreMonarchyPlugins/UPets.
Credits
- AdamAdam — Original UPets author
- Restore Monarchy — UPets maintenance
New Features
- Interactive Companion UI (
UPets+UI): Paginated pet browser, Pet Shop tab, active pet counter & balance display, instant spawn/despawn/buy actions, stay/follow toggle, custom pet renaming, and inline activity log (/pet,/pet ui,/petui). - Auto-Spawn on Join & Respawn: Persists which pet(s) you had active (
IsActive) and automatically respawns them when joining the server or reviving (AutoSpawnOnJoin,AutoSpawnOnRespawn). - Configurable Passive Pet Perks: Stat regeneration, mobility/low-gravity, fall/bleed/drowning/elemental immunities, outgoing PvP/PvE/harvest/raid damage multipliers, XP & cash bonuses, companion zombie guard attacks, and virtual pet storage bags.
- Multi-Economy Support: Works with Uconomy, Unturned Experience (
EconomyMode = Experience),Auto, orNone(permissions-only). - Multi-Pet Support: Configurable
MaxActivePetsdefault plus permission overrides (pet.max.2throughpet.max.10). - Smart AI & Vehicle Handling:
- Raycast ground-snapping keeps pets on roofs, floors, bridges, and buildings.
- Smooth follow positioning behind the player (no camera-orbit spinning) and idle stopping within
MinDistance. - Auto-hides following pets when entering a vehicle and restores them upon exiting (
HideInVehicles). - Protects pets from bullets, melee, explosions (
ProtectFromExplosions), and sentries.
- Async Storage & Hybrid Config:
- Global settings in
UPets+.configuration.xmland pet catalogue + perks inPets.json(with automatic one-time migration from legacy XML<Pets>).
- Global settings in
Commands
Player Commands (/pet, permission: pet)
| Command | Aliases | Description |
|---|---|---|
/pet | /pet ui, /pet menu, /petui, /petsui | Opens the UPets+ UI panel (or shows chat help if UI is disabled). |
/pet <name> | — | Spawns or despawns an owned pet. |
/pet list | /pets | Lists your owned pets, custom names, and [Active] status. |
/pet shop | /petshop, /petsshop | Lists pets available to purchase and their prices. |
/pet buy <name> | — | Purchases a pet using the configured economy. |
/pet despawn | /pet clear | Despawns all of your active pets. |
/pet stay / /pet follow | — | Makes active pets hold position or resume following you. |
/pet rename <pet> <newName> | — | Sets a custom name (up to 32 characters) for an owned pet. |
/pet perks | — | Displays the combined passive perks of your currently active pets. |
/pet bag [name] | /pet storage [name] | Opens your pack pet's virtual storage bag (defaults to active bag pet if name omitted). |
/pet help | /pethelp, /petshelp | Displays chat command help. |
Admin Commands (/petadmin, permission: petadmin, console + in-game)
| Command | Aliases | Description |
|---|---|---|
/petadmin give <player|steam64> <pet> | /pa give ... | Grants a pet to an online or offline player. |
/petadmin remove <player|steam64> <pet> | /pa remove ... | Removes a pet from a player and despawns it if active. |
/petadmin list <player|steam64> | /pa list ... | Lists all pets owned by a player. |
/petadmin reload | /pa reload | Reloads UPets+.configuration.xml, Pets.json, economy, and database. |
Permissions
<!-- Base command access -->
<Permission Cooldown="0">pet</Permission>
<Permission Cooldown="0">petadmin</Permission>
<!-- Optional max active pets override (pet.max.2 .. pet.max.10) -->
<Permission Cooldown="0">pet.max.2</Permission>
<!-- Grant ownership of a pet without buying it -->
<Permission Cooldown="0">pet.own.cow</Permission>
<Permission Cooldown="0">pet.own.bear</Permission>
<Permission Cooldown="0">pet.own.wolf</Permission>
<!-- Optional shop purchase permissions (configured per pet in Pets.json) -->
<Permission Cooldown="0">pet.wolf</Permission>
<Permission Cooldown="0">pet.reindeer</Permission>
Configuration (UPets+.configuration.xml)
Global settings are stored in UPets+.configuration.xml:
<?xml version="1.0" encoding="utf-8"?>
<PetsPlusConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<MessageColor>#FF00FF</MessageColor>
<MessageIconUrl>https://i.imgur.com/AdIgUbl.png</MessageIconUrl>
<CurrencySymbol>$</CurrencySymbol>
<MinDistance>4</MinDistance>
<MaxDistance>50</MaxDistance>
<EnableOwnerKill>true</EnableOwnerKill>
<ProtectFromExplosions>true</ProtectFromExplosions>
<DespawnOnDeath>true</DespawnOnDeath>
<HideInVehicles>true</HideInVehicles>
<MaxActivePets>1</MaxActivePets>
<EconomyMode>Auto</EconomyMode>
<AutoSpawnOnJoin>true</AutoSpawnOnJoin>
<AutoSpawnOnRespawn>true</AutoSpawnOnRespawn>
<AutoSpawnDelaySeconds>1.5</AutoSpawnDelaySeconds>
<EnablePerks>true</EnablePerks>
<PerkTickIntervalSeconds>5</PerkTickIntervalSeconds>
<RequirePetNearbyForPerks>true</RequirePetNearbyForPerks>
<PerkMaxDistance>25</PerkMaxDistance>
<EnableUI>true</EnableUI>
<OpenUIOnBarePetCommand>true</OpenUIOnBarePetCommand>
<UIEffectId>55000</UIEffectId>
<ClickAudioEffectId>55001</ClickAudioEffectId>
<UseMySQL>false</UseMySQL>
<DatabaseAddress>127.0.0.1</DatabaseAddress>
<DatabaseUsername>unturned</DatabaseUsername>
<DatabasePassword>password</DatabasePassword>
<DatabaseName>unturned</DatabaseName>
<DatabaseTableName>PlayersPets</DatabaseTableName>
<DatabasePort>3306</DatabasePort>
</PetsPlusConfiguration>
EconomyMode:Auto(uses Uconomy if loaded, otherwise disables shop),Uconomy,Experience(uses player XP), orNone.
Pet Catalog & Perks (Pets.json)
Pets and their perks are stored in Pets.json in the plugin folder.
[
{
"Id": 6,
"Name": "cow",
"Cost": 100.0,
"Perks": {
"FoodPerInterval": 1.0,
"WaterPerInterval": 1.0,
"StorageWidth": 5,
"StorageHeight": 4
}
},
{
"Id": 5,
"Name": "bear",
"Cost": 250.0,
"Perks": {
"DamageReductionPercent": 5.0,
"PreventBleeding": true,
"GuardDamage": 18
}
},
{
"Id": 3,
"Name": "wolf",
"Cost": 150.0,
"Permission": "pet.wolf",
"Perks": {
"SpeedMultiplier": 1.08,
"ZombieDamageMultiplier": 1.1,
"GuardDamage": 14
}
},
{
"Id": 7,
"Name": "reindeer",
"Cost": 500.0,
"Permission": "pet.reindeer",
"Perks": {
"WarmthPerInterval": 2.0,
"StaminaPerInterval": 2.0,
"FreezeDamageMultiplier": 0.5,
"StorageWidth": 4,
"StorageHeight": 3
}
},
{
"Id": 4,
"Name": "pig",
"Cost": 150.0,
"Permission": "pet.pig",
"Perks": {
"HealthPerInterval": 1.0,
"ResourceDamageMultiplier": 1.15,
"XpBonusMultiplier": 1.1
}
},
{
"Id": 1,
"Name": "deer",
"Cost": 150.0,
"Permission": "pet.deer",
"Perks": {
"StaminaPerInterval": 3.0,
"JumpMultiplier": 1.05,
"GravityMultiplier": 0.85,
"FallDamageMultiplier": 0.5,
"PreventBrokenLegs": true
}
}
]
All Available Perks Fields
Periodic Stats & Income (applied every PerkTickIntervalSeconds)
| Property | Default | Description |
|---|---|---|
HealthPerInterval | 0 | Health restored per tick. |
StaminaPerInterval | 0 | Stamina restored per tick. |
FoodPerInterval | 0 | Food restored per tick. |
WaterPerInterval | 0 | Water restored per tick. |
VirusPerInterval | 0 | Immunity/virus restored per tick. |
WarmthPerInterval | 0 | Warmth restored per tick. |
XpPerInterval | 0 | Experience points awarded per tick. |
MoneyPerInterval | 0 | Currency deposited per tick (when economy is enabled). |
Mobility, Low Gravity & Utility
| Property | Default | Description |
|---|---|---|
SpeedMultiplier | 1.0 | Movement speed multiplier (1.15 = +15% speed). |
JumpMultiplier | 1.0 | Jump height multiplier (1.2 = +20% jump). |
GravityMultiplier | 1.0 | Gravity multiplier (0.5 = half gravity / moon-jump glide). |
FallDamageMultiplier | 1.0 | Scales fall damage (0 = fall damage immunity). |
PreventBrokenLegs | false | Prevents and cures broken legs (EDeathCause.BONES bone breaks). |
AllowFreecam | false | Grants freecam (PlayerLook.sendFreecamAllowed) to non-admins while active. |
Outgoing Damage & XP Multipliers
| Property | Default | Description |
|---|---|---|
PvpDamageMultiplier | 1.0 | Scales outgoing PvP damage against other players. |
ZombieDamageMultiplier | 1.0 | Scales damage dealt to zombies. |
AnimalDamageMultiplier | 1.0 | Scales damage dealt to wild animals. |
ResourceDamageMultiplier | 1.0 | Scales damage dealt to trees & ore nodes. |
StructureDamageMultiplier | 1.0 | Scales damage dealt to structures. |
BarricadeDamageMultiplier | 1.0 | Scales damage dealt to barricades. |
VehicleDamageMultiplier | 1.0 | Scales damage dealt to vehicles. |
XpBonusMultiplier | 1.0 | Multiplies XP earned (1.25 = +25% bonus XP). |
Defense & Survival Immunities
| Property | Default | Description |
|---|---|---|
DamageReductionPercent | 0 | Incoming damage reduction (0–75%). |
PreventBleeding | false | Prevents and cures bleeding. |
PreventDrowning | false | Blocks drowning damage and tops up oxygen. |
FireDamageMultiplier | 1.0 | Scales BURNING damage (0 = immune). |
FreezeDamageMultiplier | 1.0 | Scales FREEZING damage (0.5 = 50% resist). |
AcidDamageMultiplier | 1.0 | Scales ACID damage. |
InfectionDamageMultiplier | 1.0 | Scales INFECTION damage. |
Companion Guard & Virtual Pack Storage
| Property | Default | Description |
|---|---|---|
GuardDamage | 0 | Melee damage dealt to nearby hunting zombies (0 disables guard). |
GuardRange | 10.0 | Radius in meters around owner to target hunting zombies. |
GuardCooldownSeconds | 2.5 | Seconds between guard attacks. |
StorageWidth | 0 | Virtual bag grid width (both width & height must be > 0 to enable /pet bag). |
StorageHeight | 0 | Virtual bag grid height. |
BUNDLE & SAVE 25%Save $13.75
PvE Expanded 2
The best PvE plugins to optimize your server!
Includes 5 Plugins:
Bundle Price:
$55.00$41.25
BUNDLE & SAVE 10%Save $1.60
Cosmetic Pack!
A collection of cosmetic plugins to help your players customize themselves. Good for VIP rewards.
Includes 3 Plugins:
Bundle Price:
$16.00$14.40
UPets+
roleplaypvpeconomyanimalsui
★New(0 ratings)
$10.00Save up to 25% in a Bundle↓Current Versionv1.1.4
Last Updated11/22/2026
Required Workshop
Unique Visitors24
Subscribers4
Favorites2
Workshop IDs
3838179095
Latest Changes
v1.1.4
- Added RPGSkills Integration (optional)