The Cuteness Overhaul Update

Beds, wander mode, new animations, suspiciously advanced leaf physics, and more!

Give your tamed hamsters an actual home with the new Hamster Bed, Wander Mode, and cozy bedding that doubles as a tiny leaf particle generator. Yeeted hamsters are now cuter, more terrifying, and broadcast their sound effects farther, so your friends can fully appreciate incoming fur missiles. Added new animations, updated some existing ones. Under the hood, variant spawning is now fully biome-configurable and a pile of long-suffering bugs—ghost shoulder hamsters, startup crashes, and more—have finally been escorted off the premises.

Added

• Fully Configurable Biome-Based Variant Spawning System
  • The logic determining which hamster color variants spawn in which biomes is no longer hardcoded.
  • It is now entirely driven by new settings in the config file under Spawn Settings > Variant Spawning by Biome.
  • Users can now define custom lists of biome IDs, biome tags (including c: convention tags), and exclusion lists for each of the seven main color variants/biome groups (Blue, Lavender, White, Gray, Black, Cream, and Chocolate).
  • This provides significantly greater compatibility with world-generation mods like Terralith and Biomes O' Plenty, allowing users to fine-tune hamster diversity in any modded environment. The default values have been set to preserve the existing spawning behavior that was present already.
  • The Orange variant acts as the default fallback and will spawn in any biome where hamsters are allowed that does not meet the criteria for the other configured colors. That's why it does not have its own set of biome lists in the config.
• Hamster Yeet Audio Overhaul & Visual Enhancement
  • Completely re-worked the hamster_flying animation. It's now much cuter. Not that you'll ever see it, unless of course you record yourself throwing the hamster with the Flashback mod. Hint hint. It's quite fun.
  • Re-designed the hamster_throw sound so you can hear the hamster's ears flapping in the wind, which is part of the updated animation.
  • The throw sound now plays directly at the thrower's location, ensuring the full baked-in Doppler effect is heard instead of cutting off abruptly as the hamster flies outside Minecraft's 16-block sound attenuation cutoff.
  • Added a new predictive "incoming" sound effect (reverse Doppler) that plays at the target's location, giving victims a one-second audible warning before impact.
  • Thrown hamsters now dynamically rotate their pitch to match their flight trajectory (nosing up when ascending, down when falling) instead of remaining perfectly horizontal like a frisbee.
  • Implemented a custom sound broadcasting system for long-range throws. Players between 16 and 50 blocks away (who would normally hear silence due to vanilla limits) will now hear a faint impact sound, which dynamically adjusts its volume and changes type depending on whether the hamster impacted a block or an entity. Similar to the old logic, but now you'll actually hear something if you're trying to throw a 50-yard pass.
• New Block: The Hamster Bed
  • Introducing the Hamster Bed, a new block that serves as an anchor point for the new feature, Tamed Wander Mode.
  • Craftable with a new "Hamster Bedding" item and wood planks. It comes in all nine vanilla wood variants (Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, and Bamboo).
  • A tamed hamster can be linked to a bed by right-clicking it with the bed item in hand. The bed item will then store the hamster's data. Placing the linked bed in the world activates Wander Mode for that hamster.
  • Placing the bed while targeting the underside of a block places it upside-down, triggers a new advancement, disables the bed's sleep function until it is broken, and begins to spawn floaty, cozy leaf particles. More on that in a sec.
• New Item: Hamster Bedding
  • Added "Hamster Bedding," a new crafting component for the Hamster Bed, made from a cozy blend of leaves, podzol, and dead bushes. (The leaves will be replaced with Leaf Litter when I port the mod to 1.21.5, giving them a fun purpose).
  • Beyond its use in crafting, this item can be used by hand or from a Dispenser to release a decorative cloud of leaf particles, perfect for adding a touch of autumnal ambiance to your life.
• Advanced Particle Physics System for Bedding
  • The new leaf particles are driven by a custom client-side physics simulation with two distinct behavioral models.
  • Particles spawned from bed interactions use a standard gravity-and-friction model for a simple settling effect.
  • Particles spawned from an upside down Hamster Bed, the Hamster Bedding item or a dispenser use a "floaty" physics model, featuring a gentle pendulum-like sway based on sinusoidal motion.
  • This floaty mode includes a deterministic, spatially-coherent wind gust simulation. It uses a grid-based hashing function to ensure particles in the same area react to the same pseudo-random wind events, creating synchronized, emergent behavior.
