Forgeborne Odyssey

## Forgeborne Odyssey v0.1.17 — Changelog / 更新日志 --- ## English ### 1. Geology & World Generation - **28 rock types** added (sedimentary, metamorphic, igneous — including hornfels and spotted slate), each with stairs/slab/wall variants plus models, loot tables, lang keys and pickaxe tags. - **Stratigraphic columns & tectonic domains**: 8 columns (North/South China platform, orogens A/B, continental rift, passive-margin carbonate, Archean greenstone, oceanic crust) selected by 7 tectonic domains. - **Structural geology**: multi-wavelength folds, angular unconformities, faults (normal/reverse/strike-slip) with damage zones producing fault breccia, cataclasite and mylonite. - **Phase 8-0 true dip**: realistic dip per domain (platform 0.8–3°, orogen 22–42°…); bedding surfaces tilt accordingly, and fault planes dip with depth instead of being vertical walls. - **Intrusions & metamorphism**: batholiths, dykes, sills; contact aureoles (hornfels → spotted slate); regional metamorphism graded by depth and tectonic core (slate → phyllite → schist → gneiss / quartzite / marble / amphibolite / granulite). - **Weathering profiles**: 8 soil types from biome temperature/rainfall × slope × rock hardness → regolith → shattered bedrock → fresh bedrock. - **Surface sediments**: river alluvium, beach sand, arid aeolian sand sheets and calcrete. - **Diagenesis**: loose sediments consolidate into sandstone/conglomerate/shale/mudstone with depth; shallow de-consolidation keeps a continuous gradient. - **Performance**: strata are now written once at world-generation time (`StrataFeature`); old chunks self-heal through a versioned deferred queue. Two-pass column building, section skipping, tick budget, cache cleanup on shutdown, and the fire-crack scan no longer does quadratic lookups. ### 2. Ore Deposits & Resources - **Deposit system replaces random ore veins**: 12 deposit types — porphyry copper, skarn, quartz-vein gold, banded iron formation, sedimentary copper, VMS, SEDEX Pb-Zn, placer, coal measures, evaporites, oil shale, aggregate — gated by domain, depth, host rock, faults and intrusions, with **grade zonation** (core/mid/rim). - **All random ore veins removed**; ores now only come from deposits. - **New resources & chains**: rock salt → salt, oil shale → shale oil (fuel, torches), coal measures, gypsum; salt cures rotten flesh into leather. - **Geobotanical indicator** `indicator_flower`: grows only above deposits, tinted by metal (copper, gold, lead-zinc, iron). - **Surface features** split by weathering thickness: outcrops where thin, boulders where thick, talus on steep slopes. ### 3. Fixes - Nether/End being consumed by the strata pipeline (dimension guards). - Mine ruins writing blocks across chunk borders (`Detected setBlock in a far chunk`, lost blocks) — now per-chunk with bounding-box clipping. - Growing memory use as more chunks load (version cache only in the overworld, cleared on shutdown). - `copper_ores` tag typo (`cuprovandite_ore` → `cuprovanadite_ore`). - Missing `minVersion` warning in `mixins.json`. - Old chunks repaving bug where `lastRock` was compared against the wrong block, leaving rock only at layer boundaries. ### 4. Textures - 28 rocks, 24 ores and all Phase 7 blocks redrawn procedurally at 16 px (scripts `gen_*.py`, previews in `_geo_preview/`). - Ores went through “stone base + small clusters” and “angular fragments” iterations and were **reverted to the original hand-drawn set** per feedback. Rock textures fixed a 90°-wrong foliation direction bug (gneiss, slate, phyllite, schist, mylonite now bed horizontally). ### 5. Documentation - Added `TECH_SPEC_GEO_PHASE1`…`PHASE8_STRUCTURE`, `GEOLOGY_ASSETS.md`, `GEOLOGY_BASALT_FIX.md`, and `TECH_HISTORY_ROADMAP.md` (8-stage history-of-technology roadmap v1.1). ### 6. Known Issues - Spawn generation is still slow on low-end devices (Android FCL, 4 GB laptops): ~4–5 minutes for 512 chunks; strata account for about a tenth, the rest is vanilla entity/structure generation and GC. - Several rock textures (sandstone, siltstone, rhyolite, granodiorite, peridotite, hornfels) are still hard to read at 16 px and need individual redraws. --- ## 中文 ### 一、地质与世界生成 - **28 种岩石**上线（沉积、变质、火成，含角岩 `hornfels`、斑点板岩 `spotted_slate`），每种都带楼梯、台阶、墙变体，配齐模型、掉落表、语言键与镐类标签。 - **地层柱与构造域**：8 套地层柱（华北/华南地台、造山带 A/B、大陆裂谷、被动陆缘碳酸盐、太古宙绿岩带、洋壳），按 7 种构造域自动选择。 - **构造几何**：多波长褶皱、角度不整合、断层（正、逆、走滑），带破碎带宽度，生成断层角砾岩、碎裂岩、糜棱岩。 - **Phase 8-0 真倾角**：每个构造域有真实倾角（地台 0.8–3°、造山带 22–42°…），层界随倾角倾斜；断层面随深度倾斜，不再是竖直的墙。 - **侵入与变质**：岩基、岩墙、岩床；接触变质晕（角岩→斑点板岩）；区域变质按深度与构造核分级（板岩→千枚岩→片岩→片麻岩/石英岩/大理岩/角闪岩/麻粒岩）。 - **风化剖面**：按生物群系温湿度 × 坡度 × 岩石硬度生成 8 种土壤 → 风化壳 `regolith` → 碎裂基岩 → 新鲜基岩。 - **地表沉积**：河流冲积、海滩砂、干旱区风成砂席与钙结层。 - **成岩作用**：松散沉积物随埋深固结成砂岩、砾岩、页岩、泥岩；浅部反向去固结，形成连续梯度。 - **性能改造**：地层写入改为世界生成期一次成型（`StrataFeature`），旧存档区块按版本号走延迟队列自愈；两遍建列、section 跳过、分 tick 摊平、退出清理缓存、火裂扫描去掉平方级遍历。 ### 二、矿床与资源 - **矿床系统取代随机矿脉**，共 12 类：斑岩铜、矽卡岩、石英脉金、条带状铁建造、沉积铜、VMS 块状硫化物、SEDEX 铅锌、砂矿、煤系、蒸发岩、油页岩、骨料；按构造域、深度、母岩、断层与侵入体条件生成，并做**品位分带**（核/中/边三圈不同矿物组合）。 - **随机矿脉全部下线**，矿石只来自矿床。 - **新矿物与利用链**：岩盐→盐、油页岩→页岩油（燃料、制火把）、煤系、石膏；盐可硝皮（盐 + 腐肉 → 皮革）。 - **矿化指示花** `indicator_flower`：只长在矿床上方，按金属着色（铜、金、铅锌、铁）。 - **地表特征**按风化厚度分流：薄风化处露头、厚风化处长巨石、陡坡生岩屑堆 `talus`。 ### 三、修复 - 下界、末地被地层管线误处理导致进入即卡死（补维度守卫）。 - 矿坑、竖井、工坊遗迹跨区块写方块，触发 `Detected setBlock in a far chunk` 且方块丢失（改为逐区块写入并裁剪到本区块包围盒）。 - 读取区块越多越卡（版本缓存只在主世界记录，服务器停止时整体清理）。 - `copper_ores` 标签拼写错误（`cuprovandite_ore` → `cuprovanadite_ore`）。 - `mixins.json` 缺 `minVersion` 的启动警告。 - 旧存档重铺时 `lastRock` 比较对象错误，导致岩石只出现在层界一两格。 ### 四、贴图 - 28 种岩石、24 种矿石、Phase 7 新方块贴图全部程序化重绘为 16 px（脚本 `gen_*.py`，预览在 `_geo_preview/`）。 - 矿石贴图试过“石底小簇”“棱角碎块”两版，最终按反馈**回退到原始手绘版**；岩石贴图修掉了变质岩层理方向反了 90° 的 bug（片麻岩、板岩、千枚岩、片岩、糜棱岩改为水平层理）。 ### 五、文档 - 新增 `TECH_SPEC_GEO_PHASE1`～`PHASE8_STRUCTURE`、`GEOLOGY_ASSETS.md`、`GEOLOGY_BASALT_FIX.md`、`TECH_HISTORY_ROADMAP.md`（人类技术史 8 阶段路线图 v1.1）。 ### 六、已知问题 - 低端设备（安卓 FCL、4 GB 笔记本）新世界出生点生成仍偏慢：512 区块约 4–5 分钟，地层只占约十分之一，其余是原版实体、结构生成与 GC。 - 部分岩石贴图（砂岩、粉砂岩、流纹岩、花岗闪长岩、橄榄岩、角岩）在 16 px 下辨识度仍不足，待单独重画。

