Iron's Spells: Light Pollution

1.7.5

中文更新说明

• 1.7.5 配置生成修订（版本号不变）：客户端启动时自动生成缺失的加载界面与主菜单 .properties 配置，附带中英文选项说明；已有设置不会被覆盖，默认渲染策略与光敏警告保持不变。文件位于当前游戏实例的 config 目录，修改后重启游戏生效。

• 万法归寂光幕：改为连续立体光幕，幕内玩家魔法免伤，物理攻击仍生效；魔法弹体触幕消散，并接入旧法术真伤保护。

• 新增领域法术、三级法术与星磁弦弓：新增永夜星庭、万法归寂、斥星天环、禁律封疆、星磁赋能；全部 35 个法术支持 I–III 级卷轴升级。特殊弓仅由法术充入三发，穿透实体、撞击方块生成十秒磁力奇点并以球形冲击波引爆。弓的物品栏与悬停效果按用户授权分别参考耀阳元式和实体移除器。具体合作、充能规则和验证边界见 docs/DOMAINS_AND_MAGNETIC_BOW.md。

• 完整法术获取与法术书铭刻：全部 35 个已注册法术均有绑定卷轴、默认 I 级卷轴、独立生存合成配方、战利品箱获取方式和转抄卷轴支持；真实铭刻台已验证每个法术的 I/II/III 级卷轴均可写入法术书并保留等级。

• 法术数值说明：全部 35 个已注册法术补齐实时伤害、冷却时间和魔力消耗；去掉旧描述中的固定数值。配置加载/重载后重新查看即可读取新值；北斗天坠补充服务端数值同步。参见 docs/SPELL_TOOLTIPS.md。

• 新增北斗天坠（Boreal Descent）：独立接入用户授权来源的 SevenStars 七星场景，保留七次落星时序、纯视觉终幕及所需 HUD、声音；原有太空镜头完全不变。不替换原有 Starfall，不引入原 demo 的其他法术或水印。

• 移除地面连线与七颗落地恒星：停用 ground_stars 的运行时渲染及预热；历史 shader 文件保留但不使用。运行时 constellation_ground 移除预落地地面投影（含节点标记）、燃烧地面连线及终幕地面连线；保留降落闪光、光柱、震波、原太空与高空表现，原参考 shader 不改。

• 固定球形落星伤害与非破坏性玩法：每个权威落星点中心 120 格 3D 球内按距离线性衰减：maxHealth × impactDamageFraction × max(0, 1 − d / 120)，默认中心 3.7%、60 格半伤、120 格零伤、球外不伤。连线伤害彻底停用；旧配置键仅作兼容废弃，不能恢复连线或改变 120 格范围。保留正常可取消 hurt()、友军 / PvP / 宠物过滤及 target budgets；不写地形、不加载远方 chunk。新增独立 COMMON 配置。

• 本轮验证状态：35 个法术的获取与真实铭刻台检查通过（获取 2,183 项、铭刻 1,127 项）；领域 disposable-world 客户端 smoke 通过（12 张原生截图、20 项服务端检查、14 项客户端检查）；加载屏 CPU 检查 3,491 项、RTX 4060 GPU 检查 1,025 项通过；最终离线 build 通过。本版本尚未部署或启动 PCL 实例。

• 可选北斗镜头与清理：默认 J 跳过当前电影或切换后续镜头开关；自动镜头仅面向施法者，并跟随场景权威时间。补齐独立本地偏好、资源重载及退出清理；来源 SHA、原始图像 credits 和验证边界见 docs/BOREAL_DESCENT.md。

• 四种引力透镜重做：重新实现赤移天渊、辉环崩解、施瓦西镜界和无光视界的背景扭曲，改为连续、有界的屏幕空间映射，减少重复背景圆环、角度折返和突兀的扭曲边界。

• 遮挡与屏幕边缘：补充前景深度保护和采样位置的遮挡检查；当扭曲接近屏幕边缘或缺少有效背景时，平滑回退到原场景，减少前景方块被错误拉入背景的情况。

