# Bakeries Simulation
*A business-simulation ADDON for the base Bakeries mod.*
> **⚠️ THIS IS AN ADDON, NOT A STANDALONE.** You must install the base **Bakeries** mod first — this project only adds management-simulation logic on top. All credit for base content (bread rack, cash register, oven, recipes, etc.) belongs to the original Bakeries author.
---
### 🌏 中文玩家
这是给前置 **Bakeries** 模组做的**附属模组 (Addon)** —— 你不再只是烤面包摆架子, 而是**开店、雇店长、养精灵、招待挑剔的 AI 顾客**. 必需先装前置 Bakeries + GeckoLib 5.5.2 + Curios 15. Minecraft 26.1.2 · NeoForge 26.1.2+ 专属.
---
## ✨ Highlights
- **Chain-unlock branches** — clear stars at your main store to unlock branch #1, then #2, and so on.
- **Hire NPC store managers** — level up to 50, per-branch inventory 12 → 108 slots via paid unlocks.
- **33 breads × 4 quality tiers** — Fine → Superior → Exquisite → Royal. Higher tier = higher price.
- **Living AI customers** — queue, get picky, order, pay, applaud, gossip. 4 personality moods.
- **Furniture-driven popularity** — never drops to 0 from decor, so early shops stay approachable.
- **Bread Spirit companions** — Curios pets with active + passive skills, Pixelmon-style stat panel, PvE & PvP.
- **Biome-aware weather** — no lazy yellow-tint rain filter.
- **Zero-loss persistence** — data lives on ServerLevel / ServerPlayer attachments, not third-party BlockEntities.
- **176×166 pixel UI** — retro cash-register look, right-click-heavy interactions.
---
## 🎮 Getting Started
1. Place a **Customer Station** — your customer spawner. One per shop.
2. Add a **Cash Register** and a **Glass Bread Rack** from the base Bakeries mod.
3. Bake breads with quality tiers using standard Bakeries recipes.
4. Hang a **Shop Tag** on your rack to enter selling mode.
5. Right-click the Customer Station to **open shop** / **take samples**.
6. Watch customers walk in, queue, order, pay, and applaud (or complain).
7. Earn praise → level up store → unlock next branch via **Branch License**.
---
## 📦 Dependencies
- **Minecraft 26.1.2** (required)
- **NeoForge 26.1.2.73+** (required)
- **Bakeries** (required — base mod)
- **GeckoLib 5.5.2+** (required — spirit animations)
- **Curios 15.0.0-beta.2+** (required — spirit slot)
- **LambDynamicLights 4.11+** (optional — spirit glow)
> **⚠️ NeoForge only.** Forge / Fabric are not supported. MC 1.20.x and below are not supported.
---
## 🔒 License & Modpack Policy
- **License**: **CC-BY-NC-SA-4.0** (matches upstream Bakeries mod by Renyigesai — Share-Alike compliance).
- **Modpacks**: ✅ **Permitted (non-commercial only)** — free modpacks may include this mod without asking.
- **Attribution**: Please credit both **Renyigesai** (base Bakeries) and **贪玩老登柠檬檬** (this addon).
- **Redistribution**: Please use official channels (Modrinth / CurseForge / MCMOD).
---
## 💬 Feedback & Contact
- **QQ 交流群**: 278646910
---
## 🙏 Credits
**✍ Addon Development** — by **贪玩老登柠檬檬** (tanwanlaodengningmengmeng).
---
## 🔄 Latest: v1.311.64 (2026-07-11)
First stable public release · License unified to CC-BY-NC-SA-4.0 (matches upstream Bakeries by Renyigesai) · Full source available on GitHub.
**Consolidates all critical fixes since v1.311.57:**
- Chain-unlock 4 branches from main store
- NPC store managers, level 1→50 per branch, 108-slot manager bag
- 4-tier bread quality × 33 breads
- Popularity-driven customer AI with 4 personality moods
- Bread Spirit companions with active/passive skills, PvE & PvP
- **BUG fixes**: Bread ball retention, plot protection strengthened, manager stocking realism, handshake priority over stocking, branch license infinite-spawn fix
- **Performance**: QDEBUG logs demoted from INFO → DEBUG, TPS restored to steady 20, latest.log size down 90%+
- **Presentation**: Mod description rewritten (fixed encoding mojibake), credits cleaned up
