Adorable Hamster Pets

Thanks to Crimson Gaming for the Showcase!

Tiny fur. Big fun.

Adorable Hamster Pets stuffs Minecraft with pint-sized, jiggly fur-missiles that have a craving for... diamonds. Perfect for anyone who surveyed their diamond-encrusted empire and muttered, “Needs more rodents.” These hamsters like to bounce, shoulder-surf, hoard snacks, and moonlight as throwable projectiles, all while adding maximum charm and helping with your inventory clutter. Tame, feed, or yeet at will; (ethics optional).

TL;DR Features, for the Impatient

• 
  73 fur variants – (genetics! science! questionable breeding decisions!)
  
• 
  Hyper-Configurable – control nearly every feature, from spawning to item stealing
  
• 
  Custom advancement tab – gamify your rodent wrangling
  
• 
  Taming with Sliced Cucumber – bribe your way to squeaky friendship
  
• 
  Shoulder-Surfing Perks – portable creeper radar & diamond divination, powered by cheese
  
• 
  Hamster Yeet™ (press G) – turns your shoulder buddy into a concussion-powered projectile
  
• 
  Diamond Stealing – your hamster plays high-stakes keep-away with your valuables
  
• 
  Potent Vegetables – stuff their face with Steamed Green Beans and witness the chaotic sprint-fest
  
• 
  Diamond Sniffing – complete with dramatic sulking animations if it accidentally finds gold instead
  
• 
  Cheek Pouches of Holding – six inventory slots inside the hamster (cheeks visibly expand when full)
  
• 
  Dynamic naps, personalities, sleepy-time & idle animations – because realism
  
• 
  Automatic Eating From Cheeks – they'll take a snack break on their own if they have Hamster Food Mix
  
• 
  Wild Cucumber & Green Bean Bushes – for foraging farmable seeds... or decor, if you're into that
  
• 
  Cheese Crafting – surprisingly moist snack for players; slips right down the old gullet
  
  

Or If You Prefer Juicy Details, Click Here

---

Getting Started (The "Bla Bla How Do I Make It Squeak?" Guide)

1. Go Outside: Wander aimlessly through Plains, Savannas, Forests, Swamps, etc., until you trip over Wild Cucumber Bushes or Wild Green Bean Bushes. Right-click the ones that look like they have seeds. Collect said seeds.
2. Pretend to Farm: Plant seeds on farmland. Wait. Harvest. Try not to starve while waiting for virtual vegetables.
3. Questionable Crafting: Turn Cucumbers into Sliced Cucumber (the bait). Turn Green Beans into Steamed Green Beans via furnace (for buffs). Cobble together various seeds and carrots into Hamster Food Mix (for healing). Turn Milk into Cheese (the Shoulder Shenanigans starter kit). Refer to your recipe book, I'm not writing recipes here.
4. Attempt Taming: Find a wild hamster. Sneak. Hold Sliced Cucumber. Approach like you're diffusing a tiny, furry bomb. Click. Repeat until successful or rage-quit.
5. Basic Hamster Operations: Right-click to sit/stand. Sneak + Right-click for cheek inventory access (after feeding Food Mix!). Wave Cheese around to shoulder-mount. Crouch to dismount, or Press 'G' to dismount... assertively.

---

How to Contact Me