• 赤移天渊吸积盘提速：相同配置下，吸积盘视觉转速提高至原来的 1.6 倍；同步调整时间历史处理，避免提速后仍沿用旧的拖影参数。旋转配置默认值仍为 1，设为 0 仍可冻结气体流动，设为 0.625 可恢复原来的视觉转速。

• 近距离视角与透镜叠加：修复赤移天渊近距离侧视时背景透镜突然关闭的问题；保留附属施瓦西镜界已完成透镜时的跳过机制，避免对同一背景重复扭曲。

• 边界与淡入淡出：移除辉环崩解原有的硬切换接缝；修复赤移天渊和无光视界在淡入淡出期间重复应用黑色遮罩、导致核心过暗的问题。

• 配置说明与玩法兼容：同步中英文旋转速度说明及 TOML 示例。吸积盘原有执行公式、法术伤害、服务端生命周期、注册 ID 和其他玩法保持不变；此次提速仅影响视觉流动，不加速法术计时。

English Release Notes

• 1.7.5 configuration hotfix (same version): client startup now creates missing loading-screen and main-menu .properties files with bilingual comments. Existing settings, rendering defaults and the photosensitivity warning are preserved. Files live in the active game instance's config directory; restart after editing.

• Requiem Magic curtain: changed to a continuous three-dimensional curtain. Players inside are immune to magic damage while physical attacks still work; magic projectiles dissolve at the curtain and the existing true-damage protection is preserved.

• Added domain spells, tiered scrolls and the Singularity Bow: added Astral Domain, Spell Requiem, Stellar Repel, Interdiction Field and Magnetic Charge. All 35 spells support I–III scroll upgrades. The special bow receives only three spell charges, pierces entities, creates a ten-second magnetic singularity on block impact and detonates it with a spherical shockwave. See docs/DOMAINS_AND_MAGNETIC_BOW.md for the charging rules and verification boundaries.

• Complete spell acquisition and spellbook inscription: all 35 registered spells now have a bound scroll, a default tier-I scroll, an independent survival crafting recipe, a chest-loot route and transcription support. The real Inscription Table was verified to write every spell at tiers I, II and III while preserving the level.

• Spell statistics: all 35 registered spells expose live damage, cooldown and mana values instead of fixed legacy text. Values update after configuration load/reload; Boreal Descent also has synchronized server-side values. See docs/SPELL_TOOLTIPS.md.

• Added Boreal Descent, an independent adaptation of the authorized SevenStars reference scene, retaining the seven-impact timing, visual-only finale, required HUD and audio. The original space-camera sequence remains completely unchanged. Existing Starfall is unchanged; other demo spell flows and the original watermark are excluded.

• Removed ground links and seven landed stars: ground_stars is no longer rendered or warmed up; its historical shader file remains unused. Runtime constellation_ground removes the pre-impact ground projection (including node markers), burning ground links and finale ground links, while retaining descent flashes, light columns, shockwaves, space and high-altitude effects. The original reference shader is unchanged.

• Fixed spherical impact damage and non-destructive gameplay: each authoritative impact point uses a 120-block 3D sphere with linear falloff: maxHealth × impactDamageFraction × max(0, 1 − d / 120). Default input is 3.7% at the center, half at 60 blocks, zero at 120 and outside. Link damage is completely disabled; deprecated compatibility keys cannot restore it or change the fixed radius. Ordinary cancellable hurt(), ally/PvP/pet filters and target budgets remain intact, with no terrain writes or distant chunk loading. Gameplay has its own COMMON configuration.

• Validation status: complete acquisition and inscription checks passed for all 35 spells (2,183 acquisition assertions and 1,127 inscription assertions); the disposable-world domain client smoke passed with 12 native captures, 20 server checks and 14 client checks; the loading-screen checks passed with 3,491 CPU/resource assertions and 1,025 RTX 4060 GPU assertions; the final offline build passed. No PCL instance was deployed or started for this release.