--- ## v0.1.16 Changelog ### ✨ New Content - **Bison** — New animal entity with full animation states (idle, walk, run, attack, graze, threaten, rest, fight). Supports breeding, panic behavior, and natural world spawning. - **Crude Stone Spear** — New throwable weapon with dedicated model and renderer, expanding early-game combat options. - **Storage Pot** — New storage block with 8-level water storage, interactive GUI, dedicated renderer, and loot table. Obtained by firing greenware. - **Tar Kiln** — New multi-stage block with Tar and Charcoal firing modes, with Jade/TOP Hwyla integration. - **Charcoal Ring** — New charcoal production block. - **Lime & Plaster System** - Quicklime → Slaked Lime production chain - Lime Mortar, Lime Mortar Cobblestone / Stone Bricks with slab, stair, and wall variants - Lime Concrete slab, stair, and wall variants - Black, Red, Dark Red, and Yellow Plaster blocks - Limed Hide as a leather processing intermediate - Plaster application event handler with sync system - **Waterskin** — New fluid container item for drinking from water sources. - **Ceramic Water Jug** — New greenware-fired water container. - **Greenware System** — New greenware item system: Greenware Sling Bullet, Greenware Storage Pot, and Greenware Water Jug. - **Earthworm** — New item obtainable when digging dirt. - **Crude Flint Tools** — New Crude Flint Knife, Crude Flint Shovel, and Crude Flint Sickle for early survival gameplay. - **Knapping Proficiency System** — New skill progression mechanic: the more you knap, the higher your chance of producing quality tools (up to +20% bonus). - **Birch Tar Advancement** — New advancement added. ### 🔧 Changes & Improvements - Overrode many vanilla tool, weapon, and armor recipes (stone, iron, gold, diamond, netherite, leather) to align with the mod's progression. - Overrode vanilla charcoal and stone axe recipes. - Improved event handlers (forging, mining, strength training, stress system, weight debuff). - Extended Jade plugin with Tar Kiln information display. - Improved JEI recipe compatibility and network packet synchronization. - Added Patchouli guide book entries (Charcoal Kiln, Quern Ore Processing, Survival Basics, Tar Kiln) in both English and Chinese. - Added `FluidHelper` utility and `FluidContainerShapelessRecipe` type. - Improved Copper Grass Flower world generation and biome modifiers. - Loot table improvements (animal fat, rawhide, ore grade drops). - Config manager updates and code refactoring. --- ## v0.1.16 更新日志 ### ✨ 新内容 - **野牛 (Bison)** — 新增动物实体，拥有完整的动画状态（待机、行走、奔跑、攻击、进食、威慑、休息、打斗），支持繁殖与恐慌行为，可在世界中自然生成。 - **粗制石矛 (Crude Stone Spear)** — 新增投掷武器，附带独立模型与渲染器，丰富早期战斗选择。 - **储物罐 (Storage Pot)** — 新增储物方块，支持 8 级水位存储、GUI 交互界面、独立渲染与战利品表。由湿坯烧制获得。 - **焦油窑 (Tar Kiln)** — 新增多阶段工作方块，支持焦油与木炭两种烧制模式，集成 Jade/TOP 信息显示。 - **木炭圈 (Charcoal Ring)** — 新增木炭生产方块。 - **石灰与灰泥系统 (Lime & Plaster System)** - 生石灰 → 熟石灰生产链 - 石灰砂浆、石灰砂浆圆石 / 石砖及其台阶、楼梯、墙壁变体 - 石灰混凝土台阶、楼梯、墙壁变体 - 黑色、红色、深红、黄色灰泥方块 - 石灰皮作为皮革加工中间产物 - 灰泥涂抹事件处理与同步系统 - **水袋 (Waterskin)** — 新增流体容器物品，可从水源装水饮用。 - **陶水壶 (Ceramic Water Jug)** — 新增由湿坯烧制的水容器。 - **湿坯系统 (Greenware System)** — 新增湿坯物品体系：湿坯弹丸、湿坯储物罐、湿坯水壶。 - **蚯蚓 (Earthworm)** — 新增物品，挖掘泥土时获得。 - **粗制燧石工具 (Crude Flint Tools)** — 新增粗制燧石刀、粗制燧石铲、粗制燧石镰刀，用于早期生存。 - **打制熟练度系统 (Knapping Proficiency)** — 新增技能累进机制：打制次数越多，获得优质工具的概率越高（最高 +20% 加成）。 - **桦木焦油进度 (Birch Tar Advancement)** — 新增对应进度。 ### 🔧 修改与优化 - 覆盖了大量原版工具、武器、盔甲的合成配方（石质、铁质、金质、钻石、下界合金、皮革），以适配模组进程。 - 覆盖了原版木炭与石斧配方。 - 优化了事件处理器（锻造、采矿、力量训练、压力系统、负重减益）。 - 扩展 Jade 插件，新增焦油窑信息显示。 - 改进 JEI 配方兼容与网络数据包同步。 - 新增 Patchouli 指南书条目（木炭窑、石磨矿石处理、生存基础、焦油窑），中英双语。 - 新增 `FluidHelper` 工具类和 `FluidContainerShapelessRecipe` 配方类型。 - 优化铜花草世界生成与生物群系修改器。 - 战利品表优化（动物油脂、生皮、矿石品位掉落）。 - 配置文件管理更新与代码重构。 ---

