SpellForged：奥术武器模组产品系统Vibe Coding

在复杂业务系统中，不同团队维护的第三方框架往往存在 API 契约异构、状态同步困难与生命周期冲突等问题。本项目以 Minecraft 模组生态为实践场景，为匠魂（TiC 2）与巫术学（Wizardry）两个独立框架构建一套可插拔的武器中台。核心目标是解决跨框架集成的三大痛点：兼容层维护成本、C/S 双写一致性风险、以及多系统事件并发时的竞态条件，输出高内聚、低耦合、可横向扩展的模块化框架。

系统采用分层架构：表现层负责 OpenGL 渲染与输入响应；业务逻辑层拆为四大模块——（1）武器工厂：基于 Builder 模式实现部件动态装配与修饰槽热插拔；（2）事件总线：基于 AOP 切面统一拦截攻击/命中/施法生命周期，解耦元素附魔、连击判定等横切关注点；（3）状态机：通过 FSM 管理蓄力/穿透/收回等离散状态，保证转换原子性；（4）资源调度：基于对象池复用飞行实体，NBT 序列化实现跨存档持久化。

独立负责全生命周期开发，技术栈 Java 8 + Forge Gradle。架构层面运用策略模式封装攻击策略、观察者模式解耦伤害计算、模板方法模式定义武器生命周期钩子。性能优化通过常量内联、懒加载与事件过滤将主线程 tick 负载控制在 0.05ms 以内。核心难点：（1）MCP 映射层下对 EntityArrow 物理轨迹的继承与命中逻辑注入；（2）C/S 状态同步竞态条件，通过 ThreadLocal 隔离的 Set 状态容器解决双写不一致；（3）Render 泛型协变约束下的类型擦除与匿名子类方案。版本控制采用 Git + Conventional Commits。