• Optional local camera and cleanup: J skips the current film or toggles the camera preference. Automatic playback is caster-only and follows the authoritative scene clock. Added private camera preferences and resource-reload/disconnect cleanup; see docs/BOREAL_DESCENT.md for provenance, original image credits and verification limits.

• Reworked gravitational lensing for Redshift Abyss, Radiant Collapse, Schwarzschild Lens and Event Horizon. Background distortion now uses a continuous, bounded screen-space mapping to reduce repeated background rings, angular foldback and abrupt distortion boundaries.

• Added foreground-depth protection and occlusion checks at warped sample locations. Distortion fades back to the original scene near screen edges or when valid background data is unavailable, reducing foreground blocks being pulled into the background.

• Redshift Abyss accretion flow is now 1.6 times faster at the same configuration value, with temporal-history handling updated to match. The rotation setting still defaults to 1; 0 freezes gas flow, and 0.625 restores the previous visual speed.

• Fixed Redshift Abyss lensing abruptly switching off at close side-on viewpoints. Retained the bypass when its attached Schwarzschild Lens has already distorted the scene, preventing duplicate background lensing.

• Removed Radiant Collapse's hard background-transition seam. Fixed overlapping shadow masks making the cores of Redshift Abyss and Event Horizon too dark during fade-in and fade-out.

• Updated bilingual rotation-speed descriptions and TOML examples. Existing disk formulas, spell damage, server-authoritative lifetimes, registry IDs and other gameplay remain unchanged; the speed increase affects visual flow only, not spell timing.

Compatibility

• Minecraft 1.20.1
• Forge 47+
• Iron's Spells 'n Spellbooks 1.20.1-3.16.1+
• Iron's Lib 1.20.1-1.1.0+

验证状态与已知限制

• 北斗天坠：已增加数学、服务端契约、仓库 manifest-only 资源、独立原版资源和 shader 对照入口。真实 GameTest 与 disposable-world 客户端 smoke 本轮结果待主线程补录；组件/替身测试和合成 GPU 对照不等于真实存档视觉或声音验收，不宣称 100% 视觉一致。
• 本轮开发构建、四组透镜相关检查（共 2,274 项）和隔离客户端的启动、shader 加载及资源重载检查通过；GPU 对比图为合成诊断场景，尚未完成存档内的实际施法画面验收。
• 背景透镜是屏幕空间近似，不能还原相机不可见的背景，不宣称完整广义相对论求解。
• 完整 Buffer A 严格源对照仍有 14 / 364 项检查失败。接线前原速基线已有 12 项失败，但当前误差尚未全部解释，不能将全部失败归为旧问题，也不宣称已与原始源效果严格逐像素一致。
• 部分第三方 shader 的再分发许可仍待核实；正式发布前需检查 THIRD_PARTY_NOTICES.md。详细验证记录见 docs/black-hole/LENS-REWORK-20261005.md。

Validation and Known Limitations

• Boreal Descent: separate math, server-contract, repository manifest-only resource, independent original-resource and shader checks are available. The main thread will record the real GameTest and disposable-world client smoke results; component/fixture tests and synthetic GPU comparisons are not in-world visual/audio acceptance or a claim of 100% visual equivalence.
• The development build, all four lensing check groups (2,274 checks in total), and isolated client bootstrap, shader-loading and resource-reload checks passed. GPU comparison images use synthetic diagnostic scenes; in-world spell visuals have not yet been accepted.
• Background lensing is a screen-space approximation, not a complete general-relativistic solver, and cannot reconstruct background geometry outside the camera's view.
• The full strict Buffer A source comparison still has 14 failures out of 364 checks. The pre-wiring, original-speed baseline already had 12 failures, but the current differences are not fully explained. Not all failures can be classified as pre-existing, and strict pixel-for-pixel source equivalence is not claimed.
• Redistribution terms for some third-party shaders remain unverified. Review THIRD_PARTY_NOTICES.md before publishing. Detailed validation results are recorded in docs/black-hole/LENS-REWORK-20261005.md.