## v0.1.15 Changelog ### New Features **Ochre Deposit System** - New ochre deposits generate naturally in dirt, grass, coarse dirt, sand, red sand, clay, and gravel (Y=55~90). - Four new pigments: Yellow Ochre, Red Ochre, Dark Red Ochre, Black Ochre. - Ochre color conversion via pit kiln firing: Yellow → (500°C) → Red → (700°C) → Dark Red; Red → (800°C + reducing atmosphere) → Black. **Colored Lime Plaster** - Four colored plaster variants: Red / Yellow / Black / Dark Red. - Scraper tool can now remove applied lime plaster from blocks. **Lime Building Materials** - Added Lime Mortar Cobblestone (+ stairs/slab/wall). - Added Lime Concrete (+ stairs/slab/wall). - Added Lime Mortar Stone Bricks (+ stairs/slab/wall). **Ceramic Spinning Whorl & Sling Bullet** - Added Greenware Spinning Whorl and Greenware Sling Bullet. - Both can be dried on the drying rack, then fired in a pit kiln (>600°C) into ceramics. - Ceramic Sling Bullet yields 8 per batch and serves as sling ammunition. **Limed Hide Drying** - Limed Hide can now be dried on the drying rack (400 ticks) to produce Dried Hide. **Debug Commands** - `/pitkiln info` — displays detailed pit kiln status (stage, temperature, peak temp, fuel, oxygen atmosphere, insulation, etc.). - `/pitkiln setHighTemp <ticks>` — sets the high-temperature timer for the targeted pit kiln. --- ### Balance & Mechanic Changes **Quality / Weight System Rework** - "Weight" tag now takes priority over "ore_quality" when calculating stack weight. - Fixed quality multiplier: `ore_quality * 10` → `ore_quality` (AnvilBlockEntity, FirePitBlockEntity). - Fixed weight divisor: `/1000` → `/10000` (fragments, natural metal blocks). - Container fluid weight is now included in load calculations. - Numerous items assigned realistic quality/weight ranges: rawhide, animal fat, grass fiber, birch bark, earthworm, copper grass flower, ash, flour, stone debitage, flint pebble, gravel. **Quicklime Exothermic Reaction** - Quicklime now emits steam/poof particles and deals 1 damage upon water contact. **Fire Crack Mining Balance** - Limestone fire crack mining now yields 1–2 quicklime (was 2–4). --- ### Bug Fixes / Improvements **Blowpipe Boost Duration Fix** - Ceramic blowpipe boost on Fire Mouth corrected from 12 ticks → 200 ticks (fixes progression dead-end). **Recipe Manager Reflection Compatibility** - Replaced hardcoded field-name reflection (`byName`, `recipes`) with generic field-type scanning for improved cross-mod compatibility. **Storage Pot Ochre Color Preservation** - Ochre-dyed greenware storage pots now retain their color after pit kiln firing (OchreColor NBT transfer). **Server Readiness Guards** - Cave-in handler and fire crack mining handler now check `server.isReady()` to prevent early-startup crashes. **Grease Torch Facing** - Added `facing=up` block state variant. **Fire Pit BlockState Cleanup** - Removed unused `SIGNAL_FIRE` and `WATERLOGGED` properties. **Unused Sounds Removed** - Removed forging milestone sounds (milestone_10/50/90), stone hammer light/heavy sounds, and rock steam sound. **Sling Ammo Expansion** - Ceramic Sling Bullet now usable as MEDIUM sling ammunition. --- > 42 files changed, +3177 / -2226 lines --- ## v0.1.15 更新日志 ### 新增内容 **赭石矿系统** - 新增赭石矿物（Ochre Deposit），自然生成于主世界泥土、草方块、砂土、沙子、红沙、黏土、沙砾中（Y=55~90）。 - 新增四种颜料：黄色赭石（Yellow Ochre）、红色赭石（Red Ochre）、深红赭石（Dark Red Ochre）、黑色赭石（Black Ochre）。 - 赭石可通过坑窑烧制转换颜色：黄色 →（500°C）→ 红色 →（700°C）→ 深红色；红色 →（800°C + 还原气氛）→ 黑色。 **彩色石灰灰泥** - 新增四种彩色灰泥：红色 / 黄色 / 黑色 / 深红色。 - 刮刀（Scraper）现在可用于刮除已涂抹的石灰灰泥。 **石灰建筑材料** - 新增石灰砂浆砌筑碎石（Lime Mortar Cobblestone）及其楼梯/半砖/墙。 - 新增石灰混凝土（Lime Concrete）及其楼梯/半砖/墙。 - 新增石灰砂浆砌筑石砖（Lime Mortar Stone Bricks）及其楼梯/半砖/墙。 **陶制纺轮 & 投石弹** - 新增生坯纺轮（Greenware Spinning Whorl）和生坯投石弹（Greenware Sling Bullet）。 - 两者均可置于晾晒架干燥，再经坑窑烧制（>600°C）获得成品。 - 陶制投石弹每批产出 8 个，可作为投石索弹药使用。 **石灰鞣制兽皮** - 石灰浸泡兽皮（Limed Hide）现可在晾晒架上快速干燥为干兽皮（仅需 400 tick）。 **调试命令** - `/pitkiln info` — 查看当前指向的坑窑详细状态（阶段、温度、峰值温度、燃料、氧气气氛、保温等级等）。 - `/pitkiln setHighTemp <ticks>` — 设置坑窑高温计时。 --- ### 数值与机制调整 **质量/重量系统重构** - 物品重量标签"Weight"优先级提升，优先于"ore_quality"计算堆叠重量。 - 修复 quality 倍数偏差：`ore_quality * 10` → `ore_quality`（AnvilBlockEntity、FirePitBlockEntity）。 - 修复重量除数偏差：`/1000` → `/10000`（碎片、自然金属块）。 - 新增容器内流体重量的负载计算。 - 多种物品按现实重量精细化品级赋值：生皮、动物脂肪、草纤维、桦树皮、蚯蚓、铜草花、灰烬、面粉、碎石、小石子、砂砾。 **生石灰遇水反应** - 生石灰接触水时产生蒸汽/白雾粒子效果，并对玩家造成 1 点伤害。 **火裂采矿平衡** - 石灰岩火裂采矿产出生石灰数量从 2-4 调整为 1-2。 --- ### Bug 修复 / 优化 **吹管吹气时间修复** - 陶瓷吹管对火门吹气助推时间从 12 ticks 修正为 200 ticks（修复玩法断层）。 **配方管理器反射兼容性** - 移除对 `byName` / `recipes` 字段名的硬编码反射访问，改为按字段类型扫描匹配，提升与其他模组的兼容性。 **贮藏罐赭石染色保留** - 经赭石染色的生坯贮藏罐在坑窑烧制后颜色得以保留（OchreColor NBT 传递）。 **服务器初始化安全检查** - 塌方系统和火裂采矿系统增加 `server.isReady()` 检查，防止启动早期崩溃。 **油脂火把状态完善** - 新增 `facing=up` 方块状态变体（向上放置）。 **火坑方块状态简化** - 移除未使用的 `SIGNAL_FIRE` 和 `WATERLOGGED` 属性。 **清理冗余音效** - 移除未使用的锻造里程碑音效（milestone_10/50/90）、石锤轻重音效及蒸汽音效。 **投石索弹药扩展** - 陶制投石弹可作为中等（MEDIUM）弹药使用。 --- > 42 个文件变更，+3177 / -2226 行

