RPG Companion

# DwarfPetMod Changelog

 

 

### Command Changes

| Old | New | What it does |

|-----|-----|--------------|

| `/p` | `/c` | Quick companion toggle (spawn/despawn) |

| `/f` | `/f` | Quick follow/stay toggle |

| `/a` | `/a` | Cycle combat mode: Passive > Aggressive > Hunt |

| `/panel` | `/panel` | Open companion panel |

**New player commands:**

- `/pet passive` - Companion won't attack anything

- `/pet aggressive` - Companion fights your targets and defends you

- `/pet hunt` - Companion attacks anything nearby on sight

**New admin commands:**

- `/petadmin panel` - Open the Admin Panel GUI

- `/petadmin setlevel <level>` - Set your pet's level (resets stats and talents)

- `/petadmin addxp <amount>` - Add XP to your pet

- `/petadmin config list [category]` - View all configurable settings

- `/petadmin config get <key>` - Check a setting's value

- `/petadmin config set <key> <value>` - Change a setting

- `/petadmin permissions add <name|uuid>` - Add a server admin

- `/petadmin permissions remove <name|uuid>` - Remove a server admin

- `/petadmin permissions list` - Show all admins

- `/petadmin reload` - Apply config changes without restarting

**Chat aliases** (type in chat, not the command bar):

- `!aggressive` - Toggle aggressive mode

- `!hunt` - Toggle hunt mode

- Custom aliases can be configured per-player in the companion panel Settings tab

### Admin Panel

Open with `/petadmin panel`. In single-player, all players are automatically admins.

**7 tabs for server configuration:**

| Tab | What you can change |

|-----|-------------------|

| **GENERAL** | Max pets per player, max level, save interval, XP multiplier |

| **COMBAT** | Damage reduction, melee/ranged cooldowns, attack ranges, aggro radius, crit multiplier |

| **XP** | XP per kill, XP per damage hit, stat points per level |

| **MOVE** | Follow distance, teleport distance |

| **DEATH** | Drop gear on death (on/off) |

| **STATS** | Points per stat cap, diminishing returns threshold, per-stat scaling (STR, VIT, END, AGI, INT, LCK) |

| **PERMS** | Add/remove admins by name or UUID, toggle single-player bypass |

All changes apply immediately after saving. Use `/petadmin reload` if you edited the config file manually.

**Managing admins on a multiplayer server:**

1. Open the PERMS tab

2. Type a player's name (they must be online) or their UUID

3. Click ADD — they can now use `/petadmin` commands

4. Single-Player Bypass is ON by default, so solo players don't need to configure anything

### Three Combat Modes

Your companion now has three combat behaviors instead of just on/off:

- **Passive** - Won't attack anything, follows peacefully

- **Aggressive** - Fights back when you attack something or when you take damage

- **Hunt** - Actively scans for and attacks any hostile mob within aggro radius (default 10 blocks)

Cycle modes with `/a` or set directly with `/pet passive`, `/pet aggressive`, `/pet hunt`.

The HUD shows the current mode.

### Balance Changes

- **XP curve** is now steeper — leveling takes meaningful effort instead of a few kills

  - Formula: `150 * level^1.8` (was `100 * level^1.5`)

- **Follow distance** increased from 2.5 to 3.0 blocks — companion doesn't crowd you anymore

- **`/petadmin setlevel`** now properly resets stat points, talents, and free resets

  - Previously only changed the number, leaving old stats active (caused an XP exploit)

### Bug Fixes & Stability

- All 26 admin config settings are now properly connected to gameplay (several were display-only before)

- Fixed memory leak in combat cooldown tracking

- Fixed ability scheduler leak on pet despawn

- Fixed CDR cap mismatch between UI display and actual combat

- Fixed thread safety issue in pet storage

- HUD only redraws when something actually changes (~95% fewer rebuilds)

- Removed ~400 lines of dead code

### Config File

If you're upgrading from an older version, your existing `config.json` keeps its old values.

To get the new defaults, either delete your config file and let it regenerate, or use:

```

/petadmin config set general.xpBaseAmount 150

/petadmin config set general.xpScalingFactor 1.8

/petadmin config set movement.followDistance 3.0

```

---

## v1.6.6 (2026-02-16) - Balance & QoL

### Fixed

- **`/petadmin setlevel` now resets stats, talents, and free resets** — previously only reset level and XP, leaving old stat points active which caused inflated damage and snowball XP gain

- **XP curve too shallow** — changed defaults from (100, 1.5) to (150, 1.8) for a steeper, more satisfying progression

### Changed

- **Default follow distance** increased from 2.5 to 3.0 blocks — companion no longer crowds the player

- **Permissions add/remove now accepts player names** — `/petadmin permissions add PlayerName` works alongside UUIDs; Admin Panel input field updated to match

- **Admin Panel permissions tab** shows player names next to UUIDs when players are online