A walkthrough of the systems ServerPet is being built around. This is a design preview, not live documentation: commands, numbers, and names can change before launch.
⚠️In development. ServerPet is not invitable yet. This guide describes the design in the repo's DESIGN.md so future communities know what they are signing up for.
1. Overview design preview
A server adopts one communal pet, pinned to a chosen channel. It has real needs, and the community collectively keeps it alive and thriving. The hook is shared responsibility: it is the server's pet, and its health is a reflection of the community.
Collection: unlock pet skins, evolutions, and habitat cosmetics over time.
Care: feed, play, clean, heal, and pet as a group.
Competition: cross-server leaderboards plus individual contributor flex.
2. Activity-Driven Care core mechanic
Member activity generates care energy, the resource the server spends on care actions:
Messages, reactions, voice presence, and daily check-ins all feed the pool (the exact mix and weights are open design questions).
Members spend energy on care actions, each with cooldowns so no one person can (or has to) carry it alone.
Needs drift down around the clock. A consistently active community is the win condition.
3. The Five Needs in tuning
The pet tracks hunger, happiness, energy, cleanliness, and health. Health reflects the others over time: keep four green and the fifth follows. The landing page console is a live miniature of this exact loop.
4. Neglect, Revival & Streaks stakes
Unmet needs slide the pet from sad → sick → dormant (critical).
Dormant is recoverable, always: a server rally revives the pet. No permanent death by default, because a dead-pet guilt spiral kills communities faster than it motivates them.
An opt-in hardcore mode with real death/reset stakes is an open question for veteran servers.
Streaks: consecutive healthy days build the server streak, the headline bragging stat. Neglect breaks it.
5. Rewards & Evolutions in design
The pet levels and evolves as the server keeps it healthy, unlocking skins, accessories, habitat themes, and server-wide perks.
Individual contributors earn the most: personal badges, titles, cosmetics, and soft currency. A small baseline trickles to everyone so lurkers still feel included (split is a tunable, see DESIGN.md).
Milestones (level 10/25/50, 30-day streak, first revival) unlock community cosmetics.
6. Leaderboards & Flexing cross-server
Cross-server leaderboard: healthiest pets, highest levels, longest streaks across every server running ServerPet.
Contributor leaderboard: who cared the most, per server.
Pet Hall of Fame: profile and role rewards for the most devoted carers.
7. Admin Setup scoped
Admins pick the pet channel (/setpetchannel), name the pet, and configure who can do what. Everything is per-server and properly permission-scoped from day one. Larger servers may eventually unlock multiple pets (expansion idea, not launch scope).
8. The SpartanBots Ecosystem cross-bot
ServerPet shares its rarity ladder, premium currency (Drachmas), and Patreon with the whole family: AestherBot, TackleBot, GargoyleBot, and the in-development TerraBot, PondBot, and BinderBot. Care and progress are earnable only; premium buys cosmetics and convenience, never power.