You get one automatically the first time you join a world with this mod (unless you turned that off in the config, you rebel). It contains hints. Read it. Or use it as kindling. See if I care. Lost it? Craft another with a Book and some Sliced Cucumber. Don't ask why Sliced Cucumber. It's a long story.

A custom advancements tab, "The Hamster Life," guides you through the thrilling world of hamster husbandry, from finding your first seed to... well, yeeting. (Thanks to @MylesGit on GitHub for the original advancement tree suggestion!)

Got a heavily modded world? Good news— my spawning system is set up to be incredibly compatible with world-gen mods like Terralith and Biomes O' Plenty right out of the box. Don't like the defaults? Fine. The system is also fully configurable, allowing you to define exactly where hamsters and plants should (or shouldn't) appear using biome IDs and a wide range of biome tags. Your world, your rules.

Now, for the default zoology lesson. With nine base coats and eight overlay patterns (plus the unique White color), there are a staggering 73 possible hamster variants to discover. Hamsters found shivering in snowy plains look different from those basking in deserts. Shocking, I know. They even pass these stunningly diverse palettes on to their offspring, with a polite attempt to not exactly copy their parents' overlay patterns, ensuring maximum genetic variety in your pocket pet population.

A Field Guide to Hamster Habitats:

• Orange & Cream: The most common type, often found sunning themselves in Plains, Savannas, Deserts, and non-frigid Beaches. Badlands also seem to attract the Orange ones.
• Chocolate: Prefers the shaded canopy of Forests and non-snowy Taigas (excluding Cherry Groves, those are special).
• Black: Enjoys the damp ambiance of wet biomes like swamps and the mysterious depths of the Deep Dark.
• Light Gray & Dark Gray: These stoic shades are common in non-frozen mountainous regions and also share cave real estate with their Black brethren.
• White: Exclusively found in most snowy biomes (Plains, Taiga, Groves, etc.) and makes up about 30% of the population in the extremely chilly Ice Spikes.
• Blue: A master of glacial camouflage. This rare variant's cool, blue-tinted fur is an uncanny match for the shimmering ice and packed snow of the most frigid landscapes. While vary rare in the default game, (only spawns in Ice Spikes), its love for ice means it might also be spotted in other crystalline wonderlands added by mods.
• Lavender: Less about survival and more about style, this variant's dusty purple coat is a perfect match for the fantastical flora of magical biomes. Look for them amidst the pink petals of Cherry Groves and the strange hues of Mushroom Fields. Their preference for the peculiar means you might also find them in other enchanted forests or mystical groves added by mods.

I also plan to add new darker fur patches in the future, which will add ~50-80 additional possible fur textures!

Found some Pink Petals? Right-click your tamed hamster to bestow upon it a stylish floral accessory. Not feeling that particular look? Click again with petals to cycle through a few options. Regret your decision entirely? A quick snip with Shears will undo your fashionable folly (and you even get the petal back, because I'm nice like that).

The current accessory collection is... sparse, but the hamster haberdashery is just getting started. I mean the mod is still in beta after all. Lol. My Discord community suggestion box is overflowing with ideas that range from "brilliant" to "medically concerning," so future updates might just include some of the following questionable adornments:

• Adventuring Gear: For the hamster with heroic delusions. Think tiny swords, shields, armadillo armor, and even a dried kelp eye-patch.
• Fruit-Themed Headwear: Because who doesn't want a hamster wearing a tiny banana?
• More Flower Decoration Types: We've already got pink petals, but we need ALL THE COLORS.
• Hats and Crowns: Flower crowns for when your hamster needs to feel like the tiny, unelected monarch of the forest floor, and top hats for absolute sophistication.
• And much, much more...

These are subject to change! Got a genius idea for the next hamster accessory that absolutely needs to exist? Think you've designed the perfect tiny helmet? 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.

They'll energetically implement hamster kung fu on enemies (yours or theirs). Essentially, they like round-house kicks. Complete with particles effects on their tiny kicking feet!

• Taming & Sitting

  • Bribe them with enough Sliced Cucumber, and they'll follow you like a furry, ankle-biting shadow. Right-click to make them sit, lest they develop a sudden fascination with the nearest lava pool. Again. (Jk I actually coded them to be terrified of lava and water)

• Advanced Napping Protocols

  • Tamed hamsters, when left sitting, might just decide it's naptime. Watch as they gradually drift off through an elaborate "Path to Slumber" sequence, complete with unique animations for dozing, settling, and several adorable deep sleep poses. This dedication to slumber is, of course, configurable.

• Unique Animation Personalities

  • Not all hamsters are created equal. Upon birth, each hamster is assigned one of three "personalities," which determines the specific sitting and dozing off animations it will use for its entire life. One might be a prim and proper sitter, while another is a bit more of a sloucher. It's a small touch to make your specific furry companion feel even more unique.

• I have many more plans for more QOL features like these! 👆🏼👆🏼

Lure your nearest owned hamster onto your shoulder with the irresistible siren call of Cheese. (Or if you prefer boring explanations: right-click them with it). They'll offer helpful alerts about nearby Creepers and possibly valuable shiny rocks that start with a D, and rhyme with Simon. Kind of. They almost rhyme. Whatever. Complete with "scurrying onto your shoulder" and "leaping off in a huff" sound effects.

For when words fail and you need a furry, surprisingly aerodynamic solution— press 'G' (by default - check your keybinds if you're just flailing your arms) while not staring intently at a block. Behold as your shoulder companion becomes a surprisingly effective, albeit concussed, projectile. Includes satisfying particle trail, impact sound effects, and flight sounds that change pitch as it flies— the Doppler Effect!

Does enough damage by default to kill a creeper, which is... really convenient. Gentle interaction (a pat, a click, whatever) required for post-impact recovery.

So, your shoulder-mounted furball just made a series of excited squeaks and sniffs, hinting at nearby diamonds? Excellent. Now for the fun part. Dismount your tiny prospector. If it was indeed onto something shiny, it might just take matters into its own feet.

Watch as it attempts to lead you to the alleged riches, complete with sniffing animations, determined dust-sniffing particles (the particle colors match the ground below, because details💅🏼), and a soundtrack of focused sniffs.

If its path is blocked, it'll wait patiently (or impatiently, it's hard to tell), hoping you'll clear the way. Upon reaching its target, it'll celebrate with cool particle effects and a chorus of happy bounces (with sound!).

But be warned: sometimes, in their eagerness, these little geologists might get a tad confused about what exactly constitutes a "valuable shiny rock." If it unearths something... less diamond-y and more... not-quite-diamond-ish... prepare for a dramatic sulk, complete with its own unique animation, sound effects, and a display of utter disappointment. A quick pat should snap it out of its angst.

This whole ore-seeking escapade is, of course, configurable.

Your hamster's love for shiny things may have evolved into full-blown kleptomania. If you carelessly leave valuable items (like, say, diamonds) on the ground, your tamed companion might just decide it's time for a game.

Watch as it executes a flawless pounce, snatches the item right off the ground, and takes off! The stolen treasure will be visibly held in its mouth as it initiates a chase sequence. Get too close, and it will sprint away. Fall too far behind, and it will stop and taunt you with a playful animation. Be warned. I almost died of cuteness overload while creating it.

The only way to retrieve your property is to catch the furry thief and right-click it. But be warned—if you take too long, it might get bored and drop the item. But then it might steal it again. This entire feature is fully configurable of course— from which items are considered "valuable" to the duration of the chase.

• Wild Cucumber & Green Bean Bushes: Find these lurking in specific biomes. (See the Hamster Guide book for details.) Right-click the seeded ones for seeds. Try not to step on them. They now spawn without needing a specific light level, so happy cave gardening!
• Slightly Less Useless Sunflowers: Sunflowers have had an upgrade. These look like vanilla ones, but these actually do something. Right-click the top block when it looks seeded for Sunflower Seeds. They regrow. Eventually. Patience is a virtue. Isn't that right, John?

• Cucumber/Green Beans: Grow 'em, eat 'em raw (if you must), slice 'em, steam 'em. Culinary possibilities are… present.
• Steamed Green Beans: A suspiciously potent super-food for your hamster. Grants temporary buffs, followed by a mandatory "please wait" period. Don't get greedy.
• Hamster Food Mix: Allegedly gourmet. Heals well, bypasses their irritating pickiness, and is the key to unlocking their cheek pouches. Craft it. Or don't. Your hamster, your problem.
• Cheese: Not only can it lure hamsters onto your shoulder, it's player-edible. Surprisingly nutritious (think cooked porkchop levels) and you can scarf it down about 30% faster than most foods. The only catch? The... distinctively moist eating sound. Consider it an acquired taste. Its nutritional value is fully configurable, for those of you who felt cheese was somehow "unbalanced." Plebs.

My wife's IRL hamster (Sweet Potato) goes nuts for steamed green beans, which of course inspired this feature. Feed your hamster Steamed Green Beans, and it will enter a state of pure, unadulterated zoomies.

No, it's not just faster— it will also gain icreased Strength, Absorption, and Regeneration, and instead of standing around idly, it will engage in sporadic, high-speed chaotic sprints in circles around you, leaving a trail of energetic particles in its wake. And when it comes to following you, it's less of a "follow" and more of a "hyperactive escort mission."

Yes, inventory... in their face. Feed them Hamster Food Mix once to earn their trust (and cheek access!), then Sneak + Right-click a tamed hamster for 6 slots of prime real estate. No, you can't stuff a Netherite block in there. They'll even automatically scarf down Hamster Food Mix from their cheeks if they take a tumble, after a brief, dramatic pause to consider their options. Can't make them too overpowered.

Psychological Warfare: Creepers are utterly terrified of hamsters, just like cats. They'll flee on sight.

In hindsight, I probably didn't need a whole section for this.

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.

For Fabric & Quilt:

• 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 & Forge:

• 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/Quilt/NeoForge/Forge): 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.

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. Once I get the mod out of beta, the goal is to keep it 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. I do have quite a few more features I want to add before the full release though, so don't hold your breath. Definitely join The Cheek Pouch Discord server to keep up with progress!

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.

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.

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 more Minecraft versions, but I have quite a few more features I want to add before official release— only then will I begin to port to other versions.
• 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.

The license for this project is All Rights Reserved. © 2025 Dawson Bodenhamer (www.ForTheKing.Design).

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.

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.