• New Intelligent Indoor/Outdoor Detection Algorithm for Particles
  • Implemented a custom algorithm to prevent the wind gusts from the particle system from having an effect on particles that are "indoors."
  • The system analyzes three environmental factors in real-time: skylight levels, vertical roof clearance, and horizontal openness (i.e., proximity to open doorways or windows).
  • It uses a high-performance caching system to minimize performance impact and employs hysteresis to prevent visual flickering when particles are near the threshold between an indoor and outdoor space.
• New Feature: Tamed Wander Mode
  • Tamed hamsters can now be set to "Wander Mode," allowing them to roam freely within a configurable radius of their linked bed instead of constantly following the player.
  • Activation: Link a Hamster Bed item to a hamster, then place it in the world.
  • Control: Right-click the placed bed to toggle Wander Mode on or off for the linked hamster. Sneak + right-click to cycle through three wander distances (Near, Medium, Far), which are configurable.
  • Hamsters in Wander Mode will automatically seek out their bed to sleep based on the time of day (or the "Circadian Chaos" random timer) if enabled in the config.
• Added "The Great Escape" Guide Book Entry:
  • Details the crafting and use of the new Hamster Bed and Hamster Bedding items, featuring custom artwork.
  • Explains how to link a bed to a hamster to enable "Tamed Wander Mode."
  • Outlines all interactions for configuring wander distance, luring to bed, and unlinking.
• New Animations and Sounds for Sit/Stand/Sleep
  • Added new animations for sitting down, standing up, and waking from sleep.
  • Added new hamster_swish and hamster_thump sound effects that play during these transitions, making interactions feel more realistic and fun.
• New Dispenser Behavior for Hamster Bedding
  • Dispensers can now be loaded with Hamster Bedding. When activated, they will shoot out a decorative puff of the new floaty leaf particles, consuming one Hamster Bedding item.
• New Advancements for Wander Mode and Crafting
  • Added a new branch to the "The Hamster Life" advancement tab to guide players through the new features.
  • New advancements include: "Artisanal Floor Mulch" (crafting bedding), "Luxury Leaf Pile" (crafting a bed), "Home is Where the Leaves Are" (linking a bed), "Sweet Dreams 'r Made of Leaves" (hamster sleeping in a bed), and a hidden challenge advancement for placing a bed upside-down.
• New Jade Integration for Hamster Bed
  • If the Jade mod is installed, looking at a Hamster Bed will now display a detailed tooltip.
  • It shows which hamster the bed is linked to, whether Wander Mode is active, the current wander distance, and whether the hamster is allowed to sleep in the bed. Sneaking reveals detailed instructions on how to control the bed's functions.
• Added Compatibility for Croptopia, Immersive Engineering, Serene Seasons, and Thermal Expansion
  • A huge thank you to @CasualAnimalEnjoyer for creating 30 new resource files to ensure out-of-the-box compatibility.
  • Croptopia: Food recipes now accept AHP vegetables via tags. Seed crafting recipes have been separated to ensure crafting an AHP vegetable yields an AHP seed, preventing conflicts with Croptopia's own seed recipes.
  • Serene Seasons: Cucumber and Green Bean crops now have defined growing seasons and will bloom accordingly.
  • Tech Mods: Added support for growing Cucumber and Green Bean crops in the Immersive Engineering Garden Cloche and the Thermal Expansion Phytogenic Insolator.
• New Mod Icon
  • Huge thanks to @The Retro Stitcher for re-designing the mod's icon!

Changed

• Announcement icon position in Creative Inventory
  • The announcement bell icon that appears in the Creative Inventory screen has been moved from the bottom-right corner to the top-right corner of the screen.
  • This relocation prevents the icon from being overlapped by popular inventory utility mods such as JEI, REI, and EMI.
  • The maximum configurable X/Y offsets for the creative inventory widget have also been increased from 100 to 500 to allow for greater user customization.
• Improved the "Settle to Sleep" Animations
  • Tweaked the "Settle to Sleep" Animations to make them considerably cuter and more compatible with scenarios where the hamster might be "jumping into bed."
