The Punchy Patch

In addition to a bunch of new mini-games, idle animations and QoL features (including hamster armor trims & toggleable aggression states!), this patch introduces 5 new super cute, first-person animations to your rodent-handling experience, courtesy of the amazing Punchy mod! I've been working closely with @Dev Punchy Man to overhaul how it feels to pick up, pet, yeet, and dismount your hamsters.

👉🏼 Showcase video 👈🏼

Added

• New First-Person Animations (Optional: Requires Punchy v2.6.0+)
  • Note: The Punchy mod is not a required dependency for Adorable Hamster Pets. It is only required if you want to experience these specific new first-person animations listed below:
  • Petting/Tickling Animation (Requires Punchy v2.6.0+)
    • You can finally pet your hamster! If you stare affectionately at your hamster for a while sneaking (about 15 seconds on average), you might just reach down, pick it up and give it some tickles. Comes with a new animation where the hamster flips over on your hand and asks for a belly rub! Also added a dedicated "Pet Hamster" keybind (unbound by default) for when you don't feel like waiting for the random chance to kick in.
    • For those with the patience of a fruit bat, pressing your "Pet Hamster" key or clicking your mouse will cancel the petting animation. You don't need to be sneaking to use the keybind.
    • If the hamster was sitting before you picked it up to pet it, it will remain seated when you place it back down, making this a great way to manually re-position tamed hamsters around your base.
  • Shoulder Mounting Animations (Requires Punchy v2.6.0+)
    • Luring a hamster to your shoulder is no longer a boring teleport. You will now physically lift them up, complete with the hamster adorably bouncing on your hands or running up your arm. Three new unique animations; dynamically changing depending on their destination (left shoulder, right shoulder, head).
  • Hamster Yeet Animations (Requires Punchy v2.6.0+)
    • Holding down the throw key (G) grabs a specific hamster off your shoulder and holds it in front of your face. (For more info, see "Hamster Yeet Mechanics" below).
    • While queued up, the hamster also plays its own new animation (Requires Punchy v2.6.0+) where it eagerly wiggles its butt and kicks its back feet in anticipation of being hurled through the air.
    • Releasing the throw key (G) executes the throw, which is immediately followed by a new Punchy animation where you wave goodbye to your furry projectile.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. Your character will politely place the hamster back onto the exact shoulder it came from.
• Hamster Yeet Mechanics
  • The Yeet Queuing System
    • Throwing a hamster is no longer instant. You must hold down the throw key (G by default) to "queue" a hamster for throwing. Includes new animations if the Punchy mod is installed. (for more info, see "New First-Person Animations" above).
    • Releasing the throw key (G) executes the throw.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. This charging period of 15 ticks is not configurable, due to its duration needing to match the Punchy mod's animation. But it's quite short— only 0.75 seconds— so hopefully it won't impact gameplay.
  • Hamsters Weigh Less
    • Added a Downward Force (Gravity) slider to the config, allowing you to fine-tune how far hamsters fly without needing to increase their initial thrust.
    • Reduced the default gravitational force by ~30%, so hamsters will fly a little bit further now. (Useful for recording hamster flights with the Flashback mod, which gets buggy when entities are moving very quickly through the air).
  • FOV Zoom
    • Added a smooth FOV zoom effect while queueing the Hamster Yeet, identical to drawing a vanilla bow. This FOV zoom will help indicate the new charging period for anyone who doesn't have Punchy installed, since the new animations are part of Punchy.
  • Cooldown Recovery
    • If you're impatient, feeding your hamster will now incrementally reduce its throw cooldown (similar to how feeding accelerates baby growth).
  • More Feedback
    • A new action bar message will let you know when the hamster has recovered from its concussion and is ready for launch.
