Adorable Hamster Pets

[1.1.1] - 2025-05-26

Added

• Advanced Sleep System for Tamed Hamsters:
  • Tamed hamsters, when commanded to sit, may now gradually drift off to sleep through a new multi-stage "Path to Slumber" animation sequence.
  • Features new animations: anim_hamster_drifting_off (a long, gradual doze), anim_hamster_settle_sleep1/2/3 (short transitions), and three distinct looping sleep poses (anim_hamster_sleep_pose1/2/3).
  • Sleep sequence is influenced by daytime (configurable), nearby threats, and how long they've been sitting.
  • Player interactions (feeding, inventory, etc.) will now wake up a dozing/sleeping tamed hamster.
• Configurable Sleep Timings: New options in Mod Menu config to adjust how long tamed hamsters sit before trying to sleep, their threat detection radius for sleep, and whether daytime is required for them to get drowsy.
• Pink Petal Cycling & Shear Removal:
  • Right-clicking a tamed hamster with Pink Petals now cycles through three different petal decoration styles.
  • Pink petal decorations can now be removed by right-clicking the hamster with Shears (drops one pink petal).
• Hamster Water & Fire Avoidance: Hamsters will now try to pathfind around water, fire, and lava, making them a bit safer. Lol.
• Shoulder Riding Sounds:
  • Added new unique sound effects when a hamster mounts the player's shoulder (via cheese interaction).
  • Added a distinct sound effect when a hamster dismounts from the shoulder.
• New Advancements:
  • "Petal Pusher": Awarded for decorating a hamster with pink petals. Includes subtle sound/particle effects on first application.
  • "Pocket Paramedic": Awarded when a hamster successfully auto-feeds from its cheek pouch.
  • "Nose for Treasure": Awarded when a shoulder hamster first alerts the player to nearby diamonds.
  • "Impending Doom Squeak": Awarded when a shoulder hamster first alerts the player to a targeting Creeper.
  • "Chipmunk Aspirations": Awarded when a player fills all slots in a hamster's cheek pouch.
• "Sweet Potato" Easter Egg (Advancement-Based):
  • Naming a hamster "Sweet Potato" now triggers special effects (sound, particles, message) via a hidden advancement. This is a one-time effect per player. I added this for my wife since the entire mod is based on her real life hamster named Sweet Potato. She doesn't read change logs so she'll never see this. Hehe.

Changed

• Hamster Auto-Eating Delay: Introduced a 2-second delay before a hamster begins to auto-eat from its cheek pouch when injured, giving players a better chance to notice the action and its effects.
• Hamster Auto-Eating Cooldown: Increased the cooldown after a successful auto-eat to 3 seconds (60 ticks). It was a bit overpowered.
• Hamster Melee Attack Particles: Changed from "poof" particles to "crit" particles, because poof particles already spawn when the attacked entity dies. Let me know If you're reading this and you have ideas for particles I should add to any of the other animations. I'm all ears!
• Hamster Textures: Subtle visual enhancement to the area between the hamster's eyes for increased cuteness, especially noticeable during sleep.
• Configuration Screen Reorganization: Restructured the Mod Menu config screen with more descriptive top-level sections and logical sub-headers for improved clarity and ease of use. (All your settings are still there, just better organized!)
• Wild Hamster Sleep Animation: Wild hamsters now use a new anim_hamster_wild_settle_sleep transition animation before entering their looping sleep pose (anim_hamster_sleep_pose1).

Fixed

• Sliding Sit Bug: Fixed an issue where tamed hamsters would appear to slide while in their sitting animation if they stood up to defend their owner. Animations now correctly sync with their actual sitting/standing state.
• Body Rotation While Sitting/Sleeping/KO'd: Hamsters will no longer rotate their bodies to look at entities while they are in a sitting, sleeping, or knocked-out state.
• Hamster Targeting:
  • Tamed hamsters will no longer attack other animals owned by the same player (including horses, wolves, cats, etc.) when commanded by the owner.
  • Tamed hamsters will no longer retaliate against other animals owned by the same player if accidentally hit by them.
• Shoulder Mounting Sound: Cheese use sound now plays at the hamster's last location, while the new hamster mount sound plays near the player's ear.

[1.1.0] - 2025-05-19

Added

• Advancement Tree: With distinct branches leading the player to explore different features.
• Custom Advancement Tab ("The Hamster Life"):
  • Guides players through mod features with custom titles, descriptions, and icons.
  • Features a branching structure after initial taming.
  • Includes advancements for obtaining seeds, taming, crafting key items (Sliced Cucumber, Food Mix, Steamed Beans), shouldering, throwing, feeding buffs, and unlocking cheek pouches.
  • Uses custom criteria for specific mod interactions (shouldering, throwing, feeding buffs, pouch unlock, initial guidebook).
  • "Goal" and "Challenge" advancements play distinct sounds on unlock.