## Forgeborne Odyssey 0.1.14 Changelog --- ### New Features **[Quality System Overhaul]** - Added `ItemQuality` enum and `ItemQualityHelper` utility class - Unified quality tag `item_quality`, replacing scattered `Weight` / `ore_quality` tags - Supports: random assignment, input inheritance, processing loss, old ore quality auto-migration - Auto-assign quality to all mod items on player pickup and every tick, ensuring quality from first acquisition - 5-tier quality tooltips: Crude / Poor / Common / Fine / Excellent - Added weight tooltip line **[Storage Pot & Ceramic Water Jug System]** - **Storage Pot**: Placeable block, internal item storage, 8-level water fill display with gradient - **Ceramic Water Jug**: Stores 4 water bottles (1000mB), right-click water source to fill, right-click ground to pour - **Waterskin**: Primitive leather water container - Added pre-firing variants: Greenware Storage Pot, Greenware Water Jug **[Tar Kiln Digging Mechanic Rework]** - Tar Kiln can no longer be instant-placed via bare hand + sneak + dirt - New process: Hold shovel (flint / crude flint) + sneak, continuously right-click dirt for 40 ticks (2 seconds), digging particles show real-time progress - Added network packet `PitDiggingInputPacket` to sync digging progress **[New Items]** - **Earthworm**: 12% chance drop from hand-digging dirt, usable as fishing bait - **Crude Flint Tools**: CrudeFlintKnife / CrudeFlintShovel / CrudeFlintSickle - **Crude Stone Spear**: CrudeStoneSpearItem + throwable entity + custom renderer - **Charcoal Ring**: New block **[Birch Bark Stripping Rework]** - Changed to 4-step progressive stripping: each right-click yields 1 bark, only after 4 scrapes does the log become stripped and play the full sound effect **[Pit Kiln Firing Extensions]** - Limestone Rubble + 900℃ → Quicklime - Greenware Storage Pot + 600℃ → Storage Pot (random 1 of 12 pottery color variants) - Greenware Water Jug + 600℃ → Ceramic Water Jug - Undried greenware has an extra +15% break chance in the kiln **[Drying Rack Extensions]** - Added drying support for Greenware Storage Pot / Greenware Water Jug (each occupies 2 drying slots) **[Mob Equipment System]** - At Hard / higher difficulty, hostile mobs (Zombies, Skeletons, Piglins, etc.) have a chance to equip mod armor - Skeleton-like mobs → Hide Helmet/Chestplate/Leggings/Boots (one random piece) - Zombie-like mobs → Grass Helmet/Chestplate/Leggings (one random piece) - Drop rate: 8.5% **[Full Quality Inheritance Across Processing Stages]** All processing steps automatically pass input quality to output (with optional loss): - **Anvil**: Migrates `ore_quality` → `item_quality` during forging - **Fire Pit**: Soft metal billets / cooked food inherit input quality - **Drying Rack**: Full quality inheritance after drying - **Quern**: Inheritance with -5% loss - **Pit Kiln**: Inheritance with -5% loss - **Crafting**: Aggregates input qualities from the crafting table and distributes to output **[JEI Integration Additions]** - Drying recipes for Greenware Storage Pot / Greenware Water Jug (6000 ticks) - Pit Kiln firing recipes: Greenware Storage Pot → Storage Pot, Greenware Water Jug → Ceramic Water Jug, Limestone Rubble → Quicklime **[UI / Text Additions]** - Greenware dryness tooltip (Dried ✅ / Undried ⚠️) - Knapping proficiency milestone notification - Corrected Pit Kiln greenware placement message **[Other New Files]** - `FluidHelper`: Fluid container utility - `KnappingProficiency`: Knapping skill tracker - `WildAnimalHandler`: Wild animal event handler - Full Storage Pot GUI + Rendering: `StoragePotMenu` / `StoragePotScreen` / `StoragePotRenderer` - Tar Kiln multi-stage block models - Storage Pot multi-water-level models - Ceramic Water Jug multi-fill item models --- ### Fixes & Improvements - Removed deprecated `ore_quality` handling from `ModEventHandlers`, unified under the `item_quality` system - `AbstractNaturalMetalBlock` now auto-assigns random quality to dropped items - `SurfaceCobblestoneBlock` drops now auto-assign quality - `OreQualityTooltipHandler` updated to support the new quality system - Player death `tutorial_book_received` marker now correctly transfers to the new player entity - Fixed copper / silver / gold billet and firewood crafting recipe JSONs - Updated Patchouli guide book entries for multiple languages --- --- ## Forgeborne Odyssey 0.1.14 更新日志 --- ### 新增功能 **[品质系统重构]** - 新增 ItemQuality 品质枚举与 ItemQualityHelper 核心工具类 - 统一品质标签 item_quality，替代原 Weight / ore_quality 等分散标签 - 支持：随机分配、原料继承、加工损耗、旧矿石品质自动迁移 - 玩家拾取与每 tick 自动为所有模组物品赋予品质，确保自获取起就有品质属性 - 五级品质 Tooltip：粗劣 / 低劣 / 普通 / 精良 / 卓越 - 新增重量 Tooltip 行 **[存储陶罐 & 陶水壶系统]** - **存储陶罐**：可放置方块，内部存储物品，支持 8 级渐变蓄水显示 - **陶水壶**：可存储 4 瓶水（1000mB），右键水源装水、右键地面倒水 - **皮水袋**：原始皮革水容器 - 新增生坯陶罐、生坯陶水壶作为窑烧前体 **[焦油窑挖掘机制重制]** - 焦油窑不再徒手潜行+泥土瞬时放置 - 改为：手持铲子（燧石/粗燧石）+ 潜行，对泥土持续右键 40 tick（2 秒），过程中显示挖掘粒子 - 新增网络包 PitDiggingInputPacket 同步挖掘进度 **[新物品]** - **蚯蚓**：徒手挖掘泥土 12% 几率获得，可作鱼饵 - **粗燧石工具**：粗燧石刀 / 粗燧石铲 / 粗燧石镰 - **原始石矛**：可投掷实体 + 独立渲染器 - **木炭堆环**：新方块 **[白桦树皮剥离重制]** - 改为 4 次逐步剥离：每次右键只产出 1 个树皮，累计 4 次后原木才变为去皮状态并播放完整音效 **[窑炉烧制扩展]** - 石灰岩碎石 + 900℃ → 生石灰 - 生坯陶罐 + 600℃ → 陶罐（随机 12 种颜色之一） - 生坯陶水壶 + 600℃ → 陶水壶 - 未晾晒生坯在窑中额外 +15% 破碎概率 **[晾晒架扩展]** - 新增生坯陶罐、生坯陶水壶的晾晒支持（每件占 2 个晾晒槽位） **[怪物装备系统]** - 困难/较高难度下，敌对生物（僵尸/骷髅/猪灵等）概率装备模组护甲 - 骷髅类 → 皮制头盔/胸甲/护腿/靴子（四选一） - 僵尸类 → 草制头盔/胸甲/护腿（三选一） - 掉落率 8.5% **[品质全链路继承]** 所有加工环节自动传递原料品质至成品： - **铁砧**：打制时迁移 ore_quality → item_quality - **火坑**：软金属锭 / 烹饪食品 继承原料品质 - **晾晒架**：晾晒后完整继承 - **石磨**：成品继承（-5% 损耗） - **窑炉**：成品继承（-5% 损耗） - **合成**：自动汇总合成表中原料品质分配至输出 **[JEI 集成扩展]** - 生坯陶罐、生坯陶水壶的晾晒配方（6000 tick） - 窑烧配方：生坯陶罐 → 陶罐、生坯陶水壶 → 陶水壶、石灰岩碎石 → 生石灰 **[UI / 文本]** - 生坯晾晒状态 Tooltip（已晾晒 ✅ / 未晾晒 ⚠️） - 打石熟练度里程碑提示 - 窑炉生坯放置提示文案修正 **[其他新增文件]** - FluidHelper：流体容器辅助工具 - KnappingProficiency：打石熟练度管理 - WildAnimalHandler：野生动物事件处理器 - 陶罐 GUI 与渲染：StoragePotMenu / StoragePotScreen / StoragePotRenderer - 焦油窑多阶段方块模型 - 陶罐多水量模型 - 陶水壶多水量物品模型 --- ### 修复与改进 - 移除 ModEventHandlers 中已废弃的 ore_quality 处理逻辑，统一走 item_quality 体系 - AbstractNaturalMetalBlock（天然金属方块）现在自动为拾取物分配随机品质 - SurfaceCobblestoneBlock 挖掘掉落物现在自动分配品质 - OreQualityTooltipHandler 适配新品质系统 - 玩家死亡后 tutorial_book_received 标记正确迁移至新角色 - 修复铜/银/金 billet、火木合成配方 JSON - Patchouli 指南书多语言条目更新

