Adorable Hamster Pets

3,000+ Wild Variants, Procedural Genetics, Shoulder Launching, Diamond Sniffing, Cheek Inventories, Personalities, 50+ Animations, Wander Modes, and much more!

2,1M

Adorable Hamster Pets

<p> <a href="https://mod.curseforge.com/minecraft-mod-of-the-year-2025/" target="_blank" rel="noopener noreferrer"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_MOTY_banner_for_mod_page.png" alt="Adorable Hamster Pets Banner" width="100%"/> </a> </p>

<div align="center">

</div>

<a href="https://youtu.be/18-uvVcPgdg"> <img align="right" src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_thumbnail_updatev3.6.0_showcase.png" alt="Watch the Procedural Genetics Update showcase" width="75%"> </a>

<font color="orange">The cutest, most useful pet in Minecraft.</font>

That's a bold claim, so allow me to demonstrate. Adorable Hamster Pets stuffs Minecraft with pint-sized, jiggly fur-missiles that have a craving for... diamonds.

Perfect for anyone who surveys their diamond-encrusted empire and mutters, “Needs more rodents.”

These hamsters like to bounce, shoulder-surf, hoard snacks, sniff for things, and moonlight as throwable projectiles, all while adding maximum charm and helping with your inventory clutter. Tame, feed, or yeet at will; (ethics optional).

<br> <p> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_features_banner.png" alt="Adorable Hamster Pets Features" width="100%"/> </p>

<font color="orange">TL;DR Features, for the Impatient</font>

* Widely-Compatible – <font color="gray">*(discovery! science! questionable taming decisions!)*</font> * Widely-Compatible – <font color="gray">*discover up to 2.2 million unique variants through breeding*</font> * Widely-Compatible – <font color="gray">*from biodegradable Acorn shells to Netherite plating*</font> * Widely-Compatible – <font color="gray">*procedural napping, cleaning, and personality-based sit/sleep poses*</font> * Widely-Compatible – <font color="gray">*mount them on your shoulders & head, jiggle physics included*</font> * Widely-Compatible – <font color="gray">*portable creeper radar & diamond divination, powered by cheese*</font> * Widely-Compatible – <font color="gray">*turns your shoulder buddies into furry, squeaky missiles*</font> * Widely-Compatible – <font color="gray">*link them to Hamster Beds so they stop following you*</font> * Widely-Compatible – <font color="gray">*hamsters play high-stakes keep-away with your valuables; highly configurable*</font> * Widely-Compatible – <font color="gray">*stuff their face with Steamed Green Beans and witness the chaotic zoomies*</font> * Widely-Compatible – <font color="gray">*complete with dramatic sulking animations if they accidentally find gold instead*</font> * Widely-Compatible – <font color="gray">*six inventory slots *inside the hamster* (cheeks visibly expand when full)*</font> * Widely-Compatible – <font color="gray">*they can snack on their own if they have Hamster Food Mix*</font> * Widely-Compatible – <font color="gray">*use them for rodent bribes... or decor, if you're into that*</font> * Widely-Compatible – <font color="gray">*surprisingly moist snack for players; hamsters find it intoxicating*</font> * Widely-Compatible – <font color="gray">*a wealth of ancient hamster knowledge, plus cozy illustrations*</font> * Widely-Compatible – <font color="gray">*so you can gamify your rodent wrangling*</font> * Widely-Compatible – <font color="gray">*find hamster gear in ancient loot chests; archaeologists baffled*</font> * Widely-Compatible – <font color="gray">*customize everything, from spawning to yeet velocity*</font> * Widely-Compatible – <font color="gray">*all interactions & mechanics based on configurable c:tags*</font>

<br> <p> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showcases_banner.png" alt="Adorable Hamster Pets Showcases" width="100%"> </p>

<p align="center">

<a href="https://youtu.be/-kpqJSetTBY"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showcases_thumbnail_noxus.png" alt="Showcase by Noxus" width="32%"> </a>