• Smarter Hamster Pathfinding (Bed Avoidance)
  • Hamsters now have a custom navigation system that makes them aware of Hamster Beds.
  • By default, a hamster will now attempt to pathfind around any Hamster Bed that is not its own linked bed. After all, hamsters can be a bit territorial irl.
  • To prevent hamsters from getting stuck in complex environments, they will only try a few alternate routes before giving up and taking a more direct path. This avoidance behavior can be disabled in the config.

Fixed

• Personality ID assignment for command-spawned hamsters
  • Resolved an issue where hamsters created using the /summon command were not being assigned a random "personality ID," causing them all to use the same animations and sitting poses.
  • This was caused by the /summon command bypassing the initialize() method where the ID was being set.
• Orange hamster spawning in Stony Shore biomes
  • Fixed a bug where orange hamsters were incorrectly spawning in the minecraft:stony_shore biome instead of the intended light/dark gray variants.
  • The biome was being correctly excluded from the "white" variant spawn list but did not match any other specific criteria, causing it to fall back to the default orange variant. The spawn conditions for gray hamsters now explicitly include this biome.
• Startup crash (StackOverflowError) related to the announcement system
  • Fixed a critical StackOverflowError crash that would occur on game launch if the "Snooze (Session)" feature had been used in the previous session.
  • The crash was caused by a recursive loop in the AnnouncementManager's initialization logic. The redundant check causing the loop has been removed.
• "Snooze (Session)" functionality and state synchronization with Patchouli
  • The "Snooze (Session)" button now correctly snoozes only the specific announcement being viewed, rather than incorrectly disabling all notifications globally for the session.
  • The underlying disabled_until_launch system, which was the source of the startup crash, has been completely removed and replaced with a non-persistent, in-memory list for session-snoozed items.
  • Fixed a bug where announcements snoozed for the session would remain marked as "read" in the Patchouli guide book after restarting the game. The system now correctly syncs the "unread" status of all pending notifications with Patchouli's data when a world is loaded.
• Ghost Shoulder Hamsters on Player Death
  • Resolved a critical bug where shoulder-mounted hamsters would remain on the player after death, becoming permanently stuck. They will now correctly spawn at the player's death location in a 'knocked out' state, and a new config option allows players to keep them on their shoulder upon respawn if desired.
  • Implemented a backward-compatibility fix to ensure any hamsters that were previously stuck on a player's shoulder can now be dismounted correctly.
• Stale triggerable animations playing when entity is rendered
  • Fixed a visual desynchronization where a one-shot animation (like the "Settle to Sleep" transition) triggered while a hamster was off-screen would play belatedly as soon as the hamster was rendered, causing it to be out of sync with the new sound effects.
  • A server-side cancellation scheduler now ensures that any triggered animation automatically expires if it has not been played by a client within its expected duration.
• Hamster and wild bush spawning on Sculk, Clay, and Moss blocks
  • Black hamsters can now correctly spawn on Sculk blocks, decreasing their unintentional rareness in the Deep Dark biome.
  • Wild Green Bean and Wild Cucumber bushes can now generate on Clay and Moss blocks, allowing them to spawn more frequently in biomes like Swamps, especially if you have a mod that modifies the block palette of the ground in those areas.
• Resolved "Unknown message ID" errors on dedicated servers (1.20.1)
  • Split the 1.20.1 network packet registration into distinct client-to-server and server-to-client methods. (This had already been done on 1.21.1)
  • Ensured that the server correctly registers handlers for client packets (like render state updates), preventing disconnects or log errors when players interact with hamsters.
• Corrected Gray Hamster spawning in deserts.
  • Gray hamsters were incorrectly spawning in sandy biomes like deserts, where Cream hamsters are intended to appear.
  • Added the c:is_sandy tag to the Gray variant's exclusion list to prevent this overlap.
  • Note: If you're still seeing Gray hamsters in deserts, navigate to Spawn Settings > Variant Spawning > Gray Variants > Excluded Tags in the config menu, right-click the setting, and select "Restore Defaults."
• Fixed Uninteractable Hamsters with Force-Mount Keybind
  • Resolved a critical bug where enabling the "Force Shoulder Mount" keybind in the config would prevent all interactions with tamed hamsters.
  • This was caused by the server trying to access client-side keybinding code.
  • The logic has been refactored to use a network packet, ensuring interactions work correctly regardless of the keybind setting.