## 0.1.13 ### Gameplay - **Pit kiln now requires a grate before loading greenware or sealing**: At Stage 1, attempting to remove greenware or seal the kiln without a grate installed will prompt "Grate required" - **Birch bark drop adjusted**: Stripping birch logs now drops a fixed 4 birch bark instead of a random 1-2 - **Tar kiln placement tightened**: Right-clicking a dirt-like block with an empty hand now requires holding Shift to place a tar kiln, preventing accidental placement ### Integration - **Jade plugin now supports tar kiln**: Jade can now display the progress status of the tar kiln ### Advancements - **Pit kiln advancement prerequisite corrected**: "Kiln Mastery" now requires `first_greenware` instead of `sparks_fly` (greenware must exist before firing, makes more logical sense) - **Guide book advancement trigger**: Added `tutorial_guide_book` to the guide book advancement trigger items ### Guide Book - **Tutorial overview updated**: Overview page now lists Chapter 6 (Tar Kiln & Birch Tar) and Chapter 7 (Quern & Ore Processing), chapter color unified to `§4` - **Pit kiln guide improvements**: - Overview page: Max temperature description updated to "900°C (1200°C with blowpipe)", added tip that temper grog in recipes can be substituted with sand/red sand - Results page: Detailed firing conditions and products for each greenware type - **Color formatting unified across EN/ZH guide books**: Natural metals, red mold, and other color markers changed from `§6` to `§4` ### Fixes - **Fixed BOM encoding issues in 9 rubble crafting recipes**: Removed BOM markers from JSON file headers, resolving recipe loading failures in certain environments