<a href="https://youtu.be/QCzbNhzo1mg"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showcases_thumbnail_atlas.png" alt="Showcase by Atlas" width="32%"> </a>

<a href="https://youtu.be/mKkwQfjFNJw?t=234"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showcases_thumbnail_boodlyneck.png" alt="Showcase by Boodlyneck" width="32%"> </a>

<a href="https://youtu.be/SsnFzMOVdvI"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showcases_thumbnail_wero-lovernite.png" alt="Showcase by Wero Lovernite" width="32%"> </a>

<a href="https://youtu.be/qGjH25FbPOg?t=592"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showcases_thumbnail_enderverse.png" alt="Showcase by Enderverse" width="32%"> </a>

</p>

<br> <p> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_showroom_banner.png" alt="Adorable Hamster Pets Showroom" width="100%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_the_basics_but_cuter.png" alt="The Basics" width="100%"></p>

Bribe them with Sliced Cucumber and they'll follow you like a furry, ankle-biting shadow. They have unique personalities that dictate how they sit and nap. Yes, they even have a dedicated "Path to Slumber" animation sequence.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_begging.gif" alt="Hamster begging" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_sitting.gif" alt="Hamster sitting" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_shoulder_surfing_with_perks.png" alt="Shoulder Surfing" width="100%"></p>

Lure up to three hamsters onto your person using Diamonds. They aren't just static decorations; they are fully animated, physics-enabled passengers that bounce when you jump and hold on for dear life when you sprint. While up there, they act as portable radar systems, squeaking alerts for nearby Diamonds and Diamonds.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamsters_riding_on_shoulder.gif" alt="Hamsters riding on players shoulder" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/shoulder_hamster_smells_diamond_and_creeper.gif" alt="Shoulder hamster smells diamond and creeper" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_the_hamster_yeet.png" alt="The Hamster Yeet™" width="100%"></p>

For when words fail and you need a furry, surprisingly aerodynamic solution— press 'G'. Behold as your shoulder companion becomes a surprisingly effective, albeit concussed, projectile. Includes satisfying particle trail, impact sound effects, and the 'G'! Does enough damage by default to kill a creeper, which is... really convenient.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/the_hamster_yeet1.gif" alt="The Hamster Yeet part 1" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/the_hamster_yeet2.gif" alt="The Hamster Yeet part 2" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_the_tree_heist.png" alt="The Tree Heist" width="100%"></p>

Throw a hamster at an Acorn Hat. It will vanish into the canopy, physically rustling the leaves and raining down Acorn Hat. You can use the acorns to craft Acorn Hat and the stylish Acorn Hat accessory.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/the_tree_heist_part1.gif" alt="The tree heist part 1" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/the_tree_heist_part2.gif" alt="The tree heist part 2" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_wander_mode_hamster_beds.png" alt="Tamed Wander Mode & Hamster Beds" width="100%"></p>

Craft a Hamster Bed, link it to your hamster, and place it. They will stop following you and wander freely near their bed. If they get stuck somewhere, just go to sleep— they'll find their way home during the night. Comes with numerous interactive controls specific to each bed.

P.S. - Don't place the bed upside down. Just don't do it.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_sleeping_in_bed.gif" alt="A hamster sleeping in its linked bed." width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_sitting_near_bed.gif" alt="A hamster sitting near its linked bed." width="48%"> <img src="https://i.imgur.com/wSuzX0F.jpeg" alt="9 wood types, 9 beds" width="96%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_furry_diamond_prospecting.png" alt="Prospecting" width="100%"></p>

If they smell diamonds while on your shoulder, put them down. They will lead you to the ore. Note: they sometimes mistake Gold for Diamond, and will exhibit a dramatic sulking animation when they realize their error.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_finds_diamonds.gif" alt="Shoulder hamster finds diamonds" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_finds_gold.gif" alt="Shoulder hamster finds gold" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_hamster_kung_fu_techniques.png" alt="Hamster Kung Fu Techniques" width="100%"></p>