• Resolved World Gen Config Weirdness
  • Previously, world-gen settings like spawn weights and biome lists were locked on the title screen because they were bundled with other synced server settings, making it impossible to configure them before creating a Singleplayer world.
  • The configuration system has been restructured: clicking "Adorable Hamster Pets" in the mod menu now opens a new landing page with two distinct buttons: "Main Settings" (gameplay & client options) and "World Gen Settings".
  • The new "World Gen Settings" menu uses a special save mode (SaveType.SEPARATE), allowing you to freely edit your local defaults for Singleplayer worlds while still respecting server-side overrides when joining a Multiplayer server.

The More Polite Notifications Patch

The announcement system was always intended as a personal touch—a cozy newspaper to share news and updates directly while you sip your coffee. But your feedback made it clear that 'personal touch' can feel a bit intrusive when you've got two or three hundred other mods vying for your attention. I get it.

This patch is all about handing the controls over to you. Based on some fantastic feedback, I've added a suite of new more accessible options to let you decide exactly how—or if—you see notifications. The goal is to keep the feature useful for those who want it, while making it completely unobtrusive for those who don't.

Added

• Added click-and-drag functionality to the announcement screen scrollbar.
  • You can now scroll down on announcements by dragging the scrollbar handle with your mouse, in addition to using the mouse wheel.
• Enhanced control over the announcement system with new UI options and quality-of-life features.
  • A new "Enable Announcements" master switch has been added to the config screen, allowing you to control all notification icons at once.
  • You can now instantly mark all announcements as read from a new button in the config screen.
  • A "Snooze (Session)" button is now available on the announcement screen to temporarily hide all notifications until the game is restarted.
  • Holding Shift while clicking "Mark As Read" on any announcement will now mark all pending notifications as read.

Changed

• The inventory key now closes the announcement screen.
  • Pressing the inventory key (default 'E') while viewing an announcement will now correctly close the screen, mimicking standard Minecraft UI shenanigans.
• Overhauled the announcement screen's action buttons for clarity and control.
  • The button layout has been reorganized into two rows and simplified. The old, confusing "Disable These" button has been replaced with a clearer "Disable All" button that permanently turns off the notification icons (this can be undone in the config).
• Patchouli's "Mark All as Read" button now includes announcements.
  • The "Mark All as Read" button on the main page of the Hamster Tips guide book now correctly marks all pending announcements as read in both Patchouli's system and mine, so now it behaves exactly as you'd expect it to.

Fixed

• Resolved major UI scaling issues with the announcement screen.
  • The entire announcement GUI (background, content, and buttons) now dynamically scales down to fit the available window space, preventing elements from being cut off.
• Attempted fix for a startup crash on NeoForge with large modpacks.
  • A NullPointerException was reported by one person on game launch, likely caused by a race condition with the new announcement system in heavily modded environments. While I couldn't reproduce the crash myself, I've refactored the system to initialize itself on demand, which should resolve this kind of loading order issue. This change is safe and may prevent similar problems in the future.
• Removed the concept of "mandatory" announcements.
  • You are now the master of your own notification destiny. The system no longer distinguishes between optional messages and "mandatory" update notifications, giving you full control to dismiss, snooze, or disable any and all announcements as you see fit.
• Upgraded Fzzy Config library to resolve UI bugs.
  • Updated from v0.7.0 to v0.7.3 to fix an issue where nested, collapsed groups in the config screen would incorrectly appear expanded by default. This should make navigating the configuration screen much less overwhelming.
  • This Fzzy Config update also resolves a data generation bug that was preventing tooltips from appearing for the "Survival Inventory" and "Creative Inventory" announcement bell icon offset settings.

The Server Sanity Patch

This is a quick but critical hotfix to address a series of unfortunate events that followed the 3.3.0 update, primarily aimed at making dedicated servers not immediately burst into flames.

Long story short: dedicated servers should now launch without issue, and the new announcement system will no longer crash your client for the crime of being too efficient. Your game should be much happier now.

Fixed

• Resolved multiple dedicated server crashes on startup.
  • Fixed an AbstractMethodError crash by correctly separating the registration of client-side packet handlers from the common registration of packet types.
  • Fixed an InvalidMixinException crash by moving several client-only mixin accessors (ClickableWidgetAccessor, GuiBookAccessor, etc.) to the client-specific section of the mixin configuration file.
