Browse docs
Configuration
Choose how settings are managed
Config.UseIngameConfigurator = true is the default. Authorized staff open /petsconfig, edit values and save them to SQL. Changes are revisioned; the editor provides search, an import/history area, and a reset flow. The last 30 changes are selectable in the UI while complete history remains in SQL.
To edit managed settings in Lua, change individual fields in sky_pets/config/config.lua, restart the resource, then run /petsconfig import. Import replaces the managed SQL overrides with the Lua startup snapshot; back up the current configuration first. To use Lua overrides directly, set Config.UseIngameConfigurator = false and restart. Disabling the editor keeps saved SQL settings; it does not delete them.
Config.UseIngameConfigurator = true
Config.Locale = "en"
-- Examples: restart, then /petsconfig import while the editor is enabled.
Config.BreedSettings.rottweiler = { price = 2500, enabled = true }
Config.Growth.hoursToAdult = 72
Config.UiTheme = "neon"
Shipped defaults live under source/shared/default_config.lua and source/shared/defaults/. Keep customer overrides in config/config.lua; do not replace the entire Config table or copy old default modules back into config.
Where to find a setting
| Area | Main settings and effects |
|---|---|
| Shops & locations | Shop position, interaction NPC, preview dog/camera/target, breed lists, supplies link |
| Breeds & prices | Enabled breeds, stable IDs and prices, puppy-only sales, growth duration and time mode |
| Presentation | UiTheme (warm-wood or neon), PrimaryColor, Currency, name length, preview zoom |
| Care and training | Needs, Health, Training, feeding and toy activity ranges/timers |
| Companion movement | Menu, Leash, PetVehicle movement and distance settings |
| Service dogs | WorkDogs job keys, duty rules, lessons, searches and rescue integration |
| Duels | Combat enable switch, challenge rules, XP and balance settings |
| Animal form | AnimalMenu enabled state and safety distances |
Config.Account selects the payment account (default bank). Player-facing text comes from config/locales; the default locale is en. Portraits load from Config.PedImageBaseUrl (https://cdn.sky-systems.net/peds by default), so clients need CDN access.
File-based bootstrap values
These take effect after a restart and are not editable through the SQL configurator: UseIngameConfigurator, AutoExecuteQuery, Locale, CommandPermissions, command names, HUD/radial binding methods and keys, asset loading timeout, image URL, debug settings, animal-menu admin groups, and appearance-provider completion events. Server-only scent item names are in config/work_dogs_server.lua.
The editor is permission protected. Configure Config.CommandPermissions.petsconfig to match your sky_base permission groups (default god, superadmin, admin); each read, save, import and history action is checked server-side. See Commands.
SQL persistence
Automatic pet-data migration follows Config.AutoExecuteQuery. When the editor is enabled, its own configuration tables are migrated independently. Configuration saves update the live settings; existing pets, training, wardrobes and purchases are not erased by import or reset.