Cinnamoroll friends(Halloween Update)

An unofficial mod that brings the beloved Sanrio characters Cinnamoroll, Kuromi, Melody and Hello Kitty into Minecraft!


## ✨ Features

### Hello Kitty!!!
— Summon your very own Hello Kitty with an Apple! Right-click a Cat while holding an Apple to transform it into a Hello Kitty.
- Custom Blockbench model with expressive animations — her ears perk up with the sun and droop when she's hurt.
- Biome-based variants including a rare shiny one.
- A loyal friend who wanders beside you and reacts to her friends.

### Cinnamoroll!!!
— Summon your very own Cinnamoroll with a Totem of Undying. Right-click a Snow Golem while holding a Totem of Undying to transform it into a Cinnamoroll!

### Kuromi!!!
— Transform a rabbit into Kuromi! Right-click a Rabbit while holding a Wither Rose to summon your very own Kuromi.

### My Melody!!
— Transform a Rabbit into Melody! Right-click a Rabbit with Pink Petals.

### 🏘️ Kitty Town
— A brand-new jigsaw-built town that generates beside villages (50% chance per village)!
- **Kitty Town Center** — the heart of the town.
- **Kitty House** — Hello Kitty's cozy home.
- **Cinnamoroll Cafe** — Cinnamoroll's coffee shop.
- A full road network (straight, long straight, cross, T-junction & corner pieces) with terrain matching.

### ❤️ Affection System
— Every companion now has an affection value (0–100), even mobs found in Kitty Town!
- Creator-linked mobs get a +60 affection bonus.
- Aura buffs apply per-player when a nearby companion's affection reaches 30+:
  - Kuromi → Strength I
  - Melody → Regeneration I
  - Cinnamoroll → Speed I

### 🎭 Biome-Based Variants
— No more pure random rolls! Regular variants are picked by biome temperature, while special biomes unlock special variants (including a rare glowing shiny one) — for every mob.

### 🗡️ Combat Partners
- **Cinnamoroll** fights by your side with snowball & big-snowball ranged attacks, and rallies nearby allies when attacked.
- **Kuromi** is a neutral melee fighter with a 4-hit combo into a heavy strike (1.5× damage), and can pick up and wield weapons.

### 🩹 Auto Healing
— All mobs recover health over time so they stay by your side. Feed them Cake for an instant heal.

### 🎩 5 Wearable Hats
— Dress up Cinnamoroll, Kuromi, Melody, Hello Kitty or yourself with the Top Hat, Flower Crown, Wizard Hat, Tsar Hat and Butterfly Bow. Craft hats at the Smithing Table using the Hat Upgrade Template.

### 📈 Friend GUI
— Open your companion's panel to see live health, attack, speed, variant **and affection**. Displayed attack now reflects real combat power (Cinnamoroll's projectile formula, Kuromi's equipped weapon).

### 🏆 Advancements
— Built-in advancements guide you through summoning every friend, collecting all hats, and finding the warm little town.

| Companion | How to summon | Nature | Combat | Variants |
| --- | --- | --- | --- | --- |
| Cinnamoroll | Right-click a Snow Golem with a Totem of Undying | Passive — retaliates and rallies allies when attacked | Snowball + big-snowball ranged attacks; rallies allies when hit | Blue / Pink / Shiny |
| Kuromi | Right-click a Rabbit with a Wither Rose | Neutral — retaliates when hit, hunts at night | 4 normal attacks → 1 heavy strike (1.5× damage + knockback); can wield weapons | Normal / Black / Purple / Shiny |
| My Melody | Right-click a Rabbit with Pink Petals | Friendly — pure support, never attacks; panics when hurt | None — heals over time and via cake feeding | Normal / Red / Yellow / Shiny |
| Hello Kitty | Right-click a Cat with an Apple | Friendly — passive companion | None — buffs nearby friends | Biome-based + Shiny |

## 🎩 Hats

| Hat | Where to get |
| --- | --- |
| Top Hat | Smithing: Leather Helmet + Emerald |
| Wizard Hat | Smithing: Leather Helmet + Amethyst Shard |
| Tsar Hat | Smithing: Golden Helmet + Diamond |
| Flower Crown | Crafting: any flowers |
| Butterfly Bow | Crafting: string |

## ⚙️ Compatibility

- **Loader:** NeoForge
- **Minecraft:** 26.1.0; 26.1.1; 26.1.2; 26.2; 26.3
- JARs are version-specific — install the one matching your Minecraft version.
- More Sanrio characters will be added in future updates!

---
## 中文版

# 玉桂狗之友（Cinnamoroll Friends）