• Fixed a NullPointerException when dismissing a single announcement.
  • This occurred when the notification icon was clicked from an inventory screen with only one pending notification. The system now correctly uses the fully initialized virtual BookEntry from Patchouli's data, preventing the crash.
• Corrected the "See Changelog" button URL in the announcement screen.
  • The URL was missing the required version and loader suffix, causing it to lead to a 404 page on Modrinth. It now generates the correct link for the specific version.

The Patchouli Page-Turner Update

Hamster Tips guide book graduates to Patchouli, and your game now gets a special update notes system that can pull live from my GitHub repo.

THe Hamster Tips guidebook is completely overhauled with Patchouli's built-in tools + my own custom UI, smarter text wrapping, and automatic upgrades from the old guide book. A physics-simulated notification bell (with hamster ears) flags unread notes— all configurable and snoozeable— and virtual entries in Hamster Tips open the new markdown viewer without leaving the game. Under the hood, a new smart ownership algorithm ends pet-on-pet friendly fire, and translators also get a tidier language file.

Added

• New Patchouli Guide Book
  • Replaced the original vanilla written book with a comprehensive, feature-rich guide book powered by the Patchouli library.
  • Features a completely custom user interface, including a unique book texture and a custom-coded landing page layout with a wrapped, multi-line subtitle for a more polished presentation than what Patchouli offers by default.
  • Implemented a dynamic text wrapping and pagination system for entry titles, ensuring that long or translated titles do not render off the edge of the page.
  • Includes a robust backwards-compatibility system that automatically detects and upgrades any old guide books found in a player's inventory or any opened container to the new Patchouli version.
• Client-Side Announcement & Update Notification System
  • Implemented a robust client-side notification system capable of fetching a manifest.json and individual markdown files from a public GitHub repository.
  • This allows for the delivery of announcements and "What's New" update notes to players without requiring a mod update.
  • The system intelligently compares the player's installed mod version against the latest version in the manifest to create "Update Available" notifications, which can be snoozed.
• Dynamic HUD & GUI Notification Icon
  • Added a new notification icon (a bell with hamster ears) that appears on the main game HUD and compatible GUI screens when unread notifications are pending.
  • The icon is driven by a custom, render-frame-timed physics animator using a spring-damper model to create organic, natural motion. When moving between positions (e.g., when opening the recipe book), the icon smoothly accelerates and decelerates, with a slight rotational kick and overshoot for a more dynamic feel.
  • Upon reaching its destination, it performs a brief "settle wobble" before coming to a rest. The icon also features a periodic idle wiggle animation, and smoothly scales up on hover for satisfying tactile feedback.
  • The icon dynamically repositions itself to remain anchored to the corner of inventory screens, organically transitioning to its new location when the GUI shifts, such as when opening or closing the recipe book.
  • Its tooltip is dynamic, displaying context-aware text like "New update available," "New announcement," or "What's new in vX.Y.Z."
• Custom Markdown-Powered Announcement Viewer
  • Created a new, custom GUI screen for displaying announcement and update content, replacing the standard Patchouli entry page for these notifications.
  • The viewer features a full Markdown renderer that supports headings, bold/italic text, lists, code spans, clickable links, and dividers.
  • Includes a set of vanilla-style buttons for actions like "Mark as Read," "Remind Me Later" (snooze), "Disable These," and "See Changelog," with dynamic positioning depending on which buttons are present.
• Virtual Patchouli Integration for Notifications
  • Virtually injects two new categories ("Announcements" and "Update Notes") and their corresponding entries into the Hamster Tips guide book at runtime.
  • This leverages Patchouli's list-rendering and unread-marker system without requiring any physical json files in the mod's JAR.
  • Clicking a virtual entry opens the custom announcement GUI instead of the entry (because there is no entry), and mixins have been added to prevent the "Mark All Read" button from affecting these virtual entries, and to prevent them from showing up in main "Entry Index" list.
• New Announcement Icon Configuration Options
  • Added extensive new settings to the config to control the announcement system, including toggles for the HUD and in-GUI icons.
  • Players can customize the HUD icon's screen position, scale, and offset, as well as the offset for the in-GUI widget icon.
  • New ConfigAction buttons allow players to reset their entire announcement history or re-enable optional announcements if they were previously disabled.