They'll energetically implement hamster kung fu on enemies. They like round-house kicks. Even includes particle effects on their feet.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_fighting_stray.gif" alt="A hamster fighting a stray" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamsters_fighting_husks.gif" alt="Hamsters fighting husks" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_acorn_armor.png" alt="Armor" width="100%"></p>

Craft Netherite: (works like Wolf Armor, negates all damage until it breaks). Upgrade it with Netherite: found in chests: * Netherite: Aerodynamic. Reduces wind resistance for a faster throw. * Netherite: Lightweight. Grants a permanent movement speed buff. * Netherite: The "Expensive Therapy" upgrade. Netherite: A diamond-clad hamster is so satisfied with its own shininess that it will Netherite: shiny things for you instead of stealing them. * Netherite: Dense. Grants Knockback Resistance and massive throw impact damage.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_wearing_base_armor.gif" alt="Hamster wearing base acorn armor" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/frost_walker_demo.gif" alt="Frost walker enchanted armor demo" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_item_stealing_the_game_of_tag.png" alt="Stealing" width="100%"></p>

Your hamster's love for shiny things may have evolved into full-blown kleptomania. Unless wearing Diamond armor, they will steal valuable items dropped on the floor and run away with them. Catch them to retrieve your loot (just diamonds by default; configurable).

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/item_stealing1.gif" alt="Item Stealing part 1" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/item_stealing2.gif" alt="Item Stealing part 2" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_biome_variants_genetics.png" alt="Variants" width="100%"></p>

<font color="red">OUTDATED AS OF v3.6.0 - UNDER CONSTRUCTION</font>

73+ variants spawn based on biome (White in snow, Black in caves, Lavender in magical biomes). Compatible with Terralith/Biomes O' Plenty/Oh the Biomes You'll Go out of the box. Configurable enough to work with any other mod that adds custom biomes. When bred, they pass their diverse fur coat palettes on to their offspring, with a polite attempt to not *exactly* copy their parents' overlay patterns, ensuring maximum genetic variety in your ever-growing population.

A Field Guide to Hamster Habitats

* Lavender: The most common type, often found sunning themselves in Plains, Savannas, Deserts, and non-frigid Beaches. Badlands also seem to attract the Orange ones. * Lavender: Prefers the shaded canopy of Forests and non-snowy Taigas (excluding Cherry Groves, those are special). * Lavender: Enjoys the damp ambiance of wet biomes like swamps and the mysterious depths of the Deep Dark. * Lavender: These stoic shades are common in non-frozen mountainous regions and also share cave real estate with their Black brethren. * Lavender: Exclusively found in most snowy biomes (Plains, Taiga, Groves, etc.) and makes up about 30% of the population in the extremely chilly Ice Spikes. * Lavender: 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.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/four_hamster_variants.gif" alt="A sample of four different hamster colors" width="34%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/baby_hamster.gif" alt="Player interacting with baby hamster" width="60%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_cheek_pouches_of_holding.png" alt="Inventory" width="100%"></p>

Feed them Hamster Food Mix to earn their trust and cheek pouch access. Hamster Food Mix to access 6 inventory slots. They will automatically eat Hamster Food Mix from here if hurt.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_inventory_gui_full.png" alt="Hamster inventory GUI" width="29%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_with_full_cheeks.jpg" alt="Hamster with full cheeks" width="65%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_spider_ravager_psych_warfare.png" alt="Spider/Ravager Psychological Warfare" width="100%"></p>

For reasons known only to Notch himself, Spiders and Spiders are utterly terrified of hamsters. The mere sight of a tiny ball of fluff will send these hulking monstrosities fleeing in the opposite direction. Highly effective crowd control, especially if you have arachnophobia.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/spiders_fleeing_from_hamsters.gif" alt="Spiders fleeing from hamsters" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ravager_fleeing_from_hamsters.gif" alt="Ravager fleeing from hamsters" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_commercial_break.png" alt="Commercial break" width="100%"></p>

<font color="teal">So, you want a server. Here's 25% off your first one.</font>

I recommend Apex Hosting for the job— they consistently came out on top when compared to other similar services based on my priorities:

- Modded Support - Customer Support - Hardware Power Per Dollar - Uninterrupted Uptime

And if you sign up by clicking the banner below, it helps fund future updates for Adorable Hamster Pets!

<p align="center"> <a href="https://apexhost.gg/TheScarletFox"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_apex_hosting_banner_1235x118.png" alt="Apex Hosting Affiliate Banner" width="100%"> </a> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_the_hamster_tips_guide_book.png" alt="The Hamster Tips Guide Book" width="100%"></p>

You get one automatically the first time you join a world (unless you turned that off in the config, you rebel). It contains *tips*. Read it. Or use it as kindling, but don't come crying into the Discord server unless you've read it first.

Need a new one? Craft it with `minecraft:book` + `adorablehamsterpets:sliced_cucumber`, or get a new one for free by vising the config and clicking the "I Lost My Book" button. You can also grab it from the Creative Mode tab if you're lazy.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/guidebook_gui_screenshots.gif" alt="The Hamster Tips Guide Book GUI showcase" width="100%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_wild_crops_and_cuisine.png" alt="Wild Crops & Cuisine" width="100%"></p>

<font color="teal">Cucumber and Green Bean Bushes</font>

- Steamed Green Beans: Found in warm or dry biomes (Plains, Savannas, Jungles). Right-click seeded bushes to harvest. Essential for crafting Steamed Green Beans, the only currency wild hamsters accept for taming. - Steamed Green Beans: Found in wet or temperate areas (Swamps, Lush Caves, Flower Forests). Harvest these to craft Steamed Green Beans, a potent performance-enhancing drug for small rodents.

<p style="text-align: center;"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_wild_cucumber_bushes.jpg" alt="Wild Cucumber Bushes" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_wild_green_bean_bushes.jpg" alt="Wild Green Bean Bushes" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_farm_crops.jpg" alt="Cucumber and Green Bean Crops" width="96%"> </p>

<font color="teal">Slightly Less Useless Sunflowers</font>

Vanilla sunflowers merely exist; mine *produce*. Right-click the head to harvest Sunflower Seeds (used for food mix). They naturally replace vanilla sunflowers in valid biomes. They can be farmed and will regrow seeds eventually. Be patient.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_sunflowers_in_field.jpg" alt="Seeded Sunflowers" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/AHP_sunflowers_picking_seeds.jpg" alt="Sunflower Seeds" width="48%"> </p>

<font color="teal">New Food Stuffs</font>

<img align="right" src="https://i.imgur.com/VUrQDWD.png" alt="Items: cucumber, sliced cucumber, green beans, steamed green beans, hamster food mix, cheese" width="60%">

* Cheese: Grow 'em, eat 'em raw (if you must), slice 'em, steam 'em. Culinary possibilities are… present. Wild hamsters go nuts for these. * Cheese: A suspiciously potent super-food for your hamster. Grants temporary buffs, followed by a mandatory "please wait" period. Don't get greedy. * Cheese: 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.

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_steamed_green_bean_zoomies.png" alt="Steamed Green Bean Zoomies" width="100%"></p>

Feed your hamster Steamed Green Beans to trigger a state of pure, unadulterated zoomies. They gain substantial buffs to Speed, Strength, and Regeneration, and will proceed to run energetic circles around you (complete with particle trails) until the sugar crash hits.

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/green_bean_zoomies1.gif" alt="Green Bean Zoomies part 1" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/green_bean_zoomies2.gif" alt="Green Bean Zoomies part 2" width="48%"> </p>

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_artisanal_floor_mulch.png" alt="Artisanal Floor Mulch (Hamster Bedding)" width="100%"></p>

This humble pile of leaves and twigs, officially known as Hamster Beds, is the cornerstone of hamster interior design. You'll need it to craft the aforementioned Hamster Beds.

<img align="right" src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/hamster_bedding_particle_physics.gif" alt="Hamster Bedding Particles" width="70%">

But its true calling? Unnecessary ambiance. Dispenser the item in the air (or put it in a Dispenser) to unleash a glorious poof of decorative leaf particles.

