From 0484beb64d95fb1c7377eb605aad7b914a2d86a1 Mon Sep 17 00:00:00 2001
From: Drefvelin <54400154+Drefvelin@users.noreply.github.com>
Date: Thu, 24 Sep 2026 19:15:11 +0000
Subject: [PATCH] docs: show players how to list their animals

The husbandry guide should explain /animals, including the last place each animal was seen.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 frontend/app/wiki/animal-husbandry/page.tsx | 11 ++++++++--
 frontend/app/wiki/data/animal-husbandry.ts  | 24 +++++++++++++++------
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/frontend/app/wiki/animal-husbandry/page.tsx b/frontend/app/wiki/animal-husbandry/page.tsx
index 1c22e855..9d6a9170 100644
--- a/frontend/app/wiki/animal-husbandry/page.tsx
+++ b/frontend/app/wiki/animal-husbandry/page.tsx
@@ -1,8 +1,9 @@
-import { Callout, DataTable, SeeAlso, WikiPage, WikiSectionHeading } from "@/app/components/wiki";
+import { Callout, CommandTable, DataTable, SeeAlso, WikiPage, WikiSectionHeading } from "@/app/components/wiki";
+import { animalHusbandryCommands } from "../data/animal-husbandry";
 
 export default function AnimalHusbandryPage() {
   return (
-    <WikiPage title="Animal Husbandry" lastModified="2026-09-23" intro="Raise livestock for milk, eggs, meat and materials. Claim your animals, keep them fed and clean, then breed successive generations for better genetics. You can own or co-own up to 15 animals.">
+    <WikiPage title="Animal Husbandry" lastModified="2026-09-24" intro="Raise livestock for milk, eggs, meat and materials. Claim your animals, keep them fed and clean, then breed successive generations for better genetics. You can own or co-own up to 15 animals.">
       <WikiSectionHeading id="getting-started">Claim your first animal</WikiSectionHeading>
       <ol className="mt-4 list-decimal space-y-2 pl-5 text-sm text-[var(--tfmc-mist)]">
         <li>Get an Ownership Token, Universal Feed and a Glove.</li>
@@ -76,6 +77,12 @@ export default function AnimalHusbandryPage() {
         Food quality rolls between the star tier of effective genetics and the star tier of raw genetics. For example, 800 genetics and 100 care gives 400 effective genetics, so food can roll 3 to 5 stars. At 200 care, that animal produces 5-star food. Higher genetics also unlock better material drop tiers.
       </p>
 
+      <WikiSectionHeading id="finding">Finding your animals</WikiSectionHeading>
+      <p className="mt-4 text-sm text-[var(--tfmc-mist)]">
+        <code>/animals</code> lists every animal you own or share, and the last place each one was seen. The count at the top is how many of your 15 slots are in use. Click a set of coordinates in chat to copy them. A shared animal is marked Co-owner. Visit an animal once if its place has not been recorded yet.
+      </p>
+      <CommandTable className="mt-4" commands={animalHusbandryCommands.commands} excludedStaffCommands={animalHusbandryCommands.excludedStaffCommands} />
+
       <WikiSectionHeading id="mounts">Caring for mounts</WikiSectionHeading>
       <p className="mt-4 text-sm text-[var(--tfmc-mist)]">
         Owned mounts can be ridden by their owners and co-owners. Inspect a mount to see its health, speed and jump stats. Genetics and care contribute to mount stats, so keep breeding stock healthy and check individual animals before choosing your mount.
diff --git a/frontend/app/wiki/data/animal-husbandry.ts b/frontend/app/wiki/data/animal-husbandry.ts
index 55dc4f4d..368e6605 100644
--- a/frontend/app/wiki/data/animal-husbandry.ts
+++ b/frontend/app/wiki/data/animal-husbandry.ts
@@ -1,4 +1,20 @@
-import type { WikiSection } from "./types";
+import type { WikiCommandSet, WikiSection } from "./types";
+
+export const animalHusbandryCommands: WikiCommandSet = {
+  system: "Animal Husbandry",
+  href: "/wiki/animal-husbandry",
+  commands: [
+    {
+      command: "/animals",
+      aliases: ["/livestock"],
+      description:
+        "Lists every animal you own or share, with the last place each one was seen.",
+      notes:
+        "Each line shows the name, the kind of animal, whether it is growing, and whether it is happy, hungry, or dirty. Click the coordinates in chat to copy them. If a place is missing, visit that animal once so it can be recorded.",
+    },
+  ],
+  excludedStaffCommands: ["/animals <player>"],
+};
 
 export const animalHusbandrySection: WikiSection = {
   nav: {
@@ -7,9 +23,5 @@ export const animalHusbandrySection: WikiSection = {
     category: "food",
     blurb: "Claim animals, keep them fed and clean, and breed for better food and materials.",
   },
-  commands: {
-    system: "Animal Husbandry",
-    href: "/wiki/animal-husbandry",
-    commands: [],
-  },
+  commands: animalHusbandryCommands,
 };