• New Configuration Options for Health and Mounting
  • Added Wild Hamster Max Health and Tamed Hamster Max Health settings, allowing players to customize the health pools for both wild and tamed hamsters independently.
  • Added an Enable Force-Mount Keybind option (disabled by default) that, when enabled, allows players to mount a nearby tamed hamster by pressing a dedicated keybind, without needing to hold a specific item.
  • Added a Consume Shoulder-Mount Item toggle (enabled by default) that controls whether the item used to lure a hamster onto the player's shoulder is consumed in the process.
• Farmer’s Delight Cutting Board Compatibility
  • Added cutting board recipe support for cucumbers → sliced cucumbers.
  • Thanks to Cashhew for the contribution!
• Smart Pet-Ownership Algorithm (under the hood)
  • New logic that recognizes your pets across Minecraft’s many creatures (wolves, cats, parrots, horses—and most modded pals).
  • It doesn’t just “check a box” — it can figure out ownership even when a pet only stores a hidden ID instead of a visible owner link.
  • Built to prevent friendly-fire even with all the chaos: thrown hamsters, indirect hits, and weird edge-cases from other mods. (See "Fixed" section for more details)
  • Designed to be fast and lightweight so it won’t slow your world down.
  • Future-proofed: works across loaders and should play nicely with most other mods out of the box.

Changed

• Optimized Language File Generation
  • Refactored the data generation process for the en_us.json language file to eliminate the creation of redundant, prefixed translation keys for the configuration screen.
  • This results in a smaller, cleaner, and more efficient language file with no impact on in-game text. Easier translating!

Fixed

• No More Pet-on-Pet Drama
  • Thrown hamsters now bounce off your own tamed pets (wolves, cats, parrots, horses—and most modded pets) instead of hurting them.
  • I designed a friendly-fire smart ownership algorithm that figures out who owns what—even when a pet only remembers you by an internal ID.
  • Works both ways: your other pets can’t hurt your tamed hamsters either.
• Resolved Server Crash on Hamster Throw
  • Fixed a NullPointerException that would crash dedicated servers when a player used the "Throw Hamster" keybind.
  • The crash was caused by server-to-client sound packets being registered only on the client, leading to an error when the server attempted to send them.
  • All network packet registrations have been consolidated into a single, common method, ensuring both the server and client are aware of all packet types.
• Corrected Configuration Synchronization
  • Replaced the incorrect @ClientModifiable annotation with the appropriate @NonSync annotation for all client-side settings in the configuration file.
  • This change prevents a potential issue where clients could modify server-synced settings without permission and ensures that client-only settings (like UI and animation options) are handled correctly.

The Multi-Shoulder Hamster & Mega-Configurability Update

Just when you thought your shoulders were safe, I've gone and turned them into a hamster condominium. This update completely overhauls the shoulder pet system, adds a frankly irresponsible amount of configuration, injects a hefty dose of unnecessary realism, and more!

Added

• Multi-Hamster Shoulder & Head Mount System
  • Players can now have up to three hamsters mounted simultaneously: one on each shoulder and one on their head.
  • The mounting system will automatically place a hamster in the next available slot (Right Shoulder -> Left Shoulder -> Head).
  • Shoulder-mounted hamsters will automatically adjust their offset to fit both slim and wide player models, and will sit even further out to rest on top of equipped chestplates.
  • A configurable dismount order (LIFO/FIFO) determines which hamster is removed first by the standard dismount key.
  • Added a client-side hand-swing animation when mounting a hamster to the player's shoulder.
• Dynamic & Reactive Shoulder Hamster Animations
  • Shoulder-mounted hamsters are now fully animated using their primary GeckoLib model and no longer use a separate, static vanilla model.
  • They dynamically cycle through standing, sitting, and unique, slot-specific "laying down" animations.
  • Hamsters now react when the player sprints by entering their "laying down" animation, as if holding on for dear life. A randomized micro-delay ensures each hamster reacts independently.
• Physics-Based Animation for Shoulder Hamsters
  • Shoulder-mounted hamsters now have a dynamic, physics-lite simulation applied to them, making them feel more alive.
  • Vertical Bounce: Hamsters will bounce on the player's shoulder in response to jumping and falling, with their motion driven by the player's vertical velocity.
  • Squash and Stretch: The hamster's model will visually squash and stretch to simulate inertia and impact forces, making jumps and landings feel more impactful.
  • Impact Effects: A unique squash effect and a new custom sound effect will now trigger at the moment a hamster lands back on the shoulder after a fall or jump, with the sounds staggered for a more natural feel when multiple hamsters are mounted.