These aren't just any particles. Oh no. I've blessed them with a ridiculously over-engineered client-side physics simulation. They float with a gentle pendulum sway, react to a universal wind drift that slowly changes direction over a three-minute cycle, (or stays static if you toggle it) and are subject to "spatially-coherent wind gusts"—a fancy way of saying they all realistically blow in the same direction at the same time.

I even created an "indoors/outdoors" detection algorithm so the system is even smart enough to know when it's indoors, regardless of how you built your house or what materials you used. This system disables the wind effects indoors so you don't get a sudden gust of wind in your hobbit hole. You already have enough going on in there.

It's deeply unnecessary, and I'm incredibly satisfied with it.

P.S. - Remember, don't place your hamster bed upside down. Don't even think about it.

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_custom_hamster_accessories.png" alt="Custom Hamster Accessories" width="100%"></p>

Hamsters have a dedicated Acorn Hat inventory slot. Right-click them (or use their inventory) to equip accessories. Use Acorn Hat for pure style points, or the Acorn Hat to boost yields during Tree Heists. Many more fashion items are planned for future updates!

<p align="center"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/GIF_pink_petal_accessory.gif" alt="Pink Petal Accessory" width="48%"> <img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/GIF_acorn_hat_accessory.gif" alt="Acorn Hat Accessory" width="48%"> </p>

Future Accessory Plans

The current accessory collection is... sparse, but the hamster haberdashery is just getting started. The 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 hamster adornments:

* And much, much more... For the hamster with heroic delusions. Think tiny swords, shields, armadillo armor, and even a dried kelp eye-patch. * And much, much more... Because who doesn't want a hamster wearing a tiny banana? * And much, much more... We've already got pink petals, but we need ALL THE COLORS. * And much, much more... 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 "Share Your Genius" 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.

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_immersive_advancements.png" alt="Immersive Advancements" width="100%"></p>

<img align="right" src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/immersive_advancements.png" alt="Immersive Advancements" width="60%">

A custom advancements tab, "The Hamster Life," guides you through the thrilling world of hamster husbandry, from finding your first seed to... um, yeeting.