## v0.1.12 Changelog ### Added - **Charcoal Kiln mode**: The Tar Kiln block now supports a dual-mode system — Tar mode (original) and Charcoal mode (new) - Place firewood (up to 4) and ignite with a fire drill, then seal with wet clay for low-oxygen smoldering - Dig open the sealed kiln to retrieve charcoal and plant ash - Full interaction feedback: wood placed, kiln full, wood removed, sealed, need wood first, ignited, harvested - **Fire Drill enhancements**: Added ambient fire sound (`FIRE_AMBIENT`) and flame/smoke particles when igniting charcoal rings and charcoal kilns - Added entity display name for thrown crude stone spear (`crude_stone_spear_thrown`) in both EN and ZH locales ### Changed - **Cave-in mechanics refined**: Added block looseness multiplier (`getBlockLoosenessMultiplier`) based on block hardness - Hardness ≤ 0.6 (e.g. dirt, gravel): ×2.0 cave-in chance - Hardness ≤ 1.0: ×1.5 - Hardness ≤ 1.5: ×1.0 (baseline) - Hardness ≤ 3.0 (e.g. standard stone): ×0.7 - Hardness > 3.0 (e.g. hard rock): ×0.5 - **Creative tab**: Rubble items (suffixed `_rubble`) are now hidden from the Ore Fragments & Particles tab to reduce clutter - **Block naming**: "Tar Kiln" renamed to "Kiln" to reflect its dual-mode functionality - **ZH locale**: Fixed BOM encoding artifact in `zh_cn.json` ### Fixed - Fire drill now checks kiln mode (`mode == TAR`) before triggering tar kiln ignition, preventing conflicts with the charcoal kiln mode