• Configuration Options for Shoulder Hamster Audio
  • Added a "Silence Idle Sounds" toggle to mute the ambient squeaks from shoulder hamsters.
  • Added a "Silence Physics Sounds in First-Person" toggle to mute the new landing/bounce sound effect specifically when in first-person view.
• Configurable Animation Control for Shoulder Hamsters
  • Added a config group for "Animation Settings" to give players full control over shoulder hamster behavior.
  • Players can disable the "Dynamic Animations" toggle to force all shoulder hamsters into a single, static pose using the "Forced Animation State" dropdown.
  • The duration of each dynamic state can be customized/randomized with "Min/Max Animation State Duration" sliders, controlling how long a hamster will stay in one pose before transitioning.
  • Added a forceLayDownOnWalk config option (disabled by default) that makes hamsters enter their "laying down" pose during any player movement, not just sprinting.
• Config-Driven Item Tags for All Interactions
  • All hardcoded item checks have been replaced with a high-performance, config-driven system, allowing users to customize nearly every hamster interaction.
  • Players can now define custom lists of items or item tags for taming, standard feeding, buff foods, shoulder mounting, cheek pouch unlocking, and basically every other hamster interaction.
  • This new system includes built-in default compatibility for popular mods like Farmer's Delight and its addon Cultural Delights.
• Conditional Headshake Animations
  • Added a new anim_hamster_moving_headshake animation.
  • When a hamster refuses a food item, it will now intelligently play either a stationary or a moving headshake animation depending on whether it is standing still or walking.
• Visual Height Adjustment on Snow Layers
  • Hamsters will now render slightly higher when standing on snow layers, preventing their model from sinking into the snow and creating a more realistic and visually polished effect. Now your white hamsters won't be so invisible in snow biomes! Lol.
• Fresh Moves Compatibility for Shoulder Hamsters
  • The new shoulder hamster rendering system automatically supports player animation-overhaul resource packs like Fresh Moves, because shoulder hamsters are now anchored directly to the player's animated body parts (arms and head), allowing them to realistically move and bounce along with the player's enhanced walk cycle.

Changed

• AppleSkin Compatibility for Configurable Food
  • The CheeseItem's properties are now fully dynamic*, ensuring that changes to its nutrition or saturation values in the config are correctly reflected in AppleSkin's "on-eat" HUD preview. *Unfortunately due to major API changes between MC versions, this only works on 1.21.1.
• Shoulder Mounting Behavior
  • The logic has been updated to allow players to mount a hamster onto their shoulder with a lure item (like cheese) even while sneaking.
• Wander AI Frequency
  • The default chance for a hamster's idle WanderAroundFarGoal to activate has been slightly increased, making them a bit more active when not following the player.
• Reworked mob fleeing behavior from hamsters.
  • Replaced the hardcoded Creeper-fleeing mechanic with a new configurable system. Ravagers and Spiders will now flee from hamsters by default, restoring the unique anti-Creeper role to vanilla cats. These new fleeing behaviors can be individually toggled in the config.
• Hamster Textures
  • Increased the saturation of the lavender hamster variant's texture to make it appear more purple and less gray.
  • Slightly tweaked two of the white overlay textures to make them look a little bit cuter— very subtle changes here.

Fixed

• Hamster Teleportation
  • Fixed a bug on 1.20.1 where hamsters would not teleport to their owner.
• Baby Shoulder Hamster Rendering Offset
  • Corrected the vertical offset for baby shoulder-mounted hamsters, ensuring they now move up and down correctly with the player's model when sneaking.
• Hamster Suffocation
  • Implemented a "self-rescue" mechanic for hamsters that have been thrown. If they somehow manage to phase inside a block, they will now automatically teleport upwards to the nearest safe block, preventing suffocation deaths.
• AI Goal Visual Flickering
  • Resolved a visual glitch where the hamster's head would flicker during its wander animation by preventing the LookAt and Wander goals from running at the same time.
  • The effective range of the HamsterLookAtEntityGoal was slightly reduced to prevent the hamster from looking up at an unnatural angle when the player is nearby but not directly adjacent.