Alright, let's be real. Sometimes things break. Sometimes hamsters exhibit behavior that even I can't explain (looking at you, hamster #37, who tried to eat a sign). And sometimes you, my friend, might have a stroke of genius that could elevate this mod from "questionably charming" to "quite good."


Whether it's your genius ideas, or my not-so-genius mistakes, please tell me all about it! Knowing about either one just makes the mod all that much better. Here's how to get in touch.

• GitHub Issues Page: This is the best place for bug reports and feature suggestions. I actually check it. Frequently. It helps keep things organized, and other people can see if their issue is already known.
• Official Discord Server: Come hang out, share pictures of your hamsters, or get help in real-time. It's organized chaos, and you're invited.

---

Bug Reporting Etiquette (Please, I Beg You)

If you're reporting a bug, to save both our sanities, try to include:

1. What You Were Doing: (e.g., "I was trying to teach my hamster to yodel while riding a pig backwards during a thunderstorm...")
2. What You Expected to Happen: (e.g., "...and I expected it to hit a high C, or at least not phase through the floor.")
3. What Actually Happened: (e.g., "...but instead, it turned into a turnip and started quoting Shakespeare. Also, my game crashed.")
4. Minecraft Version, Mod Version, Fabric Loader/API Versions: Usually found in the top of your crash report or your mod list.
5. Crash Report (If Applicable): Use a site like Pastebin, Gist, or Mclo.gs and give me the link. Do NOT paste the whole thing into a GitHub comment or email. My scroll wheel will thank you.
6. Pro Tip (For Crash Reports): To make your life (and mine) infinitely easier, consider installing the Crash Assistant mod. It's a client-side utility that pops up after a crash and gives you a one-click button to upload all relevant logs. It's not required, but it's highly recommended.
7. Screenshots/Videos (If Helpful): A picture (or better yet, a screen recording) is worth a thousand lines of confused log reading.

8. 👉🏼👉🏼👉🏼 Hamster Debug Info (Jade Mod):

   • If you have the Jade mod installed, my mod includes a special debug overlay for hamsters.
   • To toggle this overlay: Sneak and Right-Click a tamed hamster while holding the Hamster Guide Book. (You can craft the guidebook with a Book + Sliced Cucumber). An action bar message will confirm if it's enabled or disabled.
   • Alternatively, you can enable/disable it in the "Adorable Hamster Pets" config screen (Mod Menu -> Adorable Hamster Pets -> UI & Quality of Life -> "Enable Jade Hamster Debug Info").
   • If your bug involves hamster behavior or animations, please try to capture a screenshot or video with this debug overlay visible while looking at the affected hamster. Knowing the states shown in this overlay (e.g., "Current Custom Goal," "Sitting," "Dozing Phase") is extremely helpful for diagnosing issues!

The more info you give, the less I have to guess, and the faster things might get fixed.

Fun fact: I've already implemented new features like the custom advancement tree and config toggles for the hamster guidebook based on suggestions from my GitHub! We move quick around here.

---

Dependencies (Stuff You Need Besides Questionable Life Choices)

For Fabric:

• Fabric API: The big one. The whole show. Duh.
• Architectury API: The universal translator that makes this all possible.
• GeckoLib: For the wiggles and jiggles. Essential.
• Fzzy Config: For the config screen you'll either ignore or spend way too much time in.
• Fabric Language Kotlin: Fabric's preferred brand of Kotlin, needed by Fzzy Config.

For NeoForge:

• Architectury API: Still the universal translator.
• GeckoLib: Still essential for the wiggles.
• Fzzy Config: Still here for your tweaking pleasure.
• Kotlin for Forge: NeoForge's flavor of Kotlin, also needed by Fzzy Config.

Optional (but Recommended for Your Sanity):

• Jade (Fabric/NeoForge): For seeing what's what, and for the special hamster debug overlay.
• Mod Menu (Fabric Only): For an easy way to get to that fancy config screen.

---

Loader & Version Support (The Multi-Verse of Rodents)

Let's get this out of the way: The dark days of unofficial workarounds and digital duct tape are over.

As of version 2.3.0, this mod officially supports:

• Fabric
• Quilt
• NeoForge
• Forge

Thanks to a basically heroic, caffeine-fueled refactor to the Architectury toolchain, you can now download the appropriate JAR for your loader of choice and enjoy hamster-based chaos without any extra setup.

Actually just kidding about the heroic caffeine-fueled part. It was more like terrified, GitHub conversation-fueled. Huge thanks to @fzzyhmstrs on GitHub / @ZeMonkey / @Cool Girl on Discord for all their help. It's doubtful you would be yeeting your hamsters on NeoForge right now if it weren't for them.

"What About More Minecraft Versions?"

Yes, that's the plan. The goal is to keep the mod updated for the latest versions of Minecraft while also backporting features to older, popular versions where feasible. Your hamster army's temporal conquest is inevitable.

---

Installation (The Annoying But Necessary Bit)

1. Install Fabric Loader if you haven't already.
2. Install Fabric API, Geckolib.
3. Download the Adorable Hamster Pets .jar file, from where you got this file, presumably.
4. Shove the jar file into your mods folder. If you don't know where that is, maybe modding isn't for you.
5. Launch Minecraft. Brace yourself.
6. Briefly question the series of events that led you to installing a mod primarily focused on hamsters.

---

Configuration (For Those Who Like to Tinker)

Uses Fzzy Config for configuration. If you have Mod Menu, click the button. If not, venture into the "config/adorablehamsterpets" folder and edit "main.toml" by hand like some kind of digital caveman. The config includes extensive options to control exactly where hamsters and wild plants spawn, using biome IDs and tags for wide compatibility with other world gen mods.

You can also fine-tune nearly every feature down to the smallest detail. Adjust hamster health, melee damage, and taming difficulty. Control the velocity, damage, and cooldown of the Hamster Yeet. Decide exactly which items your hamsters consider valuable enough to steal, and set the duration and chase distances for the heist. Tweak the duration and potency of every stat in the Green Bean buff. Adjust the regrowth speed of sunflowers, the rarity of wild bushes, and even the nutritional value of cheese. Or just turn off the features you don't like entirely. Defaults are probably fine. Probably.

---

Future Plans (The Ever-Expanding Hamster Agenda)

The hamster wheel of "progress" never truly stops. Here's a peek at what might be scurrying out of the development pipeline, eventually:

• Version Voracity: My hamsters aim to colonize future Minecraft 1.21.x versions. Subject to API whims and developer sanity.
• The Art of Cheese: The current milk-to-cheese recipe is placeholder. Expect a more involved, thematically appropriate cheese-making process in the future.
• More Hamster Skins: Expanding the variety of overlay patterns for even more unique-looking companions.
• Shoulder Sync with Animation Mods: Investigating better visual integration of the shoulder hamster when using player animation overhaul mods like "Fresh Animations." This is complex and depends on external factors.
• The "Snack of Yestermouth": A peculiar item formed when multiple food types are left in a hamster's cheek pouch for an extended period (accelerated by rotten flesh). Its purpose? Still under... fermentation. It will likely serve a unique, helpful, if slightly gross, function.
• So. Many. More. Ideas.: The Discord server is overflowing with ideas. Lots of future plans in store!

Got a genius idea for the next feature that absolutely needs to exist? Bring your brilliant, weird, and wonderful ideas to The Cheek Pouch Discord Server. Make sure you select "Share Your Genius" in the screening questions to get the "@Idea Generator" role, and then unleash your creativity in the suggestions channel.

---

License (The Legal Blah Blah - But Actually Read This Bit)

What this License Covers

The whole enchilada— all the Java code, the hamster models, their fur textures, the animations, every custom sound effect, the block/item textures, and even the build scripts. Basically, everything in this repository.

What that Means

You can enjoy the mod, show it off in your videos (please do, and a little credit is always nice!), and include it in modpacks. However, you cannot copy, modify, redistribute, or use any part of this project (code or assets) in your own projects without explicit, prior, written permission. Think of it as an art gallery – admire, enjoy, don't walk out with the paintings or the blueprints for the building.

TL;DR Version:

• Play the mod? Yeppers.
• Make videos/streams? Big yep.
• Include in a modpack? Go for it.
• Use my hamster images/sounds/code in your own stuff? Nope. Not without asking first.
• Re-upload the mod somewhere else? Definitely not. Get it from official sources (like Modrinth).
• Sell the mod? The Minecraft EULA says I can't even do that, and you shouldn't either.

For the full, legally-binding-but-hopefully-still-understandable text that lawyers apparently enjoy, please see the "LICENSE.md" file included with the mod. If you're thinking of doing something not covered here, just reach out and ask! I'm generally pretty reasonable, unless you try to precisely replace all my hamsters with sentient cabbages. Then we might have words.

---

Hat Tip to the Hamster Trailblazers

Apparently, putting tiny digital rodents into Minecraft is a shared ambition. While figuring out how to make these particular fuzzballs look less like sentient bread loaves, the general aesthetic of the Hamsters mod by Starfish Studios served as an early visual reference point. It's a different spin on hamsters, focusing on things like hamster wheels and redstone, last seen conquering Minecraft 1.20.1.

You can check out their handiwork here:

• Starfish Studios' Hamsters Mod (Modrinth)
• Starfish Studios Website

Standard Procedure Disclaimer: Just to be clear, Adorable Hamster Pets is its own beast (well, rodent). All the assets you see here – models, textures, animations, code, questionable sounds – were built independently from the ground up for this mod. I appreciate the inspiration, went off and did my own thing entirely, and naturally respect their All Rights Reserved license on their assets.

---

Now go enjoy the squeaks. Or mute them. Whatever.