# -*- coding: utf-8 -*- """拖拽编程画布——块定义（JSON 结构）。 BLOCK_CATEGORIES / BLOCK_DEFS 是前端画布渲染、参数面板、后端校验与编译的唯一事实源。 新增块类型只需在此注册：category / type / label / icon / color / params / ports。 块 = 画布上一个节点。每个块有： - params: 参数定义（参数面板表单渲染 + 后端校验规则） - ports.inputs / ports.outputs: 连线端口（事件块无输入端口 = 天然入口） - dynamic_outputs: 动态端口模板（如分叉/并行按 branch_count 生成多个输出端口） """ BLOCK_CATEGORIES = [ {"key": "event", "label": "事件", "color": "#4CAF50"}, {"key": "logic", "label": "逻辑", "color": "#2196F3"}, {"key": "action", "label": "动作", "color": "#FF9800"}, {"key": "variable", "label": "变量", "color": "#9C27B0"}, {"key": "expr", "label": "表达式", "color": "#607D8B"}, ] def _p(name, label, uitype='text', required=False, default='', options=None, **kw): """参数定义。uitype: text / number / select / boolean / entity / expression / textarea""" d = {"name": name, "label": label, "uitype": uitype, "required": required, "default": default} if options: d["options"] = options d.update(kw) return d def _port(name, label, ptype='flow'): return {"name": name, "label": label, "type": ptype} def _block(btype, category, label, icon, color, params, inputs=None, outputs=None, description='', dynamic_outputs=None): return { "type": btype, "category": category, "label": label, "icon": icon, "color": color, "params": params, "ports": {"inputs": inputs or [], "outputs": outputs or []}, "description": description, "dynamic_outputs": dynamic_outputs, } _OUT = [_port('out', '下一步')] # ═══════════════════════ 事件块（入口，无输入端口） ═══════════════════════ _EVENTS = { "event_start": _block( "event_start", "event", "开始", "fa fa-play-circle", "#4CAF50", [], inputs=[], outputs=_OUT, description="程序入口：世界初始化时触发一次"), "event_click": _block( "event_click", "event", "点击", "fa fa-mouse-pointer", "#4CAF50", [ _p("target", "目标实体", "entity", required=True, placeholder="选择被点击的实体"), _p("button", "按键", "select", default="left", options=[{"value": "left", "text": "左键"}, {"value": "middle", "text": "中键"}, {"value": "right", "text": "右键"}]), ], inputs=[], outputs=_OUT, description="事件：某实体被点击时触发"), "event_hover": _block( "event_hover", "event", "悬停", "fa fa-hand-pointer", "#4CAF50", [ _p("target", "目标实体", "entity", required=True), _p("state", "状态", "select", default="enter", options=[{"value": "enter", "text": "进入"}, {"value": "leave", "text": "离开"}]), ], inputs=[], outputs=_OUT, description="事件：指针悬停进入/离开实体时触发"), "event_timer": _block( "event_timer", "event", "定时", "fa fa-clock", "#4CAF50", [ _p("interval", "间隔(秒)", "number", required=True, default="1", min=0.1), _p("repeat", "重复次数", "number", default="-1", description="-1 表示无限循环"), ], inputs=[], outputs=_OUT, description="事件：按固定间隔定时触发"), "event_collision": _block( "event_collision", "event", "碰撞", "fa fa-bolt", "#4CAF50", [ _p("entity_a", "实体 A", "entity", required=True), _p("entity_b", "实体 B", "entity", required=True), ], inputs=[], outputs=_OUT, description="事件：实体 A 与实体 B 发生碰撞时触发"), "event_keyboard": _block( "event_keyboard", "event", "键盘", "fa fa-keyboard", "#4CAF50", [ _p("key", "按键", "text", required=True, placeholder="如：Space / ArrowUp / a"), _p("action", "动作", "select", default="keydown", options=[{"value": "keydown", "text": "按下"}, {"value": "keyup", "text": "松开"}]), ], inputs=[], outputs=_OUT, description="事件：键盘按键按下/松开时触发"), } # ═══════════════════════ 逻辑框架块 ═══════════════════════ _LOGIC = { "logic_sequence": _block( "logic_sequence", "logic", "顺序", "fa fa-list-ol", "#2196F3", [], inputs=[_port('in', '上一步')], outputs=_OUT, description="顺序执行：依次执行后续块"), "logic_loop": _block( "logic_loop", "logic", "循环", "fa fa-repeat", "#2196F3", [ _p("mode", "模式", "select", default="count", options=[{"value": "count", "text": "按次数"}, {"value": "while", "text": "按条件"}]), _p("times", "次数", "number", default="3", min=0, max=10000), _p("condition", "循环条件", "expression", default="True", description="while 模式的循环条件表达式"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="循环执行后续块（按次数或按条件）"), "logic_condition": _block( "logic_condition", "logic", "条件判断", "fa fa-code-branch", "#2196F3", [ _p("condition", "条件", "expression", required=True, default="True", placeholder="如：score > 100 或 @alive == true"), ], inputs=[_port('in', '上一步')], outputs=[_port('true', '真'), _port('false', '假')], description="条件判断：条件为真走「真」出口，否则走「假」出口"), "logic_branch": _block( "logic_branch", "logic", "分叉", "fa fa-sitemap", "#2196F3", [ _p("branch_count", "分支数", "number", default="2", min=2, max=8), ], inputs=[_port('in', '上一步')], outputs=[], dynamic_outputs={"param": "branch_count", "prefix": "branch"}, description="多路分叉：按分支数生成多个出口"), "logic_wait": _block( "logic_wait", "logic", "等待", "fa fa-hourglass-half", "#2196F3", [ _p("seconds", "等待秒数", "number", required=True, default="1", min=0), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="等待指定秒数后继续"), "logic_parallel": _block( "logic_parallel", "logic", "并行", "fa fa-columns", "#2196F3", [ _p("branch_count", "分支数", "number", default="2", min=2, max=8), ], inputs=[_port('in', '上一步')], outputs=[], dynamic_outputs={"param": "branch_count", "prefix": "p"}, description="并行：多个分支同时执行（编译为顺序展开）"), "logic_function_def": _block( "logic_function_def", "logic", "函数定义", "fa fa-fw fa-code", "#2196F3", [ _p("name", "函数名", "text", required=True, placeholder="如：jump"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="定义可复用函数：函数体为后续连接块"), "logic_function_call": _block( "logic_function_call", "logic", "函数调用", "fa fa-caret-right", "#2196F3", [ _p("name", "函数名", "text", required=True, placeholder="如：jump"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="调用已定义的函数"), } # ═══════════════════════ 动作块 ═══════════════════════ _ACTION = { "action_move": _block( "action_move", "action", "移动", "fa fa-arrows-alt", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("x", "X 位移", "number", default="0"), _p("y", "Y 位移", "number", default="0"), _p("duration", "时长(秒)", "number", default="0", min=0), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="移动实体（位移量，支持负值）"), "action_rotate": _block( "action_rotate", "action", "旋转", "fa fa-undo", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("angle", "角度(度)", "number", default="90"), _p("duration", "时长(秒)", "number", default="0", min=0), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="旋转实体指定角度"), "action_scale": _block( "action_scale", "action", "缩放", "fa fa-expand-arrows-alt", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("scale_x", "X 缩放", "number", default="1", min=0), _p("scale_y", "Y 缩放", "number", default="1", min=0), _p("duration", "时长(秒)", "number", default="0", min=0), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="缩放实体（1 = 原始大小）"), "action_set_property": _block( "action_set_property", "action", "改属性", "fa fa-sliders-h", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("property", "属性名", "text", required=True, placeholder="如：alpha / color / speed"), _p("value", "属性值", "text", required=True, placeholder="如：0.5 / #ff0000"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="修改实体属性"), "action_play_animation": _block( "action_play_animation", "action", "播放动画", "fa fa-film", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("animation", "动画名", "text", required=True, placeholder="如：run / jump"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="播放实体动画"), "action_play_sound": _block( "action_play_sound", "action", "播放声音", "fa fa-volume-up", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("sound", "声音资源", "text", required=True, placeholder="如：coin.wav"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="播放声音资源"), "action_show_hide": _block( "action_show_hide", "action", "显隐", "fa fa-eye", "#FF9800", [ _p("entity", "目标实体", "entity", required=True), _p("visible", "可见", "boolean", default="true", options=[{"value": "true", "text": "显示"}, {"value": "false", "text": "隐藏"}]), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="显示/隐藏实体"), "action_camera": _block( "action_camera", "action", "相机", "fa fa-camera", "#FF9800", [ _p("camera_id", "相机 ID", "text", default="main"), _p("mode", "模式", "select", default="follow", options=[{"value": "follow", "text": "跟随"}, {"value": "free", "text": "自由"}, {"value": "lookat", "text": "注视"}]), _p("x", "X", "number", default="0"), _p("y", "Y", "number", default="0"), _p("zoom", "缩放", "number", default="1", min=0.1), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="控制相机（自由模式设置坐标，跟随模式注视目标）"), } # ═══════════════════════ 变量与表达式块 ═══════════════════════ _VARIABLE = { "var_create": _block( "var_create", "variable", "创建变量", "fa fa-plus-circle", "#9C27B0", [ _p("name", "变量名", "text", required=True, placeholder="如：score"), _p("initial_value", "初始值", "text", default="0"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="创建并初始化一个变量（编译时统一在脚本头部声明）"), "var_assign": _block( "var_assign", "variable", "赋值", "fa fa-pen", "#9C27B0", [ _p("name", "变量名", "variable", required=True, placeholder="如：score"), _p("value", "值", "expression", required=True, placeholder="如：100 或 @score + 10"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="给变量赋新值"), "var_read": _block( "var_read", "variable", "读取变量", "fa fa-eye", "#9C27B0", [ _p("name", "变量名", "variable", required=True, placeholder="如：score"), _p("result", "结果变量", "text", required=True, placeholder="如：cur_score"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="读取变量值存入结果变量"), } _EXPR = { "expr_arith": _block( "expr_arith", "expr", "算术", "fa fa-calculator", "#607D8B", [ _p("operand_a", "操作数 A", "expression", required=True, placeholder="如：10 或 @score"), _p("operator", "运算符", "select", default="+", options=[{"value": "+", "text": "加 +"}, {"value": "-", "text": "减 -"}, {"value": "*", "text": "乘 *"}, {"value": "/", "text": "除 /"}, {"value": "%", "text": "取余 %"}]), _p("operand_b", "操作数 B", "expression", required=True, placeholder="如：5"), _p("result", "结果变量", "text", required=True, placeholder="如：total"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="算术运算：A 运算符 B → 结果变量"), "expr_compare": _block( "expr_compare", "expr", "比较", "fa fa-balance-scale", "#607D8B", [ _p("operand_a", "操作数 A", "expression", required=True), _p("operator", "运算符", "select", default="==", options=[{"value": "==", "text": "等于 =="}, {"value": "!=", "text": "不等于 !="}, {"value": ">", "text": "大于 >"}, {"value": "<", "text": "小于 <"}, {"value": ">=", "text": "大于等于 >="}, {"value": "<=", "text": "小于等于 <="}]), _p("operand_b", "操作数 B", "expression", required=True), _p("result", "结果变量", "text", required=True, placeholder="如：is_win"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="比较运算：A 运算符 B → 结果变量(布尔)"), "expr_logic": _block( "expr_logic", "expr", "逻辑", "fa fa-toggle-on", "#607D8B", [ _p("operand_a", "操作数 A", "expression", required=True, default="True"), _p("operator", "运算符", "select", default="and", options=[{"value": "and", "text": "与 and"}, {"value": "or", "text": "或 or"}, {"value": "not", "text": "非 not"}]), _p("operand_b", "操作数 B", "expression", required=True, default="True"), _p("result", "结果变量", "text", required=True, placeholder="如：flag"), ], inputs=[_port('in', '上一步')], outputs=_OUT, description="逻辑运算：A and/or B → 结果变量(布尔)"), } BLOCK_DEFS = {} BLOCK_DEFS.update(_EVENTS) BLOCK_DEFS.update(_LOGIC) BLOCK_DEFS.update(_ACTION) BLOCK_DEFS.update(_VARIABLE) BLOCK_DEFS.update(_EXPR) def get_block_defs(): """返回 {categories, blocks} 供前端渲染画布。""" return {"categories": BLOCK_CATEGORIES, "blocks": BLOCK_DEFS} def get_block_def(btype): return BLOCK_DEFS.get(btype) def get_dynamic_outputs(btype, params): """按块参数生成动态输出端口名列表。无动态端口返回 []。""" bdef = BLOCK_DEFS.get(btype) if not bdef or not bdef.get("dynamic_outputs"): return [] d = bdef["dynamic_outputs"] try: n = int((params or {}).get(d["param"], 2)) except (TypeError, ValueError): n = 2 n = max(2, min(n, 8)) return ["%s%d" % (d["prefix"], i) for i in range(1, n + 1)]