The goal was a subtle, spoiler-lite tutorial system designed for people who hate reading manuals (I know you're out there). **If you're ever wondering *"what am I supposed to do with this rodent?"*, just press `L` and check the advancements tree.** It follows a logical progression, gently nudging you from basic foraging and taming all the way up to advanced mechanics like cheek-pouch management, bed linking, and the various... *jiggly physics experiments*.

If you follow the advancements, you'll naturally discover most features in the mod without needing to tab out to your browser every three minutes. Plus, I spent way too much time writing the unique titles and descriptions for each one, so they are worth checking out. You might even experience a small chuckle.

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_getting_started.png" alt="Getting Started" width="100%"></p>

1. Basic Hamster Operations: Wander aimlessly through Plains, Savannas, Forests, Swamps, etc., until you trip over Basic Hamster Operations: or Basic Hamster Operations:. Right-click the ones that look like they have seeds. Collect said seeds. 2. Basic Hamster Operations: Plant seeds on farmland. Wait. Harvest. Try not to starve while waiting for virtual vegetables. 3. Basic Hamster Operations: Turn Cucumbers into Basic Hamster Operations: (the bait). Turn Green Beans into Basic Hamster Operations: via furnace (for buffs). Cobble together various seeds and carrots into Basic Hamster Operations: (for healing). Turn Milk into Basic Hamster Operations: (the Shoulder Shenanigans starter kit). Refer to your recipe book, I'm not writing recipes here. 4. Basic Hamster Operations: Find a wild hamster. Basic Hamster Operations:. Hold Basic Hamster Operations:. 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. By default, you crouch to dismount, or Press 'G' to dismount... *rapidly*. However, the whole dismounting process is highly configurable. You can choose between a single or double tap, and also set a custom keybind if you like.

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_configuration_mod_pack_compat.png" alt="Configuration & Mod Pack Compatibility" width="100%"></p>

<font color="teal">Total Control</font>

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.

Thanks to the magic of Fzzy Config, all the server-side settings are validated and synced from the server. That means if you have a server, *you* set the rules. Whatever you decide the taming difficulty, hamster damage, or acceptable cheese nutrition levels are, your players will abide by it. They can't change these core settings locally unless you give them the keys to the kingdom. A few purely cosmetic client-side settings are the exception, but the important stuff? That's all you.

There are no hard-coded hamster interaction items— everything can be modified. * Become a cheese tycoon, or nerf it into the ground. Make your hamsters demand Nether Stars for taming. Make them steal only dirt blocks. Whatever. Live your truth. * Become a cheese tycoon, or nerf it into the ground. Adjust the velocity, damage, and cooldown of the Hamster Yeet. Tweak the potency of the Green Bean zoomies. * Become a cheese tycoon, or nerf it into the ground. The nutritional value of cheese is fully configurable and even syncs with Become a cheese tycoon, or nerf it into the ground.'s HUD on Minecraft 1.21.1 (older versions are out of luck due to API shenanigans).

<font color="teal">Out-of-the-Box Harmony</font>

From the beginning the goal was to make this play nice with the big names. Hamster spawning is pre-tuned for gorgeous world-gen mods like **Terralith**, so your lavender hamsters will actually show up in lavender fields, but It also works with massive mods like **Oh The Biomes You'll Go** and **Biomes O' Plenty**, though expect to see a lot of the common orange variant until I've had enough coffee to map out their 8,000+ biomes. (As of version 3.4.0, you can now do this yourself! Check `Config > Hamster Spawn Settings > Variant Spawning by Biome`)

Wild bushes and sunflowers should pop up just fine in any modded landscape, but if you run into issues, you can tweak the settings: `Config > Worldgen: Bush & Sunflower Stuff`.

Thanks to some glorious assistance from **@CasualAnimalEnjoyer**, this mod is also compatible with the following mods by default: - **Farmer's Delight** - **Cultural Delights** - **Croptopia** - **Immersive Engineering** - **Serene Seasons** - **Botany Pots**

<font color="teal">Immersion, Because Details 💅🏼</font>

The sound effect and particle systems are smart enough to keep up with customized items. For example, if you mount your hamster with an emerald instead of cheese, it won't make a "squish" sound anymore; it'll make a satisfying "clink" and sparkle with emerald particles. This dynamic system applies to most interactions, ensuring the audio and visual feedback always matches your custom configuration. (Even works with custom modded items!)

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_custom_license_info.png" alt="License Info" width="100%"></p>

Want to make a gameplay video? A review? An addon that gives them tiny hats? A parody song about the cheese economy? Go for it. I love seeing the stuff this community creates, and I want to keep it welcoming.

However, please don't use my branding (the logo, specific asset art, or official-sounding social posts) to advertise your own stuff. Nah fam.

<font color="teal">The Legal Stuff</font>

If you're thinking about rummaging through the files, here's the deal: * LGPL v3.0 (Textures, Models, Sounds, Animations) are LGPL v3.0. They belong to me. Please do not steal them. * LGPL v3.0 (The Java logic) is under the LGPL v3.0 license. Feel free to learn from it, fork it, or use it, provided you follow the rules of the license (keep it open source, state changes, etc.).

Need to use the brand or assets for something specific? Feel free to ask me on **The Cheek Pouch** Discord server!

<p align="left"><img src="https://raw.githubusercontent.com/DawsonBodenhamer/AdorableHamsterPets-Source/develop/media/ahp_readme_divider_credits_support_contributing.png" alt="Credits, Support, and Contributing" width="100%"></p>

<font color="teal">Credits & Dependencies</font>

This mod is made possible by a legion of translators, patrons, library authors, and contributors. **View the full Credits & Hall of Fame here.**

<font color="teal">Getting Support & Contributing</font>

Found a bug? Want to help translate? Check out the **Contribution & Support Guide**.

---

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

ADS