• Crafting Recipe for Hamster Guide Book:
  • Players can craft the Hamster Guide Book (1 Vanilla Book + 1 Sliced Cucumber).
  • Crafted book comes pre-filled with all NBT content (pages).
  • A hidden advancement triggers on crafting, playing particle/sound effects.
• Config option uiTweaks.enableItemTooltips to toggle custom mod item/block tooltips.
  • When off, tooltips will show item name and "Adorable Hamster Pets" for mod identification.
• Config option uiTweaks.enableAutoGuidebookDelivery to toggle automatic guidebook delivery on first join.
  • Thanks to @MylesGit on GitHub for suggesting those config ideas, custom advancements, and Guide Book crafting recipe.
• New hamster base color variants: Blue and Lavender.
  • Blue hamsters (with 8 overlay options) spawn rarely in Ice Spikes biomes (70% chance for Blue, 30% for White).
  • Lavender hamsters (with 8 overlay options) spawn rarely in Cherry Grove biomes.
• Four new overlay patterns (overlay5, overlay6, overlay7, overlay8) for all applicable base colors, increasing visual diversity.
• Numerous sound effect variations for hamster actions (idle, hurt, attack, sleep, beg, death, creeper detect, diamond sniff, celebrate).
• Pink Petal cosmetic overlay system:
  • Players can right-click a tamed, owned hamster with minecraft:pink_petals to apply one of three random pink petal textures.
  • Right-clicking again with pink petals removes the cosmetic overlay.
  • Applying consumes a petal item; removing does not.
  • Petal state is saved with the hamster and visible on the shoulder.
  • Includes sound and particle effects for application/removal.
• Player-edible Cheese:
  • Cheese is now a food item for players (Nutrition: 8, Saturation: 0.8F).
  • Features a custom eating sound and a faster eating time (20 ticks vs. vanilla 32).
• Cheek Pouch Locking Mechanic:
  • By default, hamster cheek pouches are locked upon taming.
  • Feeding a hamster HAMSTER_FOOD_MIX for the first time (resulting in healing/love mode) permanently unlocks its pouches.
  • Plays a sound and spawns particles upon pouch unlock.
  • New config option features.requireFoodMixToUnlockCheeks (default: true) allows disabling this lock.
• Display a random, non-repeating message on the action bar when a shoulder hamster dismounts due to sneaking.
  • Configuration option (features.enableShoulderDismountMessages) to toggle shoulder dismount messages.

Changed

• Hamster Textures: All hamster textures (including overlays) have been considerably reworked for improved aesthetics and to ensure they are not overly similar to textures from the "Hamsters" mod by Starfish Studios.
• Hamster Variant System: Breeding logic updated: If both parents have an overlay, baby must have an overlay, preferably different from parents. If one/neither parent has an overlay, baby can have an overlay (different from parents if applicable) or no overlay.
• Shoulder Summoning: Hamsters are now summoned to the shoulder by right-clicking a tamed, owned hamster while holding ModItems.CHEESE (instead of right-clicking air with cheese).
• Hamster Tempting: Hamsters are now also tempted by (and will beg for) ModItems.CHEESE and ModItems.STEAMED_GREEN_BEANS, in addition to ModItems.SLICED_CUCUMBER.
  • However, ModItems.SLICED_CUCUMBER is still the only thing that can tame a hamster.
• Spawn Egg Item Model: Now uses data generation (Models.GENERATED) for its model, pointing to a custom sprite texture adorablehamsterpets:item/hamster_spawn_egg to mesh better with the new spawn egg textures seen in Snapshot 25w08a. (Future proofing.)
• Item/Creative Tab Icons: Both the "Adorable Hamster Pets" creative tab and the root "The Hamster Life" advancement tab now use the (custom textured) HAMSTER_SPAWN_EGG as their icon.
• Hamster Spawning: Removed light level check from spawn restrictions to allow hamsters to spawn in dark areas like caves, provided the block below is valid.
• Guidebook Content: Significantly updated and expanded to reflect new features, revised mechanics, and ensure brand voice consistency. Page order adjusted.
• Guidebook Delivery: Initial delivery on first join now uses a persistent "flag" advancement (technical/has_received_initial_guidebook) to ensure it's truly one-time, respecting the config toggle. The advancement tab (husbandry/root) now unlocks immediately for all players via a minecraft:location trigger.

Fixed

• Melee Attack Particles: Implemented Geckolib creator, Tslat's suggested fix; particles now spawn correctly at the attacking hamster's foot for all attacks, including the first, and in multi-entity scenarios.
• Recipe Book Visibility: Corrected an issue where the "Hamster Food Mix" recipe might not unlock as expected; ensured its advancement criterion correctly requires only ModItems.SUNFLOWER_SEEDS.
• Corrected various minor code errors and improved config access patterns.

Removed

• Numerous hamster sound effect variations used for testing which were not intended to be present in the released version of the mod.
• Shoulder-mounted hamsters no longer dismount when the player takes damage.