网易基岩版 MOD Python 开发强制工作流。未知项目必须先 scan_py2_mod_architecture 建立认知;改动已有模块必须先 scan_py2_import_chain 分析引用链;禁止单文件堆积;禁止跨端侧 import;事件监听优先注册表分发避免重复注册;mcmodsdk 环境默认按 str 字节串处理,非必要不转 unicode;游戏业务非必要不 try 且不吞异常;关键决策点必须确认用户意图。
在处理我的世界 MOD、Bedrock、网易版、JSON UI、模型、动画、原版资源等任务时,优先通过 MCP 资料库检索接口、字段、路径、格式规则和示例,避免编造事实。
在我的世界 MOD Python 开发中,注意 import 具有初始化语义;涉及客户端/服务端和线程安全时,不要跨线程导入或初始化不该加载的模块。仅对明确安全的跳板封装库做受控导入。
在 Python 性能敏感代码中,尤其是通过 FFI 调用 C、C++ 扩展或 MC-MODSDK 接口时,优先缓存高频结果,避免重复跨语言边界获取大对象或容器数据。
在 Python 性能敏感代码中,进行字典或集合高频查找时,优先设计轻量、稳定、可复用的 key,善于利用元组,避免字符串拼接。
在 Python 中手动驱动生成器或迭代器时,优先使用 for 循环;必须手动推进时,优先使用带默认值的 next(),避免在热路径中用 try/except StopIteration 作为常态结束判断。
在编写 Python 性能敏感代码,尤其是 tick、循环、事件热路径时,避免把异常处理当作常态控制流;优先使用显式判断,并避免裸 except。