• More Flower Accessories
  • Expanded the old "Pink Petal" accessory. You can now equip any flower in the #flowers tag onto your hamster instead of just Pink Petals.
  • There are 12 unique textures. The texture assignment logic automatically scans the registry names of flowers. It uses an extensive list of color keywords and botanical families to ensure almost any flower you apply (even modded flowers) will have the correct color palette.
  • The color assignment logic is completely data-driven. You can easily force a modded flower to use a specific color palette using standard Minecraft Item Tags (e.g., adding an item to #adorablehamsterpets:flower_accessories/overlay_wither_rose).
  • For a tutorial, pop over to The Cheek Pouch Discord server, visit the FAQ channel, and search for Custom Flower Accessories.
  • Added new pages to the Hamster Tips guidebook explaining how the dynamic color assignment and tag overrides work.
• Shader LabPBR Material Support
  • All items, blocks, particles, and entities in this mod now include their own LabPBR-compliant Specular and Normal textures (with hamsters generating theirs procedurally), giving them detailed, per-layer PBR effects (emission, subsurface scattering, specular reflections, porosity, etc.) out-of-the-box with supported shaders.
  • Must have your shader's material settings set to "LabPBR" or "Hardcoded + LabPBR"
  • Metal armors have a "Vanilla-inspired" glossiness by default, but if you prefer hardcore realism and want them super metallic/reflective, I added custom sliders in the config allowing you to manually fine-tune the PBR values for each individual armor type.
  • Added a Max POM Depth slider to allow fine-tuning of the procedural 3D fur displacement (only works if your shader supports POM on entities, which is extremely rare).
• Armor Trims
  • Hamster Armor can now be customized with vanilla armor trims in the Smithing Table.
  • The following trims are currently available: Coast, Border, Vex, Eye, Sentry, Wild
  • They will naturally glow in the dark and automatically have emission with shader mods like Iris.
  • Added an Emissive Armor Trims toggle in the client config so you can disable the glowing effect if you hate fun and prefer a non-luminescent reality.
  • Added a Trim Emissive Brightness slider to give you precision control over exactly how blinding the neon lines should be.
• Configurable Aggression States
  • Hamsters now have three distinct aggression states controlled by their diet.
  • Pacifist: Sneak + right-click them any vanilla flower (e.g., #minecraft:flowers). They become total hippies and will refuse to attack anything, even if you are being actively mauled.
  • Standard: Sneak + right-click them Sunflower Seeds to factory-reset them back to their normal, wolf-like defensive behavior.
  • Menace: Sneak + right-click them a Spider Eye to unleash their inner demon. They will actively hunt down anything on the configurable "Menace Targets" list (which defaults to all monsters and bosses), and gain an expanded follow radius to give them more room to fight. If a target is outside their follow radius, they will move frantically at the edge of the tether.
  • All trigger items are fully configurable, and changing a hamster's state produces a visual and audio confirmation.
  • If you have jade installed, its overlay will display the hamster's current Aggression State when it is set to something other than the default, and can be toggled in the config alongside the other genetic displays.
  • Hamster Tips Guidebook Entry
    • The Hamster Tips guidebook now features a dedicated "Aggression States" page to explain the new mechanics. It utilizes dynamic text injection to accurately display your configured trigger items, ensuring the book is always up-to-date even if a modpack creator changes the required diets.
  • Pacifist Break: Added a Pacifist Break on Attack config toggle (false by default). When enabled, a passive hamster will automatically revert to neutral if it sees you attacking something.
• Crop Harvesting
  • Tamed, wandering hamsters now possess an irrepressible desire for the occasional midnight snack.
  • If they find a fully mature crop nearby and they have room in their cheek pouch, they will violently pounce on it, aggressively stuff the harvest into their cheek pouches, and accidentally replant some seeds in the process.
  • Includes dynamic block particles and a leaf-crunching sound effect when pouncing on the crop block.
  • Includes dynamic item particles when the hamster scoops up the dropped seeds and harvest items.
  • Added a new Crop Snacking Settings allowing you to disable the feature entirely, tweak the cooldown, or add specific crops from their menu.
  • Added a new custom #adorablehamsterpets:crop_items union tag so hamsters can recognize and eat/harvest most modded crops and vegetables out of the box.
  • Added two new "Crop Harvesting" pages to the Hamster Tips guidebook explaining the feature.
• Swimming Mechanics
  • Added a new swimming animation loop for hamsters that accidentally fall into the water. This seems to happen a lot when they are snacking on crops so I thought it was a good time to add it.
  • Replaced the Vanilla game's erratic swimming AI with a custom, smoother physics simulation that doesn't launch them out of the water every couple of seconds like a dolphin.
  • Included 7 new unique water-swishing sound effects as part of the swimming animation.
  • Hamsters can now dive underwater in persuit of items they want to steal/snack on.
  • They will still do their best to avoid water the rest of the time, but now they don't look so broken when they inevitably fall into it.
• Hide & Seek Mini-Game
  • Tamed hamsters now occasionally get the urge to disappear into the woodwork.
  • If they find a suitable hiding spot (bushes, chests, barrels, etc.), they will leap into it and vanish.
  • You have a limited time to find them (configurable, ~45-60 seconds by default) before their short attention span gets the better of them. If you try to break or interact with the block they are hiding in during that time, you win! They will pop out and reward you with an item from their cheek pouches.
  • If the timer runs out before you find them, they will emerge, sulk, and you get nothing.
  • The block they are hiding in will occasionally jiggle, make noise, and spawn particles to help you locate them.
  • You will also see a trail of subtle particles from your location directly towards the hiding spot, provided you are within 25 blocks of the hidden hamster.
  • These effects will be very scarce at the start, but dynamically increases in frequency/intensity as the game progresses.
  • Configurability: Everything is customizable in the config. You can adjust the initiation chance, duration, block lists, and whether they are allowed to hide inside storage blocks like chests.
• Storage Crates
  • Thanks to @The Retro Stitcher for helping to design new compacting storage crates for Acorns, Cucumbers, Green Beans, and Hamster Food Mix.
  • Fully compatible with LabPBR shader materials out-of-the-box.
• "Hamtaro" Easter Egg
  • Renaming a hamster "Hamtaro" gives it a special texture. This functions identically to the "Sweet Potato" easter egg. Both base textures provided by @jimcerberus!
• New "Panda" Overlay Pattern
  • Added a new "Panda" fur overlay pattern to the genetics engine, allowing you to breed panda-like hamsters. To get a "Panda" hamster, you'll need a Black base coat and a white overlay with the new "Panda" pattern. These can't be found in the wild, since black hamsters do not spawn with white overlays in the wild (breaks their camouflage). Thanks to @jimcerberus for the Panda inspiration!
• 3 New Music Discs & Hamster Dancing
  • A legendary new Cheese Music Disc featuring the Adorable Hamster Pets theme song, created by yours truly. Can only be obtained by orchestrating a high-velocity, terminal collision between an airborne hamster and a Charged Creeper.
  • Alternate Versions
    • The Parmesan Music Disc: Features an Orchestral remix of the Adorable Hamster Pets theme song. Piglins are apparently lactose aficionados. Trade a regular Cheese Music Disc with a Piglin to receive this highly adventurous, grated alternative.
    • The Blue Cheese Music Disc: Features a Low-Fi remix of the Adorable Hamster Pets theme song. Obtainable by tossing a regular Cheese Music Disc into the End exit portal after defeating the dragon. The void will age the cheese and violently spit it back out at you.
  • ⚠️ Content Creators ↓
    • All three songs are fully licensed and safe for YouTube & Twitch monetization. Feel free to feature them in your videos!
  • If playing in a Jukebox, nearby hamsters will dance to the music.
  • Tried one of the remixes but not a fan? Surround the Blue Cheese or Parmesan discs with regular Cheese in a crafting table to restore them to their original 8-Bit glory.
  • Added new advancements and guidebook pages hinting about how to obtain them.
  • Modded Music Disc Support
    • Added a Dancing Music Discs string list in the config that contains a few strings by default: hamster, hampter, and hamtaro. If a jukebox plays a music disc containing any of these configured strings in its name, description, or lore (case-insensitive), nearby hamsters will dance to it.
• Inter-Hamster Tag Mini-Game
  • Hamsters will now spontaneously instigate games of tag with each other.
  • The instigator will sprint up to an unsuspecting victim, deliver a visual (damage-free) slap (using a new cowbell sound effect), and sprint away to begin the chase.
  • If the chaser catches the instigator or if the 15-second timer runs out, the game ends and both hamsters celebrate.
  • Tethering: The instigator dynamically restricts its flee path to stay within 14 blocks of you (if tamed), ensuring they don't sprint off a cliff or into an unloaded chunk during the heat of the chase.
  • Player Interruption: Right-clicking either hamster while they are playing tag with each other will instantly break up the game and send them back to their normal routines, but will not reward you with a gift.
  • Population-Independent Rarity: The probability math dynamically adjusts based on the local hamster population. Whether you have 2 hamsters in your base or an apocalyptic horde, you will only see an average of 1 game per minute in that area.
  • Configurability: Added Enable Hamster-vs-Hamster Tag, Average Minutes Between Games, and Inter-Hamster Tag Duration settings to the config.
• New Ambient Sitting Animation
  • Added a new "sitting roll" animation where sitting hamsters occasionally roll on their backs. Comes with new sound effects, and it's configurable in the new "Ambient Sitting Behaviors" config group, which also controls cleaning frequency.
  • Includes a "Cartoon Rolling Sound" config toggle. By default, the hamster's rolling SFX will include a cartoon-ish slide whistle. It's subtle, but some people might get distracted easily or prefer more realism.
• Hamster Armor Template Duplication
  • Hamster Smithing Templates can now be duplicated on a crafting table!
  • Use 1 Template (top center), 1 corresponding material ingot/gem (center), and 7 Acorn Shards.
• Botanical Vandalism (Sapling Trimming)
  • You can now right-click any sapling with a pair of Shears to instantly turn it into a Dead Bush. This provides a much more accessible way to gather the necessary materials for crafting Hamster Bedding if you don't live near a desert.
  • Added a new page to the Hamster Tips guidebook detailing this mechanic.
• Free Bed Respawn Toggle
  • Added a config toggle to allow hamsters to respawn at their linked beds indefinitely without requiring a tribute item charge (like a Totem of Undying). Disabled by default.
• Dynamic Trees Compatibility
  • Added out-of-the-box support for Dynamic Trees via some new config settings.
  • Replaced hardcoded oak leaves checks with a new Heistable Leaves list in the config, allowing modpack makers to easily add other modded leaves or trees to the heist feature.
  • Added a new Heistable Logs list to the Tree Heist Settings config, similar to the Heistable Leaves list. This means you can now start a tree heist by throwing the hamster at a branch or the trunk.
  • Developed a dumber but more compatible canopy-mapping algorithm that activates automatically if Dynamic Trees is installed, ensuring heist still works without the vanilla leaves' internal distance from trunk property.
  • Acorn Note: The Dynamic Trees mod adds their own type of acorns and drop methods. When that mod is installed, the only way to get the specific acorns from my mod is through the Tree Heist.
• Dehydration and NutritionZ Compatibility
  • Added built-in datapacks for the Dehydration and NutritionZ mods. Cucumbers will now hydrate you, and Cheese will finally clog your arteries properly.
• Combustible Acorns
  • Acorns can now be used as furnace fuel, smelting exactly the same amount of items as a vanilla stick.
  • Alternatively, placing an Acorn in the top slot of a furnace will smelt it down into a piece of Charcoal.
• World Gen Compatibility Enhancements
  • Added massive out-of-the-box biome compatibility configuration data for Oh The Biomes We've Gone, ensuring hamster variants properly disperse across their beautiful landscapes. Huge thanks to @jlk2003r for helping configure these lists!
• Create Mod Compatibility
  • Added out-of-the-box recipe compatibility for Create: Bitterballen and Create Crafts & Additions.
  • You can now mill, crush, compact, roast, and smoke AHP Sunflower Seeds to progress through the Bitterballen tech tree seamlessly, bypassing the need to hunt down vanilla sunflowers. Thanks to @jlk2003r for teaching me about Create so I knew what recipes to add!
• Armor Tier Jumping
  • You can now upgrade Hamster Armor between any tiers using the Smithing Table (e.g., Iron to Diamond, Diamond to Netherite). Previously, all upgrades had to start from base Acorn Armor. You can also downgrade it... should you decide to do so.
• Infinite Bed Respawns
  • Added a new Tribute One-Time Use config setting. When enabled, a bed only requires the tribute item (Totem of Undying by default) once, permanently unlocking infinite respawns for that specific bed and hamster.
• Taming Feedback
  • The mod will now provide snarky chat feedback if you try to tame a hamster incorrectly (such as not sneaking or offering them the wrong food) and will point you to the guidebook for help.
• Hamster Bed Placement Safeguard
  • Unlinked hamster beds can no longer be placed in the world accidentally.
  • Attempting to do so for the first time triggers an audible warning and chat message explaining that they must be linked to a hamster first.
  • After receiving the warning, a 2-second cooldown begins. Once it expires, players are allowed to place the unlinked bed freely. The game remembers that you've been warned and won't bother you again.
  • Added config settings under 'Hamster Beds & Wander Mode' to disable the warning entirely, or to clear your history so you can experience it all over again.
  • The tooltips and guidebook entries have been updated to make the linking process ("right-click a hamster with bed in hand") much clearer.
• Global Notification Toggle
  • Added a Server Disable Announcements config setting. Server owners can now globally disable the notification bell icon for all connected players.
• Smoker Support
  • Green Beans can now be cooked into Steamed Green Beans using a Smoker, which cooks them twice as fast as a standard furnace.
• Compostable Sunflowers
  • The custom Adorable Hamster Pets Sunflower can now be placed in a composter (matching the 65% compost chance of vanilla sunflowers).
• Plantable Acorns
  • Acorns can now be planted directly on dirt/grass to grow vanilla Oak Trees. Once placed they will become Oak Saplings.

Changed

• Config GUI Major Overhaul
  • During development on v3.6.1, the mod's configuration file exceeded Minecraft's hard-coded networking limits due to a Fzzy Config NeoForge bug which I've already reported. As a work-around, the main config has been split into multiple smaller, organized configs. It needed to be done anyway, so I simultaneously re-organized everything, making it more intuitive to navigate.
• Dismount Keybinding Simplification
  • Removed the confusing config toggle that forced players to enable a custom keybind in the config before they could rebind the "Dismount Hamster" key in the Controls > Key Binds menu. The keybind is now permanently exposed.
  • The "Dismount Hamster" keybind now utilizes an unbound fallback system. By default, the keybind is set to Unbound, and the game will naturally listen to your vanilla Sneak key to dismount hamsters. However, if you manually assign a key to it in the controls menu, it will override the sneak behavior and listen exclusively to your custom key.
  • The default "Button-Press Behavior" config setting has been changed from Single Press to Double Tap to prevent accidental dismounts when sneaking near ledges. Originally it was set to single press to mimic vanilla parrot behavior, but it's just so annoying. I finally can't stand it anymore. Lol.
  • Added a Custom Key Behavior Override config toggle (true by default). When you bind a custom key for dismounting, it automatically overrides the Double Tap behavior and makes it a Single Press. I assume if you assigned a dedicated key to it, you don't want to have to tap it twice.
• Keybind Names
  • Renamed several of the key binds to make the Controls > Key Binds menu more intuitive.
• Hamster Attacking AI
  • Hamsters can no longer pathfind outside the follow radius when targeting entities. They will instead exhibit erratic behavior near the edge of the boundary.
  • This prevents repetitive teleportation back to the player when the hamster is aggressively targeting something outside the follow distance.
  • To compensate, follow distance has been increased by five blocks when the hamster is in MENACE mode.
• The Hamster Yeet
  • Throwing a hamster is no longer canceled/prevented if the player's crosshair is over non-solid blocks like tall grass, flowers, sugar cane etc.
  • Reduced the default gravity applied to thrown hamsters by 30%, resulting in naturally longer, flatter arcs out-of-the-box. Hamsters will feel less "heavy" now during throws.
  • Thrown hamsters now generate a shower of block-breaking particles upon impacting a surface.
  • Resolved an issue where players throwing their hamsters very far away wouldn't hear some of the animation-based impact sounds due to vanilla audio distance attenuation.
• Hamster Tips Guidebook
  • "The Great Escape" has been renamed to "Beds & Wander Mode," and "Acorn Armor" has been renamed to "Tree Heist & Armor" so you guys won't keep coming into my Discord server asking how the beds work and where to find acorns 😂
  • This has another super useful perk: Now whenever you search through the guidebook for a specific topic, you can search for things like "bed," "tree heist," or "armor" and those specific entries will pop up in the results.
  • Now utilizes dynamic text injection to accurately display your configured resurrection tribute items. So now if a server owner or modpack creator changes the default item from a Totem of Undying, the guidebook will update itself automatically.
• Tag Mini-Game
  • Wild hamsters can no longer initiate a game of tag to prevent interference with taming. Tamed hamsters can still play tag with strangers if enabled in the config.
  • The game will no longer randomly start while you are sneaking, preventing interference with petting.
  • You can now manually start a game of tag on-demand by rapidly sneaking and un-sneaking while maintaining eye contact with a tamed hamster.
  • Since there is now a manual trigger, the chance of the game starting is now much lower. You will need to stare at a hamster for ~15 seconds on average for the game to automatically start.
  • Starting a game of tag now plays a sound, spawns particles, and displays an action bar message to clearly indicate that it is a fun event and not a bug.
  • Hamsters will now lovingly slap you (applying knockback and brief nausea, but no damage) when the game starts.
  • Added a 1-second interaction cooldown when the game starts to prevent accidentally catching the hamster immediately.
• Genetics & Color Groups
  • Renamed the ROSE color group to CHERRY since the only hamster in that group is the "Pearl Rose" hamster, which is basically pink anyway.
  • Added a new RUST color group. The "Rust" hamster has officially been evicted from the ORANGE category, allowing it to have its own dedicated spawning rules.
• Spawning Config Overhaul
  • Reorganized the World Gen config UI to clearly separate the global "Allow/Prevent Spawns" lists from the "Region-Based Color Filters". It now clearly explains the "filter funnel" concept so you know exactly why the Plains environment acts as a catch-all.
  • Expanded the procedural spawning logic from 10 environments to 12, giving modpack makers perfect 1:1 granular control over all 12 hamster color groups.
  • The Wildcard: Added a "Priority 1: Wildcard" zone. Allows server owners to surgically extract specific biomes from broader categories and assign them unique colors without overhauling the other lists. (i.e., If you wanted to separate the environments in which Light Gray and Dark Gray hamsters spawn, now you can do so).
  • Sky Environments: Added a dedicated zone for floating island biomes to host the SKY color group. Vanilla players— no need to freak out; there's still a 15% chance to find SKY hamsters instead of WHITE in snowy areas.
  • Cherry Environments: Extracted Cherry Groves out of the Magical environments so they can be balanced independently. Defaults to 100% CHERRY hamsters.
  • Auburn Environments: Added a dedicated zone targeting Badlands (and modded autumnal forests with red trees if you like). This is the exclusive new home for RUST hamsters. (ORANGE hamsters will no longer spawn in Badlands by default).
  • Re-balanced Weights: Adjusted the default spawning weights across the Icy, Magical, and Snowy environments to accommodate the new color zones.
• ⚠ Important Config Note for Existing Worlds
  • If you are updating an existing modpack, your old config files will obstinately hold on to their old settings. This is good, otherwise you would lose all your work every time I pushed out an update. However, this means that in order to see these new default spawn weights, you will need to right-click specific settings in the config screen and select "Restore Defaults." Alternatively, click the "Changes" button (bottom-right corner) and click "Restore Defaults" to reset everything at once (only affects the config from my mod).
• Hamster Bedding Leaf Particles
  • Doubled the visual size of the Hamster Bedding particles to better match the leaves on the trees and on the hamster bed itself.
• Pink Petal Accessories
  • Added a new config toggle (true by default) to dynamically render Pink Petal accessories on the outside of equipped armor, so your hamster can be safe and fabulous simultaneously.
• Configurable 3D Visualizer Particles
  • Added a Continuous Genetics Cylinder toggle to the config. When disabled, the 3D bounding cylinder generated by /ahp spawn_all_bases_3D will only render for the first second after spawning to reduce clutter.
• Spawning & Testing Commands
  • Added /ahp undo_last_spawn. Easily discards all hamsters spawned by your very last /ahp spawn... command. Perfect for when you set up a hamster display and then accidentally run the 2-million permutation command in the wrong location.
  • Overhauled the /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD command. It is now called /ahp spawn_random_group <count>.
    • You must now provide a <count> argument. It accepts standard numbers (e.g., 500) or an all_THIS_CAN_BREAK_YOUR_WORLD string.
    • Hamsters are now spawned in a completely randomized order and placement on the grid.
    • If the requested count is 5,000 or less, the hamsters are spawned synchronously and instantly without invoking the asynchronous batch-spawning system.
  • Added five additional optional arguments to the 2D, 3D, and randomized spawn commands: [spacing_multiplier], [match_player_yaw], [randomize_sitting], [randomize_sleeping], and [randomize_yaw]. These arguments allow you to expand or shrink the physical distance between the spawned hamsters, force the entire grid of spawned hamsters to face one direction, a random direction, and/or give them static poses to keep things more visually interesting.
  • Added a new argument to the /ahp spawn_random_group command called use_wild_overlay_rules_for_breeding_overlays. Allows you to spawn a more realistic/natural looking random group of hamsters.
  • Added a new <pose> argument to the /ahp spawn hamster command, allowing you to specify sitting, sleeping, idle, or none.
  • Added personality ID's for command-spawned hamsters. The random sitting/sleeping poses are based on that ID, so they will retain those poses even after being tamed.
  • Updated the Admin Commands chapter in the Hamster Tips guidebook to include descriptions for these new commands and arguments.
• Hamster Bed Placement
  • Placing down a new hamster bed no longer forces the hamster to sleep in it immediately unless the conditions are correct (i.e., time of day, config settings).
• Wandering Hamster Sitting
  • Hamsters linked to a bed will no longer automatically sit down when their owner logs out or changes dimensions, as long as the bed is still intact.

Fixed

• Hamsters Falling Into End Portals
  • Hamsters that wander into the exit End Portal will now bounce right back out, complete with particle and sound effects.
  • Prevents them from teleporting to the Overworld spawn coordinates and getting lost.
  • Added a toggle to the config to revert to standard vanilla behavior if desired.
• Hamster Yeet & Evilcraft Bug
  • Resolved an bug that prevented hamsters from being thrown on Forge and NeoForge dedicated servers, caused by environment annotations running on the server thread. Super niche little insect that slipped by because it doesn't exist on Fabric. You should be able to throw your hamsters in multiplayer again!
  • This also resolves a server startup crash when playing with EvilCraft, which attempts to instantiate the projectile to check its blood levels. Lol.
• Food Item Stacking
  • Resolved an issue on 1.21.1 where the configurable food items became unstackable in the inventory GUI after being split or spread.
  • Implemented a stable ComponentMap caching system to ensure GUI right-click dragging correctly identifies dynamic food stacks as equal.
• Sliced Cucumber Feeding
  • Resolved a bug where already-tamed hamsters would refuse to eat their taming food (e.g. Sliced Cucumber) to heal or breed.
• Projectile Accessories
  • Fixed a visual bug where a hamster's equipped armor and accessories would temporarily vanish while they were airborne during a throw.
• Server Performance
  • Resolved a few pathfinding and AI issues where tamed hamsters following the player would sometimes experience server-tick lag spikes. Usually you wouldn't notice these unless you had a lot of hamsters following you at once.
• Wander Mode Override
  • Resolved a bug where disabling Wander Mode in the global config wouldn't stop already-wandering hamsters from lingering around their beds.
• Cheese Item Texture
  • Finally fixed the 99% transparent pixel in the bottom left corner of the cheese item texture. I only recently realized what was causing it to look so strange. Lol
• Console Log Spam
  • Resolved an issue where players with internet disabled (or those playing in regions where GitHub is blocked) would receive a massive, screen-filling error stack trace in their console every 5 minutes when the mod silently checked for updates in the background. Background network failures are now politely logged as a single warning line.
  • Resolved an issue where the genetics engine would spam the server console with warnings when attempting to generate wild overlays for hamsters with extremely bright base coats (like Coconut).
• Sweet Potato Easter Egg
  • Renaming a hamster to "Sweet Potato" now correctly applies the easter egg texture without accidentally deleting the hamster's eyes, skin layer, and accessories. So that's good.
  • Resolved an issue where the effects would trigger immediately upon renaming a hamster via the GUI, before the screen was closed.
  • Resolved an issue where the affects would not trigger at all on 1.20.1 if a hamster was renamed via the GUI.
• Missing Vanilla Tags
  • The custom AHP Sunflower block is now properly registered under the vanilla #minecraft:flowers and #minecraft:tall_flowers tags. This resolves compatibility issues with mods like Alex's Mobs that rely on these tags to identify flowers in the world.
• Flashback Mod
  • Resolved a server crash that occurred when scrubbing through replay timelines using the Flashback mod, caused by missing NBT data on Hamster Beds.
  • Resolved a persistent desync issue where shoulder hamsters would disappear when scrubbing backwards or jumping to different points on the replay timeline. Future replays will hopefully be fixed via a periodic server-side data sync that runs once per second.
• File Parsing Crashes
  • Fixed a crash that occurred when reading corrupted .json cache files for the supporter perk system. It will now safely ignore the corrupted file and download a fresh copy from the internet.
• Guidebook Server Synchronization
  • Resolved an issue where the "Missing Guidebook" chat warning would trigger repeatedly across multiple game sessions when playing on a dedicated server due to a configuration synchronization flaw.
  • Fixed an issue where players were falsely led to believe they could locally disable Guidebook Auto-Delivery on dedicated servers. These settings now properly sync from the server to the client's config UI, reflecting the server's true authority over the book's delivery.
• Food Interactions
  • Fixed a bug where players could not toggle their hamster's sitting state if they were holding Hamster Food Mix or other food items.
• "Hampter" Custom Name
  • The "Use 'Hampter' as Default Name" config setting now properly reflects on the Jade HUD overlay and the Hamster Inventory screen.
• Cheek Pouch Allowed Items
  • Fixed an issue where all vanilla food items were forbidden in the Cheek Pouch on 1.20.1 due to a typo.
• Spawn Commands
  • Resolved an issue where AI-disabled hamsters generated by /ahp spawn_all_bases_3D would sometimes suffocate and die if they spawned inside each other. They are now completely invulnerable until they are tamed/woken up.
• Cheek Pouch Desync
  • Fixed an issue where a hamster's cheek pouches would visually deflate in heavily modded environments due to partial NBT syncing from mods like Jade.
• Guidebook Recovery Routing
  • The "Missing Guidebook" chat warning now correctly opens the root configuration menu so the recovery button is actually visible.

The Punchy Patch

In addition to a bunch of new mini-games, idle animations and QoL features (including hamster armor trims & toggleable aggression states!), this patch introduces 5 new super cute, first-person animations to your rodent-handling experience, courtesy of the amazing Punchy mod! I've been working closely with @Dev Punchy Man to overhaul how it feels to pick up, pet, yeet, and dismount your hamsters.

👉🏼 Showcase video 👈🏼

Added

• New First-Person Animations (Optional: Requires Punchy v2.6.0+)
  • Note: The Punchy mod is not a required dependency for Adorable Hamster Pets. It is only required if you want to experience these specific new first-person animations listed below:
  • Petting/Tickling Animation (Requires Punchy v2.6.0+)
    • You can finally pet your hamster! If you stare affectionately at your hamster for a while sneaking (about 15 seconds on average), you might just reach down, pick it up and give it some tickles. Comes with a new animation where the hamster flips over on your hand and asks for a belly rub! Also added a dedicated "Pet Hamster" keybind (unbound by default) for when you don't feel like waiting for the random chance to kick in.
    • For those with the patience of a fruit bat, pressing your "Pet Hamster" key or clicking your mouse will cancel the petting animation. You don't need to be sneaking to use the keybind.
    • If the hamster was sitting before you picked it up to pet it, it will remain seated when you place it back down, making this a great way to manually re-position tamed hamsters around your base.
  • Shoulder Mounting Animations (Requires Punchy v2.6.0+)
    • Luring a hamster to your shoulder is no longer a boring teleport. You will now physically lift them up, complete with the hamster adorably bouncing on your hands or running up your arm. Three new unique animations; dynamically changing depending on their destination (left shoulder, right shoulder, head).
  • Hamster Yeet Animations (Requires Punchy v2.6.0+)
    • Holding down the throw key (G) grabs a specific hamster off your shoulder and holds it in front of your face. (For more info, see "Hamster Yeet Mechanics" below).
    • While queued up, the hamster also plays its own new animation (Requires Punchy v2.6.0+) where it eagerly wiggles its butt and kicks its back feet in anticipation of being hurled through the air.
    • Releasing the throw key (G) executes the throw, which is immediately followed by a new Punchy animation where you wave goodbye to your furry projectile.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. Your character will politely place the hamster back onto the exact shoulder it came from.
• Hamster Yeet Mechanics
  • The Yeet Queuing System
    • Throwing a hamster is no longer instant. You must hold down the throw key (G by default) to "queue" a hamster for throwing. Includes new animations if the Punchy mod is installed. (for more info, see "New First-Person Animations" above).
    • Releasing the throw key (G) executes the throw.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. This charging period of 15 ticks is not configurable, due to its duration needing to match the Punchy mod's animation. But it's quite short— only 0.75 seconds— so hopefully it won't impact gameplay.
  • Hamsters Weigh Less
    • Added a Downward Force (Gravity) slider to the config, allowing you to fine-tune how far hamsters fly without needing to increase their initial thrust.
    • Reduced the default gravitational force by ~30%, so hamsters will fly a little bit further now. (Useful for recording hamster flights with the Flashback mod, which gets buggy when entities are moving very quickly through the air).
  • FOV Zoom
    • Added a smooth FOV zoom effect while queueing the Hamster Yeet, identical to drawing a vanilla bow. This FOV zoom will help indicate the new charging period for anyone who doesn't have Punchy installed, since the new animations are part of Punchy.
  • Cooldown Recovery
    • If you're impatient, feeding your hamster will now incrementally reduce its throw cooldown (similar to how feeding accelerates baby growth).
  • More Feedback
    • A new action bar message will let you know when the hamster has recovered from its concussion and is ready for launch.
• More Flower Accessories
  • Expanded the old "Pink Petal" accessory. You can now equip any flower in the #flowers tag onto your hamster instead of just Pink Petals.
  • There are 12 unique textures. The texture assignment logic automatically scans the registry names of flowers. It uses an extensive list of color keywords and botanical families to ensure almost any flower you apply (even modded flowers) will have the correct color palette.
  • The color assignment logic is completely data-driven. You can easily force a modded flower to use a specific color palette using standard Minecraft Item Tags (e.g., adding an item to #adorablehamsterpets:flower_accessories/overlay_wither_rose).
  • For a tutorial, pop over to The Cheek Pouch Discord server, visit the FAQ channel, and search for Custom Flower Accessories.
  • Added new pages to the Hamster Tips guidebook explaining how the dynamic color assignment and tag overrides work.
• Shader LabPBR Material Support
  • All items, blocks, particles, and entities in this mod now include their own LabPBR-compliant Specular and Normal textures (with hamsters generating theirs procedurally), giving them detailed, per-layer PBR effects (emission, subsurface scattering, specular reflections, porosity, etc.) out-of-the-box with supported shaders.
  • Must have your shader's material settings set to "LabPBR" or "Hardcoded + LabPBR"
  • Metal armors have a "Vanilla-inspired" glossiness by default, but if you prefer hardcore realism and want them super metallic/reflective, I added custom sliders in the config allowing you to manually fine-tune the PBR values for each individual armor type.
  • Added a Max POM Depth slider to allow fine-tuning of the procedural 3D fur displacement (only works if your shader supports POM on entities, which is extremely rare).
• Armor Trims
  • Hamster Armor can now be customized with vanilla armor trims in the Smithing Table.
  • The following trims are currently available: Coast, Border, Vex, Eye, Sentry, Wild
  • They will naturally glow in the dark and automatically have emission with shader mods like Iris.
  • Added an Emissive Armor Trims toggle in the client config so you can disable the glowing effect if you hate fun and prefer a non-luminescent reality.
  • Added a Trim Emissive Brightness slider to give you precision control over exactly how blinding the neon lines should be.
• Configurable Aggression States
  • Hamsters now have three distinct aggression states controlled by their diet.
  • Pacifist: Sneak + right-click them any vanilla flower (e.g., #minecraft:flowers). They become total hippies and will refuse to attack anything, even if you are being actively mauled.
  • Standard: Sneak + right-click them Sunflower Seeds to factory-reset them back to their normal, wolf-like defensive behavior.
  • Menace: Sneak + right-click them a Spider Eye to unleash their inner demon. They will actively hunt down anything on the configurable "Menace Targets" list (which defaults to all monsters and bosses), and gain an expanded follow radius to give them more room to fight. If a target is outside their follow radius, they will move frantically at the edge of the tether.
  • All trigger items are fully configurable, and changing a hamster's state produces a visual and audio confirmation.
  • If you have jade installed, its overlay will display the hamster's current Aggression State when it is set to something other than the default, and can be toggled in the config alongside the other genetic displays.
  • Hamster Tips Guidebook Entry
    • The Hamster Tips guidebook now features a dedicated "Aggression States" page to explain the new mechanics. It utilizes dynamic text injection to accurately display your configured trigger items, ensuring the book is always up-to-date even if a modpack creator changes the required diets.
  • Pacifist Break: Added a Pacifist Break on Attack config toggle (false by default). When enabled, a passive hamster will automatically revert to neutral if it sees you attacking something.
• Crop Harvesting
  • Tamed, wandering hamsters now possess an irrepressible desire for the occasional midnight snack.
  • If they find a fully mature crop nearby and they have room in their cheek pouch, they will violently pounce on it, aggressively stuff the harvest into their cheek pouches, and accidentally replant some seeds in the process.
  • Includes dynamic block particles and a leaf-crunching sound effect when pouncing on the crop block.
  • Includes dynamic item particles when the hamster scoops up the dropped seeds and harvest items.
  • Added a new Crop Snacking Settings allowing you to disable the feature entirely, tweak the cooldown, or add specific crops from their menu.
  • Added a new custom #adorablehamsterpets:crop_items union tag so hamsters can recognize and eat/harvest most modded crops and vegetables out of the box.
  • Added two new "Crop Harvesting" pages to the Hamster Tips guidebook explaining the feature.
• Swimming Mechanics
  • Added a new swimming animation loop for hamsters that accidentally fall into the water. This seems to happen a lot when they are snacking on crops so I thought it was a good time to add it.
  • Replaced the Vanilla game's erratic swimming AI with a custom, smoother physics simulation that doesn't launch them out of the water every couple of seconds like a dolphin.
  • Included 7 new unique water-swishing sound effects as part of the swimming animation.
  • Hamsters can now dive underwater in persuit of items they want to steal/snack on.
  • They will still do their best to avoid water the rest of the time, but now they don't look so broken when they inevitably fall into it.
• Hide & Seek Mini-Game
  • Tamed hamsters now occasionally get the urge to disappear into the woodwork.
  • If they find a suitable hiding spot (bushes, chests, barrels, etc.), they will leap into it and vanish.
  • You have a limited time to find them (configurable, ~45-60 seconds by default) before their short attention span gets the better of them. If you try to break or interact with the block they are hiding in during that time, you win! They will pop out and reward you with an item from their cheek pouches.
  • If the timer runs out before you find them, they will emerge, sulk, and you get nothing.
  • The block they are hiding in will occasionally jiggle, make noise, and spawn particles to help you locate them.
  • You will also see a trail of subtle particles from your location directly towards the hiding spot, provided you are within 25 blocks of the hidden hamster.
  • These effects will be very scarce at the start, but dynamically increases in frequency/intensity as the game progresses.
  • Configurability: Everything is customizable in the config. You can adjust the initiation chance, duration, block lists, and whether they are allowed to hide inside storage blocks like chests.
• Storage Crates
  • Thanks to @The Retro Stitcher for helping to design new compacting storage crates for Acorns, Cucumbers, Green Beans, and Hamster Food Mix.
  • Fully compatible with LabPBR shader materials out-of-the-box.
• "Hamtaro" Easter Egg
  • Renaming a hamster "Hamtaro" gives it a special texture. This functions identically to the "Sweet Potato" easter egg. Both base textures provided by @jimcerberus!
• New "Panda" Overlay Pattern
  • Added a new "Panda" fur overlay pattern to the genetics engine, allowing you to breed panda-like hamsters. To get a "Panda" hamster, you'll need a Black base coat and a white overlay with the new "Panda" pattern. These can't be found in the wild, since black hamsters do not spawn with white overlays in the wild (breaks their camouflage). Thanks to @jimcerberus for the Panda inspiration!
• 3 New Music Discs & Hamster Dancing
  • A legendary new Cheese Music Disc featuring the Adorable Hamster Pets theme song, created by yours truly. Can only be obtained by orchestrating a high-velocity, terminal collision between an airborne hamster and a Charged Creeper.
  • Alternate Versions
    • The Parmesan Music Disc: Features an Orchestral remix of the Adorable Hamster Pets theme song. Piglins are apparently lactose aficionados. Trade a regular Cheese Music Disc with a Piglin to receive this highly adventurous, grated alternative.
    • The Blue Cheese Music Disc: Features a Low-Fi remix of the Adorable Hamster Pets theme song. Obtainable by tossing a regular Cheese Music Disc into the End exit portal after defeating the dragon. The void will age the cheese and violently spit it back out at you.
  • ⚠️ Content Creators ↓
    • All three songs are fully licensed and safe for YouTube & Twitch monetization. Feel free to feature them in your videos!
  • If playing in a Jukebox, nearby hamsters will dance to the music.
  • Tried one of the remixes but not a fan? Surround the Blue Cheese or Parmesan discs with regular Cheese in a crafting table to restore them to their original 8-Bit glory.
  • Added new advancements and guidebook pages hinting about how to obtain them.
  • Modded Music Disc Support
    • Added a Dancing Music Discs string list in the config that contains a few strings by default: hamster, hampter, and hamtaro. If a jukebox plays a music disc containing any of these configured strings in its name, description, or lore (case-insensitive), nearby hamsters will dance to it.
• Inter-Hamster Tag Mini-Game
  • Hamsters will now spontaneously instigate games of tag with each other.
  • The instigator will sprint up to an unsuspecting victim, deliver a visual (damage-free) slap (using a new cowbell sound effect), and sprint away to begin the chase.
  • If the chaser catches the instigator or if the 15-second timer runs out, the game ends and both hamsters celebrate.
  • Tethering: The instigator dynamically restricts its flee path to stay within 14 blocks of you (if tamed), ensuring they don't sprint off a cliff or into an unloaded chunk during the heat of the chase.
  • Player Interruption: Right-clicking either hamster while they are playing tag with each other will instantly break up the game and send them back to their normal routines, but will not reward you with a gift.
  • Population-Independent Rarity: The probability math dynamically adjusts based on the local hamster population. Whether you have 2 hamsters in your base or an apocalyptic horde, you will only see an average of 1 game per minute in that area.
  • Configurability: Added Enable Hamster-vs-Hamster Tag, Average Minutes Between Games, and Inter-Hamster Tag Duration settings to the config.
• New Ambient Sitting Animation
  • Added a new "sitting roll" animation where sitting hamsters occasionally roll on their backs. Comes with new sound effects, and it's configurable in the new "Ambient Sitting Behaviors" config group, which also controls cleaning frequency.
  • Includes a "Cartoon Rolling Sound" config toggle. By default, the hamster's rolling SFX will include a cartoon-ish slide whistle. It's subtle, but some people might get distracted easily or prefer more realism.
• Hamster Armor Template Duplication
  • Hamster Smithing Templates can now be duplicated on a crafting table!
  • Use 1 Template (top center), 1 corresponding material ingot/gem (center), and 7 Acorn Shards.
• Botanical Vandalism (Sapling Trimming)
  • You can now right-click any sapling with a pair of Shears to instantly turn it into a Dead Bush. This provides a much more accessible way to gather the necessary materials for crafting Hamster Bedding if you don't live near a desert.
  • Added a new page to the Hamster Tips guidebook detailing this mechanic.
• Free Bed Respawn Toggle
  • Added a config toggle to allow hamsters to respawn at their linked beds indefinitely without requiring a tribute item charge (like a Totem of Undying). Disabled by default.
• Dynamic Trees Compatibility
  • Added out-of-the-box support for Dynamic Trees via some new config settings.
  • Replaced hardcoded oak leaves checks with a new Heistable Leaves list in the config, allowing modpack makers to easily add other modded leaves or trees to the heist feature.
  • Added a new Heistable Logs list to the Tree Heist Settings config, similar to the Heistable Leaves list. This means you can now start a tree heist by throwing the hamster at a branch or the trunk.
  • Developed a dumber but more compatible canopy-mapping algorithm that activates automatically if Dynamic Trees is installed, ensuring heist still works without the vanilla leaves' internal distance from trunk property.
  • Acorn Note: The Dynamic Trees mod adds their own type of acorns and drop methods. When that mod is installed, the only way to get the specific acorns from my mod is through the Tree Heist.
• Dehydration and NutritionZ Compatibility
  • Added built-in datapacks for the Dehydration and NutritionZ mods. Cucumbers will now hydrate you, and Cheese will finally clog your arteries properly.
• Combustible Acorns
  • Acorns can now be used as furnace fuel, smelting exactly the same amount of items as a vanilla stick.
  • Alternatively, placing an Acorn in the top slot of a furnace will smelt it down into a piece of Charcoal.
• World Gen Compatibility Enhancements
  • Added massive out-of-the-box biome compatibility configuration data for Oh The Biomes We've Gone, ensuring hamster variants properly disperse across their beautiful landscapes. Huge thanks to @jlk2003r for helping configure these lists!
• Create Mod Compatibility
  • Added out-of-the-box recipe compatibility for Create: Bitterballen and Create Crafts & Additions.
  • You can now mill, crush, compact, roast, and smoke AHP Sunflower Seeds to progress through the Bitterballen tech tree seamlessly, bypassing the need to hunt down vanilla sunflowers. Thanks to @jlk2003r for teaching me about Create so I knew what recipes to add!
• Armor Tier Jumping
  • You can now upgrade Hamster Armor between any tiers using the Smithing Table (e.g., Iron to Diamond, Diamond to Netherite). Previously, all upgrades had to start from base Acorn Armor. You can also downgrade it... should you decide to do so.
• Infinite Bed Respawns
  • Added a new Tribute One-Time Use config setting. When enabled, a bed only requires the tribute item (Totem of Undying by default) once, permanently unlocking infinite respawns for that specific bed and hamster.
• Taming Feedback
  • The mod will now provide snarky chat feedback if you try to tame a hamster incorrectly (such as not sneaking or offering them the wrong food) and will point you to the guidebook for help.
• Hamster Bed Placement Safeguard
  • Unlinked hamster beds can no longer be placed in the world accidentally.
  • Attempting to do so for the first time triggers an audible warning and chat message explaining that they must be linked to a hamster first.
  • After receiving the warning, a 2-second cooldown begins. Once it expires, players are allowed to place the unlinked bed freely. The game remembers that you've been warned and won't bother you again.
  • Added config settings under 'Hamster Beds & Wander Mode' to disable the warning entirely, or to clear your history so you can experience it all over again.
  • The tooltips and guidebook entries have been updated to make the linking process ("right-click a hamster with bed in hand") much clearer.
• Global Notification Toggle
  • Added a Server Disable Announcements config setting. Server owners can now globally disable the notification bell icon for all connected players.
• Smoker Support
  • Green Beans can now be cooked into Steamed Green Beans using a Smoker, which cooks them twice as fast as a standard furnace.
• Compostable Sunflowers
  • The custom Adorable Hamster Pets Sunflower can now be placed in a composter (matching the 65% compost chance of vanilla sunflowers).
• Plantable Acorns
  • Acorns can now be planted directly on dirt/grass to grow vanilla Oak Trees. Once placed they will become Oak Saplings.

Changed

• Config GUI Major Overhaul
  • During development on v3.6.1, the mod's configuration file exceeded Minecraft's hard-coded networking limits due to a Fzzy Config NeoForge bug which I've already reported. As a work-around, the main config has been split into multiple smaller, organized configs. It needed to be done anyway, so I simultaneously re-organized everything, making it more intuitive to navigate.
• Dismount Keybinding Simplification
  • Removed the confusing config toggle that forced players to enable a custom keybind in the config before they could rebind the "Dismount Hamster" key in the Controls > Key Binds menu. The keybind is now permanently exposed.
  • The "Dismount Hamster" keybind now utilizes an unbound fallback system. By default, the keybind is set to Unbound, and the game will naturally listen to your vanilla Sneak key to dismount hamsters. However, if you manually assign a key to it in the controls menu, it will override the sneak behavior and listen exclusively to your custom key.
  • The default "Button-Press Behavior" config setting has been changed from Single Press to Double Tap to prevent accidental dismounts when sneaking near ledges. Originally it was set to single press to mimic vanilla parrot behavior, but it's just so annoying. I finally can't stand it anymore. Lol.
  • Added a Custom Key Behavior Override config toggle (true by default). When you bind a custom key for dismounting, it automatically overrides the Double Tap behavior and makes it a Single Press. I assume if you assigned a dedicated key to it, you don't want to have to tap it twice.
• Keybind Names
  • Renamed several of the key binds to make the Controls > Key Binds menu more intuitive.
• Hamster Attacking AI
  • Hamsters can no longer pathfind outside the follow radius when targeting entities. They will instead exhibit erratic behavior near the edge of the boundary.
  • This prevents repetitive teleportation back to the player when the hamster is aggressively targeting something outside the follow distance.
  • To compensate, follow distance has been increased by five blocks when the hamster is in MENACE mode.
• The Hamster Yeet
  • Throwing a hamster is no longer canceled/prevented if the player's crosshair is over non-solid blocks like tall grass, flowers, sugar cane etc.
  • Reduced the default gravity applied to thrown hamsters by 30%, resulting in naturally longer, flatter arcs out-of-the-box. Hamsters will feel less "heavy" now during throws.
  • Thrown hamsters now generate a shower of block-breaking particles upon impacting a surface.
  • Resolved an issue where players throwing their hamsters very far away wouldn't hear some of the animation-based impact sounds due to vanilla audio distance attenuation.
• Hamster Tips Guidebook
  • "The Great Escape" has been renamed to "Beds & Wander Mode," and "Acorn Armor" has been renamed to "Tree Heist & Armor" so you guys won't keep coming into my Discord server asking how the beds work and where to find acorns 😂
  • This has another super useful perk: Now whenever you search through the guidebook for a specific topic, you can search for things like "bed," "tree heist," or "armor" and those specific entries will pop up in the results.
  • Now utilizes dynamic text injection to accurately display your configured resurrection tribute items. So now if a server owner or modpack creator changes the default item from a Totem of Undying, the guidebook will update itself automatically.
• Tag Mini-Game
  • Wild hamsters can no longer initiate a game of tag to prevent interference with taming. Tamed hamsters can still play tag with strangers if enabled in the config.
  • The game will no longer randomly start while you are sneaking, preventing interference with petting.
  • You can now manually start a game of tag on-demand by rapidly sneaking and un-sneaking while maintaining eye contact with a tamed hamster.
  • Since there is now a manual trigger, the chance of the game starting is now much lower. You will need to stare at a hamster for ~15 seconds on average for the game to automatically start.
  • Starting a game of tag now plays a sound, spawns particles, and displays an action bar message to clearly indicate that it is a fun event and not a bug.
  • Hamsters will now lovingly slap you (applying knockback and brief nausea, but no damage) when the game starts.
  • Added a 1-second interaction cooldown when the game starts to prevent accidentally catching the hamster immediately.
• Genetics & Color Groups
  • Renamed the ROSE color group to CHERRY since the only hamster in that group is the "Pearl Rose" hamster, which is basically pink anyway.
  • Added a new RUST color group. The "Rust" hamster has officially been evicted from the ORANGE category, allowing it to have its own dedicated spawning rules.
• Spawning Config Overhaul
  • Reorganized the World Gen config UI to clearly separate the global "Allow/Prevent Spawns" lists from the "Region-Based Color Filters". It now clearly explains the "filter funnel" concept so you know exactly why the Plains environment acts as a catch-all.
  • Expanded the procedural spawning logic from 10 environments to 12, giving modpack makers perfect 1:1 granular control over all 12 hamster color groups.
  • The Wildcard: Added a "Priority 1: Wildcard" zone. Allows server owners to surgically extract specific biomes from broader categories and assign them unique colors without overhauling the other lists. (i.e., If you wanted to separate the environments in which Light Gray and Dark Gray hamsters spawn, now you can do so).
  • Sky Environments: Added a dedicated zone for floating island biomes to host the SKY color group. Vanilla players— no need to freak out; there's still a 15% chance to find SKY hamsters instead of WHITE in snowy areas.
  • Cherry Environments: Extracted Cherry Groves out of the Magical environments so they can be balanced independently. Defaults to 100% CHERRY hamsters.
  • Auburn Environments: Added a dedicated zone targeting Badlands (and modded autumnal forests with red trees if you like). This is the exclusive new home for RUST hamsters. (ORANGE hamsters will no longer spawn in Badlands by default).
  • Re-balanced Weights: Adjusted the default spawning weights across the Icy, Magical, and Snowy environments to accommodate the new color zones.
• ⚠ Important Config Note for Existing Worlds
  • If you are updating an existing modpack, your old config files will obstinately hold on to their old settings. This is good, otherwise you would lose all your work every time I pushed out an update. However, this means that in order to see these new default spawn weights, you will need to right-click specific settings in the config screen and select "Restore Defaults." Alternatively, click the "Changes" button (bottom-right corner) and click "Restore Defaults" to reset everything at once (only affects the config from my mod).
• Hamster Bedding Leaf Particles
  • Doubled the visual size of the Hamster Bedding particles to better match the leaves on the trees and on the hamster bed itself.
• Pink Petal Accessories
  • Added a new config toggle (true by default) to dynamically render Pink Petal accessories on the outside of equipped armor, so your hamster can be safe and fabulous simultaneously.
• Configurable 3D Visualizer Particles
  • Added a Continuous Genetics Cylinder toggle to the config. When disabled, the 3D bounding cylinder generated by /ahp spawn_all_bases_3D will only render for the first second after spawning to reduce clutter.
• Spawning & Testing Commands
  • Added /ahp undo_last_spawn. Easily discards all hamsters spawned by your very last /ahp spawn... command. Perfect for when you set up a hamster display and then accidentally run the 2-million permutation command in the wrong location.
  • Overhauled the /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD command. It is now called /ahp spawn_random_group <count>.
    • You must now provide a <count> argument. It accepts standard numbers (e.g., 500) or an all_THIS_CAN_BREAK_YOUR_WORLD string.
    • Hamsters are now spawned in a completely randomized order and placement on the grid.
    • If the requested count is 5,000 or less, the hamsters are spawned synchronously and instantly without invoking the asynchronous batch-spawning system.
  • Added five additional optional arguments to the 2D, 3D, and randomized spawn commands: [spacing_multiplier], [match_player_yaw], [randomize_sitting], [randomize_sleeping], and [randomize_yaw]. These arguments allow you to expand or shrink the physical distance between the spawned hamsters, force the entire grid of spawned hamsters to face one direction, a random direction, and/or give them static poses to keep things more visually interesting.
  • Added a new argument to the /ahp spawn_random_group command called use_wild_overlay_rules_for_breeding_overlays. Allows you to spawn a more realistic/natural looking random group of hamsters.
  • Added a new <pose> argument to the /ahp spawn hamster command, allowing you to specify sitting, sleeping, idle, or none.
  • Added personality ID's for command-spawned hamsters. The random sitting/sleeping poses are based on that ID, so they will retain those poses even after being tamed.
  • Updated the Admin Commands chapter in the Hamster Tips guidebook to include descriptions for these new commands and arguments.
• Hamster Bed Placement
  • Placing down a new hamster bed no longer forces the hamster to sleep in it immediately unless the conditions are correct (i.e., time of day, config settings).
• Wandering Hamster Sitting
  • Hamsters linked to a bed will no longer automatically sit down when their owner logs out or changes dimensions, as long as the bed is still intact.

Fixed

• Hamsters Falling Into End Portals
  • Hamsters that wander into the exit End Portal will now bounce right back out, complete with particle and sound effects.
  • Prevents them from teleporting to the Overworld spawn coordinates and getting lost.
  • Added a toggle to the config to revert to standard vanilla behavior if desired.
• Hamster Yeet & Evilcraft Bug
  • Resolved an bug that prevented hamsters from being thrown on Forge and NeoForge dedicated servers, caused by environment annotations running on the server thread. Super niche little insect that slipped by because it doesn't exist on Fabric. You should be able to throw your hamsters in multiplayer again!
  • This also resolves a server startup crash when playing with EvilCraft, which attempts to instantiate the projectile to check its blood levels. Lol.
• Food Item Stacking
  • Resolved an issue on 1.21.1 where the configurable food items became unstackable in the inventory GUI after being split or spread.
  • Implemented a stable ComponentMap caching system to ensure GUI right-click dragging correctly identifies dynamic food stacks as equal.
• Sliced Cucumber Feeding
  • Resolved a bug where already-tamed hamsters would refuse to eat their taming food (e.g. Sliced Cucumber) to heal or breed.
• Projectile Accessories
  • Fixed a visual bug where a hamster's equipped armor and accessories would temporarily vanish while they were airborne during a throw.
• Server Performance
  • Resolved a few pathfinding and AI issues where tamed hamsters following the player would sometimes experience server-tick lag spikes. Usually you wouldn't notice these unless you had a lot of hamsters following you at once.
• Wander Mode Override
  • Resolved a bug where disabling Wander Mode in the global config wouldn't stop already-wandering hamsters from lingering around their beds.
• Cheese Item Texture
  • Finally fixed the 99% transparent pixel in the bottom left corner of the cheese item texture. I only recently realized what was causing it to look so strange. Lol
• Console Log Spam
  • Resolved an issue where players with internet disabled (or those playing in regions where GitHub is blocked) would receive a massive, screen-filling error stack trace in their console every 5 minutes when the mod silently checked for updates in the background. Background network failures are now politely logged as a single warning line.
  • Resolved an issue where the genetics engine would spam the server console with warnings when attempting to generate wild overlays for hamsters with extremely bright base coats (like Coconut).
• Sweet Potato Easter Egg
  • Renaming a hamster to "Sweet Potato" now correctly applies the easter egg texture without accidentally deleting the hamster's eyes, skin layer, and accessories. So that's good.
  • Resolved an issue where the effects would trigger immediately upon renaming a hamster via the GUI, before the screen was closed.
  • Resolved an issue where the affects would not trigger at all on 1.20.1 if a hamster was renamed via the GUI.
• Missing Vanilla Tags
  • The custom AHP Sunflower block is now properly registered under the vanilla #minecraft:flowers and #minecraft:tall_flowers tags. This resolves compatibility issues with mods like Alex's Mobs that rely on these tags to identify flowers in the world.
• Flashback Mod
  • Resolved a server crash that occurred when scrubbing through replay timelines using the Flashback mod, caused by missing NBT data on Hamster Beds.
  • Resolved a persistent desync issue where shoulder hamsters would disappear when scrubbing backwards or jumping to different points on the replay timeline. Future replays will hopefully be fixed via a periodic server-side data sync that runs once per second.
• File Parsing Crashes
  • Fixed a crash that occurred when reading corrupted .json cache files for the supporter perk system. It will now safely ignore the corrupted file and download a fresh copy from the internet.
• Guidebook Server Synchronization
  • Resolved an issue where the "Missing Guidebook" chat warning would trigger repeatedly across multiple game sessions when playing on a dedicated server due to a configuration synchronization flaw.
  • Fixed an issue where players were falsely led to believe they could locally disable Guidebook Auto-Delivery on dedicated servers. These settings now properly sync from the server to the client's config UI, reflecting the server's true authority over the book's delivery.
• Food Interactions
  • Fixed a bug where players could not toggle their hamster's sitting state if they were holding Hamster Food Mix or other food items.
• "Hampter" Custom Name
  • The "Use 'Hampter' as Default Name" config setting now properly reflects on the Jade HUD overlay and the Hamster Inventory screen.
• Cheek Pouch Allowed Items
  • Fixed an issue where all vanilla food items were forbidden in the Cheek Pouch on 1.20.1 due to a typo.
• Spawn Commands
  • Resolved an issue where AI-disabled hamsters generated by /ahp spawn_all_bases_3D would sometimes suffocate and die if they spawned inside each other. They are now completely invulnerable until they are tamed/woken up.
• Cheek Pouch Desync
  • Fixed an issue where a hamster's cheek pouches would visually deflate in heavily modded environments due to partial NBT syncing from mods like Jade.
• Guidebook Recovery Routing
  • The "Missing Guidebook" chat warning now correctly opens the root configuration menu so the recovery button is actually visible.

The Punchy Patch

In addition to a bunch of new mini-games, idle animations and QoL features (including hamster armor trims & toggleable aggression states!), this patch introduces 5 new super cute, first-person animations to your rodent-handling experience, courtesy of the amazing Punchy mod! I've been working closely with @Dev Punchy Man to overhaul how it feels to pick up, pet, yeet, and dismount your hamsters.

👉🏼 Showcase video 👈🏼

Added

• New First-Person Animations (Optional: Requires Punchy v2.6.0+)
  • Note: The Punchy mod is not a required dependency for Adorable Hamster Pets. It is only required if you want to experience these specific new first-person animations listed below:
  • Petting/Tickling Animation (Requires Punchy v2.6.0+)
    • You can finally pet your hamster! If you stare affectionately at your hamster for a while sneaking (about 15 seconds on average), you might just reach down, pick it up and give it some tickles. Comes with a new animation where the hamster flips over on your hand and asks for a belly rub! Also added a dedicated "Pet Hamster" keybind (unbound by default) for when you don't feel like waiting for the random chance to kick in.
    • For those with the patience of a fruit bat, pressing your "Pet Hamster" key or clicking your mouse will cancel the petting animation. You don't need to be sneaking to use the keybind.
    • If the hamster was sitting before you picked it up to pet it, it will remain seated when you place it back down, making this a great way to manually re-position tamed hamsters around your base.
  • Shoulder Mounting Animations (Requires Punchy v2.6.0+)
    • Luring a hamster to your shoulder is no longer a boring teleport. You will now physically lift them up, complete with the hamster adorably bouncing on your hands or running up your arm. Three new unique animations; dynamically changing depending on their destination (left shoulder, right shoulder, head).
  • Hamster Yeet Animations (Requires Punchy v2.6.0+)
    • Holding down the throw key (G) grabs a specific hamster off your shoulder and holds it in front of your face. (For more info, see "Hamster Yeet Mechanics" below).
    • While queued up, the hamster also plays its own new animation (Requires Punchy v2.6.0+) where it eagerly wiggles its butt and kicks its back feet in anticipation of being hurled through the air.
    • Releasing the throw key (G) executes the throw, which is immediately followed by a new Punchy animation where you wave goodbye to your furry projectile.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. Your character will politely place the hamster back onto the exact shoulder it came from.
• Hamster Yeet Mechanics
  • The Yeet Queuing System
    • Throwing a hamster is no longer instant. You must hold down the throw key (G by default) to "queue" a hamster for throwing. Includes new animations if the Punchy mod is installed. (for more info, see "New First-Person Animations" above).
    • Releasing the throw key (G) executes the throw.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. This charging period of 15 ticks is not configurable, due to its duration needing to match the Punchy mod's animation. But it's quite short— only 0.75 seconds— so hopefully it won't impact gameplay.
  • Hamsters Weigh Less
    • Added a Downward Force (Gravity) slider to the config, allowing you to fine-tune how far hamsters fly without needing to increase their initial thrust.
    • Reduced the default gravitational force by ~30%, so hamsters will fly a little bit further now. (Useful for recording hamster flights with the Flashback mod, which gets buggy when entities are moving very quickly through the air).
  • FOV Zoom
    • Added a smooth FOV zoom effect while queueing the Hamster Yeet, identical to drawing a vanilla bow. This FOV zoom will help indicate the new charging period for anyone who doesn't have Punchy installed, since the new animations are part of Punchy.
  • Cooldown Recovery
    • If you're impatient, feeding your hamster will now incrementally reduce its throw cooldown (similar to how feeding accelerates baby growth).
  • More Feedback
    • A new action bar message will let you know when the hamster has recovered from its concussion and is ready for launch.
• More Flower Accessories
  • Expanded the old "Pink Petal" accessory. You can now equip any flower in the #flowers tag onto your hamster instead of just Pink Petals.
  • There are 12 unique textures. The texture assignment logic automatically scans the registry names of flowers. It uses an extensive list of color keywords and botanical families to ensure almost any flower you apply (even modded flowers) will have the correct color palette.
  • The color assignment logic is completely data-driven. You can easily force a modded flower to use a specific color palette using standard Minecraft Item Tags (e.g., adding an item to #adorablehamsterpets:flower_accessories/overlay_wither_rose).
  • For a tutorial, pop over to The Cheek Pouch Discord server, visit the FAQ channel, and search for Custom Flower Accessories.
  • Added new pages to the Hamster Tips guidebook explaining how the dynamic color assignment and tag overrides work.
• Shader LabPBR Material Support
  • All items, blocks, particles, and entities in this mod now include their own LabPBR-compliant Specular and Normal textures (with hamsters generating theirs procedurally), giving them detailed, per-layer PBR effects (emission, subsurface scattering, specular reflections, porosity, etc.) out-of-the-box with supported shaders.
  • Must have your shader's material settings set to "LabPBR" or "Hardcoded + LabPBR"
  • Metal armors have a "Vanilla-inspired" glossiness by default, but if you prefer hardcore realism and want them super metallic/reflective, I added custom sliders in the config allowing you to manually fine-tune the PBR values for each individual armor type.
  • Added a Max POM Depth slider to allow fine-tuning of the procedural 3D fur displacement (only works if your shader supports POM on entities, which is extremely rare).
• Armor Trims
  • Hamster Armor can now be customized with vanilla armor trims in the Smithing Table.
  • The following trims are currently available: Coast, Border, Vex, Eye, Sentry, Wild
  • They will naturally glow in the dark and automatically have emission with shader mods like Iris.
  • Added an Emissive Armor Trims toggle in the client config so you can disable the glowing effect if you hate fun and prefer a non-luminescent reality.
  • Added a Trim Emissive Brightness slider to give you precision control over exactly how blinding the neon lines should be.
• Configurable Aggression States
  • Hamsters now have three distinct aggression states controlled by their diet.
  • Pacifist: Sneak + right-click them any vanilla flower (e.g., #minecraft:flowers). They become total hippies and will refuse to attack anything, even if you are being actively mauled.
  • Standard: Sneak + right-click them Sunflower Seeds to factory-reset them back to their normal, wolf-like defensive behavior.
  • Menace: Sneak + right-click them a Spider Eye to unleash their inner demon. They will actively hunt down anything on the configurable "Menace Targets" list (which defaults to all monsters and bosses), and gain an expanded follow radius to give them more room to fight. If a target is outside their follow radius, they will move frantically at the edge of the tether.
  • All trigger items are fully configurable, and changing a hamster's state produces a visual and audio confirmation.
  • If you have jade installed, its overlay will display the hamster's current Aggression State when it is set to something other than the default, and can be toggled in the config alongside the other genetic displays.
  • Hamster Tips Guidebook Entry
    • The Hamster Tips guidebook now features a dedicated "Aggression States" page to explain the new mechanics. It utilizes dynamic text injection to accurately display your configured trigger items, ensuring the book is always up-to-date even if a modpack creator changes the required diets.
  • Pacifist Break: Added a Pacifist Break on Attack config toggle (false by default). When enabled, a passive hamster will automatically revert to neutral if it sees you attacking something.
• Crop Harvesting
  • Tamed, wandering hamsters now possess an irrepressible desire for the occasional midnight snack.
  • If they find a fully mature crop nearby and they have room in their cheek pouch, they will violently pounce on it, aggressively stuff the harvest into their cheek pouches, and accidentally replant some seeds in the process.
  • Includes dynamic block particles and a leaf-crunching sound effect when pouncing on the crop block.
  • Includes dynamic item particles when the hamster scoops up the dropped seeds and harvest items.
  • Added a new Crop Snacking Settings allowing you to disable the feature entirely, tweak the cooldown, or add specific crops from their menu.
  • Added a new custom #adorablehamsterpets:crop_items union tag so hamsters can recognize and eat/harvest most modded crops and vegetables out of the box.
  • Added two new "Crop Harvesting" pages to the Hamster Tips guidebook explaining the feature.
• Swimming Mechanics
  • Added a new swimming animation loop for hamsters that accidentally fall into the water. This seems to happen a lot when they are snacking on crops so I thought it was a good time to add it.
  • Replaced the Vanilla game's erratic swimming AI with a custom, smoother physics simulation that doesn't launch them out of the water every couple of seconds like a dolphin.
  • Included 7 new unique water-swishing sound effects as part of the swimming animation.
  • Hamsters can now dive underwater in persuit of items they want to steal/snack on.
  • They will still do their best to avoid water the rest of the time, but now they don't look so broken when they inevitably fall into it.
• Hide & Seek Mini-Game
  • Tamed hamsters now occasionally get the urge to disappear into the woodwork.
  • If they find a suitable hiding spot (bushes, chests, barrels, etc.), they will leap into it and vanish.
  • You have a limited time to find them (configurable, ~45-60 seconds by default) before their short attention span gets the better of them. If you try to break or interact with the block they are hiding in during that time, you win! They will pop out and reward you with an item from their cheek pouches.
  • If the timer runs out before you find them, they will emerge, sulk, and you get nothing.
  • The block they are hiding in will occasionally jiggle, make noise, and spawn particles to help you locate them.
  • You will also see a trail of subtle particles from your location directly towards the hiding spot, provided you are within 25 blocks of the hidden hamster.
  • These effects will be very scarce at the start, but dynamically increases in frequency/intensity as the game progresses.
  • Configurability: Everything is customizable in the config. You can adjust the initiation chance, duration, block lists, and whether they are allowed to hide inside storage blocks like chests.
• Storage Crates
  • Thanks to @The Retro Stitcher for helping to design new compacting storage crates for Acorns, Cucumbers, Green Beans, and Hamster Food Mix.
  • Fully compatible with LabPBR shader materials out-of-the-box.
• "Hamtaro" Easter Egg
  • Renaming a hamster "Hamtaro" gives it a special texture. This functions identically to the "Sweet Potato" easter egg. Both base textures provided by @jimcerberus!
• New "Panda" Overlay Pattern
  • Added a new "Panda" fur overlay pattern to the genetics engine, allowing you to breed panda-like hamsters. To get a "Panda" hamster, you'll need a Black base coat and a white overlay with the new "Panda" pattern. These can't be found in the wild, since black hamsters do not spawn with white overlays in the wild (breaks their camouflage). Thanks to @jimcerberus for the Panda inspiration!
• 3 New Music Discs & Hamster Dancing
  • A legendary new Cheese Music Disc featuring the Adorable Hamster Pets theme song, created by yours truly. Can only be obtained by orchestrating a high-velocity, terminal collision between an airborne hamster and a Charged Creeper.
  • Alternate Versions
    • The Parmesan Music Disc: Features an Orchestral remix of the Adorable Hamster Pets theme song. Piglins are apparently lactose aficionados. Trade a regular Cheese Music Disc with a Piglin to receive this highly adventurous, grated alternative.
    • The Blue Cheese Music Disc: Features a Low-Fi remix of the Adorable Hamster Pets theme song. Obtainable by tossing a regular Cheese Music Disc into the End exit portal after defeating the dragon. The void will age the cheese and violently spit it back out at you.
  • ⚠️ Content Creators ↓
    • All three songs are fully licensed and safe for YouTube & Twitch monetization. Feel free to feature them in your videos!
  • If playing in a Jukebox, nearby hamsters will dance to the music.
  • Tried one of the remixes but not a fan? Surround the Blue Cheese or Parmesan discs with regular Cheese in a crafting table to restore them to their original 8-Bit glory.
  • Added new advancements and guidebook pages hinting about how to obtain them.
  • Modded Music Disc Support
    • Added a Dancing Music Discs string list in the config that contains a few strings by default: hamster, hampter, and hamtaro. If a jukebox plays a music disc containing any of these configured strings in its name, description, or lore (case-insensitive), nearby hamsters will dance to it.
• Inter-Hamster Tag Mini-Game
  • Hamsters will now spontaneously instigate games of tag with each other.
  • The instigator will sprint up to an unsuspecting victim, deliver a visual (damage-free) slap (using a new cowbell sound effect), and sprint away to begin the chase.
  • If the chaser catches the instigator or if the 15-second timer runs out, the game ends and both hamsters celebrate.
  • Tethering: The instigator dynamically restricts its flee path to stay within 14 blocks of you (if tamed), ensuring they don't sprint off a cliff or into an unloaded chunk during the heat of the chase.
  • Player Interruption: Right-clicking either hamster while they are playing tag with each other will instantly break up the game and send them back to their normal routines, but will not reward you with a gift.
  • Population-Independent Rarity: The probability math dynamically adjusts based on the local hamster population. Whether you have 2 hamsters in your base or an apocalyptic horde, you will only see an average of 1 game per minute in that area.
  • Configurability: Added Enable Hamster-vs-Hamster Tag, Average Minutes Between Games, and Inter-Hamster Tag Duration settings to the config.
• New Ambient Sitting Animation
  • Added a new "sitting roll" animation where sitting hamsters occasionally roll on their backs. Comes with new sound effects, and it's configurable in the new "Ambient Sitting Behaviors" config group, which also controls cleaning frequency.
  • Includes a "Cartoon Rolling Sound" config toggle. By default, the hamster's rolling SFX will include a cartoon-ish slide whistle. It's subtle, but some people might get distracted easily or prefer more realism.
• Hamster Armor Template Duplication
  • Hamster Smithing Templates can now be duplicated on a crafting table!
  • Use 1 Template (top center), 1 corresponding material ingot/gem (center), and 7 Acorn Shards.
• Botanical Vandalism (Sapling Trimming)
  • You can now right-click any sapling with a pair of Shears to instantly turn it into a Dead Bush. This provides a much more accessible way to gather the necessary materials for crafting Hamster Bedding if you don't live near a desert.
  • Added a new page to the Hamster Tips guidebook detailing this mechanic.
• Free Bed Respawn Toggle
  • Added a config toggle to allow hamsters to respawn at their linked beds indefinitely without requiring a tribute item charge (like a Totem of Undying). Disabled by default.
• Dynamic Trees Compatibility
  • Added out-of-the-box support for Dynamic Trees via some new config settings.
  • Replaced hardcoded oak leaves checks with a new Heistable Leaves list in the config, allowing modpack makers to easily add other modded leaves or trees to the heist feature.
  • Added a new Heistable Logs list to the Tree Heist Settings config, similar to the Heistable Leaves list. This means you can now start a tree heist by throwing the hamster at a branch or the trunk.
  • Developed a dumber but more compatible canopy-mapping algorithm that activates automatically if Dynamic Trees is installed, ensuring heist still works without the vanilla leaves' internal distance from trunk property.
  • Acorn Note: The Dynamic Trees mod adds their own type of acorns and drop methods. When that mod is installed, the only way to get the specific acorns from my mod is through the Tree Heist.
• Dehydration and NutritionZ Compatibility
  • Added built-in datapacks for the Dehydration and NutritionZ mods. Cucumbers will now hydrate you, and Cheese will finally clog your arteries properly.
• Combustible Acorns
  • Acorns can now be used as furnace fuel, smelting exactly the same amount of items as a vanilla stick.
  • Alternatively, placing an Acorn in the top slot of a furnace will smelt it down into a piece of Charcoal.
• World Gen Compatibility Enhancements
  • Added massive out-of-the-box biome compatibility configuration data for Oh The Biomes We've Gone, ensuring hamster variants properly disperse across their beautiful landscapes. Huge thanks to @jlk2003r for helping configure these lists!
• Create Mod Compatibility
  • Added out-of-the-box recipe compatibility for Create: Bitterballen and Create Crafts & Additions.
  • You can now mill, crush, compact, roast, and smoke AHP Sunflower Seeds to progress through the Bitterballen tech tree seamlessly, bypassing the need to hunt down vanilla sunflowers. Thanks to @jlk2003r for teaching me about Create so I knew what recipes to add!
• Armor Tier Jumping
  • You can now upgrade Hamster Armor between any tiers using the Smithing Table (e.g., Iron to Diamond, Diamond to Netherite). Previously, all upgrades had to start from base Acorn Armor. You can also downgrade it... should you decide to do so.
• Infinite Bed Respawns
  • Added a new Tribute One-Time Use config setting. When enabled, a bed only requires the tribute item (Totem of Undying by default) once, permanently unlocking infinite respawns for that specific bed and hamster.
• Taming Feedback
  • The mod will now provide snarky chat feedback if you try to tame a hamster incorrectly (such as not sneaking or offering them the wrong food) and will point you to the guidebook for help.
• Hamster Bed Placement Safeguard
  • Unlinked hamster beds can no longer be placed in the world accidentally.
  • Attempting to do so for the first time triggers an audible warning and chat message explaining that they must be linked to a hamster first.
  • After receiving the warning, a 2-second cooldown begins. Once it expires, players are allowed to place the unlinked bed freely. The game remembers that you've been warned and won't bother you again.
  • Added config settings under 'Hamster Beds & Wander Mode' to disable the warning entirely, or to clear your history so you can experience it all over again.
  • The tooltips and guidebook entries have been updated to make the linking process ("right-click a hamster with bed in hand") much clearer.
• Global Notification Toggle
  • Added a Server Disable Announcements config setting. Server owners can now globally disable the notification bell icon for all connected players.
• Smoker Support
  • Green Beans can now be cooked into Steamed Green Beans using a Smoker, which cooks them twice as fast as a standard furnace.
• Compostable Sunflowers
  • The custom Adorable Hamster Pets Sunflower can now be placed in a composter (matching the 65% compost chance of vanilla sunflowers).
• Plantable Acorns
  • Acorns can now be planted directly on dirt/grass to grow vanilla Oak Trees. Once placed they will become Oak Saplings.

Changed

• Config GUI Major Overhaul
  • During development on v3.6.1, the mod's configuration file exceeded Minecraft's hard-coded networking limits due to a Fzzy Config NeoForge bug which I've already reported. As a work-around, the main config has been split into multiple smaller, organized configs. It needed to be done anyway, so I simultaneously re-organized everything, making it more intuitive to navigate.
• Dismount Keybinding Simplification
  • Removed the confusing config toggle that forced players to enable a custom keybind in the config before they could rebind the "Dismount Hamster" key in the Controls > Key Binds menu. The keybind is now permanently exposed.
  • The "Dismount Hamster" keybind now utilizes an unbound fallback system. By default, the keybind is set to Unbound, and the game will naturally listen to your vanilla Sneak key to dismount hamsters. However, if you manually assign a key to it in the controls menu, it will override the sneak behavior and listen exclusively to your custom key.
  • The default "Button-Press Behavior" config setting has been changed from Single Press to Double Tap to prevent accidental dismounts when sneaking near ledges. Originally it was set to single press to mimic vanilla parrot behavior, but it's just so annoying. I finally can't stand it anymore. Lol.
  • Added a Custom Key Behavior Override config toggle (true by default). When you bind a custom key for dismounting, it automatically overrides the Double Tap behavior and makes it a Single Press. I assume if you assigned a dedicated key to it, you don't want to have to tap it twice.
• Keybind Names
  • Renamed several of the key binds to make the Controls > Key Binds menu more intuitive.
• Hamster Attacking AI
  • Hamsters can no longer pathfind outside the follow radius when targeting entities. They will instead exhibit erratic behavior near the edge of the boundary.
  • This prevents repetitive teleportation back to the player when the hamster is aggressively targeting something outside the follow distance.
  • To compensate, follow distance has been increased by five blocks when the hamster is in MENACE mode.
• The Hamster Yeet
  • Throwing a hamster is no longer canceled/prevented if the player's crosshair is over non-solid blocks like tall grass, flowers, sugar cane etc.
  • Reduced the default gravity applied to thrown hamsters by 30%, resulting in naturally longer, flatter arcs out-of-the-box. Hamsters will feel less "heavy" now during throws.
  • Thrown hamsters now generate a shower of block-breaking particles upon impacting a surface.
  • Resolved an issue where players throwing their hamsters very far away wouldn't hear some of the animation-based impact sounds due to vanilla audio distance attenuation.
• Hamster Tips Guidebook
  • "The Great Escape" has been renamed to "Beds & Wander Mode," and "Acorn Armor" has been renamed to "Tree Heist & Armor" so you guys won't keep coming into my Discord server asking how the beds work and where to find acorns 😂
  • This has another super useful perk: Now whenever you search through the guidebook for a specific topic, you can search for things like "bed," "tree heist," or "armor" and those specific entries will pop up in the results.
  • Now utilizes dynamic text injection to accurately display your configured resurrection tribute items. So now if a server owner or modpack creator changes the default item from a Totem of Undying, the guidebook will update itself automatically.
• Tag Mini-Game
  • Wild hamsters can no longer initiate a game of tag to prevent interference with taming. Tamed hamsters can still play tag with strangers if enabled in the config.
  • The game will no longer randomly start while you are sneaking, preventing interference with petting.
  • You can now manually start a game of tag on-demand by rapidly sneaking and un-sneaking while maintaining eye contact with a tamed hamster.
  • Since there is now a manual trigger, the chance of the game starting is now much lower. You will need to stare at a hamster for ~15 seconds on average for the game to automatically start.
  • Starting a game of tag now plays a sound, spawns particles, and displays an action bar message to clearly indicate that it is a fun event and not a bug.
  • Hamsters will now lovingly slap you (applying knockback and brief nausea, but no damage) when the game starts.
  • Added a 1-second interaction cooldown when the game starts to prevent accidentally catching the hamster immediately.
• Genetics & Color Groups
  • Renamed the ROSE color group to CHERRY since the only hamster in that group is the "Pearl Rose" hamster, which is basically pink anyway.
  • Added a new RUST color group. The "Rust" hamster has officially been evicted from the ORANGE category, allowing it to have its own dedicated spawning rules.
• Spawning Config Overhaul
  • Reorganized the World Gen config UI to clearly separate the global "Allow/Prevent Spawns" lists from the "Region-Based Color Filters". It now clearly explains the "filter funnel" concept so you know exactly why the Plains environment acts as a catch-all.
  • Expanded the procedural spawning logic from 10 environments to 12, giving modpack makers perfect 1:1 granular control over all 12 hamster color groups.
  • The Wildcard: Added a "Priority 1: Wildcard" zone. Allows server owners to surgically extract specific biomes from broader categories and assign them unique colors without overhauling the other lists. (i.e., If you wanted to separate the environments in which Light Gray and Dark Gray hamsters spawn, now you can do so).
  • Sky Environments: Added a dedicated zone for floating island biomes to host the SKY color group. Vanilla players— no need to freak out; there's still a 15% chance to find SKY hamsters instead of WHITE in snowy areas.
  • Cherry Environments: Extracted Cherry Groves out of the Magical environments so they can be balanced independently. Defaults to 100% CHERRY hamsters.
  • Auburn Environments: Added a dedicated zone targeting Badlands (and modded autumnal forests with red trees if you like). This is the exclusive new home for RUST hamsters. (ORANGE hamsters will no longer spawn in Badlands by default).
  • Re-balanced Weights: Adjusted the default spawning weights across the Icy, Magical, and Snowy environments to accommodate the new color zones.
• ⚠ Important Config Note for Existing Worlds
  • If you are updating an existing modpack, your old config files will obstinately hold on to their old settings. This is good, otherwise you would lose all your work every time I pushed out an update. However, this means that in order to see these new default spawn weights, you will need to right-click specific settings in the config screen and select "Restore Defaults." Alternatively, click the "Changes" button (bottom-right corner) and click "Restore Defaults" to reset everything at once (only affects the config from my mod).
• Hamster Bedding Leaf Particles
  • Doubled the visual size of the Hamster Bedding particles to better match the leaves on the trees and on the hamster bed itself.
• Pink Petal Accessories
  • Added a new config toggle (true by default) to dynamically render Pink Petal accessories on the outside of equipped armor, so your hamster can be safe and fabulous simultaneously.
• Configurable 3D Visualizer Particles
  • Added a Continuous Genetics Cylinder toggle to the config. When disabled, the 3D bounding cylinder generated by /ahp spawn_all_bases_3D will only render for the first second after spawning to reduce clutter.
• Spawning & Testing Commands
  • Added /ahp undo_last_spawn. Easily discards all hamsters spawned by your very last /ahp spawn... command. Perfect for when you set up a hamster display and then accidentally run the 2-million permutation command in the wrong location.
  • Overhauled the /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD command. It is now called /ahp spawn_random_group <count>.
    • You must now provide a <count> argument. It accepts standard numbers (e.g., 500) or an all_THIS_CAN_BREAK_YOUR_WORLD string.
    • Hamsters are now spawned in a completely randomized order and placement on the grid.
    • If the requested count is 5,000 or less, the hamsters are spawned synchronously and instantly without invoking the asynchronous batch-spawning system.
  • Added five additional optional arguments to the 2D, 3D, and randomized spawn commands: [spacing_multiplier], [match_player_yaw], [randomize_sitting], [randomize_sleeping], and [randomize_yaw]. These arguments allow you to expand or shrink the physical distance between the spawned hamsters, force the entire grid of spawned hamsters to face one direction, a random direction, and/or give them static poses to keep things more visually interesting.
  • Added a new argument to the /ahp spawn_random_group command called use_wild_overlay_rules_for_breeding_overlays. Allows you to spawn a more realistic/natural looking random group of hamsters.
  • Added a new <pose> argument to the /ahp spawn hamster command, allowing you to specify sitting, sleeping, idle, or none.
  • Added personality ID's for command-spawned hamsters. The random sitting/sleeping poses are based on that ID, so they will retain those poses even after being tamed.
  • Updated the Admin Commands chapter in the Hamster Tips guidebook to include descriptions for these new commands and arguments.
• Hamster Bed Placement
  • Placing down a new hamster bed no longer forces the hamster to sleep in it immediately unless the conditions are correct (i.e., time of day, config settings).
• Wandering Hamster Sitting
  • Hamsters linked to a bed will no longer automatically sit down when their owner logs out or changes dimensions, as long as the bed is still intact.

Fixed

• Hamsters Falling Into End Portals
  • Hamsters that wander into the exit End Portal will now bounce right back out, complete with particle and sound effects.
  • Prevents them from teleporting to the Overworld spawn coordinates and getting lost.
  • Added a toggle to the config to revert to standard vanilla behavior if desired.
• Hamster Yeet & Evilcraft Bug
  • Resolved an bug that prevented hamsters from being thrown on Forge and NeoForge dedicated servers, caused by environment annotations running on the server thread. Super niche little insect that slipped by because it doesn't exist on Fabric. You should be able to throw your hamsters in multiplayer again!
  • This also resolves a server startup crash when playing with EvilCraft, which attempts to instantiate the projectile to check its blood levels. Lol.
• Food Item Stacking
  • Resolved an issue on 1.21.1 where the configurable food items became unstackable in the inventory GUI after being split or spread.
  • Implemented a stable ComponentMap caching system to ensure GUI right-click dragging correctly identifies dynamic food stacks as equal.
• Sliced Cucumber Feeding
  • Resolved a bug where already-tamed hamsters would refuse to eat their taming food (e.g. Sliced Cucumber) to heal or breed.
• Projectile Accessories
  • Fixed a visual bug where a hamster's equipped armor and accessories would temporarily vanish while they were airborne during a throw.
• Server Performance
  • Resolved a few pathfinding and AI issues where tamed hamsters following the player would sometimes experience server-tick lag spikes. Usually you wouldn't notice these unless you had a lot of hamsters following you at once.
• Wander Mode Override
  • Resolved a bug where disabling Wander Mode in the global config wouldn't stop already-wandering hamsters from lingering around their beds.
• Cheese Item Texture
  • Finally fixed the 99% transparent pixel in the bottom left corner of the cheese item texture. I only recently realized what was causing it to look so strange. Lol
• Console Log Spam
  • Resolved an issue where players with internet disabled (or those playing in regions where GitHub is blocked) would receive a massive, screen-filling error stack trace in their console every 5 minutes when the mod silently checked for updates in the background. Background network failures are now politely logged as a single warning line.
  • Resolved an issue where the genetics engine would spam the server console with warnings when attempting to generate wild overlays for hamsters with extremely bright base coats (like Coconut).
• Sweet Potato Easter Egg
  • Renaming a hamster to "Sweet Potato" now correctly applies the easter egg texture without accidentally deleting the hamster's eyes, skin layer, and accessories. So that's good.
  • Resolved an issue where the effects would trigger immediately upon renaming a hamster via the GUI, before the screen was closed.
  • Resolved an issue where the affects would not trigger at all on 1.20.1 if a hamster was renamed via the GUI.
• Missing Vanilla Tags
  • The custom AHP Sunflower block is now properly registered under the vanilla #minecraft:flowers and #minecraft:tall_flowers tags. This resolves compatibility issues with mods like Alex's Mobs that rely on these tags to identify flowers in the world.
• Flashback Mod
  • Resolved a server crash that occurred when scrubbing through replay timelines using the Flashback mod, caused by missing NBT data on Hamster Beds.
  • Resolved a persistent desync issue where shoulder hamsters would disappear when scrubbing backwards or jumping to different points on the replay timeline. Future replays will hopefully be fixed via a periodic server-side data sync that runs once per second.
• File Parsing Crashes
  • Fixed a crash that occurred when reading corrupted .json cache files for the supporter perk system. It will now safely ignore the corrupted file and download a fresh copy from the internet.
• Guidebook Server Synchronization
  • Resolved an issue where the "Missing Guidebook" chat warning would trigger repeatedly across multiple game sessions when playing on a dedicated server due to a configuration synchronization flaw.
  • Fixed an issue where players were falsely led to believe they could locally disable Guidebook Auto-Delivery on dedicated servers. These settings now properly sync from the server to the client's config UI, reflecting the server's true authority over the book's delivery.
• Food Interactions
  • Fixed a bug where players could not toggle their hamster's sitting state if they were holding Hamster Food Mix or other food items.
• "Hampter" Custom Name
  • The "Use 'Hampter' as Default Name" config setting now properly reflects on the Jade HUD overlay and the Hamster Inventory screen.
• Cheek Pouch Allowed Items
  • Fixed an issue where all vanilla food items were forbidden in the Cheek Pouch on 1.20.1 due to a typo.
• Spawn Commands
  • Resolved an issue where AI-disabled hamsters generated by /ahp spawn_all_bases_3D would sometimes suffocate and die if they spawned inside each other. They are now completely invulnerable until they are tamed/woken up.
• Cheek Pouch Desync
  • Fixed an issue where a hamster's cheek pouches would visually deflate in heavily modded environments due to partial NBT syncing from mods like Jade.
• Guidebook Recovery Routing
  • The "Missing Guidebook" chat warning now correctly opens the root configuration menu so the recovery button is actually visible.

The Punchy Patch

In addition to a bunch of new mini-games, idle animations and QoL features (including hamster armor trims & toggleable aggression states!), this patch introduces 5 new super cute, first-person animations to your rodent-handling experience, courtesy of the amazing Punchy mod! I've been working closely with @Dev Punchy Man to overhaul how it feels to pick up, pet, yeet, and dismount your hamsters.

👉🏼 Showcase video 👈🏼

Added

• New First-Person Animations (Optional: Requires Punchy v2.6.0+)
  • Note: The Punchy mod is not a required dependency for Adorable Hamster Pets. It is only required if you want to experience these specific new first-person animations listed below:
  • Petting/Tickling Animation (Requires Punchy v2.6.0+)
    • You can finally pet your hamster! If you stare affectionately at your hamster for a while sneaking (about 15 seconds on average), you might just reach down, pick it up and give it some tickles. Comes with a new animation where the hamster flips over on your hand and asks for a belly rub! Also added a dedicated "Pet Hamster" keybind (unbound by default) for when you don't feel like waiting for the random chance to kick in.
    • For those with the patience of a fruit bat, pressing your "Pet Hamster" key or clicking your mouse will cancel the petting animation. You don't need to be sneaking to use the keybind.
    • If the hamster was sitting before you picked it up to pet it, it will remain seated when you place it back down, making this a great way to manually re-position tamed hamsters around your base.
  • Shoulder Mounting Animations (Requires Punchy v2.6.0+)
    • Luring a hamster to your shoulder is no longer a boring teleport. You will now physically lift them up, complete with the hamster adorably bouncing on your hands or running up your arm. Three new unique animations; dynamically changing depending on their destination (left shoulder, right shoulder, head).
  • Hamster Yeet Animations (Requires Punchy v2.6.0+)
    • Holding down the throw key (G) grabs a specific hamster off your shoulder and holds it in front of your face. (For more info, see "Hamster Yeet Mechanics" below).
    • While queued up, the hamster also plays its own new animation (Requires Punchy v2.6.0+) where it eagerly wiggles its butt and kicks its back feet in anticipation of being hurled through the air.
    • Releasing the throw key (G) executes the throw, which is immediately followed by a new Punchy animation where you wave goodbye to your furry projectile.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. Your character will politely place the hamster back onto the exact shoulder it came from.
• Hamster Yeet Mechanics
  • The Yeet Queuing System
    • Throwing a hamster is no longer instant. You must hold down the throw key (G by default) to "queue" a hamster for throwing. Includes new animations if the Punchy mod is installed. (for more info, see "New First-Person Animations" above).
    • Releasing the throw key (G) executes the throw.
    • If you release the key before the short charging period (15 ticks) is over, you safely abort the throw. This charging period of 15 ticks is not configurable, due to its duration needing to match the Punchy mod's animation. But it's quite short— only 0.75 seconds— so hopefully it won't impact gameplay.
  • Hamsters Weigh Less
    • Added a Downward Force (Gravity) slider to the config, allowing you to fine-tune how far hamsters fly without needing to increase their initial thrust.
    • Reduced the default gravitational force by ~30%, so hamsters will fly a little bit further now. (Useful for recording hamster flights with the Flashback mod, which gets buggy when entities are moving very quickly through the air).
  • FOV Zoom
    • Added a smooth FOV zoom effect while queueing the Hamster Yeet, identical to drawing a vanilla bow. This FOV zoom will help indicate the new charging period for anyone who doesn't have Punchy installed, since the new animations are part of Punchy.
  • Cooldown Recovery
    • If you're impatient, feeding your hamster will now incrementally reduce its throw cooldown (similar to how feeding accelerates baby growth).
  • More Feedback
    • A new action bar message will let you know when the hamster has recovered from its concussion and is ready for launch.
• More Flower Accessories
  • Expanded the old "Pink Petal" accessory. You can now equip any flower in the #flowers tag onto your hamster instead of just Pink Petals.
  • There are 12 unique textures. The texture assignment logic automatically scans the registry names of flowers. It uses an extensive list of color keywords and botanical families to ensure almost any flower you apply (even modded flowers) will have the correct color palette.
  • The color assignment logic is completely data-driven. You can easily force a modded flower to use a specific color palette using standard Minecraft Item Tags (e.g., adding an item to #adorablehamsterpets:flower_accessories/overlay_wither_rose).
  • For a tutorial, pop over to The Cheek Pouch Discord server, visit the FAQ channel, and search for Custom Flower Accessories.
  • Added new pages to the Hamster Tips guidebook explaining how the dynamic color assignment and tag overrides work.
• Shader LabPBR Material Support
  • All items, blocks, particles, and entities in this mod now include their own LabPBR-compliant Specular and Normal textures (with hamsters generating theirs procedurally), giving them detailed, per-layer PBR effects (emission, subsurface scattering, specular reflections, porosity, etc.) out-of-the-box with supported shaders.
  • Must have your shader's material settings set to "LabPBR" or "Hardcoded + LabPBR"
  • Metal armors have a "Vanilla-inspired" glossiness by default, but if you prefer hardcore realism and want them super metallic/reflective, I added custom sliders in the config allowing you to manually fine-tune the PBR values for each individual armor type.
  • Added a Max POM Depth slider to allow fine-tuning of the procedural 3D fur displacement (only works if your shader supports POM on entities, which is extremely rare).
• Armor Trims
  • Hamster Armor can now be customized with vanilla armor trims in the Smithing Table.
  • The following trims are currently available: Coast, Border, Vex, Eye, Sentry, Wild
  • They will naturally glow in the dark and automatically have emission with shader mods like Iris.
  • Added an Emissive Armor Trims toggle in the client config so you can disable the glowing effect if you hate fun and prefer a non-luminescent reality.
  • Added a Trim Emissive Brightness slider to give you precision control over exactly how blinding the neon lines should be.
• Configurable Aggression States
  • Hamsters now have three distinct aggression states controlled by their diet.
  • Pacifist: Sneak + right-click them any vanilla flower (e.g., #minecraft:flowers). They become total hippies and will refuse to attack anything, even if you are being actively mauled.
  • Standard: Sneak + right-click them Sunflower Seeds to factory-reset them back to their normal, wolf-like defensive behavior.
  • Menace: Sneak + right-click them a Spider Eye to unleash their inner demon. They will actively hunt down anything on the configurable "Menace Targets" list (which defaults to all monsters and bosses), and gain an expanded follow radius to give them more room to fight. If a target is outside their follow radius, they will move frantically at the edge of the tether.
  • All trigger items are fully configurable, and changing a hamster's state produces a visual and audio confirmation.
  • If you have jade installed, its overlay will display the hamster's current Aggression State when it is set to something other than the default, and can be toggled in the config alongside the other genetic displays.
  • Hamster Tips Guidebook Entry
    • The Hamster Tips guidebook now features a dedicated "Aggression States" page to explain the new mechanics. It utilizes dynamic text injection to accurately display your configured trigger items, ensuring the book is always up-to-date even if a modpack creator changes the required diets.
  • Pacifist Break: Added a Pacifist Break on Attack config toggle (false by default). When enabled, a passive hamster will automatically revert to neutral if it sees you attacking something.
• Crop Harvesting
  • Tamed, wandering hamsters now possess an irrepressible desire for the occasional midnight snack.
  • If they find a fully mature crop nearby and they have room in their cheek pouch, they will violently pounce on it, aggressively stuff the harvest into their cheek pouches, and accidentally replant some seeds in the process.
  • Includes dynamic block particles and a leaf-crunching sound effect when pouncing on the crop block.
  • Includes dynamic item particles when the hamster scoops up the dropped seeds and harvest items.
  • Added a new Crop Snacking Settings allowing you to disable the feature entirely, tweak the cooldown, or add specific crops from their menu.
  • Added a new custom #adorablehamsterpets:crop_items union tag so hamsters can recognize and eat/harvest most modded crops and vegetables out of the box.
  • Added two new "Crop Harvesting" pages to the Hamster Tips guidebook explaining the feature.
• Swimming Mechanics
  • Added a new swimming animation loop for hamsters that accidentally fall into the water. This seems to happen a lot when they are snacking on crops so I thought it was a good time to add it.
  • Replaced the Vanilla game's erratic swimming AI with a custom, smoother physics simulation that doesn't launch them out of the water every couple of seconds like a dolphin.
  • Included 7 new unique water-swishing sound effects as part of the swimming animation.
  • Hamsters can now dive underwater in persuit of items they want to steal/snack on.
  • They will still do their best to avoid water the rest of the time, but now they don't look so broken when they inevitably fall into it.
• Hide & Seek Mini-Game
  • Tamed hamsters now occasionally get the urge to disappear into the woodwork.
  • If they find a suitable hiding spot (bushes, chests, barrels, etc.), they will leap into it and vanish.
  • You have a limited time to find them (configurable, ~45-60 seconds by default) before their short attention span gets the better of them. If you try to break or interact with the block they are hiding in during that time, you win! They will pop out and reward you with an item from their cheek pouches.
  • If the timer runs out before you find them, they will emerge, sulk, and you get nothing.
  • The block they are hiding in will occasionally jiggle, make noise, and spawn particles to help you locate them.
  • You will also see a trail of subtle particles from your location directly towards the hiding spot, provided you are within 25 blocks of the hidden hamster.
  • These effects will be very scarce at the start, but dynamically increases in frequency/intensity as the game progresses.
  • Configurability: Everything is customizable in the config. You can adjust the initiation chance, duration, block lists, and whether they are allowed to hide inside storage blocks like chests.
• Storage Crates
  • Thanks to @The Retro Stitcher for helping to design new compacting storage crates for Acorns, Cucumbers, Green Beans, and Hamster Food Mix.
  • Fully compatible with LabPBR shader materials out-of-the-box.
• "Hamtaro" Easter Egg
  • Renaming a hamster "Hamtaro" gives it a special texture. This functions identically to the "Sweet Potato" easter egg. Both base textures provided by @jimcerberus!
• New "Panda" Overlay Pattern
  • Added a new "Panda" fur overlay pattern to the genetics engine, allowing you to breed panda-like hamsters. To get a "Panda" hamster, you'll need a Black base coat and a white overlay with the new "Panda" pattern. These can't be found in the wild, since black hamsters do not spawn with white overlays in the wild (breaks their camouflage). Thanks to @jimcerberus for the Panda inspiration!
• 3 New Music Discs & Hamster Dancing
  • A legendary new Cheese Music Disc featuring the Adorable Hamster Pets theme song, created by yours truly. Can only be obtained by orchestrating a high-velocity, terminal collision between an airborne hamster and a Charged Creeper.
  • Alternate Versions
    • The Parmesan Music Disc: Features an Orchestral remix of the Adorable Hamster Pets theme song. Piglins are apparently lactose aficionados. Trade a regular Cheese Music Disc with a Piglin to receive this highly adventurous, grated alternative.
    • The Blue Cheese Music Disc: Features a Low-Fi remix of the Adorable Hamster Pets theme song. Obtainable by tossing a regular Cheese Music Disc into the End exit portal after defeating the dragon. The void will age the cheese and violently spit it back out at you.
  • ⚠️ Content Creators ↓
    • All three songs are fully licensed and safe for YouTube & Twitch monetization. Feel free to feature them in your videos!
  • If playing in a Jukebox, nearby hamsters will dance to the music.
  • Tried one of the remixes but not a fan? Surround the Blue Cheese or Parmesan discs with regular Cheese in a crafting table to restore them to their original 8-Bit glory.
  • Added new advancements and guidebook pages hinting about how to obtain them.
  • Modded Music Disc Support
    • Added a Dancing Music Discs string list in the config that contains a few strings by default: hamster, hampter, and hamtaro. If a jukebox plays a music disc containing any of these configured strings in its name, description, or lore (case-insensitive), nearby hamsters will dance to it.
• Inter-Hamster Tag Mini-Game
  • Hamsters will now spontaneously instigate games of tag with each other.
  • The instigator will sprint up to an unsuspecting victim, deliver a visual (damage-free) slap (using a new cowbell sound effect), and sprint away to begin the chase.
  • If the chaser catches the instigator or if the 15-second timer runs out, the game ends and both hamsters celebrate.
  • Tethering: The instigator dynamically restricts its flee path to stay within 14 blocks of you (if tamed), ensuring they don't sprint off a cliff or into an unloaded chunk during the heat of the chase.
  • Player Interruption: Right-clicking either hamster while they are playing tag with each other will instantly break up the game and send them back to their normal routines, but will not reward you with a gift.
  • Population-Independent Rarity: The probability math dynamically adjusts based on the local hamster population. Whether you have 2 hamsters in your base or an apocalyptic horde, you will only see an average of 1 game per minute in that area.
  • Configurability: Added Enable Hamster-vs-Hamster Tag, Average Minutes Between Games, and Inter-Hamster Tag Duration settings to the config.
• New Ambient Sitting Animation
  • Added a new "sitting roll" animation where sitting hamsters occasionally roll on their backs. Comes with new sound effects, and it's configurable in the new "Ambient Sitting Behaviors" config group, which also controls cleaning frequency.
  • Includes a "Cartoon Rolling Sound" config toggle. By default, the hamster's rolling SFX will include a cartoon-ish slide whistle. It's subtle, but some people might get distracted easily or prefer more realism.
• Hamster Armor Template Duplication
  • Hamster Smithing Templates can now be duplicated on a crafting table!
  • Use 1 Template (top center), 1 corresponding material ingot/gem (center), and 7 Acorn Shards.
• Botanical Vandalism (Sapling Trimming)
  • You can now right-click any sapling with a pair of Shears to instantly turn it into a Dead Bush. This provides a much more accessible way to gather the necessary materials for crafting Hamster Bedding if you don't live near a desert.
  • Added a new page to the Hamster Tips guidebook detailing this mechanic.
• Free Bed Respawn Toggle
  • Added a config toggle to allow hamsters to respawn at their linked beds indefinitely without requiring a tribute item charge (like a Totem of Undying). Disabled by default.
• Dynamic Trees Compatibility
  • Added out-of-the-box support for Dynamic Trees via some new config settings.
  • Replaced hardcoded oak leaves checks with a new Heistable Leaves list in the config, allowing modpack makers to easily add other modded leaves or trees to the heist feature.
  • Added a new Heistable Logs list to the Tree Heist Settings config, similar to the Heistable Leaves list. This means you can now start a tree heist by throwing the hamster at a branch or the trunk.
  • Developed a dumber but more compatible canopy-mapping algorithm that activates automatically if Dynamic Trees is installed, ensuring heist still works without the vanilla leaves' internal distance from trunk property.
  • Acorn Note: The Dynamic Trees mod adds their own type of acorns and drop methods. When that mod is installed, the only way to get the specific acorns from my mod is through the Tree Heist.
• Dehydration and NutritionZ Compatibility
  • Added built-in datapacks for the Dehydration and NutritionZ mods. Cucumbers will now hydrate you, and Cheese will finally clog your arteries properly.
• Combustible Acorns
  • Acorns can now be used as furnace fuel, smelting exactly the same amount of items as a vanilla stick.
  • Alternatively, placing an Acorn in the top slot of a furnace will smelt it down into a piece of Charcoal.
• World Gen Compatibility Enhancements
  • Added massive out-of-the-box biome compatibility configuration data for Oh The Biomes We've Gone, ensuring hamster variants properly disperse across their beautiful landscapes. Huge thanks to @jlk2003r for helping configure these lists!
• Create Mod Compatibility
  • Added out-of-the-box recipe compatibility for Create: Bitterballen and Create Crafts & Additions.
  • You can now mill, crush, compact, roast, and smoke AHP Sunflower Seeds to progress through the Bitterballen tech tree seamlessly, bypassing the need to hunt down vanilla sunflowers. Thanks to @jlk2003r for teaching me about Create so I knew what recipes to add!
• Armor Tier Jumping
  • You can now upgrade Hamster Armor between any tiers using the Smithing Table (e.g., Iron to Diamond, Diamond to Netherite). Previously, all upgrades had to start from base Acorn Armor. You can also downgrade it... should you decide to do so.
• Infinite Bed Respawns
  • Added a new Tribute One-Time Use config setting. When enabled, a bed only requires the tribute item (Totem of Undying by default) once, permanently unlocking infinite respawns for that specific bed and hamster.
• Taming Feedback
  • The mod will now provide snarky chat feedback if you try to tame a hamster incorrectly (such as not sneaking or offering them the wrong food) and will point you to the guidebook for help.
• Hamster Bed Placement Safeguard
  • Unlinked hamster beds can no longer be placed in the world accidentally.
  • Attempting to do so for the first time triggers an audible warning and chat message explaining that they must be linked to a hamster first.
  • After receiving the warning, a 2-second cooldown begins. Once it expires, players are allowed to place the unlinked bed freely. The game remembers that you've been warned and won't bother you again.
  • Added config settings under 'Hamster Beds & Wander Mode' to disable the warning entirely, or to clear your history so you can experience it all over again.
  • The tooltips and guidebook entries have been updated to make the linking process ("right-click a hamster with bed in hand") much clearer.
• Global Notification Toggle
  • Added a Server Disable Announcements config setting. Server owners can now globally disable the notification bell icon for all connected players.
• Smoker Support
  • Green Beans can now be cooked into Steamed Green Beans using a Smoker, which cooks them twice as fast as a standard furnace.
• Compostable Sunflowers
  • The custom Adorable Hamster Pets Sunflower can now be placed in a composter (matching the 65% compost chance of vanilla sunflowers).
• Plantable Acorns
  • Acorns can now be planted directly on dirt/grass to grow vanilla Oak Trees. Once placed they will become Oak Saplings.

Changed

• Config GUI Major Overhaul
  • During development on v3.6.1, the mod's configuration file exceeded Minecraft's hard-coded networking limits due to a Fzzy Config NeoForge bug which I've already reported. As a work-around, the main config has been split into multiple smaller, organized configs. It needed to be done anyway, so I simultaneously re-organized everything, making it more intuitive to navigate.
• Dismount Keybinding Simplification
  • Removed the confusing config toggle that forced players to enable a custom keybind in the config before they could rebind the "Dismount Hamster" key in the Controls > Key Binds menu. The keybind is now permanently exposed.
  • The "Dismount Hamster" keybind now utilizes an unbound fallback system. By default, the keybind is set to Unbound, and the game will naturally listen to your vanilla Sneak key to dismount hamsters. However, if you manually assign a key to it in the controls menu, it will override the sneak behavior and listen exclusively to your custom key.
  • The default "Button-Press Behavior" config setting has been changed from Single Press to Double Tap to prevent accidental dismounts when sneaking near ledges. Originally it was set to single press to mimic vanilla parrot behavior, but it's just so annoying. I finally can't stand it anymore. Lol.
  • Added a Custom Key Behavior Override config toggle (true by default). When you bind a custom key for dismounting, it automatically overrides the Double Tap behavior and makes it a Single Press. I assume if you assigned a dedicated key to it, you don't want to have to tap it twice.
• Keybind Names
  • Renamed several of the key binds to make the Controls > Key Binds menu more intuitive.
• Hamster Attacking AI
  • Hamsters can no longer pathfind outside the follow radius when targeting entities. They will instead exhibit erratic behavior near the edge of the boundary.
  • This prevents repetitive teleportation back to the player when the hamster is aggressively targeting something outside the follow distance.
  • To compensate, follow distance has been increased by five blocks when the hamster is in MENACE mode.
• The Hamster Yeet
  • Throwing a hamster is no longer canceled/prevented if the player's crosshair is over non-solid blocks like tall grass, flowers, sugar cane etc.
  • Reduced the default gravity applied to thrown hamsters by 30%, resulting in naturally longer, flatter arcs out-of-the-box. Hamsters will feel less "heavy" now during throws.
  • Thrown hamsters now generate a shower of block-breaking particles upon impacting a surface.
  • Resolved an issue where players throwing their hamsters very far away wouldn't hear some of the animation-based impact sounds due to vanilla audio distance attenuation.
• Hamster Tips Guidebook
  • "The Great Escape" has been renamed to "Beds & Wander Mode," and "Acorn Armor" has been renamed to "Tree Heist & Armor" so you guys won't keep coming into my Discord server asking how the beds work and where to find acorns 😂
  • This has another super useful perk: Now whenever you search through the guidebook for a specific topic, you can search for things like "bed," "tree heist," or "armor" and those specific entries will pop up in the results.
  • Now utilizes dynamic text injection to accurately display your configured resurrection tribute items. So now if a server owner or modpack creator changes the default item from a Totem of Undying, the guidebook will update itself automatically.
• Tag Mini-Game
  • Wild hamsters can no longer initiate a game of tag to prevent interference with taming. Tamed hamsters can still play tag with strangers if enabled in the config.
  • The game will no longer randomly start while you are sneaking, preventing interference with petting.
  • You can now manually start a game of tag on-demand by rapidly sneaking and un-sneaking while maintaining eye contact with a tamed hamster.
  • Since there is now a manual trigger, the chance of the game starting is now much lower. You will need to stare at a hamster for ~15 seconds on average for the game to automatically start.
  • Starting a game of tag now plays a sound, spawns particles, and displays an action bar message to clearly indicate that it is a fun event and not a bug.
  • Hamsters will now lovingly slap you (applying knockback and brief nausea, but no damage) when the game starts.
  • Added a 1-second interaction cooldown when the game starts to prevent accidentally catching the hamster immediately.
• Genetics & Color Groups
  • Renamed the ROSE color group to CHERRY since the only hamster in that group is the "Pearl Rose" hamster, which is basically pink anyway.
  • Added a new RUST color group. The "Rust" hamster has officially been evicted from the ORANGE category, allowing it to have its own dedicated spawning rules.
• Spawning Config Overhaul
  • Reorganized the World Gen config UI to clearly separate the global "Allow/Prevent Spawns" lists from the "Region-Based Color Filters". It now clearly explains the "filter funnel" concept so you know exactly why the Plains environment acts as a catch-all.
  • Expanded the procedural spawning logic from 10 environments to 12, giving modpack makers perfect 1:1 granular control over all 12 hamster color groups.
  • The Wildcard: Added a "Priority 1: Wildcard" zone. Allows server owners to surgically extract specific biomes from broader categories and assign them unique colors without overhauling the other lists. (i.e., If you wanted to separate the environments in which Light Gray and Dark Gray hamsters spawn, now you can do so).
  • Sky Environments: Added a dedicated zone for floating island biomes to host the SKY color group. Vanilla players— no need to freak out; there's still a 15% chance to find SKY hamsters instead of WHITE in snowy areas.
  • Cherry Environments: Extracted Cherry Groves out of the Magical environments so they can be balanced independently. Defaults to 100% CHERRY hamsters.
  • Auburn Environments: Added a dedicated zone targeting Badlands (and modded autumnal forests with red trees if you like). This is the exclusive new home for RUST hamsters. (ORANGE hamsters will no longer spawn in Badlands by default).
  • Re-balanced Weights: Adjusted the default spawning weights across the Icy, Magical, and Snowy environments to accommodate the new color zones.
• ⚠ Important Config Note for Existing Worlds
  • If you are updating an existing modpack, your old config files will obstinately hold on to their old settings. This is good, otherwise you would lose all your work every time I pushed out an update. However, this means that in order to see these new default spawn weights, you will need to right-click specific settings in the config screen and select "Restore Defaults." Alternatively, click the "Changes" button (bottom-right corner) and click "Restore Defaults" to reset everything at once (only affects the config from my mod).
• Hamster Bedding Leaf Particles
  • Doubled the visual size of the Hamster Bedding particles to better match the leaves on the trees and on the hamster bed itself.
• Pink Petal Accessories
  • Added a new config toggle (true by default) to dynamically render Pink Petal accessories on the outside of equipped armor, so your hamster can be safe and fabulous simultaneously.
• Configurable 3D Visualizer Particles
  • Added a Continuous Genetics Cylinder toggle to the config. When disabled, the 3D bounding cylinder generated by /ahp spawn_all_bases_3D will only render for the first second after spawning to reduce clutter.
• Spawning & Testing Commands
  • Added /ahp undo_last_spawn. Easily discards all hamsters spawned by your very last /ahp spawn... command. Perfect for when you set up a hamster display and then accidentally run the 2-million permutation command in the wrong location.
  • Overhauled the /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD command. It is now called /ahp spawn_random_group <count>.
    • You must now provide a <count> argument. It accepts standard numbers (e.g., 500) or an all_THIS_CAN_BREAK_YOUR_WORLD string.
    • Hamsters are now spawned in a completely randomized order and placement on the grid.
    • If the requested count is 5,000 or less, the hamsters are spawned synchronously and instantly without invoking the asynchronous batch-spawning system.
  • Added five additional optional arguments to the 2D, 3D, and randomized spawn commands: [spacing_multiplier], [match_player_yaw], [randomize_sitting], [randomize_sleeping], and [randomize_yaw]. These arguments allow you to expand or shrink the physical distance between the spawned hamsters, force the entire grid of spawned hamsters to face one direction, a random direction, and/or give them static poses to keep things more visually interesting.
  • Added a new argument to the /ahp spawn_random_group command called use_wild_overlay_rules_for_breeding_overlays. Allows you to spawn a more realistic/natural looking random group of hamsters.
  • Added a new <pose> argument to the /ahp spawn hamster command, allowing you to specify sitting, sleeping, idle, or none.
  • Added personality ID's for command-spawned hamsters. The random sitting/sleeping poses are based on that ID, so they will retain those poses even after being tamed.
  • Updated the Admin Commands chapter in the Hamster Tips guidebook to include descriptions for these new commands and arguments.
• Hamster Bed Placement
  • Placing down a new hamster bed no longer forces the hamster to sleep in it immediately unless the conditions are correct (i.e., time of day, config settings).
• Wandering Hamster Sitting
  • Hamsters linked to a bed will no longer automatically sit down when their owner logs out or changes dimensions, as long as the bed is still intact.

Fixed

• Hamsters Falling Into End Portals
  • Hamsters that wander into the exit End Portal will now bounce right back out, complete with particle and sound effects.
  • Prevents them from teleporting to the Overworld spawn coordinates and getting lost.
  • Added a toggle to the config to revert to standard vanilla behavior if desired.
• Hamster Yeet & Evilcraft Bug
  • Resolved an bug that prevented hamsters from being thrown on Forge and NeoForge dedicated servers, caused by environment annotations running on the server thread. Super niche little insect that slipped by because it doesn't exist on Fabric. You should be able to throw your hamsters in multiplayer again!
  • This also resolves a server startup crash when playing with EvilCraft, which attempts to instantiate the projectile to check its blood levels. Lol.
• Food Item Stacking
  • Resolved an issue on 1.21.1 where the configurable food items became unstackable in the inventory GUI after being split or spread.
  • Implemented a stable ComponentMap caching system to ensure GUI right-click dragging correctly identifies dynamic food stacks as equal.
• Sliced Cucumber Feeding
  • Resolved a bug where already-tamed hamsters would refuse to eat their taming food (e.g. Sliced Cucumber) to heal or breed.
• Projectile Accessories
  • Fixed a visual bug where a hamster's equipped armor and accessories would temporarily vanish while they were airborne during a throw.
• Server Performance
  • Resolved a few pathfinding and AI issues where tamed hamsters following the player would sometimes experience server-tick lag spikes. Usually you wouldn't notice these unless you had a lot of hamsters following you at once.
• Wander Mode Override
  • Resolved a bug where disabling Wander Mode in the global config wouldn't stop already-wandering hamsters from lingering around their beds.
• Cheese Item Texture
  • Finally fixed the 99% transparent pixel in the bottom left corner of the cheese item texture. I only recently realized what was causing it to look so strange. Lol
• Console Log Spam
  • Resolved an issue where players with internet disabled (or those playing in regions where GitHub is blocked) would receive a massive, screen-filling error stack trace in their console every 5 minutes when the mod silently checked for updates in the background. Background network failures are now politely logged as a single warning line.
  • Resolved an issue where the genetics engine would spam the server console with warnings when attempting to generate wild overlays for hamsters with extremely bright base coats (like Coconut).
• Sweet Potato Easter Egg
  • Renaming a hamster to "Sweet Potato" now correctly applies the easter egg texture without accidentally deleting the hamster's eyes, skin layer, and accessories. So that's good.
  • Resolved an issue where the effects would trigger immediately upon renaming a hamster via the GUI, before the screen was closed.
  • Resolved an issue where the affects would not trigger at all on 1.20.1 if a hamster was renamed via the GUI.
• Missing Vanilla Tags
  • The custom AHP Sunflower block is now properly registered under the vanilla #minecraft:flowers and #minecraft:tall_flowers tags. This resolves compatibility issues with mods like Alex's Mobs that rely on these tags to identify flowers in the world.
• Flashback Mod
  • Resolved a server crash that occurred when scrubbing through replay timelines using the Flashback mod, caused by missing NBT data on Hamster Beds.
  • Resolved a persistent desync issue where shoulder hamsters would disappear when scrubbing backwards or jumping to different points on the replay timeline. Future replays will hopefully be fixed via a periodic server-side data sync that runs once per second.
• File Parsing Crashes
  • Fixed a crash that occurred when reading corrupted .json cache files for the supporter perk system. It will now safely ignore the corrupted file and download a fresh copy from the internet.
• Guidebook Server Synchronization
  • Resolved an issue where the "Missing Guidebook" chat warning would trigger repeatedly across multiple game sessions when playing on a dedicated server due to a configuration synchronization flaw.
  • Fixed an issue where players were falsely led to believe they could locally disable Guidebook Auto-Delivery on dedicated servers. These settings now properly sync from the server to the client's config UI, reflecting the server's true authority over the book's delivery.
• Food Interactions
  • Fixed a bug where players could not toggle their hamster's sitting state if they were holding Hamster Food Mix or other food items.
• "Hampter" Custom Name
  • The "Use 'Hampter' as Default Name" config setting now properly reflects on the Jade HUD overlay and the Hamster Inventory screen.
• Cheek Pouch Allowed Items
  • Fixed an issue where all vanilla food items were forbidden in the Cheek Pouch on 1.20.1 due to a typo.
• Spawn Commands
  • Resolved an issue where AI-disabled hamsters generated by /ahp spawn_all_bases_3D would sometimes suffocate and die if they spawned inside each other. They are now completely invulnerable until they are tamed/woken up.
• Cheek Pouch Desync
  • Fixed an issue where a hamster's cheek pouches would visually deflate in heavily modded environments due to partial NBT syncing from mods like Jade.
• Guidebook Recovery Routing
  • The "Missing Guidebook" chat warning now correctly opens the root configuration menu so the recovery button is actually visible.

The Procedural Genetics Update

Hamsters now utilize a fully procedural and configurable genetics engine with 3,158 new wild variants, 2,285,046 potential breeding outcomes, recessive red eyes, 13 new advancements, and a guidebook update that explains everything. Added comprehensive breeding settings to balance obsessions with server tick speed (looking at you, Janet). Also many bugs were squashed, and hamsters learned to play tag and spit out gifts from their cheeks. Make sure you update Patchouli to the latest version or your game won't launch!

→ /ahp print genetics report ↓

  |                                                                                      
  |                      Adorable Hamster Pets Procedural Genetics Engine                
  |      --------------------------------------------------------------------------------
  |      Base Fur Palettes ................. | 45
  |      Base Fur Patterns ................. | x 1
  |      Potential Wild Overlay Types ...... | x 235 (26 Palettes x 9 Patterns + 1 blank)
  |      Potential Breeding Overlay Types .. | x 406 (45 Palettes x 9 Patterns + 1 blank)
  |      Potential Eye Color Types ......... | x 2
  |      Visually Distinct Wild Variants ... | = 3,231
  |        ↑ Filtered: Overlays must...
  |          - Be allowed (WHITE, LIGHT_GRAY, DARK_GRAY, CREAM) ← default: neutrals
  |          - Be brighter than base color
  |          - Be less saturated than base color
  |          - Not clash with the BLUE, LAVENDER color zones
  |      Total Possible After Breeding ..... | = 2,285,046
  |      Number of 3D Color Relationships .. | = 2,610,718,753,581
  |                                                                                                                 

Added

• Procedural Genetics & Texture System
  • Procedural Genetics Engine
    • Hamsters are no longer pre-defined, hardcoded variants. Every hamster now possesses a fully serialized HamsterGenome detailing its precise genetic makeup across six distinct traits.
    • This was accomplished by developing a 3D Hue/Saturation/Brightness (HSB) Cartesian color space. The mod uses this to mathematically map the exact color coordinates of every hamster variant into a three-dimensional neural network, which is dynamically used to calculate genetic relationships, mutations, overlay exclusion rules, and environment-spawning rules on the fly.
    • I got the idea for creating the textures programmatically like this because that's how I made the original textures in Photoshop— using various Gradient Maps applied to a single, grayscale texture. Then I realized Java code can do the same thing!
    • The total number of unique hamster types that spawn in the wild is now 3,231 by default, and the number of genetically inheritable hamster permutations from breeding is now over 2.2 Million.
    • Want to understand the math? Keep reading below— look for the "Advanced Spawning & Testing Commands" section. I have added all sorts of fancy commands and tools to walk you through the breeding system in a way that is (hopefully) easy to understand.
  • Dynamic Palette Swapping
    • Built an optimized, client-side dynamic texture generator. Instead of bloating your hard drive with over 2 million distinct PNG files, the mod dynamically recolors grayscale fur templates at runtime using custom genetic palette hex code data I designed based off my Photoshop workflow, then mixes them with hard-coded PNGs from the community.
    • I realized the original hamster variants were just gradient maps applied to a grayscale texture in Photoshop. So, naturally, I invested an unreasonable amount of effort rebuilding Photoshop's Gradient Map tool inside Java.
    • Does this save file space? Sort of, though tiny PNGs don't take up much space anyway. But it makes the system infinitely scalable. If I add just one new grayscale pattern or community-made texture in the future, the Java math will automatically multiply it across every single other variant in the game. For now, consider it an over-engineered proof of concept.
  • Community Hamster Textures
    • Developed a parallel pipeline that automatically scans, analyzes, and genetically categorizes static, community-made PNG textures directly from the mod's JAR file. These static textures are seamlessly integrated into the procedural breeding pool alongside my programmatic colors.
    • The rendering engine can automatically composite custom community textures into overlay masks. This means hamsters can spawn with community-made palettes serving as the color for their overlay spots and splotches!
    • Thanks to @jimcerberus, we have 18 brand-new base hamster variants spawning in the wild! (Including Cheesecake Mocha, Blue Fawn, Pearl Rose, Sable, and 14 more). You can see them all in-game using the new spawn commands (see below).
  • Expanded Overlays
    • Overlays are no longer just white.
    • Wild Overlays: Naturally spawning hamsters can now have overlays in any color that is closely related to White, Cream, or Gray, with a few configurable exceptions. To keep things looking natural, the default config ensures wild overlays are always brighter & less saturated than the base coat, Cream is disallowed on a Lavender or Blue base coat, and cave-spawned hamsters can only receive Gray overlays to help them blend in.
    • Breeding Overlays: A completely new secondary overlay layer, unlocked exclusively through breeding (45% chance when two first-generation wild hamsters breed). These are chosen based on the midpoint between the parents' base color in the 3D color-space coordinate system, with a bit of jitter so the baby won't always look the same when you breed two parents repeatedly, so the possibilities are nearly endless. These overlays will mathematically avoid copying the same shape/pattern as the wild overlay, to ensure they are not hidden/covered up by it.
• Breeding & Lifecycle Mechanics
  • Breeding Inheritance and Visualization Tool
    • Here's how it works: When breeding two hamsters together, the color for the baby (and its overlay colors) are chosen based on a connected line between the two parents in the 3D color-space coordinate system. This means babies will tend towards the mathematical center, but occasionally one parent's color traits will strongly dominate the outcome, mimicking real-world genetics and providing visual variety within a single hamster family even if you breed the same two parents together repeatedly.
    • Outcome Visualizer: You can right-click two hamsters inside the 3D variants layout (/ahp spawn_all_bases_3D) with the Hamster Tips guidebook to visualize the genetic probability distribution for their offspring via a cloud of Wax On particles. The particle spawning logic uses the exact same probability math that is used when creating babies, so it gives you a perfectly accurate representation of potential outcomes.
    • Config Settings and Real-time Controls
      • Genetic Variance: Adjusts how much a baby's base color can deviate from the exact center between its parents. Think of this as the "length" of the line between the parents.
      • Genetic Mutation Rate: Adjusts the random color scatter/mutations applied to babies. Think of this as the "thickness" of the line.
      • Simulated Offspring Per Second: Adjust the density of the 3D visualizer particle cloud. Each particle represents a potential baby.
      • Real-time Controls: While holding the guidebook, you can dynamically tweak the shape of the genetic probability cloud using the arrow keys: Left/Right Arrows adjust Genetic Variance; Up/Down Arrows adjust Genetic Mutation Rate.
      • Server and Client Sync: Since the particle visualizer is driven by the literal server-side breeding math, which is driven by the config for your server, and the changes you make with the arrow keys directly alter that config, the changes will take effect immediately for any future babies.
  • Recessive Eye Genetics
    • Hamsters now possess dominant (Black) and recessive (Red) eye genetics.
    • Red eyes do not exist in the wild. They are genetically tied to the "diluteness" (brightness/saturation) of the hamster's coat. A fully dilute hamster has up to a 50% chance of spawning with a recessive red eye gene. By selectively breeding highly dilute hamsters, players can uncover carriers (Br) and eventually breed Red-Eyed (rr) variants. Uses punnet squares.
  • Baby Growth Mechanics
    • You can now feed baby hamsters standard hamster food items to accelerate their growth.
    • To balance this with their natural pickiness, a new config option (Disable Baby Food Refusal) allows you to bypass their desire for dietary variety specifically for babies if you want. This is turned off by default, so to bypass their pickiness you'll need lots of Hamster Food Mix if you want to quickly grow them up.
    • Feeding baby hamsters visually and mechanically accelerates their growth in smooth, continuous increments, similar to vanilla horses. Their "extra big head" proportions scale dynamically as they grow.
  • Breeding Limitations
    • Added comprehensive config settings to manage hamster breeding for server owners who want to keep the population under control.
    • Added a global Enable Breeding toggle (on by default) to instantly shut down all romance.
    • Added a configurable Max Breeding Cycles limit per hamster to stop them from infinitely multiplying (off by default).
    • Added a Limit Breeding By Player toggle. (also off by default). Limits can be assigned per-player based on Minecraft days or Real Life days, or simply capped as a lifetime maximum limit. Includes feedback to explain what's happening when attempting to over-feed beyond the limit.
    • Added a /ahp reset_player_breeding_history command for server operators to reset their own breeding history.
    • Added a /ahp reset_hamster_breeding_history command for server operators to reset a specific hamster's timesBred quota to zero.
    • Added a convenient "Reset Breeding History" button in the Config screen that executes the command for the user (requires OP permissions).
  • Configurable Litter Size
    • Added to config sliders allowing you to set the minimum and maximum litter size when hamsters get into hanky-panky. The final size of the litter will be a random number between the min and max.
  • Breeder Whitelist
    • Added a config list allowing specific players to bypass the global breeding ban. In case your server needs a designated rodent baron.
  • Post-Breeding Animation
    • Hamsters will now crouch down and lovingly inspect their baby(s) after the litter is born, spawn heart particles, and make affectionate sounds shortly after successfully contributing to your growing population problem.
  • Wild Baby Configuration
    • Added Babies Spawn Wild setting. When enabled, babies are born feral and do not inherit their parent's ownership status, letting multiplayer groups decide who claims them.
    • When untamed, babies no longer flee from players, making them easier to manage.
  • Parent-Following
    • Babies will now randomly select a parent to follow until adulthood, instead of following their owner.
    • Wild baby hamsters will switch to following the player if their parent is currently mounted on the player's shoulder. They will automatically resume following the parent once it is dismounted.
    • If you want the baby to follow you instead, you must first tame it, then you can break its connection to the parent by right-clicking it with a Lure Item (Cheese by default).
    • Added a config toggle to disable the action bar message that warns you when a newly tamed baby hamster refuses to follow you because it's still attached to its parent.
  • Age Tracking
    • Hamsters now track their absolute lifetime age in ticks.
    • Wild hamsters spawn with a random age between 1 and 30 days.
    • Added /ahp set_age command to manually override a hamster's age (since older hamsters will start at 0 days old upon updating to this version of the mod). It accepts units (days, months, years) and provides autocomplete suggestions.
    • If you do not specify a target, it will automatically apply to the hamster you are currently looking at.
    • The Jade HUD overlay displays the hamster's age alongside its genetic data.
    • Added a new Display IRL Age config setting that dictates how fast the hamster ages. If true, their age progresses at 1/72nd the normal speed (matching the real-world 24-hour cycle).
• Performance Improvements
  • Significant Overall Improvements
    • Flattened the entire visual render layer stack (base coat, wild overlays, breeding overlays, skin, eyes, armor, and accessories) into a single, dynamically composited texture at runtime.
    • This completely eliminates all secondary GeoRenderLayer passes. Every hamster, regardless of its complex genetics or equipped items, now costs exactly one draw call to render (previously it was anywhere from 2 to 8!), resulting in a massive performance boost. Especially noticeable when numerous hamsters are on screen at the same time.
  • Bare-Bones Ultra Performance Mode
    • Added a new Performance Mode toggle in the config (and an assignable keybind) designed specifically for viewing absurd numbers of hamsters simultaneously without melting your GPU.
    • When enabled, it bypasses the dynamic texture engine entirely (falling back to a single flat texture) and hides almost all the model's geometry.
    • The hamsters essentially become grayscale cubes, stripping away nearly all matrix-calculation overhead.
    • The Jade HUD overlay will still display their exact genetic information, because the server never forgets what they are actually supposed to look like.
• New Config Settings
  • Wild Overlay Configurability
    • Added new Allowed Wild Overlay Zones list to the World Gen & Loot config. This allows server owners/modpack makers to explicitly control which color zones the genetics engine is allowed to use when picking an overlay for a naturally spawning hamster. Defaults to natural colors (WHITE, LIGHT_GRAY, DARK_GRAY, and CREAM).
    • Added new Restricted Base Colors and Clashing Overlay Colors lists. By default, these prevent CREAM and DARK_GRAY wild overlays from spawning on top of BLUE and LAVENDER base coats, as these color combinations tend to look a bit strange visually.
    • Added new Enforce Brighter Overlays and Enforce Muted Overlays toggles. Allows players to disable the overlay filtering that prevents saturated colors (like Cream) from spawning on muted bases (like Black) and darker colors from being used as overlays on top of lighter bases.
    • Modifying the overlay settings can dramatically change the number of possible combinations for wild hamsters (3,231 by default).
  • Red Eye Config Toggle
    • Don't like the red eye hamsters? You can visually disable that for your own client via a new config toggle, which makes them appear to have black eyes.
  • Friendly Fire Config Toggle
    • Added Prevent Owner Friendly Fire to the Core config toggles.
    • When enabled, players can no longer accidentally damage their own tamed hamsters. Disabled by default to remain vanilla-friendly.
    • In the next update (hopefully), this setting will be tied to a new item: the Acorn Ring. I also plan to integrate with the Trinkets mod so you can use a trinket slot for it.
  • Configurable Cuisine
    • You can now configure the nutrition and saturation values for all food items added by the mod (Cucumbers, Green Beans, Food Mix).
    • Changed nutrition/saturation values are dynamically reflected in AppleSkin's "on-eat" HUD preview. *Unfortunately due to major API changes between MC versions, this only works on 1.21.1.
  • Max Mounted Hamsters Config
    • Added a configuration slider under 'Shoulder Hamster Settings > Core Settings' allowing players to limit the maximum number of hamsters that can be mounted simultaneously (1 to 3).
• Gameplay Mechanics & Interactions
  • Tag Mini-Game
    • Hamsters can now initiate a playful game of tag. If you maintain eye contact with a hamster for a few seconds, it will squeak and excitedly run away.
    • The Chase: The hamster will flee if you get too close and stop to playfully taunt you if you fall too far behind.
    • Payoff: Successfully "catching" (right-clicking) the hamster before it gets bored ends the game triggers a celebration. The hamster will then spit out a random item from its cheek pouches as a gift (pulling from the configurable cheek pouch loot lists).
    • Stranger Danger: By default, you can play tag with wild hamsters and hamsters owned by other players. (Can be disabled in config).
    • Configurable Limits and Rewards
      • Added configs to control how often they want to play, the cooldown between games, and an anti-abuse cap on how many times a single player can play the game per in-game day (so they can't farm rewards).
      • Added configs to control rewards: By default, hamsters will randomly pick an item from their configurable "Cheek Pouch Loot" list (the list of potential items a wild hamster might spawn with). The item does not have to be in the hamster's cheek pouch for it to give it as a gift.
      • That can be disabled, in which case the hamster will choose the gift from a separate "Custom Tag Rewards" list in the config, which means you can make your hamster give you a diamond or any modded item (or whatever you want) when you catch it after a game of tag. Only server moderators can modify this of course.
  • Dynamic Gaze
    • Hamsters will now sustain eye contact with you indefinitely, provided you are nearby and continue looking back at them, and of course as long as they don't start a game of tag.
  • Hamster Yeet Overhaul
    • Thrown hamsters are now officially registered as ProjectileEntity instances while airborne. This provides automatic, out-of-the-box compatibility with external mods that use targets or hoops (such as the Tin Hoops in Caverns and Chasms).
    • Thrown hamsters now experience dynamic physics upon impact. They will ricochet backward off of walls and entities, or skip forward when hitting floors and ceilings.
    • Thrown hamsters now dynamically query and broadcast the native sound of the block or entity they strike (including modded blocks/entities).
    • Impact physics are magnified when hitting Slime blocks, and completely absorbed by Honey blocks.
    • Added a new config toggle (true by default) allowing thrown hamsters to damage their owner. Throwing your own rodent straight up in the air will now result in a realistic, concussive reunion on the way back down.
  • Precision Tree Heists
    • Right-clicking Oak Leaves with a lure item (Cheese) while a hamster is on your shoulder will now initiate a "Precision Tree Heist."
    • This sets that specific leaf block as the guaranteed exit point for the hamster.
    • While a precision heist is active, right-clicking in the air with the lure item will set the hamster's exit direction to match the direction you are currently looking.
    • Why? This allows you to precisely control the exact block and angle by which your hamster will exit the tree, which makes for much more predictable recording sessions.
  • Moonwalking Easter Egg
    • Name your hamster "Michael Jackson" or "Steve Irwin" and it will rotate backwards and remain that way until you change the name again.
  • Expanded Default Diet
    • Hamsters can now eat seeds from almost any mod out-of-the-box. Added a robust union tag to the default config that automatically syncs with #c:seeds and #forge:seeds to ensure compatibility across all versions and mod loaders.
• Failsafes & Rescues
  • Teleport Rescue Protocol
    • Overhauled how hamsters follow you across vast distances or dimensions (e.g., when using Waystones).
    • Instead of relying on their tiny legs and pathfinding AI to catch up, your player code will now safely scoop up any actively following hamsters (and their babies if the babies are following them), hold them in a little NBT pocket while the world loads, and drop them at your new location 0.75 seconds later.
  • Void Rescue Protocol
    • If a player falls into the void and dies with hamsters on their shoulders, the hamsters will no longer spawn in the void and immediately perish. The system will safely teleport them back to their linked bed. If they do not have a linked bed, they will be sent to the player's personal respawn point or the world spawn.
• UI, HUD, & Audio
  • Jade Integration
    • Added comprehensive Jade overlay integration that reveals a hamster's exact genetic makeup (base coat, wild overlay, breeding overlay, eye genotype, etc.) when you look at them.
    • Enabled without needing to turn on debug mode to help with breeding.
    • Fully customizable. Each setting comes with its own toggle, and you can decide which ones show up when you sneak to keep the Jade HUD de-cluttered.
  • GUI Renaming System
    • Players can now rename their hamsters directly from the Hamster Inventory screen.
    • Features dynamic down-scaling to ensure long names always fit perfectly within the UI constraints.
    • An interactive pencil icon and underline display when hovering/typing.
    • New Config Options (UI & Quality of Life > Hamster Renaming)
      • Enable GUI Renaming: Master toggle for the feature.
      • Consume Name Tag: Forces players to sacrifice a Name Tag from their inventory (or the hamster's cheeks) to finalize the rename.
      • Pencil Icon Placement: Allows swapping the icon to the left or right of the text for those who read in different directions.
  • New Audio & Visuals
    • Added a brand new anim_hamster_cheek_unload animation used for gifting items, complete with item and spit particle effects.
    • Added 4 new scratching sound variations for the cleaning animation, and switched to keyframes for the SFX to make it less repetitive and more realistic. This also has the side effect of muting the sound effect if the hamster is not on screen, and thus not being rendered. This means you will no longer hear nearby hamsters cleaning unless you can also see them.
    • Added dynamic item sounds (clink, squish, thud, etc.) to the new gifting sequence.
• Commands & Admin Tools
  • Advanced Spawning & Testing Commands
    • Added /ahp spawn hamster <basePalette> <wildPattern> <wildPalette> <breedPattern> <breedPalette> <eyes>. This command features a custom Brigadier auto-complete engine that suggests exact, human-readable palette and pattern names as you type, allowing you to easily test specific genetic combinations.
    • Added /ahp spawn_all_bases_2D. Systematically lines up every single hamster color base in the game (including custom community additions), sorted cleanly into rows by their dynamically determined, mathematical color zone.
    • Added /ahp spawn_all_bases_3D. Spawns the hamsters hovering in a physical 3D "cylinder" representing their Hue/Saturation/Brightness coordinates. This is useful for the Breeding Inheritance and Visualization Tool (see below).
      • Hue = the degree of the circle (0-360)
      • Saturation = the radius of the circle (more saturated colors are closer to the edge)
      • Brightness = the height of the cylinder (brighter hamsters are closer to the top)
      • By default, each /ahp spawn_all_bases... command spawns just the 45 base colors, but each one comes with 3 optional arguments to change the number of hamsters spawned:
      1. [with_wild_overlays] Displays all 3,231 hamster variants that can spawn naturally in the wild.
      2. [with_sample_breeding_overlays] Displays genetic combinations of every wild hamster but adds in a small sample of three breeding overlays (Tortoise Shell, Silver, and Rust). Due to the triple-multiplication math involved, this heavily increases the total number of hamsters spawned (from 3,231 up to 9,693) creating a much bigger display.
      3. [author] only uses color palletes from a certain author (e.g., jimcerberus or default).
    • Added /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD. Exactly what it sounds like. Don't run it unless you have a super-flat world, a fire extinguisher for your PC, and a lot of patience. Note that every time I have run this command, my server tick speed never quite returned to baseline— even after deleting all the hamsters that were spawned using /kill @e[type=!player].
    • Added /ahp print_genetics_report command, allowing server operators to recalculate and view the current 3D color-space math of the genetics engine at runtime. Useful because it dynamically updates its readout based on your exact AhpWorldGenConfig wild overlay settings, so you can see how your changes are affecting the total possible variant numbers without having to spawn them all.
  • Tree Heist History Command
    • Added /ahp reset_tree_economy for quick clearing of tree depletion memory without needing to open the config screen.
• Advancements
  • Advancement: Carat Confusion
    • Triggers when a hamster leads you to Gold Ore instead of Diamond.
  • Advancement: Load-Bearing Human
    • Triggers when you mount 3 hamsters simultaneously (Right, Left, Head).
  • Genetic Progression Advancements
    • Added "The Collector" advancement path tracking unique wild variants tamed (up to dynamic maximum based on configuration limits).
    • Added "The Breeder" advancement path tracking unique bred combinations (up to 1,000,000).
    • Added a conditional advancement "Seeing Red" for successfully breeding the recessive eye trait. Does not trigger if red eyes have been turned off in the config.
    • Implemented high-performance, non-bloating NBT storage using IntArrays to track thousands of HamsterGenome hashes without lagging the player entity.
• Guidebook Enhancements
  • Guidebook Delivery Fallback
    • Added a new configuration option that acts as a fallback for modpacks that disable auto-guidebook delivery on login.
    • If enabled (default), players will automatically be given the Hamster Tips guidebook and receive a chat prompt the very first time they spot a wild hamster from <=10 blocks away.
    • Targeting calculation includes wiggle room to ensure the event triggers even if the player's crosshair isn't perfectly on the hamster's hit box.
    • Only triggers once, and only if the player has never yet received the guidebook (regardless of current inventory status).
  • Lectern Reading
    • Added code for placing the Hamster Tips guide book into a lectern and an event handler so you can read it. You can now display your rodent knowledge in your base or wherever.
  • Hamster Tips Guidebook Improvements
    • The Hamster Tips guidebook now uses a custom string processor to pull live data directly into the text, so I can do things like automatically displaying the exact number of mathematically possible wild variants or the name of your dynamically configured Lure Item instead of hardcoding "Cheese".
    • Updated the "Regional Rodents" entry to explain the new biome-adaptive color logic, Wild Overlays and Jade integration.
    • Added a new "Breeding" entry in The Hamster Life chapter detailing the genetic mechanics, recessive red eyes, and feral youth mechanics.
    • Added a new "Admin Commands" entry in The Kitchen Drawer chapter detailing the various new (and old) commands the mod has to offer since some of them (especially the new ones) are super useful.
• Pixie-Dust Crown for Supporters
  • Added a dynamic, spinning, bobbing particle crown that renders above the heads of mod supporters. Uses a custom Pixie Dust particle system featuring a dense, short-lived, shimmering effect.
  • Emits a subtle sparkling sound and includes 5 different themes (Gold, Crimson, Lavender, Ice, Emerald) by manipulating the HSB color values of a single grayscale texture at runtime.
  • Automatically hides in first-person view to prevent visual obstruction.
  • Powered by a remote manager that pulls configuration data asynchronously from GitHub and caches it for offline use. You will need to briefly connect to the Internet while launching Minecraft at least once to verify your ownership of the Crown. After that you can play offline and still see it!
  • Configurable Aesthetics
    • Added a new Supporter Perks config group.
    • Added a global toggle to disable rendering of all crowns if you hate fun.
    • Added a global toggle to disable sound effects of all crowns.
    • Added a local toggle to allow rendering your own crown in first-person mode if you want to both obstruct your view and thrill yourself.
    • Added sliders for sound volume, particle count, crown radius, crown height, crown thickness, and vertical offset.
    • Added a new "Toggle Supporter Crown" keybind allowing users to show/hide their own crown from both themselves and the rest of the server. A single press cycles the crown to the next available color theme, while a double-tap toggles the crown's visibility.
    • Supporters can pick their own crown color. Your preference syncs instantly to all other players looking at you utilizing DataTracker networking.

Changed

• Location-Centric Spawning Overhaul
  • Completely rewrote the world generation spawning logic. Instead of mapping individual hamster colors to biomes, biomes are now grouped into 9 "Spawning Environments" (e.g., Icy, Sandy, Forest, etc.)
  • Each environment rolls against weighted hamster color groups. This ensures that whether a texture is procedurally generated or community-made, it mathematically evaluates its own color and automatically spawns in a biologically appropriate location.
• Diamond Sniffing Visuals & Audio
  • Added directional animations to indicate whether a buried diamond ore is above or below the hamster when it's sniffing for one and the path is obstructed.
  • Added a dynamic "quick bounce" animation that intermittently triggers when the diamond ore is hidden somewhere above the hamster.
  • Added a new head-shake sound effect that plays when the hamster is sniffing for ore and gets confused.
• Sweet Potato Easter Egg
  • The "Sweet Potato" Easter egg now applies a unique custom texture to the hamster, thanks to @jimcerberus!
  • Renaming a hamster "Sweet Potato" hides its normal genetics (base coat, overlays, and eye color) without permanently deleting them.
  • Sweet Potato hamsters can still breed, and their offspring will genetically inherit traits mathematically blended from the sweet potato's unique color palette, but they do not spawn in the wild.
• Jade HUD Config Settings
  • Added a new "Jade Overlay Settings" section to the config under "UI & Quality of Life".
  • Displays complex genetic info (Age, Base Coat, Wild Overlay, Breeding Overlay, Eye Color) by default.
  • Added a "Require Sneaking" toggle (disabled by default) allowing you to hide the genetic overlay unless you are actively sneaking.
  • Added individual toggles for every piece of my custom genetic info shown in the Jade overlay.
  • Added additional toggles for selectively disabling default Jade info lines (Name, Health, Growth Time, Owner, Inventory) specifically for hamsters without impacting other entities, and a toggle to link their visibility to the player's sneaking state, allowing you to completely customize the HUD to your liking.
  • Built a smart-formatting engine so that community texture IDs are automatically converted into localized, human-readable titles on the HUD (e.g., cheesecake_mocha.png -> "Cheesecake Mocha").
• Statue Performance & AI Toggling
  • Hamsters spawned with their AI disabled will now completely freeze their animation playback and no longer emit ambient idle squeaks. This attempts to reduce client-side rendering lag when hundreds of thousands of hamsters are on screen for testing, but Java itself struggles with that many cubes on screen, so it's still laggy if you try to look at 2 million+ hamsters simultaneously.
  • You can now tame an AI-disabled hamster, which will instantly "wake it up" and turn it into a real, fully functional hamster.
  • Added an Allow Taming to Re-Enable AI toggle to the config in case you're a server owner who wants to sell specific hamster breeds in a shop. If you have OP permissions on your server, you can turn this off to prevent players from taming and "waking up" frozen hamsters, allowing them to be used as shop displays or decorative statues.
• Mod Page/README
  • The README was functioning as a marketing poster, a technical manual, a credits roll, and a tutorial. That is too many jobs for one file.
  • It was getting too large, so I have reorganized it, reworded it, and split a few things off into other easily accessible files, so the README only has one job now.
• Mount Priority
  • Changed default config value to HEAD_FIRST.
• Action Bar Config Toggles
  • Grouped all action bar message toggles (Shoulder Dismount, Tree Heist Start, Bed Break, Tamed Baby Warning, and Display Duration) into a new "Action Bar Messages" sub-category under "UI & Quality of Life" for easier access.
• Guidebook
  • Updated Hamster Bed entry to explicitly mention the Totem of Undying requirement for respawning.
• Guidebook Effects
  • If you obtain the Hamster Tips guidebook while viewing a chest or crafting screen, the "rediscovered" visual and audio effects will now be postponed until you close the screen, ensuring the effects do not play while you're looking at your inventory.
  • If you keep the screen open for longer than 5 seconds after obtaining the book, the effects are silently cancelled.
• Cucumber Rebalance
  • Sliced Cucumbers are no longer inexplicably nutritious. Their default food value has been dropped from 2 hearts to 0.5 hearts to match items like Dried Kelp.
• Hamster Hitbox Adjustment
  • Shrunk the physical hitbox of hamsters by 15% to more accurately match their actual visual model size.
  • Note: Because the bounding box is now smaller, you will need to aim slightly more accurately when trying to interact with a hamster.
• Patchouli Version
  • Updated the internal guidebook generation logic to accommodate API breaking changes introduced in Patchouli version 1.21.1-93.
  • You must update Patchouli to the latest version or the game will not launch.
• Shoulder Animation Configs
  • Replaced the single Forced Animation State setting with three distinct settings. You can now independently force the Head, Left Shoulder, and Right Shoulder hamsters into specific animation loops (when dynamic animations are disabled).
• Tree Heist Exits
  • Hamsters will now perform a small outward jump, launching themselves away from the tree upon successfully completing a Tree Heist.
• Breeding Cooldown Config
  • The config setting for breeding cooldown has been changed from Ticks to Seconds to make it significantly easier to manage with the slider.

Fixed

• Config Live Changes
  • Fixed an issue where changing settings in the World Gen & Loot config (such as wild bush or hamster spawning settings) required a full game restart to take effect. Saving changes to any config now recalibrates the mod's logic caches on both the client and the server.
• Visual Rotation Glitch
  • Attempted to fix an issue where using teleportation mods (like Waystones) or interrupting animations could cause the hamster's model to become permanently rotated backwards or upside down on the client side.
  • I can't be 100% certain about this fix yet, because no one has been able to figure out exactly what causes it and I can't re-create it myself, so let me know if you run into it.
• Hamster Stretching with Shaders
  • Fixed a visual bug where hamsters would stretch to extreme sizes during multiplayer server lag or when pausing the game.
• Dismount Bug
  • Fixed an issue where holding down the Sneak key for more than a second would cause the OS's auto-key-repeat feature to spam the game with inputs, dismounting all of your shoulder hamsters rapidly.
  • You can now safely hold Sneak without losing your friends.
  • This bug has existed ever since the double-tap setting was added, but I hadn't found it because I usually play with Sneak set to "Toggle" (which means I have no reason to hold it down for extended periods).
• Memory Optimization
  • Implemented pre-caching for texture identifiers and simplified rotation math in the render loop to eliminate extra memory objects being generated every frame.
• Spanish Localization
  • Some strings in the Hamster Tips guidebook were still outdated (i.e., the Accessories and Sunflower pages).
• Malformed Recipe
  • The sliced_cucumber_from_cutting_board.json recipe for compatibility with Farmers Delight failed to load on 1.20.1 due to a typo.
• Acorn Inflation
  • Fixed a decimal point error where Oak Leaves dropped Acorns at a 5% rate instead of the intended 0.5% (now it correctly matches vanilla Apple rarity).
• Guidebook Effects
  • Fixed an issue where moving the Hamster Tips guidebook around in your own inventory would sometimes re-trigger the "rediscovered" sound and particle effects.
  • Added a 30-second grace period to the guidebook tracking system. Prevents the effects from spamming if you move it between inventories, or drop it and pick it back up.
• Pink Petals Bug (1.20.1 only)
  • Fixed an issue where Pink Petals would visually apply to all three locations simultaneously when first equipping them or reloading a world.
• Hamster Bed Linking
  • Reduced the maximum stack size of Hamster Beds to 1. Not only does this feel like the way it always should have been, it resolves an issue where holding a stack of beds and right-clicking a hamster would link the entire stack simultaneously.
• Invisible Hamster Glitches
  • Solved a vanilla Minecraft issue where hamsters (and other pets) get left behind in unloaded chunks because their AI stops ticking before they can teleport.
  • Fixed a related bug where teleporting hamsters would sometimes successfully arrive but remain completely invisible to the client until you relogged. The new Teleport Rescue Protocol bypasses these vanilla quirks entirely.
  • Overhauled shoulder-hamster data synchronization to prevent them from becoming invisible upon player respawn if they were configured to respawn with the player when the player fell into the void.
• Ghost Bed Crash
  • Fixed a server crash that occurred when a hamster's linked bed was destroyed while the hamster was sleeping or unloaded. Hamsters will now detect the missing bed, cancel their sleep effects, and unlink themselves to prevent future issues.
• Bed State
  • Fixed an issue where chunk load order could occasionally cause a sleeping hamster's bed to visually revert to an "unoccupied" state across server restarts.
• Shoulder Hamster Physics
  • Capped the maximum vertical offset in the shoulder hamster physics simulation. This prevents hamsters from visually floating too far off the player's shoulders during long, extreme falls.
  • This was mostly an issue with resource packs that add cool player animations to the arms. The shoulder hamsters are locked to the arms of the player, so when the arms go out to the sides during a fall, the shoulder hamsters would cross over the midpoint of the head. This doesn't fix the issue 100% (I'm not sure if that's even possible with pretty player animations) but makes it a bit less obvious.
• Shoulder Cleaning Loop
  • Fixed a bug where a hamster mounted to the player's shoulder mid-cleaning would get permanently stuck in the cleaning animation when it was supposed to be sitting while on the shoulder.
• Jade Debug Overlay
  • Fixed an issue where the Jade debug toggle book-interaction failed to update the client config on dedicated servers.
• Non-Dynamic Taming Food
  • Fixed a bug where wild hamsters would still flee from players attempting to tame them using anything other than Sliced Cucumber. Now correctly uses the configurable "Taming Foods" from the config.
• Suicidal Hamsters
  • Hamsters will no longer choose to run through lava or fire when cornered and fleeing from a player. They will now properly recognize these hazards as completely impassable terrain.
• Immersive Engineering Compatibility
  • Fixed a data formatting error in the Garden Cloche recipes for cucumbers and green beans that caused the game to crash upon world creation or loading. (Thanks to @CasualAnimalEnjoyer for the fix!)

The Procedural Genetics Update

Hamsters now utilize a fully procedural and configurable genetics engine with 3,158 new wild variants, 2,285,046 potential breeding outcomes, recessive red eyes, 13 new advancements, and a guidebook update that explains everything. Added comprehensive breeding settings to balance obsessions with server tick speed (looking at you, Janet). Also many bugs were squashed, and hamsters learned to play tag and spit out gifts from their cheeks. Make sure you update Patchouli to the latest version or your game won't launch!

→ /ahp print genetics report ↓

  |                                                                                      
  |                      Adorable Hamster Pets Procedural Genetics Engine                
  |      --------------------------------------------------------------------------------
  |      Base Fur Palettes ................. | 45
  |      Base Fur Patterns ................. | x 1
  |      Potential Wild Overlay Types ...... | x 235 (26 Palettes x 9 Patterns + 1 blank)
  |      Potential Breeding Overlay Types .. | x 406 (45 Palettes x 9 Patterns + 1 blank)
  |      Potential Eye Color Types ......... | x 2
  |      Visually Distinct Wild Variants ... | = 3,231
  |        ↑ Filtered: Overlays must...
  |          - Be allowed (WHITE, LIGHT_GRAY, DARK_GRAY, CREAM) ← default: neutrals
  |          - Be brighter than base color
  |          - Be less saturated than base color
  |          - Not clash with the BLUE, LAVENDER color zones
  |      Total Possible After Breeding ..... | = 2,285,046
  |      Number of 3D Color Relationships .. | = 2,610,718,753,581
  |                                                                                                                 

Added

• Procedural Genetics & Texture System
  • Procedural Genetics Engine
    • Hamsters are no longer pre-defined, hardcoded variants. Every hamster now possesses a fully serialized HamsterGenome detailing its precise genetic makeup across six distinct traits.
    • This was accomplished by developing a 3D Hue/Saturation/Brightness (HSB) Cartesian color space. The mod uses this to mathematically map the exact color coordinates of every hamster variant into a three-dimensional neural network, which is dynamically used to calculate genetic relationships, mutations, overlay exclusion rules, and environment-spawning rules on the fly.
    • I got the idea for creating the textures programmatically like this because that's how I made the original textures in Photoshop— using various Gradient Maps applied to a single, grayscale texture. Then I realized Java code can do the same thing!
    • The total number of unique hamster types that spawn in the wild is now 3,231 by default, and the number of genetically inheritable hamster permutations from breeding is now over 2.2 Million.
    • Want to understand the math? Keep reading below— look for the "Advanced Spawning & Testing Commands" section. I have added all sorts of fancy commands and tools to walk you through the breeding system in a way that is (hopefully) easy to understand.
  • Dynamic Palette Swapping
    • Built an optimized, client-side dynamic texture generator. Instead of bloating your hard drive with over 2 million distinct PNG files, the mod dynamically recolors grayscale fur templates at runtime using custom genetic palette hex code data I designed based off my Photoshop workflow, then mixes them with hard-coded PNGs from the community.
    • I realized the original hamster variants were just gradient maps applied to a grayscale texture in Photoshop. So, naturally, I invested an unreasonable amount of effort rebuilding Photoshop's Gradient Map tool inside Java.
    • Does this save file space? Sort of, though tiny PNGs don't take up much space anyway. But it makes the system infinitely scalable. If I add just one new grayscale pattern or community-made texture in the future, the Java math will automatically multiply it across every single other variant in the game. For now, consider it an over-engineered proof of concept.
  • Community Hamster Textures
    • Developed a parallel pipeline that automatically scans, analyzes, and genetically categorizes static, community-made PNG textures directly from the mod's JAR file. These static textures are seamlessly integrated into the procedural breeding pool alongside my programmatic colors.
    • The rendering engine can automatically composite custom community textures into overlay masks. This means hamsters can spawn with community-made palettes serving as the color for their overlay spots and splotches!
    • Thanks to @jimcerberus, we have 18 brand-new base hamster variants spawning in the wild! (Including Cheesecake Mocha, Blue Fawn, Pearl Rose, Sable, and 14 more). You can see them all in-game using the new spawn commands (see below).
  • Expanded Overlays
    • Overlays are no longer just white.
    • Wild Overlays: Naturally spawning hamsters can now have overlays in any color that is closely related to White, Cream, or Gray, with a few configurable exceptions. To keep things looking natural, the default config ensures wild overlays are always brighter & less saturated than the base coat, Cream is disallowed on a Lavender or Blue base coat, and cave-spawned hamsters can only receive Gray overlays to help them blend in.
    • Breeding Overlays: A completely new secondary overlay layer, unlocked exclusively through breeding (45% chance when two first-generation wild hamsters breed). These are chosen based on the midpoint between the parents' base color in the 3D color-space coordinate system, with a bit of jitter so the baby won't always look the same when you breed two parents repeatedly, so the possibilities are nearly endless. These overlays will mathematically avoid copying the same shape/pattern as the wild overlay, to ensure they are not hidden/covered up by it.
• Breeding & Lifecycle Mechanics
  • Breeding Inheritance and Visualization Tool
    • Here's how it works: When breeding two hamsters together, the color for the baby (and its overlay colors) are chosen based on a connected line between the two parents in the 3D color-space coordinate system. This means babies will tend towards the mathematical center, but occasionally one parent's color traits will strongly dominate the outcome, mimicking real-world genetics and providing visual variety within a single hamster family even if you breed the same two parents together repeatedly.
    • Outcome Visualizer: You can right-click two hamsters inside the 3D variants layout (/ahp spawn_all_bases_3D) with the Hamster Tips guidebook to visualize the genetic probability distribution for their offspring via a cloud of Wax On particles. The particle spawning logic uses the exact same probability math that is used when creating babies, so it gives you a perfectly accurate representation of potential outcomes.
    • Config Settings and Real-time Controls
      • Genetic Variance: Adjusts how much a baby's base color can deviate from the exact center between its parents. Think of this as the "length" of the line between the parents.
      • Genetic Mutation Rate: Adjusts the random color scatter/mutations applied to babies. Think of this as the "thickness" of the line.
      • Simulated Offspring Per Second: Adjust the density of the 3D visualizer particle cloud. Each particle represents a potential baby.
      • Real-time Controls: While holding the guidebook, you can dynamically tweak the shape of the genetic probability cloud using the arrow keys: Left/Right Arrows adjust Genetic Variance; Up/Down Arrows adjust Genetic Mutation Rate.
      • Server and Client Sync: Since the particle visualizer is driven by the literal server-side breeding math, which is driven by the config for your server, and the changes you make with the arrow keys directly alter that config, the changes will take effect immediately for any future babies.
  • Recessive Eye Genetics
    • Hamsters now possess dominant (Black) and recessive (Red) eye genetics.
    • Red eyes do not exist in the wild. They are genetically tied to the "diluteness" (brightness/saturation) of the hamster's coat. A fully dilute hamster has up to a 50% chance of spawning with a recessive red eye gene. By selectively breeding highly dilute hamsters, players can uncover carriers (Br) and eventually breed Red-Eyed (rr) variants. Uses punnet squares.
  • Baby Growth Mechanics
    • You can now feed baby hamsters standard hamster food items to accelerate their growth.
    • To balance this with their natural pickiness, a new config option (Disable Baby Food Refusal) allows you to bypass their desire for dietary variety specifically for babies if you want. This is turned off by default, so to bypass their pickiness you'll need lots of Hamster Food Mix if you want to quickly grow them up.
    • Feeding baby hamsters visually and mechanically accelerates their growth in smooth, continuous increments, similar to vanilla horses. Their "extra big head" proportions scale dynamically as they grow.
  • Breeding Limitations
    • Added comprehensive config settings to manage hamster breeding for server owners who want to keep the population under control.
    • Added a global Enable Breeding toggle (on by default) to instantly shut down all romance.
    • Added a configurable Max Breeding Cycles limit per hamster to stop them from infinitely multiplying (off by default).
    • Added a Limit Breeding By Player toggle. (also off by default). Limits can be assigned per-player based on Minecraft days or Real Life days, or simply capped as a lifetime maximum limit. Includes feedback to explain what's happening when attempting to over-feed beyond the limit.
    • Added a /ahp reset_player_breeding_history command for server operators to reset their own breeding history.
    • Added a /ahp reset_hamster_breeding_history command for server operators to reset a specific hamster's timesBred quota to zero.
    • Added a convenient "Reset Breeding History" button in the Config screen that executes the command for the user (requires OP permissions).
  • Configurable Litter Size
    • Added to config sliders allowing you to set the minimum and maximum litter size when hamsters get into hanky-panky. The final size of the litter will be a random number between the min and max.
  • Breeder Whitelist
    • Added a config list allowing specific players to bypass the global breeding ban. In case your server needs a designated rodent baron.
  • Post-Breeding Animation
    • Hamsters will now crouch down and lovingly inspect their baby(s) after the litter is born, spawn heart particles, and make affectionate sounds shortly after successfully contributing to your growing population problem.
  • Wild Baby Configuration
    • Added Babies Spawn Wild setting. When enabled, babies are born feral and do not inherit their parent's ownership status, letting multiplayer groups decide who claims them.
    • When untamed, babies no longer flee from players, making them easier to manage.
  • Parent-Following
    • Babies will now randomly select a parent to follow until adulthood, instead of following their owner.
    • Wild baby hamsters will switch to following the player if their parent is currently mounted on the player's shoulder. They will automatically resume following the parent once it is dismounted.
    • If you want the baby to follow you instead, you must first tame it, then you can break its connection to the parent by right-clicking it with a Lure Item (Cheese by default).
    • Added a config toggle to disable the action bar message that warns you when a newly tamed baby hamster refuses to follow you because it's still attached to its parent.
  • Age Tracking
    • Hamsters now track their absolute lifetime age in ticks.
    • Wild hamsters spawn with a random age between 1 and 30 days.
    • Added /ahp set_age command to manually override a hamster's age (since older hamsters will start at 0 days old upon updating to this version of the mod). It accepts units (days, months, years) and provides autocomplete suggestions.
    • If you do not specify a target, it will automatically apply to the hamster you are currently looking at.
    • The Jade HUD overlay displays the hamster's age alongside its genetic data.
    • Added a new Display IRL Age config setting that dictates how fast the hamster ages. If true, their age progresses at 1/72nd the normal speed (matching the real-world 24-hour cycle).
• Performance Improvements
  • Significant Overall Improvements
    • Flattened the entire visual render layer stack (base coat, wild overlays, breeding overlays, skin, eyes, armor, and accessories) into a single, dynamically composited texture at runtime.
    • This completely eliminates all secondary GeoRenderLayer passes. Every hamster, regardless of its complex genetics or equipped items, now costs exactly one draw call to render (previously it was anywhere from 2 to 8!), resulting in a massive performance boost. Especially noticeable when numerous hamsters are on screen at the same time.
  • Bare-Bones Ultra Performance Mode
    • Added a new Performance Mode toggle in the config (and an assignable keybind) designed specifically for viewing absurd numbers of hamsters simultaneously without melting your GPU.
    • When enabled, it bypasses the dynamic texture engine entirely (falling back to a single flat texture) and hides almost all the model's geometry.
    • The hamsters essentially become grayscale cubes, stripping away nearly all matrix-calculation overhead.
    • The Jade HUD overlay will still display their exact genetic information, because the server never forgets what they are actually supposed to look like.
• New Config Settings
  • Wild Overlay Configurability
    • Added new Allowed Wild Overlay Zones list to the World Gen & Loot config. This allows server owners/modpack makers to explicitly control which color zones the genetics engine is allowed to use when picking an overlay for a naturally spawning hamster. Defaults to natural colors (WHITE, LIGHT_GRAY, DARK_GRAY, and CREAM).
    • Added new Restricted Base Colors and Clashing Overlay Colors lists. By default, these prevent CREAM and DARK_GRAY wild overlays from spawning on top of BLUE and LAVENDER base coats, as these color combinations tend to look a bit strange visually.
    • Added new Enforce Brighter Overlays and Enforce Muted Overlays toggles. Allows players to disable the overlay filtering that prevents saturated colors (like Cream) from spawning on muted bases (like Black) and darker colors from being used as overlays on top of lighter bases.
    • Modifying the overlay settings can dramatically change the number of possible combinations for wild hamsters (3,231 by default).
  • Red Eye Config Toggle
    • Don't like the red eye hamsters? You can visually disable that for your own client via a new config toggle, which makes them appear to have black eyes.
  • Friendly Fire Config Toggle
    • Added Prevent Owner Friendly Fire to the Core config toggles.
    • When enabled, players can no longer accidentally damage their own tamed hamsters. Disabled by default to remain vanilla-friendly.
    • In the next update (hopefully), this setting will be tied to a new item: the Acorn Ring. I also plan to integrate with the Trinkets mod so you can use a trinket slot for it.
  • Configurable Cuisine
    • You can now configure the nutrition and saturation values for all food items added by the mod (Cucumbers, Green Beans, Food Mix).
    • Changed nutrition/saturation values are dynamically reflected in AppleSkin's "on-eat" HUD preview. *Unfortunately due to major API changes between MC versions, this only works on 1.21.1.
  • Max Mounted Hamsters Config
    • Added a configuration slider under 'Shoulder Hamster Settings > Core Settings' allowing players to limit the maximum number of hamsters that can be mounted simultaneously (1 to 3).
• Gameplay Mechanics & Interactions
  • Tag Mini-Game
    • Hamsters can now initiate a playful game of tag. If you maintain eye contact with a hamster for a few seconds, it will squeak and excitedly run away.
    • The Chase: The hamster will flee if you get too close and stop to playfully taunt you if you fall too far behind.
    • Payoff: Successfully "catching" (right-clicking) the hamster before it gets bored ends the game triggers a celebration. The hamster will then spit out a random item from its cheek pouches as a gift (pulling from the configurable cheek pouch loot lists).
    • Stranger Danger: By default, you can play tag with wild hamsters and hamsters owned by other players. (Can be disabled in config).
    • Configurable Limits and Rewards
      • Added configs to control how often they want to play, the cooldown between games, and an anti-abuse cap on how many times a single player can play the game per in-game day (so they can't farm rewards).
      • Added configs to control rewards: By default, hamsters will randomly pick an item from their configurable "Cheek Pouch Loot" list (the list of potential items a wild hamster might spawn with). The item does not have to be in the hamster's cheek pouch for it to give it as a gift.
      • That can be disabled, in which case the hamster will choose the gift from a separate "Custom Tag Rewards" list in the config, which means you can make your hamster give you a diamond or any modded item (or whatever you want) when you catch it after a game of tag. Only server moderators can modify this of course.
  • Dynamic Gaze
    • Hamsters will now sustain eye contact with you indefinitely, provided you are nearby and continue looking back at them, and of course as long as they don't start a game of tag.
  • Hamster Yeet Overhaul
    • Thrown hamsters are now officially registered as ProjectileEntity instances while airborne. This provides automatic, out-of-the-box compatibility with external mods that use targets or hoops (such as the Tin Hoops in Caverns and Chasms).
    • Thrown hamsters now experience dynamic physics upon impact. They will ricochet backward off of walls and entities, or skip forward when hitting floors and ceilings.
    • Thrown hamsters now dynamically query and broadcast the native sound of the block or entity they strike (including modded blocks/entities).
    • Impact physics are magnified when hitting Slime blocks, and completely absorbed by Honey blocks.
    • Added a new config toggle (true by default) allowing thrown hamsters to damage their owner. Throwing your own rodent straight up in the air will now result in a realistic, concussive reunion on the way back down.
  • Precision Tree Heists
    • Right-clicking Oak Leaves with a lure item (Cheese) while a hamster is on your shoulder will now initiate a "Precision Tree Heist."
    • This sets that specific leaf block as the guaranteed exit point for the hamster.
    • While a precision heist is active, right-clicking in the air with the lure item will set the hamster's exit direction to match the direction you are currently looking.
    • Why? This allows you to precisely control the exact block and angle by which your hamster will exit the tree, which makes for much more predictable recording sessions.
  • Moonwalking Easter Egg
    • Name your hamster "Michael Jackson" or "Steve Irwin" and it will rotate backwards and remain that way until you change the name again.
  • Expanded Default Diet
    • Hamsters can now eat seeds from almost any mod out-of-the-box. Added a robust union tag to the default config that automatically syncs with #c:seeds and #forge:seeds to ensure compatibility across all versions and mod loaders.
• Failsafes & Rescues
  • Teleport Rescue Protocol
    • Overhauled how hamsters follow you across vast distances or dimensions (e.g., when using Waystones).
    • Instead of relying on their tiny legs and pathfinding AI to catch up, your player code will now safely scoop up any actively following hamsters (and their babies if the babies are following them), hold them in a little NBT pocket while the world loads, and drop them at your new location 0.75 seconds later.
  • Void Rescue Protocol
    • If a player falls into the void and dies with hamsters on their shoulders, the hamsters will no longer spawn in the void and immediately perish. The system will safely teleport them back to their linked bed. If they do not have a linked bed, they will be sent to the player's personal respawn point or the world spawn.
• UI, HUD, & Audio
  • Jade Integration
    • Added comprehensive Jade overlay integration that reveals a hamster's exact genetic makeup (base coat, wild overlay, breeding overlay, eye genotype, etc.) when you look at them.
    • Enabled without needing to turn on debug mode to help with breeding.
    • Fully customizable. Each setting comes with its own toggle, and you can decide which ones show up when you sneak to keep the Jade HUD de-cluttered.
  • GUI Renaming System
    • Players can now rename their hamsters directly from the Hamster Inventory screen.
    • Features dynamic down-scaling to ensure long names always fit perfectly within the UI constraints.
    • An interactive pencil icon and underline display when hovering/typing.
    • New Config Options (UI & Quality of Life > Hamster Renaming)
      • Enable GUI Renaming: Master toggle for the feature.
      • Consume Name Tag: Forces players to sacrifice a Name Tag from their inventory (or the hamster's cheeks) to finalize the rename.
      • Pencil Icon Placement: Allows swapping the icon to the left or right of the text for those who read in different directions.
  • New Audio & Visuals
    • Added a brand new anim_hamster_cheek_unload animation used for gifting items, complete with item and spit particle effects.
    • Added 4 new scratching sound variations for the cleaning animation, and switched to keyframes for the SFX to make it less repetitive and more realistic. This also has the side effect of muting the sound effect if the hamster is not on screen, and thus not being rendered. This means you will no longer hear nearby hamsters cleaning unless you can also see them.
    • Added dynamic item sounds (clink, squish, thud, etc.) to the new gifting sequence.
• Commands & Admin Tools
  • Advanced Spawning & Testing Commands
    • Added /ahp spawn hamster <basePalette> <wildPattern> <wildPalette> <breedPattern> <breedPalette> <eyes>. This command features a custom Brigadier auto-complete engine that suggests exact, human-readable palette and pattern names as you type, allowing you to easily test specific genetic combinations.
    • Added /ahp spawn_all_bases_2D. Systematically lines up every single hamster color base in the game (including custom community additions), sorted cleanly into rows by their dynamically determined, mathematical color zone.
    • Added /ahp spawn_all_bases_3D. Spawns the hamsters hovering in a physical 3D "cylinder" representing their Hue/Saturation/Brightness coordinates. This is useful for the Breeding Inheritance and Visualization Tool (see below).
      • Hue = the degree of the circle (0-360)
      • Saturation = the radius of the circle (more saturated colors are closer to the edge)
      • Brightness = the height of the cylinder (brighter hamsters are closer to the top)
      • By default, each /ahp spawn_all_bases... command spawns just the 45 base colors, but each one comes with 3 optional arguments to change the number of hamsters spawned:
      1. [with_wild_overlays] Displays all 3,231 hamster variants that can spawn naturally in the wild.
      2. [with_sample_breeding_overlays] Displays genetic combinations of every wild hamster but adds in a small sample of three breeding overlays (Tortoise Shell, Silver, and Rust). Due to the triple-multiplication math involved, this heavily increases the total number of hamsters spawned (from 3,231 up to 9,693) creating a much bigger display.
      3. [author] only uses color palletes from a certain author (e.g., jimcerberus or default).
    • Added /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD. Exactly what it sounds like. Don't run it unless you have a super-flat world, a fire extinguisher for your PC, and a lot of patience. Note that every time I have run this command, my server tick speed never quite returned to baseline— even after deleting all the hamsters that were spawned using /kill @e[type=!player].
    • Added /ahp print_genetics_report command, allowing server operators to recalculate and view the current 3D color-space math of the genetics engine at runtime. Useful because it dynamically updates its readout based on your exact AhpWorldGenConfig wild overlay settings, so you can see how your changes are affecting the total possible variant numbers without having to spawn them all.
  • Tree Heist History Command
    • Added /ahp reset_tree_economy for quick clearing of tree depletion memory without needing to open the config screen.
• Advancements
  • Advancement: Carat Confusion
    • Triggers when a hamster leads you to Gold Ore instead of Diamond.
  • Advancement: Load-Bearing Human
    • Triggers when you mount 3 hamsters simultaneously (Right, Left, Head).
  • Genetic Progression Advancements
    • Added "The Collector" advancement path tracking unique wild variants tamed (up to dynamic maximum based on configuration limits).
    • Added "The Breeder" advancement path tracking unique bred combinations (up to 1,000,000).
    • Added a conditional advancement "Seeing Red" for successfully breeding the recessive eye trait. Does not trigger if red eyes have been turned off in the config.
    • Implemented high-performance, non-bloating NBT storage using IntArrays to track thousands of HamsterGenome hashes without lagging the player entity.
• Guidebook Enhancements
  • Guidebook Delivery Fallback
    • Added a new configuration option that acts as a fallback for modpacks that disable auto-guidebook delivery on login.
    • If enabled (default), players will automatically be given the Hamster Tips guidebook and receive a chat prompt the very first time they spot a wild hamster from <=10 blocks away.
    • Targeting calculation includes wiggle room to ensure the event triggers even if the player's crosshair isn't perfectly on the hamster's hit box.
    • Only triggers once, and only if the player has never yet received the guidebook (regardless of current inventory status).
  • Lectern Reading
    • Added code for placing the Hamster Tips guide book into a lectern and an event handler so you can read it. You can now display your rodent knowledge in your base or wherever.
  • Hamster Tips Guidebook Improvements
    • The Hamster Tips guidebook now uses a custom string processor to pull live data directly into the text, so I can do things like automatically displaying the exact number of mathematically possible wild variants or the name of your dynamically configured Lure Item instead of hardcoding "Cheese".
    • Updated the "Regional Rodents" entry to explain the new biome-adaptive color logic, Wild Overlays and Jade integration.
    • Added a new "Breeding" entry in The Hamster Life chapter detailing the genetic mechanics, recessive red eyes, and feral youth mechanics.
    • Added a new "Admin Commands" entry in The Kitchen Drawer chapter detailing the various new (and old) commands the mod has to offer since some of them (especially the new ones) are super useful.
• Pixie-Dust Crown for Supporters
  • Added a dynamic, spinning, bobbing particle crown that renders above the heads of mod supporters. Uses a custom Pixie Dust particle system featuring a dense, short-lived, shimmering effect.
  • Emits a subtle sparkling sound and includes 5 different themes (Gold, Crimson, Lavender, Ice, Emerald) by manipulating the HSB color values of a single grayscale texture at runtime.
  • Automatically hides in first-person view to prevent visual obstruction.
  • Powered by a remote manager that pulls configuration data asynchronously from GitHub and caches it for offline use. You will need to briefly connect to the Internet while launching Minecraft at least once to verify your ownership of the Crown. After that you can play offline and still see it!
  • Configurable Aesthetics
    • Added a new Supporter Perks config group.
    • Added a global toggle to disable rendering of all crowns if you hate fun.
    • Added a global toggle to disable sound effects of all crowns.
    • Added a local toggle to allow rendering your own crown in first-person mode if you want to both obstruct your view and thrill yourself.
    • Added sliders for sound volume, particle count, crown radius, crown height, crown thickness, and vertical offset.
    • Added a new "Toggle Supporter Crown" keybind allowing users to show/hide their own crown from both themselves and the rest of the server. A single press cycles the crown to the next available color theme, while a double-tap toggles the crown's visibility.
    • Supporters can pick their own crown color. Your preference syncs instantly to all other players looking at you utilizing DataTracker networking.

Changed

• Location-Centric Spawning Overhaul
  • Completely rewrote the world generation spawning logic. Instead of mapping individual hamster colors to biomes, biomes are now grouped into 9 "Spawning Environments" (e.g., Icy, Sandy, Forest, etc.)
  • Each environment rolls against weighted hamster color groups. This ensures that whether a texture is procedurally generated or community-made, it mathematically evaluates its own color and automatically spawns in a biologically appropriate location.
• Diamond Sniffing Visuals & Audio
  • Added directional animations to indicate whether a buried diamond ore is above or below the hamster when it's sniffing for one and the path is obstructed.
  • Added a dynamic "quick bounce" animation that intermittently triggers when the diamond ore is hidden somewhere above the hamster.
  • Added a new head-shake sound effect that plays when the hamster is sniffing for ore and gets confused.
• Sweet Potato Easter Egg
  • The "Sweet Potato" Easter egg now applies a unique custom texture to the hamster, thanks to @jimcerberus!
  • Renaming a hamster "Sweet Potato" hides its normal genetics (base coat, overlays, and eye color) without permanently deleting them.
  • Sweet Potato hamsters can still breed, and their offspring will genetically inherit traits mathematically blended from the sweet potato's unique color palette, but they do not spawn in the wild.
• Jade HUD Config Settings
  • Added a new "Jade Overlay Settings" section to the config under "UI & Quality of Life".
  • Displays complex genetic info (Age, Base Coat, Wild Overlay, Breeding Overlay, Eye Color) by default.
  • Added a "Require Sneaking" toggle (disabled by default) allowing you to hide the genetic overlay unless you are actively sneaking.
  • Added individual toggles for every piece of my custom genetic info shown in the Jade overlay.
  • Added additional toggles for selectively disabling default Jade info lines (Name, Health, Growth Time, Owner, Inventory) specifically for hamsters without impacting other entities, and a toggle to link their visibility to the player's sneaking state, allowing you to completely customize the HUD to your liking.
  • Built a smart-formatting engine so that community texture IDs are automatically converted into localized, human-readable titles on the HUD (e.g., cheesecake_mocha.png -> "Cheesecake Mocha").
• Statue Performance & AI Toggling
  • Hamsters spawned with their AI disabled will now completely freeze their animation playback and no longer emit ambient idle squeaks. This attempts to reduce client-side rendering lag when hundreds of thousands of hamsters are on screen for testing, but Java itself struggles with that many cubes on screen, so it's still laggy if you try to look at 2 million+ hamsters simultaneously.
  • You can now tame an AI-disabled hamster, which will instantly "wake it up" and turn it into a real, fully functional hamster.
  • Added an Allow Taming to Re-Enable AI toggle to the config in case you're a server owner who wants to sell specific hamster breeds in a shop. If you have OP permissions on your server, you can turn this off to prevent players from taming and "waking up" frozen hamsters, allowing them to be used as shop displays or decorative statues.
• Mod Page/README
  • The README was functioning as a marketing poster, a technical manual, a credits roll, and a tutorial. That is too many jobs for one file.
  • It was getting too large, so I have reorganized it, reworded it, and split a few things off into other easily accessible files, so the README only has one job now.
• Mount Priority
  • Changed default config value to HEAD_FIRST.
• Action Bar Config Toggles
  • Grouped all action bar message toggles (Shoulder Dismount, Tree Heist Start, Bed Break, Tamed Baby Warning, and Display Duration) into a new "Action Bar Messages" sub-category under "UI & Quality of Life" for easier access.
• Guidebook
  • Updated Hamster Bed entry to explicitly mention the Totem of Undying requirement for respawning.
• Guidebook Effects
  • If you obtain the Hamster Tips guidebook while viewing a chest or crafting screen, the "rediscovered" visual and audio effects will now be postponed until you close the screen, ensuring the effects do not play while you're looking at your inventory.
  • If you keep the screen open for longer than 5 seconds after obtaining the book, the effects are silently cancelled.
• Cucumber Rebalance
  • Sliced Cucumbers are no longer inexplicably nutritious. Their default food value has been dropped from 2 hearts to 0.5 hearts to match items like Dried Kelp.
• Hamster Hitbox Adjustment
  • Shrunk the physical hitbox of hamsters by 15% to more accurately match their actual visual model size.
  • Note: Because the bounding box is now smaller, you will need to aim slightly more accurately when trying to interact with a hamster.
• Patchouli Version
  • Updated the internal guidebook generation logic to accommodate API breaking changes introduced in Patchouli version 1.21.1-93.
  • You must update Patchouli to the latest version or the game will not launch.
• Shoulder Animation Configs
  • Replaced the single Forced Animation State setting with three distinct settings. You can now independently force the Head, Left Shoulder, and Right Shoulder hamsters into specific animation loops (when dynamic animations are disabled).
• Tree Heist Exits
  • Hamsters will now perform a small outward jump, launching themselves away from the tree upon successfully completing a Tree Heist.
• Breeding Cooldown Config
  • The config setting for breeding cooldown has been changed from Ticks to Seconds to make it significantly easier to manage with the slider.

Fixed

• Config Live Changes
  • Fixed an issue where changing settings in the World Gen & Loot config (such as wild bush or hamster spawning settings) required a full game restart to take effect. Saving changes to any config now recalibrates the mod's logic caches on both the client and the server.
• Visual Rotation Glitch
  • Attempted to fix an issue where using teleportation mods (like Waystones) or interrupting animations could cause the hamster's model to become permanently rotated backwards or upside down on the client side.
  • I can't be 100% certain about this fix yet, because no one has been able to figure out exactly what causes it and I can't re-create it myself, so let me know if you run into it.
• Hamster Stretching with Shaders
  • Fixed a visual bug where hamsters would stretch to extreme sizes during multiplayer server lag or when pausing the game.
• Dismount Bug
  • Fixed an issue where holding down the Sneak key for more than a second would cause the OS's auto-key-repeat feature to spam the game with inputs, dismounting all of your shoulder hamsters rapidly.
  • You can now safely hold Sneak without losing your friends.
  • This bug has existed ever since the double-tap setting was added, but I hadn't found it because I usually play with Sneak set to "Toggle" (which means I have no reason to hold it down for extended periods).
• Memory Optimization
  • Implemented pre-caching for texture identifiers and simplified rotation math in the render loop to eliminate extra memory objects being generated every frame.
• Spanish Localization
  • Some strings in the Hamster Tips guidebook were still outdated (i.e., the Accessories and Sunflower pages).
• Malformed Recipe
  • The sliced_cucumber_from_cutting_board.json recipe for compatibility with Farmers Delight failed to load on 1.20.1 due to a typo.
• Acorn Inflation
  • Fixed a decimal point error where Oak Leaves dropped Acorns at a 5% rate instead of the intended 0.5% (now it correctly matches vanilla Apple rarity).
• Guidebook Effects
  • Fixed an issue where moving the Hamster Tips guidebook around in your own inventory would sometimes re-trigger the "rediscovered" sound and particle effects.
  • Added a 30-second grace period to the guidebook tracking system. Prevents the effects from spamming if you move it between inventories, or drop it and pick it back up.
• Pink Petals Bug (1.20.1 only)
  • Fixed an issue where Pink Petals would visually apply to all three locations simultaneously when first equipping them or reloading a world.
• Hamster Bed Linking
  • Reduced the maximum stack size of Hamster Beds to 1. Not only does this feel like the way it always should have been, it resolves an issue where holding a stack of beds and right-clicking a hamster would link the entire stack simultaneously.
• Invisible Hamster Glitches
  • Solved a vanilla Minecraft issue where hamsters (and other pets) get left behind in unloaded chunks because their AI stops ticking before they can teleport.
  • Fixed a related bug where teleporting hamsters would sometimes successfully arrive but remain completely invisible to the client until you relogged. The new Teleport Rescue Protocol bypasses these vanilla quirks entirely.
  • Overhauled shoulder-hamster data synchronization to prevent them from becoming invisible upon player respawn if they were configured to respawn with the player when the player fell into the void.
• Ghost Bed Crash
  • Fixed a server crash that occurred when a hamster's linked bed was destroyed while the hamster was sleeping or unloaded. Hamsters will now detect the missing bed, cancel their sleep effects, and unlink themselves to prevent future issues.
• Bed State
  • Fixed an issue where chunk load order could occasionally cause a sleeping hamster's bed to visually revert to an "unoccupied" state across server restarts.
• Shoulder Hamster Physics
  • Capped the maximum vertical offset in the shoulder hamster physics simulation. This prevents hamsters from visually floating too far off the player's shoulders during long, extreme falls.
  • This was mostly an issue with resource packs that add cool player animations to the arms. The shoulder hamsters are locked to the arms of the player, so when the arms go out to the sides during a fall, the shoulder hamsters would cross over the midpoint of the head. This doesn't fix the issue 100% (I'm not sure if that's even possible with pretty player animations) but makes it a bit less obvious.
• Shoulder Cleaning Loop
  • Fixed a bug where a hamster mounted to the player's shoulder mid-cleaning would get permanently stuck in the cleaning animation when it was supposed to be sitting while on the shoulder.
• Jade Debug Overlay
  • Fixed an issue where the Jade debug toggle book-interaction failed to update the client config on dedicated servers.
• Non-Dynamic Taming Food
  • Fixed a bug where wild hamsters would still flee from players attempting to tame them using anything other than Sliced Cucumber. Now correctly uses the configurable "Taming Foods" from the config.
• Suicidal Hamsters
  • Hamsters will no longer choose to run through lava or fire when cornered and fleeing from a player. They will now properly recognize these hazards as completely impassable terrain.
• Immersive Engineering Compatibility
  • Fixed a data formatting error in the Garden Cloche recipes for cucumbers and green beans that caused the game to crash upon world creation or loading. (Thanks to @CasualAnimalEnjoyer for the fix!)

The Procedural Genetics Update

Hamsters now utilize a fully procedural and configurable genetics engine with 3,158 new wild variants, 2,285,046 potential breeding outcomes, recessive red eyes, 13 new advancements, and a guidebook update that explains everything. Added comprehensive breeding settings to balance obsessions with server tick speed (looking at you, Janet). Also many bugs were squashed, and hamsters learned to play tag and spit out gifts from their cheeks. Make sure you update Patchouli to the latest version or your game won't launch!

→ /ahp print genetics report ↓

  |                                                                                      
  |                      Adorable Hamster Pets Procedural Genetics Engine                
  |      --------------------------------------------------------------------------------
  |      Base Fur Palettes ................. | 45
  |      Base Fur Patterns ................. | x 1
  |      Potential Wild Overlay Types ...... | x 235 (26 Palettes x 9 Patterns + 1 blank)
  |      Potential Breeding Overlay Types .. | x 406 (45 Palettes x 9 Patterns + 1 blank)
  |      Potential Eye Color Types ......... | x 2
  |      Visually Distinct Wild Variants ... | = 3,231
  |        ↑ Filtered: Overlays must...
  |          - Be allowed (WHITE, LIGHT_GRAY, DARK_GRAY, CREAM) ← default: neutrals
  |          - Be brighter than base color
  |          - Be less saturated than base color
  |          - Not clash with the BLUE, LAVENDER color zones
  |      Total Possible After Breeding ..... | = 2,285,046
  |      Number of 3D Color Relationships .. | = 2,610,718,753,581
  |                                                                                                                 

Added

• Procedural Genetics & Texture System
  • Procedural Genetics Engine
    • Hamsters are no longer pre-defined, hardcoded variants. Every hamster now possesses a fully serialized HamsterGenome detailing its precise genetic makeup across six distinct traits.
    • This was accomplished by developing a 3D Hue/Saturation/Brightness (HSB) Cartesian color space. The mod uses this to mathematically map the exact color coordinates of every hamster variant into a three-dimensional neural network, which is dynamically used to calculate genetic relationships, mutations, overlay exclusion rules, and environment-spawning rules on the fly.
    • I got the idea for creating the textures programmatically like this because that's how I made the original textures in Photoshop— using various Gradient Maps applied to a single, grayscale texture. Then I realized Java code can do the same thing!
    • The total number of unique hamster types that spawn in the wild is now 3,231 by default, and the number of genetically inheritable hamster permutations from breeding is now over 2.2 Million.
    • Want to understand the math? Keep reading below— look for the "Advanced Spawning & Testing Commands" section. I have added all sorts of fancy commands and tools to walk you through the breeding system in a way that is (hopefully) easy to understand.
  • Dynamic Palette Swapping
    • Built an optimized, client-side dynamic texture generator. Instead of bloating your hard drive with over 2 million distinct PNG files, the mod dynamically recolors grayscale fur templates at runtime using custom genetic palette hex code data I designed based off my Photoshop workflow, then mixes them with hard-coded PNGs from the community.
    • I realized the original hamster variants were just gradient maps applied to a grayscale texture in Photoshop. So, naturally, I invested an unreasonable amount of effort rebuilding Photoshop's Gradient Map tool inside Java.
    • Does this save file space? Sort of, though tiny PNGs don't take up much space anyway. But it makes the system infinitely scalable. If I add just one new grayscale pattern or community-made texture in the future, the Java math will automatically multiply it across every single other variant in the game. For now, consider it an over-engineered proof of concept.
  • Community Hamster Textures
    • Developed a parallel pipeline that automatically scans, analyzes, and genetically categorizes static, community-made PNG textures directly from the mod's JAR file. These static textures are seamlessly integrated into the procedural breeding pool alongside my programmatic colors.
    • The rendering engine can automatically composite custom community textures into overlay masks. This means hamsters can spawn with community-made palettes serving as the color for their overlay spots and splotches!
    • Thanks to @jimcerberus, we have 18 brand-new base hamster variants spawning in the wild! (Including Cheesecake Mocha, Blue Fawn, Pearl Rose, Sable, and 14 more). You can see them all in-game using the new spawn commands (see below).
  • Expanded Overlays
    • Overlays are no longer just white.
    • Wild Overlays: Naturally spawning hamsters can now have overlays in any color that is closely related to White, Cream, or Gray, with a few configurable exceptions. To keep things looking natural, the default config ensures wild overlays are always brighter & less saturated than the base coat, Cream is disallowed on a Lavender or Blue base coat, and cave-spawned hamsters can only receive Gray overlays to help them blend in.
    • Breeding Overlays: A completely new secondary overlay layer, unlocked exclusively through breeding (45% chance when two first-generation wild hamsters breed). These are chosen based on the midpoint between the parents' base color in the 3D color-space coordinate system, with a bit of jitter so the baby won't always look the same when you breed two parents repeatedly, so the possibilities are nearly endless. These overlays will mathematically avoid copying the same shape/pattern as the wild overlay, to ensure they are not hidden/covered up by it.
• Breeding & Lifecycle Mechanics
  • Breeding Inheritance and Visualization Tool
    • Here's how it works: When breeding two hamsters together, the color for the baby (and its overlay colors) are chosen based on a connected line between the two parents in the 3D color-space coordinate system. This means babies will tend towards the mathematical center, but occasionally one parent's color traits will strongly dominate the outcome, mimicking real-world genetics and providing visual variety within a single hamster family even if you breed the same two parents together repeatedly.
    • Outcome Visualizer: You can right-click two hamsters inside the 3D variants layout (/ahp spawn_all_bases_3D) with the Hamster Tips guidebook to visualize the genetic probability distribution for their offspring via a cloud of Wax On particles. The particle spawning logic uses the exact same probability math that is used when creating babies, so it gives you a perfectly accurate representation of potential outcomes.
    • Config Settings and Real-time Controls
      • Genetic Variance: Adjusts how much a baby's base color can deviate from the exact center between its parents. Think of this as the "length" of the line between the parents.
      • Genetic Mutation Rate: Adjusts the random color scatter/mutations applied to babies. Think of this as the "thickness" of the line.
      • Simulated Offspring Per Second: Adjust the density of the 3D visualizer particle cloud. Each particle represents a potential baby.
      • Real-time Controls: While holding the guidebook, you can dynamically tweak the shape of the genetic probability cloud using the arrow keys: Left/Right Arrows adjust Genetic Variance; Up/Down Arrows adjust Genetic Mutation Rate.
      • Server and Client Sync: Since the particle visualizer is driven by the literal server-side breeding math, which is driven by the config for your server, and the changes you make with the arrow keys directly alter that config, the changes will take effect immediately for any future babies.
  • Recessive Eye Genetics
    • Hamsters now possess dominant (Black) and recessive (Red) eye genetics.
    • Red eyes do not exist in the wild. They are genetically tied to the "diluteness" (brightness/saturation) of the hamster's coat. A fully dilute hamster has up to a 50% chance of spawning with a recessive red eye gene. By selectively breeding highly dilute hamsters, players can uncover carriers (Br) and eventually breed Red-Eyed (rr) variants. Uses punnet squares.
  • Baby Growth Mechanics
    • You can now feed baby hamsters standard hamster food items to accelerate their growth.
    • To balance this with their natural pickiness, a new config option (Disable Baby Food Refusal) allows you to bypass their desire for dietary variety specifically for babies if you want. This is turned off by default, so to bypass their pickiness you'll need lots of Hamster Food Mix if you want to quickly grow them up.
    • Feeding baby hamsters visually and mechanically accelerates their growth in smooth, continuous increments, similar to vanilla horses. Their "extra big head" proportions scale dynamically as they grow.
  • Breeding Limitations
    • Added comprehensive config settings to manage hamster breeding for server owners who want to keep the population under control.
    • Added a global Enable Breeding toggle (on by default) to instantly shut down all romance.
    • Added a configurable Max Breeding Cycles limit per hamster to stop them from infinitely multiplying (off by default).
    • Added a Limit Breeding By Player toggle. (also off by default). Limits can be assigned per-player based on Minecraft days or Real Life days, or simply capped as a lifetime maximum limit. Includes feedback to explain what's happening when attempting to over-feed beyond the limit.
    • Added a /ahp reset_player_breeding_history command for server operators to reset their own breeding history.
    • Added a /ahp reset_hamster_breeding_history command for server operators to reset a specific hamster's timesBred quota to zero.
    • Added a convenient "Reset Breeding History" button in the Config screen that executes the command for the user (requires OP permissions).
  • Configurable Litter Size
    • Added to config sliders allowing you to set the minimum and maximum litter size when hamsters get into hanky-panky. The final size of the litter will be a random number between the min and max.
  • Breeder Whitelist
    • Added a config list allowing specific players to bypass the global breeding ban. In case your server needs a designated rodent baron.
  • Post-Breeding Animation
    • Hamsters will now crouch down and lovingly inspect their baby(s) after the litter is born, spawn heart particles, and make affectionate sounds shortly after successfully contributing to your growing population problem.
  • Wild Baby Configuration
    • Added Babies Spawn Wild setting. When enabled, babies are born feral and do not inherit their parent's ownership status, letting multiplayer groups decide who claims them.
    • When untamed, babies no longer flee from players, making them easier to manage.
  • Parent-Following
    • Babies will now randomly select a parent to follow until adulthood, instead of following their owner.
    • Wild baby hamsters will switch to following the player if their parent is currently mounted on the player's shoulder. They will automatically resume following the parent once it is dismounted.
    • If you want the baby to follow you instead, you must first tame it, then you can break its connection to the parent by right-clicking it with a Lure Item (Cheese by default).
    • Added a config toggle to disable the action bar message that warns you when a newly tamed baby hamster refuses to follow you because it's still attached to its parent.
  • Age Tracking
    • Hamsters now track their absolute lifetime age in ticks.
    • Wild hamsters spawn with a random age between 1 and 30 days.
    • Added /ahp set_age command to manually override a hamster's age (since older hamsters will start at 0 days old upon updating to this version of the mod). It accepts units (days, months, years) and provides autocomplete suggestions.
    • If you do not specify a target, it will automatically apply to the hamster you are currently looking at.
    • The Jade HUD overlay displays the hamster's age alongside its genetic data.
    • Added a new Display IRL Age config setting that dictates how fast the hamster ages. If true, their age progresses at 1/72nd the normal speed (matching the real-world 24-hour cycle).
• Performance Improvements
  • Significant Overall Improvements
    • Flattened the entire visual render layer stack (base coat, wild overlays, breeding overlays, skin, eyes, armor, and accessories) into a single, dynamically composited texture at runtime.
    • This completely eliminates all secondary GeoRenderLayer passes. Every hamster, regardless of its complex genetics or equipped items, now costs exactly one draw call to render (previously it was anywhere from 2 to 8!), resulting in a massive performance boost. Especially noticeable when numerous hamsters are on screen at the same time.
  • Bare-Bones Ultra Performance Mode
    • Added a new Performance Mode toggle in the config (and an assignable keybind) designed specifically for viewing absurd numbers of hamsters simultaneously without melting your GPU.
    • When enabled, it bypasses the dynamic texture engine entirely (falling back to a single flat texture) and hides almost all the model's geometry.
    • The hamsters essentially become grayscale cubes, stripping away nearly all matrix-calculation overhead.
    • The Jade HUD overlay will still display their exact genetic information, because the server never forgets what they are actually supposed to look like.
• New Config Settings
  • Wild Overlay Configurability
    • Added new Allowed Wild Overlay Zones list to the World Gen & Loot config. This allows server owners/modpack makers to explicitly control which color zones the genetics engine is allowed to use when picking an overlay for a naturally spawning hamster. Defaults to natural colors (WHITE, LIGHT_GRAY, DARK_GRAY, and CREAM).
    • Added new Restricted Base Colors and Clashing Overlay Colors lists. By default, these prevent CREAM and DARK_GRAY wild overlays from spawning on top of BLUE and LAVENDER base coats, as these color combinations tend to look a bit strange visually.
    • Added new Enforce Brighter Overlays and Enforce Muted Overlays toggles. Allows players to disable the overlay filtering that prevents saturated colors (like Cream) from spawning on muted bases (like Black) and darker colors from being used as overlays on top of lighter bases.
    • Modifying the overlay settings can dramatically change the number of possible combinations for wild hamsters (3,231 by default).
  • Red Eye Config Toggle
    • Don't like the red eye hamsters? You can visually disable that for your own client via a new config toggle, which makes them appear to have black eyes.
  • Friendly Fire Config Toggle
    • Added Prevent Owner Friendly Fire to the Core config toggles.
    • When enabled, players can no longer accidentally damage their own tamed hamsters. Disabled by default to remain vanilla-friendly.
    • In the next update (hopefully), this setting will be tied to a new item: the Acorn Ring. I also plan to integrate with the Trinkets mod so you can use a trinket slot for it.
  • Configurable Cuisine
    • You can now configure the nutrition and saturation values for all food items added by the mod (Cucumbers, Green Beans, Food Mix).
    • Changed nutrition/saturation values are dynamically reflected in AppleSkin's "on-eat" HUD preview. *Unfortunately due to major API changes between MC versions, this only works on 1.21.1.
  • Max Mounted Hamsters Config
    • Added a configuration slider under 'Shoulder Hamster Settings > Core Settings' allowing players to limit the maximum number of hamsters that can be mounted simultaneously (1 to 3).
• Gameplay Mechanics & Interactions
  • Tag Mini-Game
    • Hamsters can now initiate a playful game of tag. If you maintain eye contact with a hamster for a few seconds, it will squeak and excitedly run away.
    • The Chase: The hamster will flee if you get too close and stop to playfully taunt you if you fall too far behind.
    • Payoff: Successfully "catching" (right-clicking) the hamster before it gets bored ends the game triggers a celebration. The hamster will then spit out a random item from its cheek pouches as a gift (pulling from the configurable cheek pouch loot lists).
    • Stranger Danger: By default, you can play tag with wild hamsters and hamsters owned by other players. (Can be disabled in config).
    • Configurable Limits and Rewards
      • Added configs to control how often they want to play, the cooldown between games, and an anti-abuse cap on how many times a single player can play the game per in-game day (so they can't farm rewards).
      • Added configs to control rewards: By default, hamsters will randomly pick an item from their configurable "Cheek Pouch Loot" list (the list of potential items a wild hamster might spawn with). The item does not have to be in the hamster's cheek pouch for it to give it as a gift.
      • That can be disabled, in which case the hamster will choose the gift from a separate "Custom Tag Rewards" list in the config, which means you can make your hamster give you a diamond or any modded item (or whatever you want) when you catch it after a game of tag. Only server moderators can modify this of course.
  • Dynamic Gaze
    • Hamsters will now sustain eye contact with you indefinitely, provided you are nearby and continue looking back at them, and of course as long as they don't start a game of tag.
  • Hamster Yeet Overhaul
    • Thrown hamsters are now officially registered as ProjectileEntity instances while airborne. This provides automatic, out-of-the-box compatibility with external mods that use targets or hoops (such as the Tin Hoops in Caverns and Chasms).
    • Thrown hamsters now experience dynamic physics upon impact. They will ricochet backward off of walls and entities, or skip forward when hitting floors and ceilings.
    • Thrown hamsters now dynamically query and broadcast the native sound of the block or entity they strike (including modded blocks/entities).
    • Impact physics are magnified when hitting Slime blocks, and completely absorbed by Honey blocks.
    • Added a new config toggle (true by default) allowing thrown hamsters to damage their owner. Throwing your own rodent straight up in the air will now result in a realistic, concussive reunion on the way back down.
  • Precision Tree Heists
    • Right-clicking Oak Leaves with a lure item (Cheese) while a hamster is on your shoulder will now initiate a "Precision Tree Heist."
    • This sets that specific leaf block as the guaranteed exit point for the hamster.
    • While a precision heist is active, right-clicking in the air with the lure item will set the hamster's exit direction to match the direction you are currently looking.
    • Why? This allows you to precisely control the exact block and angle by which your hamster will exit the tree, which makes for much more predictable recording sessions.
  • Moonwalking Easter Egg
    • Name your hamster "Michael Jackson" or "Steve Irwin" and it will rotate backwards and remain that way until you change the name again.
  • Expanded Default Diet
    • Hamsters can now eat seeds from almost any mod out-of-the-box. Added a robust union tag to the default config that automatically syncs with #c:seeds and #forge:seeds to ensure compatibility across all versions and mod loaders.
• Failsafes & Rescues
  • Teleport Rescue Protocol
    • Overhauled how hamsters follow you across vast distances or dimensions (e.g., when using Waystones).
    • Instead of relying on their tiny legs and pathfinding AI to catch up, your player code will now safely scoop up any actively following hamsters (and their babies if the babies are following them), hold them in a little NBT pocket while the world loads, and drop them at your new location 0.75 seconds later.
  • Void Rescue Protocol
    • If a player falls into the void and dies with hamsters on their shoulders, the hamsters will no longer spawn in the void and immediately perish. The system will safely teleport them back to their linked bed. If they do not have a linked bed, they will be sent to the player's personal respawn point or the world spawn.
• UI, HUD, & Audio
  • Jade Integration
    • Added comprehensive Jade overlay integration that reveals a hamster's exact genetic makeup (base coat, wild overlay, breeding overlay, eye genotype, etc.) when you look at them.
    • Enabled without needing to turn on debug mode to help with breeding.
    • Fully customizable. Each setting comes with its own toggle, and you can decide which ones show up when you sneak to keep the Jade HUD de-cluttered.
  • GUI Renaming System
    • Players can now rename their hamsters directly from the Hamster Inventory screen.
    • Features dynamic down-scaling to ensure long names always fit perfectly within the UI constraints.
    • An interactive pencil icon and underline display when hovering/typing.
    • New Config Options (UI & Quality of Life > Hamster Renaming)
      • Enable GUI Renaming: Master toggle for the feature.
      • Consume Name Tag: Forces players to sacrifice a Name Tag from their inventory (or the hamster's cheeks) to finalize the rename.
      • Pencil Icon Placement: Allows swapping the icon to the left or right of the text for those who read in different directions.
  • New Audio & Visuals
    • Added a brand new anim_hamster_cheek_unload animation used for gifting items, complete with item and spit particle effects.
    • Added 4 new scratching sound variations for the cleaning animation, and switched to keyframes for the SFX to make it less repetitive and more realistic. This also has the side effect of muting the sound effect if the hamster is not on screen, and thus not being rendered. This means you will no longer hear nearby hamsters cleaning unless you can also see them.
    • Added dynamic item sounds (clink, squish, thud, etc.) to the new gifting sequence.
• Commands & Admin Tools
  • Advanced Spawning & Testing Commands
    • Added /ahp spawn hamster <basePalette> <wildPattern> <wildPalette> <breedPattern> <breedPalette> <eyes>. This command features a custom Brigadier auto-complete engine that suggests exact, human-readable palette and pattern names as you type, allowing you to easily test specific genetic combinations.
    • Added /ahp spawn_all_bases_2D. Systematically lines up every single hamster color base in the game (including custom community additions), sorted cleanly into rows by their dynamically determined, mathematical color zone.
    • Added /ahp spawn_all_bases_3D. Spawns the hamsters hovering in a physical 3D "cylinder" representing their Hue/Saturation/Brightness coordinates. This is useful for the Breeding Inheritance and Visualization Tool (see below).
      • Hue = the degree of the circle (0-360)
      • Saturation = the radius of the circle (more saturated colors are closer to the edge)
      • Brightness = the height of the cylinder (brighter hamsters are closer to the top)
      • By default, each /ahp spawn_all_bases... command spawns just the 45 base colors, but each one comes with 3 optional arguments to change the number of hamsters spawned:
      1. [with_wild_overlays] Displays all 3,231 hamster variants that can spawn naturally in the wild.
      2. [with_sample_breeding_overlays] Displays genetic combinations of every wild hamster but adds in a small sample of three breeding overlays (Tortoise Shell, Silver, and Rust). Due to the triple-multiplication math involved, this heavily increases the total number of hamsters spawned (from 3,231 up to 9,693) creating a much bigger display.
      3. [author] only uses color palletes from a certain author (e.g., jimcerberus or default).
    • Added /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD. Exactly what it sounds like. Don't run it unless you have a super-flat world, a fire extinguisher for your PC, and a lot of patience. Note that every time I have run this command, my server tick speed never quite returned to baseline— even after deleting all the hamsters that were spawned using /kill @e[type=!player].
    • Added /ahp print_genetics_report command, allowing server operators to recalculate and view the current 3D color-space math of the genetics engine at runtime. Useful because it dynamically updates its readout based on your exact AhpWorldGenConfig wild overlay settings, so you can see how your changes are affecting the total possible variant numbers without having to spawn them all.
  • Tree Heist History Command
    • Added /ahp reset_tree_economy for quick clearing of tree depletion memory without needing to open the config screen.
• Advancements
  • Advancement: Carat Confusion
    • Triggers when a hamster leads you to Gold Ore instead of Diamond.
  • Advancement: Load-Bearing Human
    • Triggers when you mount 3 hamsters simultaneously (Right, Left, Head).
  • Genetic Progression Advancements
    • Added "The Collector" advancement path tracking unique wild variants tamed (up to dynamic maximum based on configuration limits).
    • Added "The Breeder" advancement path tracking unique bred combinations (up to 1,000,000).
    • Added a conditional advancement "Seeing Red" for successfully breeding the recessive eye trait. Does not trigger if red eyes have been turned off in the config.
    • Implemented high-performance, non-bloating NBT storage using IntArrays to track thousands of HamsterGenome hashes without lagging the player entity.
• Guidebook Enhancements
  • Guidebook Delivery Fallback
    • Added a new configuration option that acts as a fallback for modpacks that disable auto-guidebook delivery on login.
    • If enabled (default), players will automatically be given the Hamster Tips guidebook and receive a chat prompt the very first time they spot a wild hamster from <=10 blocks away.
    • Targeting calculation includes wiggle room to ensure the event triggers even if the player's crosshair isn't perfectly on the hamster's hit box.
    • Only triggers once, and only if the player has never yet received the guidebook (regardless of current inventory status).
  • Lectern Reading
    • Added code for placing the Hamster Tips guide book into a lectern and an event handler so you can read it. You can now display your rodent knowledge in your base or wherever.
  • Hamster Tips Guidebook Improvements
    • The Hamster Tips guidebook now uses a custom string processor to pull live data directly into the text, so I can do things like automatically displaying the exact number of mathematically possible wild variants or the name of your dynamically configured Lure Item instead of hardcoding "Cheese".
    • Updated the "Regional Rodents" entry to explain the new biome-adaptive color logic, Wild Overlays and Jade integration.
    • Added a new "Breeding" entry in The Hamster Life chapter detailing the genetic mechanics, recessive red eyes, and feral youth mechanics.
    • Added a new "Admin Commands" entry in The Kitchen Drawer chapter detailing the various new (and old) commands the mod has to offer since some of them (especially the new ones) are super useful.
• Pixie-Dust Crown for Supporters
  • Added a dynamic, spinning, bobbing particle crown that renders above the heads of mod supporters. Uses a custom Pixie Dust particle system featuring a dense, short-lived, shimmering effect.
  • Emits a subtle sparkling sound and includes 5 different themes (Gold, Crimson, Lavender, Ice, Emerald) by manipulating the HSB color values of a single grayscale texture at runtime.
  • Automatically hides in first-person view to prevent visual obstruction.
  • Powered by a remote manager that pulls configuration data asynchronously from GitHub and caches it for offline use. You will need to briefly connect to the Internet while launching Minecraft at least once to verify your ownership of the Crown. After that you can play offline and still see it!
  • Configurable Aesthetics
    • Added a new Supporter Perks config group.
    • Added a global toggle to disable rendering of all crowns if you hate fun.
    • Added a global toggle to disable sound effects of all crowns.
    • Added a local toggle to allow rendering your own crown in first-person mode if you want to both obstruct your view and thrill yourself.
    • Added sliders for sound volume, particle count, crown radius, crown height, crown thickness, and vertical offset.
    • Added a new "Toggle Supporter Crown" keybind allowing users to show/hide their own crown from both themselves and the rest of the server. A single press cycles the crown to the next available color theme, while a double-tap toggles the crown's visibility.
    • Supporters can pick their own crown color. Your preference syncs instantly to all other players looking at you utilizing DataTracker networking.

Changed

• Location-Centric Spawning Overhaul
  • Completely rewrote the world generation spawning logic. Instead of mapping individual hamster colors to biomes, biomes are now grouped into 9 "Spawning Environments" (e.g., Icy, Sandy, Forest, etc.)
  • Each environment rolls against weighted hamster color groups. This ensures that whether a texture is procedurally generated or community-made, it mathematically evaluates its own color and automatically spawns in a biologically appropriate location.
• Diamond Sniffing Visuals & Audio
  • Added directional animations to indicate whether a buried diamond ore is above or below the hamster when it's sniffing for one and the path is obstructed.
  • Added a dynamic "quick bounce" animation that intermittently triggers when the diamond ore is hidden somewhere above the hamster.
  • Added a new head-shake sound effect that plays when the hamster is sniffing for ore and gets confused.
• Sweet Potato Easter Egg
  • The "Sweet Potato" Easter egg now applies a unique custom texture to the hamster, thanks to @jimcerberus!
  • Renaming a hamster "Sweet Potato" hides its normal genetics (base coat, overlays, and eye color) without permanently deleting them.
  • Sweet Potato hamsters can still breed, and their offspring will genetically inherit traits mathematically blended from the sweet potato's unique color palette, but they do not spawn in the wild.
• Jade HUD Config Settings
  • Added a new "Jade Overlay Settings" section to the config under "UI & Quality of Life".
  • Displays complex genetic info (Age, Base Coat, Wild Overlay, Breeding Overlay, Eye Color) by default.
  • Added a "Require Sneaking" toggle (disabled by default) allowing you to hide the genetic overlay unless you are actively sneaking.
  • Added individual toggles for every piece of my custom genetic info shown in the Jade overlay.
  • Added additional toggles for selectively disabling default Jade info lines (Name, Health, Growth Time, Owner, Inventory) specifically for hamsters without impacting other entities, and a toggle to link their visibility to the player's sneaking state, allowing you to completely customize the HUD to your liking.
  • Built a smart-formatting engine so that community texture IDs are automatically converted into localized, human-readable titles on the HUD (e.g., cheesecake_mocha.png -> "Cheesecake Mocha").
• Statue Performance & AI Toggling
  • Hamsters spawned with their AI disabled will now completely freeze their animation playback and no longer emit ambient idle squeaks. This attempts to reduce client-side rendering lag when hundreds of thousands of hamsters are on screen for testing, but Java itself struggles with that many cubes on screen, so it's still laggy if you try to look at 2 million+ hamsters simultaneously.
  • You can now tame an AI-disabled hamster, which will instantly "wake it up" and turn it into a real, fully functional hamster.
  • Added an Allow Taming to Re-Enable AI toggle to the config in case you're a server owner who wants to sell specific hamster breeds in a shop. If you have OP permissions on your server, you can turn this off to prevent players from taming and "waking up" frozen hamsters, allowing them to be used as shop displays or decorative statues.
• Mod Page/README
  • The README was functioning as a marketing poster, a technical manual, a credits roll, and a tutorial. That is too many jobs for one file.
  • It was getting too large, so I have reorganized it, reworded it, and split a few things off into other easily accessible files, so the README only has one job now.
• Mount Priority
  • Changed default config value to HEAD_FIRST.
• Action Bar Config Toggles
  • Grouped all action bar message toggles (Shoulder Dismount, Tree Heist Start, Bed Break, Tamed Baby Warning, and Display Duration) into a new "Action Bar Messages" sub-category under "UI & Quality of Life" for easier access.
• Guidebook
  • Updated Hamster Bed entry to explicitly mention the Totem of Undying requirement for respawning.
• Guidebook Effects
  • If you obtain the Hamster Tips guidebook while viewing a chest or crafting screen, the "rediscovered" visual and audio effects will now be postponed until you close the screen, ensuring the effects do not play while you're looking at your inventory.
  • If you keep the screen open for longer than 5 seconds after obtaining the book, the effects are silently cancelled.
• Cucumber Rebalance
  • Sliced Cucumbers are no longer inexplicably nutritious. Their default food value has been dropped from 2 hearts to 0.5 hearts to match items like Dried Kelp.
• Hamster Hitbox Adjustment
  • Shrunk the physical hitbox of hamsters by 15% to more accurately match their actual visual model size.
  • Note: Because the bounding box is now smaller, you will need to aim slightly more accurately when trying to interact with a hamster.
• Patchouli Version
  • Updated the internal guidebook generation logic to accommodate API breaking changes introduced in Patchouli version 1.21.1-93.
  • You must update Patchouli to the latest version or the game will not launch.
• Shoulder Animation Configs
  • Replaced the single Forced Animation State setting with three distinct settings. You can now independently force the Head, Left Shoulder, and Right Shoulder hamsters into specific animation loops (when dynamic animations are disabled).
• Tree Heist Exits
  • Hamsters will now perform a small outward jump, launching themselves away from the tree upon successfully completing a Tree Heist.
• Breeding Cooldown Config
  • The config setting for breeding cooldown has been changed from Ticks to Seconds to make it significantly easier to manage with the slider.

Fixed

• Config Live Changes
  • Fixed an issue where changing settings in the World Gen & Loot config (such as wild bush or hamster spawning settings) required a full game restart to take effect. Saving changes to any config now recalibrates the mod's logic caches on both the client and the server.
• Visual Rotation Glitch
  • Attempted to fix an issue where using teleportation mods (like Waystones) or interrupting animations could cause the hamster's model to become permanently rotated backwards or upside down on the client side.
  • I can't be 100% certain about this fix yet, because no one has been able to figure out exactly what causes it and I can't re-create it myself, so let me know if you run into it.
• Hamster Stretching with Shaders
  • Fixed a visual bug where hamsters would stretch to extreme sizes during multiplayer server lag or when pausing the game.
• Dismount Bug
  • Fixed an issue where holding down the Sneak key for more than a second would cause the OS's auto-key-repeat feature to spam the game with inputs, dismounting all of your shoulder hamsters rapidly.
  • You can now safely hold Sneak without losing your friends.
  • This bug has existed ever since the double-tap setting was added, but I hadn't found it because I usually play with Sneak set to "Toggle" (which means I have no reason to hold it down for extended periods).
• Memory Optimization
  • Implemented pre-caching for texture identifiers and simplified rotation math in the render loop to eliminate extra memory objects being generated every frame.
• Spanish Localization
  • Some strings in the Hamster Tips guidebook were still outdated (i.e., the Accessories and Sunflower pages).
• Malformed Recipe
  • The sliced_cucumber_from_cutting_board.json recipe for compatibility with Farmers Delight failed to load on 1.20.1 due to a typo.
• Acorn Inflation
  • Fixed a decimal point error where Oak Leaves dropped Acorns at a 5% rate instead of the intended 0.5% (now it correctly matches vanilla Apple rarity).
• Guidebook Effects
  • Fixed an issue where moving the Hamster Tips guidebook around in your own inventory would sometimes re-trigger the "rediscovered" sound and particle effects.
  • Added a 30-second grace period to the guidebook tracking system. Prevents the effects from spamming if you move it between inventories, or drop it and pick it back up.
• Pink Petals Bug (1.20.1 only)
  • Fixed an issue where Pink Petals would visually apply to all three locations simultaneously when first equipping them or reloading a world.
• Hamster Bed Linking
  • Reduced the maximum stack size of Hamster Beds to 1. Not only does this feel like the way it always should have been, it resolves an issue where holding a stack of beds and right-clicking a hamster would link the entire stack simultaneously.
• Invisible Hamster Glitches
  • Solved a vanilla Minecraft issue where hamsters (and other pets) get left behind in unloaded chunks because their AI stops ticking before they can teleport.
  • Fixed a related bug where teleporting hamsters would sometimes successfully arrive but remain completely invisible to the client until you relogged. The new Teleport Rescue Protocol bypasses these vanilla quirks entirely.
  • Overhauled shoulder-hamster data synchronization to prevent them from becoming invisible upon player respawn if they were configured to respawn with the player when the player fell into the void.
• Ghost Bed Crash
  • Fixed a server crash that occurred when a hamster's linked bed was destroyed while the hamster was sleeping or unloaded. Hamsters will now detect the missing bed, cancel their sleep effects, and unlink themselves to prevent future issues.
• Bed State
  • Fixed an issue where chunk load order could occasionally cause a sleeping hamster's bed to visually revert to an "unoccupied" state across server restarts.
• Shoulder Hamster Physics
  • Capped the maximum vertical offset in the shoulder hamster physics simulation. This prevents hamsters from visually floating too far off the player's shoulders during long, extreme falls.
  • This was mostly an issue with resource packs that add cool player animations to the arms. The shoulder hamsters are locked to the arms of the player, so when the arms go out to the sides during a fall, the shoulder hamsters would cross over the midpoint of the head. This doesn't fix the issue 100% (I'm not sure if that's even possible with pretty player animations) but makes it a bit less obvious.
• Shoulder Cleaning Loop
  • Fixed a bug where a hamster mounted to the player's shoulder mid-cleaning would get permanently stuck in the cleaning animation when it was supposed to be sitting while on the shoulder.
• Jade Debug Overlay
  • Fixed an issue where the Jade debug toggle book-interaction failed to update the client config on dedicated servers.
• Non-Dynamic Taming Food
  • Fixed a bug where wild hamsters would still flee from players attempting to tame them using anything other than Sliced Cucumber. Now correctly uses the configurable "Taming Foods" from the config.
• Suicidal Hamsters
  • Hamsters will no longer choose to run through lava or fire when cornered and fleeing from a player. They will now properly recognize these hazards as completely impassable terrain.
• Immersive Engineering Compatibility
  • Fixed a data formatting error in the Garden Cloche recipes for cucumbers and green beans that caused the game to crash upon world creation or loading. (Thanks to @CasualAnimalEnjoyer for the fix!)

The Procedural Genetics Update

Hamsters now utilize a fully procedural and configurable genetics engine with 3,158 new wild variants, 2,285,046 potential breeding outcomes, recessive red eyes, 13 new advancements, and a guidebook update that explains everything. Added comprehensive breeding settings to balance obsessions with server tick speed (looking at you, Janet). Also many bugs were squashed, and hamsters learned to play tag and spit out gifts from their cheeks. Make sure you update Patchouli to the latest version or your game won't launch!

→ /ahp print genetics report ↓

  |                                                                                      
  |                      Adorable Hamster Pets Procedural Genetics Engine                
  |      --------------------------------------------------------------------------------
  |      Base Fur Palettes ................. | 45
  |      Base Fur Patterns ................. | x 1
  |      Potential Wild Overlay Types ...... | x 235 (26 Palettes x 9 Patterns + 1 blank)
  |      Potential Breeding Overlay Types .. | x 406 (45 Palettes x 9 Patterns + 1 blank)
  |      Potential Eye Color Types ......... | x 2
  |      Visually Distinct Wild Variants ... | = 3,231
  |        ↑ Filtered: Overlays must...
  |          - Be allowed (WHITE, LIGHT_GRAY, DARK_GRAY, CREAM) ← default: neutrals
  |          - Be brighter than base color
  |          - Be less saturated than base color
  |          - Not clash with the BLUE, LAVENDER color zones
  |      Total Possible After Breeding ..... | = 2,285,046
  |      Number of 3D Color Relationships .. | = 2,610,718,753,581
  |                                                                                                                 

Added

• Procedural Genetics & Texture System
  • Procedural Genetics Engine
    • Hamsters are no longer pre-defined, hardcoded variants. Every hamster now possesses a fully serialized HamsterGenome detailing its precise genetic makeup across six distinct traits.
    • This was accomplished by developing a 3D Hue/Saturation/Brightness (HSB) Cartesian color space. The mod uses this to mathematically map the exact color coordinates of every hamster variant into a three-dimensional neural network, which is dynamically used to calculate genetic relationships, mutations, overlay exclusion rules, and environment-spawning rules on the fly.
    • I got the idea for creating the textures programmatically like this because that's how I made the original textures in Photoshop— using various Gradient Maps applied to a single, grayscale texture. Then I realized Java code can do the same thing!
    • The total number of unique hamster types that spawn in the wild is now 3,231 by default, and the number of genetically inheritable hamster permutations from breeding is now over 2.2 Million.
    • Want to understand the math? Keep reading below— look for the "Advanced Spawning & Testing Commands" section. I have added all sorts of fancy commands and tools to walk you through the breeding system in a way that is (hopefully) easy to understand.
  • Dynamic Palette Swapping
    • Built an optimized, client-side dynamic texture generator. Instead of bloating your hard drive with over 2 million distinct PNG files, the mod dynamically recolors grayscale fur templates at runtime using custom genetic palette hex code data I designed based off my Photoshop workflow, then mixes them with hard-coded PNGs from the community.
    • I realized the original hamster variants were just gradient maps applied to a grayscale texture in Photoshop. So, naturally, I invested an unreasonable amount of effort rebuilding Photoshop's Gradient Map tool inside Java.
    • Does this save file space? Sort of, though tiny PNGs don't take up much space anyway. But it makes the system infinitely scalable. If I add just one new grayscale pattern or community-made texture in the future, the Java math will automatically multiply it across every single other variant in the game. For now, consider it an over-engineered proof of concept.
  • Community Hamster Textures
    • Developed a parallel pipeline that automatically scans, analyzes, and genetically categorizes static, community-made PNG textures directly from the mod's JAR file. These static textures are seamlessly integrated into the procedural breeding pool alongside my programmatic colors.
    • The rendering engine can automatically composite custom community textures into overlay masks. This means hamsters can spawn with community-made palettes serving as the color for their overlay spots and splotches!
    • Thanks to @jimcerberus, we have 18 brand-new base hamster variants spawning in the wild! (Including Cheesecake Mocha, Blue Fawn, Pearl Rose, Sable, and 14 more). You can see them all in-game using the new spawn commands (see below).
  • Expanded Overlays
    • Overlays are no longer just white.
    • Wild Overlays: Naturally spawning hamsters can now have overlays in any color that is closely related to White, Cream, or Gray, with a few configurable exceptions. To keep things looking natural, the default config ensures wild overlays are always brighter & less saturated than the base coat, Cream is disallowed on a Lavender or Blue base coat, and cave-spawned hamsters can only receive Gray overlays to help them blend in.
    • Breeding Overlays: A completely new secondary overlay layer, unlocked exclusively through breeding (45% chance when two first-generation wild hamsters breed). These are chosen based on the midpoint between the parents' base color in the 3D color-space coordinate system, with a bit of jitter so the baby won't always look the same when you breed two parents repeatedly, so the possibilities are nearly endless. These overlays will mathematically avoid copying the same shape/pattern as the wild overlay, to ensure they are not hidden/covered up by it.
• Breeding & Lifecycle Mechanics
  • Breeding Inheritance and Visualization Tool
    • Here's how it works: When breeding two hamsters together, the color for the baby (and its overlay colors) are chosen based on a connected line between the two parents in the 3D color-space coordinate system. This means babies will tend towards the mathematical center, but occasionally one parent's color traits will strongly dominate the outcome, mimicking real-world genetics and providing visual variety within a single hamster family even if you breed the same two parents together repeatedly.
    • Outcome Visualizer: You can right-click two hamsters inside the 3D variants layout (/ahp spawn_all_bases_3D) with the Hamster Tips guidebook to visualize the genetic probability distribution for their offspring via a cloud of Wax On particles. The particle spawning logic uses the exact same probability math that is used when creating babies, so it gives you a perfectly accurate representation of potential outcomes.
    • Config Settings and Real-time Controls
      • Genetic Variance: Adjusts how much a baby's base color can deviate from the exact center between its parents. Think of this as the "length" of the line between the parents.
      • Genetic Mutation Rate: Adjusts the random color scatter/mutations applied to babies. Think of this as the "thickness" of the line.
      • Simulated Offspring Per Second: Adjust the density of the 3D visualizer particle cloud. Each particle represents a potential baby.
      • Real-time Controls: While holding the guidebook, you can dynamically tweak the shape of the genetic probability cloud using the arrow keys: Left/Right Arrows adjust Genetic Variance; Up/Down Arrows adjust Genetic Mutation Rate.
      • Server and Client Sync: Since the particle visualizer is driven by the literal server-side breeding math, which is driven by the config for your server, and the changes you make with the arrow keys directly alter that config, the changes will take effect immediately for any future babies.
  • Recessive Eye Genetics
    • Hamsters now possess dominant (Black) and recessive (Red) eye genetics.
    • Red eyes do not exist in the wild. They are genetically tied to the "diluteness" (brightness/saturation) of the hamster's coat. A fully dilute hamster has up to a 50% chance of spawning with a recessive red eye gene. By selectively breeding highly dilute hamsters, players can uncover carriers (Br) and eventually breed Red-Eyed (rr) variants. Uses punnet squares.
  • Baby Growth Mechanics
    • You can now feed baby hamsters standard hamster food items to accelerate their growth.
    • To balance this with their natural pickiness, a new config option (Disable Baby Food Refusal) allows you to bypass their desire for dietary variety specifically for babies if you want. This is turned off by default, so to bypass their pickiness you'll need lots of Hamster Food Mix if you want to quickly grow them up.
    • Feeding baby hamsters visually and mechanically accelerates their growth in smooth, continuous increments, similar to vanilla horses. Their "extra big head" proportions scale dynamically as they grow.
  • Breeding Limitations
    • Added comprehensive config settings to manage hamster breeding for server owners who want to keep the population under control.
    • Added a global Enable Breeding toggle (on by default) to instantly shut down all romance.
    • Added a configurable Max Breeding Cycles limit per hamster to stop them from infinitely multiplying (off by default).
    • Added a Limit Breeding By Player toggle. (also off by default). Limits can be assigned per-player based on Minecraft days or Real Life days, or simply capped as a lifetime maximum limit. Includes feedback to explain what's happening when attempting to over-feed beyond the limit.
    • Added a /ahp reset_player_breeding_history command for server operators to reset their own breeding history.
    • Added a /ahp reset_hamster_breeding_history command for server operators to reset a specific hamster's timesBred quota to zero.
    • Added a convenient "Reset Breeding History" button in the Config screen that executes the command for the user (requires OP permissions).
  • Configurable Litter Size
    • Added to config sliders allowing you to set the minimum and maximum litter size when hamsters get into hanky-panky. The final size of the litter will be a random number between the min and max.
  • Breeder Whitelist
    • Added a config list allowing specific players to bypass the global breeding ban. In case your server needs a designated rodent baron.
  • Post-Breeding Animation
    • Hamsters will now crouch down and lovingly inspect their baby(s) after the litter is born, spawn heart particles, and make affectionate sounds shortly after successfully contributing to your growing population problem.
  • Wild Baby Configuration
    • Added Babies Spawn Wild setting. When enabled, babies are born feral and do not inherit their parent's ownership status, letting multiplayer groups decide who claims them.
    • When untamed, babies no longer flee from players, making them easier to manage.
  • Parent-Following
    • Babies will now randomly select a parent to follow until adulthood, instead of following their owner.
    • Wild baby hamsters will switch to following the player if their parent is currently mounted on the player's shoulder. They will automatically resume following the parent once it is dismounted.
    • If you want the baby to follow you instead, you must first tame it, then you can break its connection to the parent by right-clicking it with a Lure Item (Cheese by default).
    • Added a config toggle to disable the action bar message that warns you when a newly tamed baby hamster refuses to follow you because it's still attached to its parent.
  • Age Tracking
    • Hamsters now track their absolute lifetime age in ticks.
    • Wild hamsters spawn with a random age between 1 and 30 days.
    • Added /ahp set_age command to manually override a hamster's age (since older hamsters will start at 0 days old upon updating to this version of the mod). It accepts units (days, months, years) and provides autocomplete suggestions.
    • If you do not specify a target, it will automatically apply to the hamster you are currently looking at.
    • The Jade HUD overlay displays the hamster's age alongside its genetic data.
    • Added a new Display IRL Age config setting that dictates how fast the hamster ages. If true, their age progresses at 1/72nd the normal speed (matching the real-world 24-hour cycle).
• Performance Improvements
  • Significant Overall Improvements
    • Flattened the entire visual render layer stack (base coat, wild overlays, breeding overlays, skin, eyes, armor, and accessories) into a single, dynamically composited texture at runtime.
    • This completely eliminates all secondary GeoRenderLayer passes. Every hamster, regardless of its complex genetics or equipped items, now costs exactly one draw call to render (previously it was anywhere from 2 to 8!), resulting in a massive performance boost. Especially noticeable when numerous hamsters are on screen at the same time.
  • Bare-Bones Ultra Performance Mode
    • Added a new Performance Mode toggle in the config (and an assignable keybind) designed specifically for viewing absurd numbers of hamsters simultaneously without melting your GPU.
    • When enabled, it bypasses the dynamic texture engine entirely (falling back to a single flat texture) and hides almost all the model's geometry.
    • The hamsters essentially become grayscale cubes, stripping away nearly all matrix-calculation overhead.
    • The Jade HUD overlay will still display their exact genetic information, because the server never forgets what they are actually supposed to look like.
• New Config Settings
  • Wild Overlay Configurability
    • Added new Allowed Wild Overlay Zones list to the World Gen & Loot config. This allows server owners/modpack makers to explicitly control which color zones the genetics engine is allowed to use when picking an overlay for a naturally spawning hamster. Defaults to natural colors (WHITE, LIGHT_GRAY, DARK_GRAY, and CREAM).
    • Added new Restricted Base Colors and Clashing Overlay Colors lists. By default, these prevent CREAM and DARK_GRAY wild overlays from spawning on top of BLUE and LAVENDER base coats, as these color combinations tend to look a bit strange visually.
    • Added new Enforce Brighter Overlays and Enforce Muted Overlays toggles. Allows players to disable the overlay filtering that prevents saturated colors (like Cream) from spawning on muted bases (like Black) and darker colors from being used as overlays on top of lighter bases.
    • Modifying the overlay settings can dramatically change the number of possible combinations for wild hamsters (3,231 by default).
  • Red Eye Config Toggle
    • Don't like the red eye hamsters? You can visually disable that for your own client via a new config toggle, which makes them appear to have black eyes.
  • Friendly Fire Config Toggle
    • Added Prevent Owner Friendly Fire to the Core config toggles.
    • When enabled, players can no longer accidentally damage their own tamed hamsters. Disabled by default to remain vanilla-friendly.
    • In the next update (hopefully), this setting will be tied to a new item: the Acorn Ring. I also plan to integrate with the Trinkets mod so you can use a trinket slot for it.
  • Configurable Cuisine
    • You can now configure the nutrition and saturation values for all food items added by the mod (Cucumbers, Green Beans, Food Mix).
    • Changed nutrition/saturation values are dynamically reflected in AppleSkin's "on-eat" HUD preview. *Unfortunately due to major API changes between MC versions, this only works on 1.21.1.
  • Max Mounted Hamsters Config
    • Added a configuration slider under 'Shoulder Hamster Settings > Core Settings' allowing players to limit the maximum number of hamsters that can be mounted simultaneously (1 to 3).
• Gameplay Mechanics & Interactions
  • Tag Mini-Game
    • Hamsters can now initiate a playful game of tag. If you maintain eye contact with a hamster for a few seconds, it will squeak and excitedly run away.
    • The Chase: The hamster will flee if you get too close and stop to playfully taunt you if you fall too far behind.
    • Payoff: Successfully "catching" (right-clicking) the hamster before it gets bored ends the game triggers a celebration. The hamster will then spit out a random item from its cheek pouches as a gift (pulling from the configurable cheek pouch loot lists).
    • Stranger Danger: By default, you can play tag with wild hamsters and hamsters owned by other players. (Can be disabled in config).
    • Configurable Limits and Rewards
      • Added configs to control how often they want to play, the cooldown between games, and an anti-abuse cap on how many times a single player can play the game per in-game day (so they can't farm rewards).
      • Added configs to control rewards: By default, hamsters will randomly pick an item from their configurable "Cheek Pouch Loot" list (the list of potential items a wild hamster might spawn with). The item does not have to be in the hamster's cheek pouch for it to give it as a gift.
      • That can be disabled, in which case the hamster will choose the gift from a separate "Custom Tag Rewards" list in the config, which means you can make your hamster give you a diamond or any modded item (or whatever you want) when you catch it after a game of tag. Only server moderators can modify this of course.
  • Dynamic Gaze
    • Hamsters will now sustain eye contact with you indefinitely, provided you are nearby and continue looking back at them, and of course as long as they don't start a game of tag.
  • Hamster Yeet Overhaul
    • Thrown hamsters are now officially registered as ProjectileEntity instances while airborne. This provides automatic, out-of-the-box compatibility with external mods that use targets or hoops (such as the Tin Hoops in Caverns and Chasms).
    • Thrown hamsters now experience dynamic physics upon impact. They will ricochet backward off of walls and entities, or skip forward when hitting floors and ceilings.
    • Thrown hamsters now dynamically query and broadcast the native sound of the block or entity they strike (including modded blocks/entities).
    • Impact physics are magnified when hitting Slime blocks, and completely absorbed by Honey blocks.
    • Added a new config toggle (true by default) allowing thrown hamsters to damage their owner. Throwing your own rodent straight up in the air will now result in a realistic, concussive reunion on the way back down.
  • Precision Tree Heists
    • Right-clicking Oak Leaves with a lure item (Cheese) while a hamster is on your shoulder will now initiate a "Precision Tree Heist."
    • This sets that specific leaf block as the guaranteed exit point for the hamster.
    • While a precision heist is active, right-clicking in the air with the lure item will set the hamster's exit direction to match the direction you are currently looking.
    • Why? This allows you to precisely control the exact block and angle by which your hamster will exit the tree, which makes for much more predictable recording sessions.
  • Moonwalking Easter Egg
    • Name your hamster "Michael Jackson" or "Steve Irwin" and it will rotate backwards and remain that way until you change the name again.
  • Expanded Default Diet
    • Hamsters can now eat seeds from almost any mod out-of-the-box. Added a robust union tag to the default config that automatically syncs with #c:seeds and #forge:seeds to ensure compatibility across all versions and mod loaders.
• Failsafes & Rescues
  • Teleport Rescue Protocol
    • Overhauled how hamsters follow you across vast distances or dimensions (e.g., when using Waystones).
    • Instead of relying on their tiny legs and pathfinding AI to catch up, your player code will now safely scoop up any actively following hamsters (and their babies if the babies are following them), hold them in a little NBT pocket while the world loads, and drop them at your new location 0.75 seconds later.
  • Void Rescue Protocol
    • If a player falls into the void and dies with hamsters on their shoulders, the hamsters will no longer spawn in the void and immediately perish. The system will safely teleport them back to their linked bed. If they do not have a linked bed, they will be sent to the player's personal respawn point or the world spawn.
• UI, HUD, & Audio
  • Jade Integration
    • Added comprehensive Jade overlay integration that reveals a hamster's exact genetic makeup (base coat, wild overlay, breeding overlay, eye genotype, etc.) when you look at them.
    • Enabled without needing to turn on debug mode to help with breeding.
    • Fully customizable. Each setting comes with its own toggle, and you can decide which ones show up when you sneak to keep the Jade HUD de-cluttered.
  • GUI Renaming System
    • Players can now rename their hamsters directly from the Hamster Inventory screen.
    • Features dynamic down-scaling to ensure long names always fit perfectly within the UI constraints.
    • An interactive pencil icon and underline display when hovering/typing.
    • New Config Options (UI & Quality of Life > Hamster Renaming)
      • Enable GUI Renaming: Master toggle for the feature.
      • Consume Name Tag: Forces players to sacrifice a Name Tag from their inventory (or the hamster's cheeks) to finalize the rename.
      • Pencil Icon Placement: Allows swapping the icon to the left or right of the text for those who read in different directions.
  • New Audio & Visuals
    • Added a brand new anim_hamster_cheek_unload animation used for gifting items, complete with item and spit particle effects.
    • Added 4 new scratching sound variations for the cleaning animation, and switched to keyframes for the SFX to make it less repetitive and more realistic. This also has the side effect of muting the sound effect if the hamster is not on screen, and thus not being rendered. This means you will no longer hear nearby hamsters cleaning unless you can also see them.
    • Added dynamic item sounds (clink, squish, thud, etc.) to the new gifting sequence.
• Commands & Admin Tools
  • Advanced Spawning & Testing Commands
    • Added /ahp spawn hamster <basePalette> <wildPattern> <wildPalette> <breedPattern> <breedPalette> <eyes>. This command features a custom Brigadier auto-complete engine that suggests exact, human-readable palette and pattern names as you type, allowing you to easily test specific genetic combinations.
    • Added /ahp spawn_all_bases_2D. Systematically lines up every single hamster color base in the game (including custom community additions), sorted cleanly into rows by their dynamically determined, mathematical color zone.
    • Added /ahp spawn_all_bases_3D. Spawns the hamsters hovering in a physical 3D "cylinder" representing their Hue/Saturation/Brightness coordinates. This is useful for the Breeding Inheritance and Visualization Tool (see below).
      • Hue = the degree of the circle (0-360)
      • Saturation = the radius of the circle (more saturated colors are closer to the edge)
      • Brightness = the height of the cylinder (brighter hamsters are closer to the top)
      • By default, each /ahp spawn_all_bases... command spawns just the 45 base colors, but each one comes with 3 optional arguments to change the number of hamsters spawned:
      1. [with_wild_overlays] Displays all 3,231 hamster variants that can spawn naturally in the wild.
      2. [with_sample_breeding_overlays] Displays genetic combinations of every wild hamster but adds in a small sample of three breeding overlays (Tortoise Shell, Silver, and Rust). Due to the triple-multiplication math involved, this heavily increases the total number of hamsters spawned (from 3,231 up to 9,693) creating a much bigger display.
      3. [author] only uses color palletes from a certain author (e.g., jimcerberus or default).
    • Added /ahp spawn_all_possible_permutations_THIS_CAN_BREAK_YOUR_WORLD. Exactly what it sounds like. Don't run it unless you have a super-flat world, a fire extinguisher for your PC, and a lot of patience. Note that every time I have run this command, my server tick speed never quite returned to baseline— even after deleting all the hamsters that were spawned using /kill @e[type=!player].
    • Added /ahp print_genetics_report command, allowing server operators to recalculate and view the current 3D color-space math of the genetics engine at runtime. Useful because it dynamically updates its readout based on your exact AhpWorldGenConfig wild overlay settings, so you can see how your changes are affecting the total possible variant numbers without having to spawn them all.
  • Tree Heist History Command
    • Added /ahp reset_tree_economy for quick clearing of tree depletion memory without needing to open the config screen.
• Advancements
  • Advancement: Carat Confusion
    • Triggers when a hamster leads you to Gold Ore instead of Diamond.
  • Advancement: Load-Bearing Human
    • Triggers when you mount 3 hamsters simultaneously (Right, Left, Head).
  • Genetic Progression Advancements
    • Added "The Collector" advancement path tracking unique wild variants tamed (up to dynamic maximum based on configuration limits).
    • Added "The Breeder" advancement path tracking unique bred combinations (up to 1,000,000).
    • Added a conditional advancement "Seeing Red" for successfully breeding the recessive eye trait. Does not trigger if red eyes have been turned off in the config.
    • Implemented high-performance, non-bloating NBT storage using IntArrays to track thousands of HamsterGenome hashes without lagging the player entity.
• Guidebook Enhancements
  • Guidebook Delivery Fallback
    • Added a new configuration option that acts as a fallback for modpacks that disable auto-guidebook delivery on login.
    • If enabled (default), players will automatically be given the Hamster Tips guidebook and receive a chat prompt the very first time they spot a wild hamster from <=10 blocks away.
    • Targeting calculation includes wiggle room to ensure the event triggers even if the player's crosshair isn't perfectly on the hamster's hit box.
    • Only triggers once, and only if the player has never yet received the guidebook (regardless of current inventory status).
  • Lectern Reading
    • Added code for placing the Hamster Tips guide book into a lectern and an event handler so you can read it. You can now display your rodent knowledge in your base or wherever.
  • Hamster Tips Guidebook Improvements
    • The Hamster Tips guidebook now uses a custom string processor to pull live data directly into the text, so I can do things like automatically displaying the exact number of mathematically possible wild variants or the name of your dynamically configured Lure Item instead of hardcoding "Cheese".
    • Updated the "Regional Rodents" entry to explain the new biome-adaptive color logic, Wild Overlays and Jade integration.
    • Added a new "Breeding" entry in The Hamster Life chapter detailing the genetic mechanics, recessive red eyes, and feral youth mechanics.
    • Added a new "Admin Commands" entry in The Kitchen Drawer chapter detailing the various new (and old) commands the mod has to offer since some of them (especially the new ones) are super useful.
• Pixie-Dust Crown for Supporters
  • Added a dynamic, spinning, bobbing particle crown that renders above the heads of mod supporters. Uses a custom Pixie Dust particle system featuring a dense, short-lived, shimmering effect.
  • Emits a subtle sparkling sound and includes 5 different themes (Gold, Crimson, Lavender, Ice, Emerald) by manipulating the HSB color values of a single grayscale texture at runtime.
  • Automatically hides in first-person view to prevent visual obstruction.
  • Powered by a remote manager that pulls configuration data asynchronously from GitHub and caches it for offline use. You will need to briefly connect to the Internet while launching Minecraft at least once to verify your ownership of the Crown. After that you can play offline and still see it!
  • Configurable Aesthetics
    • Added a new Supporter Perks config group.
    • Added a global toggle to disable rendering of all crowns if you hate fun.
    • Added a global toggle to disable sound effects of all crowns.
    • Added a local toggle to allow rendering your own crown in first-person mode if you want to both obstruct your view and thrill yourself.
    • Added sliders for sound volume, particle count, crown radius, crown height, crown thickness, and vertical offset.
    • Added a new "Toggle Supporter Crown" keybind allowing users to show/hide their own crown from both themselves and the rest of the server. A single press cycles the crown to the next available color theme, while a double-tap toggles the crown's visibility.
    • Supporters can pick their own crown color. Your preference syncs instantly to all other players looking at you utilizing DataTracker networking.

Changed

• Location-Centric Spawning Overhaul
  • Completely rewrote the world generation spawning logic. Instead of mapping individual hamster colors to biomes, biomes are now grouped into 9 "Spawning Environments" (e.g., Icy, Sandy, Forest, etc.)
  • Each environment rolls against weighted hamster color groups. This ensures that whether a texture is procedurally generated or community-made, it mathematically evaluates its own color and automatically spawns in a biologically appropriate location.
• Diamond Sniffing Visuals & Audio
  • Added directional animations to indicate whether a buried diamond ore is above or below the hamster when it's sniffing for one and the path is obstructed.
  • Added a dynamic "quick bounce" animation that intermittently triggers when the diamond ore is hidden somewhere above the hamster.
  • Added a new head-shake sound effect that plays when the hamster is sniffing for ore and gets confused.
• Sweet Potato Easter Egg
  • The "Sweet Potato" Easter egg now applies a unique custom texture to the hamster, thanks to @jimcerberus!
  • Renaming a hamster "Sweet Potato" hides its normal genetics (base coat, overlays, and eye color) without permanently deleting them.
  • Sweet Potato hamsters can still breed, and their offspring will genetically inherit traits mathematically blended from the sweet potato's unique color palette, but they do not spawn in the wild.
• Jade HUD Config Settings
  • Added a new "Jade Overlay Settings" section to the config under "UI & Quality of Life".
  • Displays complex genetic info (Age, Base Coat, Wild Overlay, Breeding Overlay, Eye Color) by default.
  • Added a "Require Sneaking" toggle (disabled by default) allowing you to hide the genetic overlay unless you are actively sneaking.
  • Added individual toggles for every piece of my custom genetic info shown in the Jade overlay.
  • Added additional toggles for selectively disabling default Jade info lines (Name, Health, Growth Time, Owner, Inventory) specifically for hamsters without impacting other entities, and a toggle to link their visibility to the player's sneaking state, allowing you to completely customize the HUD to your liking.
  • Built a smart-formatting engine so that community texture IDs are automatically converted into localized, human-readable titles on the HUD (e.g., cheesecake_mocha.png -> "Cheesecake Mocha").
• Statue Performance & AI Toggling
  • Hamsters spawned with their AI disabled will now completely freeze their animation playback and no longer emit ambient idle squeaks. This attempts to reduce client-side rendering lag when hundreds of thousands of hamsters are on screen for testing, but Java itself struggles with that many cubes on screen, so it's still laggy if you try to look at 2 million+ hamsters simultaneously.
  • You can now tame an AI-disabled hamster, which will instantly "wake it up" and turn it into a real, fully functional hamster.
  • Added an Allow Taming to Re-Enable AI toggle to the config in case you're a server owner who wants to sell specific hamster breeds in a shop. If you have OP permissions on your server, you can turn this off to prevent players from taming and "waking up" frozen hamsters, allowing them to be used as shop displays or decorative statues.
• Mod Page/README
  • The README was functioning as a marketing poster, a technical manual, a credits roll, and a tutorial. That is too many jobs for one file.
  • It was getting too large, so I have reorganized it, reworded it, and split a few things off into other easily accessible files, so the README only has one job now.
• Mount Priority
  • Changed default config value to HEAD_FIRST.
• Action Bar Config Toggles
  • Grouped all action bar message toggles (Shoulder Dismount, Tree Heist Start, Bed Break, Tamed Baby Warning, and Display Duration) into a new "Action Bar Messages" sub-category under "UI & Quality of Life" for easier access.
• Guidebook
  • Updated Hamster Bed entry to explicitly mention the Totem of Undying requirement for respawning.
• Guidebook Effects
  • If you obtain the Hamster Tips guidebook while viewing a chest or crafting screen, the "rediscovered" visual and audio effects will now be postponed until you close the screen, ensuring the effects do not play while you're looking at your inventory.
  • If you keep the screen open for longer than 5 seconds after obtaining the book, the effects are silently cancelled.
• Cucumber Rebalance
  • Sliced Cucumbers are no longer inexplicably nutritious. Their default food value has been dropped from 2 hearts to 0.5 hearts to match items like Dried Kelp.
• Hamster Hitbox Adjustment
  • Shrunk the physical hitbox of hamsters by 15% to more accurately match their actual visual model size.
  • Note: Because the bounding box is now smaller, you will need to aim slightly more accurately when trying to interact with a hamster.
• Patchouli Version
  • Updated the internal guidebook generation logic to accommodate API breaking changes introduced in Patchouli version 1.21.1-93.
  • You must update Patchouli to the latest version or the game will not launch.
• Shoulder Animation Configs
  • Replaced the single Forced Animation State setting with three distinct settings. You can now independently force the Head, Left Shoulder, and Right Shoulder hamsters into specific animation loops (when dynamic animations are disabled).
• Tree Heist Exits
  • Hamsters will now perform a small outward jump, launching themselves away from the tree upon successfully completing a Tree Heist.
• Breeding Cooldown Config
  • The config setting for breeding cooldown has been changed from Ticks to Seconds to make it significantly easier to manage with the slider.

Fixed

• Config Live Changes
  • Fixed an issue where changing settings in the World Gen & Loot config (such as wild bush or hamster spawning settings) required a full game restart to take effect. Saving changes to any config now recalibrates the mod's logic caches on both the client and the server.
• Visual Rotation Glitch
  • Attempted to fix an issue where using teleportation mods (like Waystones) or interrupting animations could cause the hamster's model to become permanently rotated backwards or upside down on the client side.
  • I can't be 100% certain about this fix yet, because no one has been able to figure out exactly what causes it and I can't re-create it myself, so let me know if you run into it.
• Hamster Stretching with Shaders
  • Fixed a visual bug where hamsters would stretch to extreme sizes during multiplayer server lag or when pausing the game.
• Dismount Bug
  • Fixed an issue where holding down the Sneak key for more than a second would cause the OS's auto-key-repeat feature to spam the game with inputs, dismounting all of your shoulder hamsters rapidly.
  • You can now safely hold Sneak without losing your friends.
  • This bug has existed ever since the double-tap setting was added, but I hadn't found it because I usually play with Sneak set to "Toggle" (which means I have no reason to hold it down for extended periods).
• Memory Optimization
  • Implemented pre-caching for texture identifiers and simplified rotation math in the render loop to eliminate extra memory objects being generated every frame.
• Spanish Localization
  • Some strings in the Hamster Tips guidebook were still outdated (i.e., the Accessories and Sunflower pages).
• Malformed Recipe
  • The sliced_cucumber_from_cutting_board.json recipe for compatibility with Farmers Delight failed to load on 1.20.1 due to a typo.
• Acorn Inflation
  • Fixed a decimal point error where Oak Leaves dropped Acorns at a 5% rate instead of the intended 0.5% (now it correctly matches vanilla Apple rarity).
• Guidebook Effects
  • Fixed an issue where moving the Hamster Tips guidebook around in your own inventory would sometimes re-trigger the "rediscovered" sound and particle effects.
  • Added a 30-second grace period to the guidebook tracking system. Prevents the effects from spamming if you move it between inventories, or drop it and pick it back up.
• Pink Petals Bug (1.20.1 only)
  • Fixed an issue where Pink Petals would visually apply to all three locations simultaneously when first equipping them or reloading a world.
• Hamster Bed Linking
  • Reduced the maximum stack size of Hamster Beds to 1. Not only does this feel like the way it always should have been, it resolves an issue where holding a stack of beds and right-clicking a hamster would link the entire stack simultaneously.
• Invisible Hamster Glitches
  • Solved a vanilla Minecraft issue where hamsters (and other pets) get left behind in unloaded chunks because their AI stops ticking before they can teleport.
  • Fixed a related bug where teleporting hamsters would sometimes successfully arrive but remain completely invisible to the client until you relogged. The new Teleport Rescue Protocol bypasses these vanilla quirks entirely.
  • Overhauled shoulder-hamster data synchronization to prevent them from becoming invisible upon player respawn if they were configured to respawn with the player when the player fell into the void.
• Ghost Bed Crash
  • Fixed a server crash that occurred when a hamster's linked bed was destroyed while the hamster was sleeping or unloaded. Hamsters will now detect the missing bed, cancel their sleep effects, and unlink themselves to prevent future issues.
• Bed State
  • Fixed an issue where chunk load order could occasionally cause a sleeping hamster's bed to visually revert to an "unoccupied" state across server restarts.
• Shoulder Hamster Physics
  • Capped the maximum vertical offset in the shoulder hamster physics simulation. This prevents hamsters from visually floating too far off the player's shoulders during long, extreme falls.
  • This was mostly an issue with resource packs that add cool player animations to the arms. The shoulder hamsters are locked to the arms of the player, so when the arms go out to the sides during a fall, the shoulder hamsters would cross over the midpoint of the head. This doesn't fix the issue 100% (I'm not sure if that's even possible with pretty player animations) but makes it a bit less obvious.
• Shoulder Cleaning Loop
  • Fixed a bug where a hamster mounted to the player's shoulder mid-cleaning would get permanently stuck in the cleaning animation when it was supposed to be sitting while on the shoulder.
• Jade Debug Overlay
  • Fixed an issue where the Jade debug toggle book-interaction failed to update the client config on dedicated servers.
• Non-Dynamic Taming Food
  • Fixed a bug where wild hamsters would still flee from players attempting to tame them using anything other than Sliced Cucumber. Now correctly uses the configurable "Taming Foods" from the config.
• Suicidal Hamsters
  • Hamsters will no longer choose to run through lava or fire when cornered and fleeing from a player. They will now properly recognize these hazards as completely impassable terrain.
• Immersive Engineering Compatibility
  • Fixed a data formatting error in the Garden Cloche recipes for cucumbers and green beans that caused the game to crash upon world creation or loading. (Thanks to @CasualAnimalEnjoyer for the fix!)