## v0.1.11 Changelog ### New Features **Tar Kiln System** - Added **Tar Kiln** block — place by right-clicking dirt/grass blocks with an empty hand. Build a charcoal ring around it, ignite, and use it to dry-distill birch bark into birch tar - Added **Charcoal Ring** block — place around the Tar Kiln's perimeter, ignite to provide heat - Added **Birch Bark** — obtained by right-clicking birch logs with a flint knife or crude flint knife - Added **Birch Tar** — a natural adhesive used for hafting stone tools **Crude Stone Tool System (Knapping)** - Hold a **Surface Cobblestone** in each hand and right-click to knap them together. Probability breakdown: - 20% nothing (both stones shatter) - 30% 1–2 Flint Flakes - 12.5% Crude Flint Knife - 12.5% Crude Flint Shovel - 12.5% Crude Flint Sickle - 12.5% Crude Stone Spear - Added **Crude Flint Knife**, **Crude Flint Shovel**, **Crude Flint Sickle**, **Crude Stone Spear** (including thrown entity + renderer) - Crude Flint Knife is now included in the `forge:tools/knives` tag, usable for collecting grass fiber **New Surface Cobblestone Interactions** - **Sneak + right-click** on a knappable stone surface (Stone, Granite, Andesite, Diorite, Deepslate, Tuff, Basalt, Calcite, Dripstone Block, Sandstone, Obsidian, etc.) with a Surface Cobblestone: consumes 1 cobblestone, 60% chance for 2 flint flakes, 40% for 1 - Right-click with a **Cobblestone Hammer** on a knappable stone surface: auto-consumes Surface Cobblestone from inventory, 80% chance for 3 flint flakes, 20% for 2 **New Interactions** - Right-clicking grass blocks with an **empty hand** now collects Grass Fiber directly (no tool required, with particle effects) - Right-clicking dirt blocks with an empty hand now places a **Tar Kiln** - Crude Flint Shovel can now also be used to dig Pit Kilns and collect clay (same functionality as the regular Flint Shovel) **Creative Tab** - `raw_clay` is no longer filtered out of the "Ore Fragments" tab - Added 9 rock rubble variants (Shale, Sandstone, Limestone, Marble, Quartzite, Gabbro, Quartz Vein, Sericitized, Chlorite) to the Ore Fragments tab ### Mechanics Improvements **Pit Kiln** - Support for **direct greenware loading without a grate** (place greenware at Stage 0, skipping grate installation) - Grate can now be installed at Stage 1 (more flexible build order) - Added ambient fire sound effects during burning **Anvil (Forging System)** - **Mass conservation fix**: when crushing ore, the total quality is now evenly distributed across all output items (grains + grog), rather than each output inheriting the full quality value **Fire Pit** - Removed direct flint-and-steel / fire charge ignition logic from `FirePitBlock`, now unified under `FireDrillItem` **Ignition System Refactor** - Removed `FireCrackMiningHandler.onIgniteWithFlint`, all ignition is now handled centrally by `FireDrillItem.releaseUsing()` (with charge mechanic) - Fire Drill now also supports igniting **Charcoal Rings** and **Tar Kilns** **Quern** - **Flint Pebble** (`flint_pebble`) can now also be ground into a Polished Axe Head, same as regular Flint **Sling** - Copper, Silver, and Gold Beads can now be used as **heavy ammunition** ### Recipe Changes - **Bone Fish Hook**: changed from shapeless to shaped (Bone + Flint Flake) - **Fire-Crack Mining Guide**: material changed from Book to Rawhide - **Fire Mouth**: temper material changed from `temper_grog` to `temper_materials` tag (more flexible) - **Flint Knife / Shovel / Sickle / Stone Axe / Stone Hoe / Stone Spear**: recipes now include Birch Tar and Sticks as hafting materials ### UI / Text Adjustments - Advancement `sparks_fly` icon changed from Flint and Steel to **Fire Drill** - Global text color standardization: `§7`(gray) → `§8`(dark gray), `§e`(yellow) → `§6`(gold), `§a`(green) → `§2`(dark green) - Title color changed from `#2F4F4F` (dark slate gray) to `#000055` (dark blue) - Anvil messages: "temper grog" simplified to "grog" - Grease Torch now has ambient fire sound effects via `animateTick` ### New Localization Entries - Added English and Chinese translations for Tar Kiln, Charcoal Ring, Birch Bark, Birch Tar, 4 crude stone tools, and all related tooltips