一款将三丽鸥人气角色 玉桂狗（Cinnamoroll）、库洛米（Kuromi）、美乐蒂（My Melody）与凯蒂猫（Hello Kitty）带入 Minecraft 的非官方模组！
本模组为粉丝自制作品，与三丽鸥公司无任何关联或授权关系。

## ✨ 特色

### 凯蒂猫！！！
— 用红苹果召唤属于你的凯蒂猫！手持红苹果右键猫，即可将其转化为凯蒂猫。
- 全新 Blockbench 模型与生动动画——她的耳朵会随着太阳升起而竖起，受伤时会耷拉下来。
- 群系变种，包含稀有闪光变种。

### 玉桂狗！！！
— 用不死图腾召唤属于你的玉桂狗！手持不死图腾右键雪傀儡，即可将其转化为玉桂狗。

### 库洛米！！！
— 用凋零玫瑰将兔子转化为库洛米！手持凋零玫瑰右键兔子，即可召唤属于你的库洛米。

### 美乐蒂！！
— 用粉色樱花簇将兔子转化为美乐蒂！

### 🏘️ 凯蒂小镇（Kitty Town）
— 全新拼图结构小镇，有 50% 概率生成在村庄旁边！
- **小镇中心** — 小镇的心脏地带。
- **凯蒂小屋** — 凯蒂猫温馨的家。
- **玉桂狗咖啡屋** — 玉桂狗的咖啡店。
- 完整的道路网络（直路、长直路、十字路、丁字路、转角路），并适配地形起伏。

### ❤️ 亲密度系统
— 每位伙伴现在都拥有亲密度（0–100），包括在小镇中发现的伙伴！
- 由 Creator 转化的伙伴获得 +60 亲密度加成。
- 当附近伙伴的亲密度达到 30 以上时，光环效果会对每位玩家生效：
  - 库洛米 → 力量 I
  - 美乐蒂 → 生命恢复 I
  - 玉桂狗 → 速度 I

### 🎭 群系变种
— 不再纯随机！普通变种按群系温度决定，特殊群系解锁特殊变种（包括稀有的发光闪光变种），适用于所有伙伴。

### 🗡️ 战斗伙伴
- **玉桂狗** 使用雪球与大雪球远程攻击，受到攻击时会鼓舞附近的伙伴。
- **库洛米** 是中立的近战战士，4 连击后接重击（1.5 倍伤害），可以拾取并使用武器。

### 🩹 自动回复
— 所有伙伴都会随时间恢复生命值，喂它们蛋糕可立即回血。

### 🎩 5 款可穿戴帽子
— 为玉桂狗、库洛米、美乐蒂、凯蒂猫或你自己戴上礼帽、花环、巫师帽、沙皇帽和蝴蝶结。使用帽子升级模板在锻造台上制作。

### 📈 伙伴界面（GUI）
— 打开伙伴面板即可查看实时生命值、攻击力、速度、变种**和亲密度**。显示的攻击力现在反映真实战力（玉桂狗的投射物公式、库洛米装备的武器）。

### 🏆 进度成就
— 内置成就引导你召唤每一位伙伴、集齐所有帽子，并找到这座温暖的小镇。

| 伙伴 | 召唤方式 | 性格 | 战斗 | 变种 |
| --- | --- | --- | --- | --- |
| 玉桂狗 | 用不死图腾右键雪傀儡 | 被动——受击反击并鼓舞同伴 | 雪球+大雪球远程攻击；受击时鼓舞同伴 | 蓝 / 粉 / 闪光 |
| 库洛米 | 用凋零玫瑰右键兔子 | 中立——受击反击，夜晚狩猎 | 4 连击 → 重击（1.5 倍伤害+击退）；可使用武器 | 普通 / 黑 / 紫 / 闪光 |
| 美乐蒂 | 用粉色樱花簇右键兔子 | 友好——纯辅助，永不攻击 | 无——随时间回复生命 | 普通 / 红 / 黄 / 闪光 |
| 凯蒂猫 | 用红苹果右键猫 | 友好——被动伙伴 | 无——为附近伙伴提供增益 | 群系变种 + 闪光 |

## 🎩 帽子

| 帽子 | 获取方式 |
| --- | --- |
| 礼帽 | 锻造：皮革头盔 + 绿宝石 |
| 巫师帽 | 锻造：皮革头盔 + 紫水晶碎片 |
| 沙皇帽 | 锻造：金头盔 + 钻石 |
| 花环 | 合成：任意花朵 |
| 蝴蝶结 | 合成：线 |

## ⚙️ 兼容性

- **加载器：** NeoForge
- **Minecraft：** 26.1.0; 26.1.1; 26.1.2; 26.2; 26.3
- JAR 为版本专属，请安装与你游戏版本匹配的那个。
- 更多三丽鸥角色将在未来更新中加入！