Bakeries Simulation

# 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).

- **Source**: [GitHub · gracefuljun91/bakeries-simulation](https://github.com/gracefuljun91/bakeries-simulation) (open source under CC-BY-NC-SA-4.0).

- **Redistribution**: Please use official channels (Modrinth / CurseForge / MCMOD).

---

## 💬 Feedback & Contact

- **Bilibili**: [贪玩老登柠檬檬](https://space.bilibili.com/495785661) (UID: 495785661)

- **QQ 交流群**: 278646910

---

## 🙏 Credits

**🎩 Original Bakeries Mod** — this addon extends the base [Bakeries](https://modrinth.com/mod/bakeries-renyigesai) mod by [Renyigesai](https://modrinth.com/user/Renyigesai) (also on [GitHub](https://github.com/Renyigesai/bakery)). All credit for base content (bread rack, cash register, oven, bread models, recipes, textures) belongs to Renyigesai. Please install and support the base mod first. If Renyigesai objects, please contact us via Bilibili and we'll take this down. This addon is licensed under CC-BY-NC-SA-4.0 to match the upstream Share-Alike clause.

**✍ 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

Full version history in the **CHANGELOG** on the mod's [Modrinth page](https://modrinth.com/mod/bakeries-simulation).