This update focuses on filling gaps in the early-game progression loop and cleaning up legacy content. New Features Ore Quality System - Added OreGrade, OrePurity, and OreQuality enums with five tiers: Poor, Low, Medium, High, Rich. - Added OreDropCalculator -- ore drops now scale with quality grade. - Added GradeLootModifier -- a global loot modifier that automatically assigns quality to mined ores. - Added OreGradeComponentProvider (Jade integration) -- displays ore quality in-world when hovering over ore blocks. - Added OreQualityTooltipHandler -- item tooltips now show ore quality. Player Strength System - Added PlayerStrengthManager -- tracks player strength level, which affects carrying capacity. - Added StrengthTrainingHandler -- mining, combat, and other activities gradually train strength. - Added WeightDebuffHandler -- exceeding carry weight applies slowness and other debuffs. - Added StrengthHudOverlay -- on-screen HUD element showing current strength level. - Added SyncStrengthPacket for client-server synchronization. New Blocks - Quern -- A hand-operated grinding stone. Rotate to crush ores and grains. (QuernBlock, QuernBlockEntity, QuernRenderer) - Grease Torch -- A primitive torch with lit and unlit states, supports wall placement. (GreaseTorchBlock) - Cassiterite Placer Block -- A decorative tin ore block. New Weapons - Simple Bow -- A basic bow for early-game ranged combat. (SimpleBowItem) - Sling -- Hurls stones at enemies. Includes custom sound effects (sling_spin, sling_release). (SlingItem, ThrownSlingStone) - Stone Spear -- A throwable melee/ranged hybrid weapon. (StoneSpearItem, ThrownStoneSpear) - Stone Arrow -- Flint-tipped arrow for the simple bow. (StoneArrowItem, StoneArrow, model + renderer) - Bone Arrow -- Bone-tipped arrow, lighter alternative. (BoneArrowItem, BoneArrow, model + renderer) - Polished Stone Axe -- A refined stone axe with improved durability. (PolishedStoneAxeItem) New Tools - Scraper -- Used for hide processing. (ScraperItem) - Bone Needle -- Crafting tool for leatherwork. (BoneNeedleItem) - Simple Fishing Rod -- A basic fishing rod for early-game fishing. (SimpleFishingRodItem) - Stone Hoe -- Replaces the removed Stone Hammer for tilling soil. (StoneHoeItem) New Armor - Grass Armor -- Woven grass helmet, chestplate, and leggings with custom 3D models. - Hide Armor -- Rawhide boots, helmet, chestplate, and leggings. New Items - Animal Fat -- Obtained from animals, used for crafting grease torches. - Rawhide / Dried Hide / Tanned Leather -- A multi-step hide processing chain. - Fiber Rope -- Crafted from plant fibers. - Flour -- Ground from grains using the quern. - Herb Poultice -- A basic healing item. - Grass Basket -- A portable 9-slot container with its own UI. (GrassBasketMenu, GrassBasketScreen) - Bone Fish Hook -- Component for crafting fishing rods. - Flint Arrowhead / Spearhead / Knife Head / Shovel Head / Sickle Head -- Intermediate crafting components. - 20+ ore grain textures (azurite, bornite, chalcocite, chalcopyrite, etc.) - Tutorial Guide Book -- A Patchouli guidebook covering the mod's core mechanics. New World Generation - Stone Workshop Remains -- A surface structure with early-game loot. (StoneWorkshopRemainsStructure, StoneWorkshopRemainsPiece) - Cassiterite Placer -- A worldgen structure for surface tin ore deposits. (CassiteritePlacerStructure, CassiteritePlacerPiece) JEI Integration Eight new recipe categories added: - Axe Bending, Chisel Carving, Drying, FirePit Cooking, FirePit Smelting - Knapping, Ore Crushing, Pit Kiln Firing, Quern Grinding - Added JeiDrawHelper utility and ToolShapelessRecipe support. Patchouli Guidebook - New tutorial_guide book (English & Chinese) covering: Overview, Stone Tools, Fire Crack Mining, Pit Kiln, Cold Forging, and Natural Metals. Advancements - New advancements: first_stone_tool, bone_fish_hook, herb_poultice, simple_fishing_rod. Changes & Adjustments Recipe Changes - Removed all surface_cobblestone_stone_* tool recipes (hoe, pickaxe, shovel, sword). - Removed prepared_clay_crafting. - Added recipes for: stone axe, stone hoe, stone spear, stone arrow, bone arrow, simple bow, sling, simple fishing rod, scraper, bone needle, bone fish hook, fiber rope, grass basket, grass armor, hide armor, grease torch, herb poultice, tanned leather, polished stone axe, quern, and more. - Added vanilla recipe overrides: all armor tiers, netherite upgrades, flint and steel, shears, shield, crossbow, bow, turtle helmet. - stone_hammer_crafting renamed to quern_crafting. - stone_axe renamed to crossbow. - surface_cobblestone_stone_axe_crafting renamed to simple_bow_crafting. - Adjusted flint tool recipes (knife, shovel, sickle). - Adjusted copper fishing rod recipe. - Added gravel.json loot table. - Added kiln_fuel item tag. Block / Entity Changes - Refactored FireMouthBlock and FirePitBlock. - Significantly expanded AnvilBlockEntity (+763 lines). - Adjusted AbstractAnvilBlock. - Added CorpseEntity and CorpseRenderer. - Simplified CopperFishingRodItem (-137 lines). - Expanded FireDrillItem (+253 lines). - Minor adjustments to metal weapons (MetalKnife, WroughtMetalSword, etc.). Client Changes - Expanded ClientEventHandler and ClientForgeEventHandler. - Adjusted GuideBookScreen. - Adjusted AnvilRenderer. - Removed redundant code from KilnLidRenderer and PitKilnRenderer. Event System - Adjusted AnvilInteractionHandler, CaveInEventHandler, RockMiningHandler, FireCrackMiningHandler. Registration - Updated ModItems, ModBlocks, ModEntities, ModCreativeTabs, ModRecipes, ModSounds, ModStructures, ModArmorMaterials, ModMenuTypes. Removed / Cleaned Up - Removed StoneHammerItem (replaced by Stone Hoe). - Removed 8 unused GUI textures (anvil_selection, chipping_gui, copper_sign_gui, gold_sign_gui, guide_book, metal_strip_crafting, pit_kiln_overview, silver_sign_gui). - Removed crude_clay_ball, prepared_clay, plant_fiber, and temper_grit textures. - Removed obsolete surface_cobblestone_* recipes. - Cleaned up redundant code in OpenPitMineRuinPiece and ShaftMineRuinPiece. Miscellaneous - Updated gradle.properties version number. - Significantly expanded en_us.json and zh_cn.json localization files. - Added sling sound effects to sounds.json. - Added new ConfigManager options. - Updated ModEventHandlers registration. - Added IForgeItem interface extension (875 lines).

1. Added a beginner’s tutorial book. 2. Fixed the stress value issue with placed blocks. 3. Adjusted weight‑lifting stats. 4. Training levels no longer reset upon death. 5. Disabled most vanilla tools and all armor. 6. Added some particle effects. 7. Implemented a block‑shattering mechanic. 8. Adjusted weapon stats. 9. Improved the cave‑in sound effects. 10. Added a straw‑weave outfit. 11. Added a stone spear. 12. Adjusted some crafting recipes. 13. Added a sling. 14. Wooden tongs can now be used in either hand. 15. The bow drill requires charge to ignite. 16. Adjusted the font color of certain sections in the manual. 17. Revised parts of the manual content. 18. Fixed the bug where the active training progress bar did not advance when unburdened. 19. Added a corpse‑processing system.

1. Added a system for grade, purity, and quality. 2. Implemented weight‑carrying and training mechanics. 3. Modified the models for crucible blanks and gray‑ware crucibles. 4. The drying rack must be used in conditions free from direct sunlight to 5. produce finished ware; otherwise, it will yield broken pottery shards. 6. Adjusted the generation logic for surface‑spawned raw stone blocks.