melon-lua 5.2.1__tar.gz → 5.2.4__tar.gz

{melon_lua-5.2.1 → melon_lua-5.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: melon-lua
-Version: 5.2.1
+Version: 5.2.4
 Summary: 甜瓜游乐场 Lua 芯片执行器模拟 - Melon Playground Lua chip sandbox
 Author: melonapk
 License: MIT
@@ -35,7 +35,8 @@ Requires-Dist: pillow>=10.0
 - ✅ 真实前置脚本 `LuaPreamble.lua`（Entity OOP、`shared`/`signal`/`require` 系统）
 - ✅ 甜瓜允许的标准库（`stdlib_melon` + `verify_melon_stdlib.py`）
 - ✅ 11 个 ApiModule：`entity`、`spawn`、`env`、`camera`、`input`、`inputFilter`、`chip`、`mechanic`、`world`、`variables`、`uicontrol`、`print`
-- ✅ SDK 目录：`object_physics_by_id.json`（495 条尺寸；`spawn.create("202")` / `spawn_entity(object_id=…)`）
+- ✅ SDK 目录：`object_physics_by_id.json`（495 条尺寸，Python `spawn_entity`/`add_item`）+ 真机菜单 alias 表（`spawn.create("plastic_plate")`）
+- ✅ Agent 文档对：`docs/persona.md` + `docs/API.md`
 - ✅ 类型化输入输出：`inputs.num.x`、`outputs.string.status`、`outputs.vec.dir`、`outputs.color.tint` 等
 - ✅ 完整生命周期：`OnInit`、`OnTick`、`OnActivated`、`OnDeactivated`、`OnSpawned`、`OnDestroy`
 - ✅ Box2D 真实 2D 物理：重力、碰撞、`addForce`、`setVelocity`、`freeze`、`gravityScale`

{melon_lua-5.2.1 → melon_lua-5.2.4}/README.md

@@ -9,7 +9,8 @@
 - ✅ 真实前置脚本 `LuaPreamble.lua`（Entity OOP、`shared`/`signal`/`require` 系统）
 - ✅ 甜瓜允许的标准库（`stdlib_melon` + `verify_melon_stdlib.py`）
 - ✅ 11 个 ApiModule：`entity`、`spawn`、`env`、`camera`、`input`、`inputFilter`、`chip`、`mechanic`、`world`、`variables`、`uicontrol`、`print`
-- ✅ SDK 目录：`object_physics_by_id.json`（495 条尺寸；`spawn.create("202")` / `spawn_entity(object_id=…)`）
+- ✅ SDK 目录：`object_physics_by_id.json`（495 条尺寸，Python `spawn_entity`/`add_item`）+ 真机菜单 alias 表（`spawn.create("plastic_plate")`）
+- ✅ Agent 文档对：`docs/persona.md` + `docs/API.md`
 - ✅ 类型化输入输出：`inputs.num.x`、`outputs.string.status`、`outputs.vec.dir`、`outputs.color.tint` 等
 - ✅ 完整生命周期：`OnInit`、`OnTick`、`OnActivated`、`OnDeactivated`、`OnSpawned`、`OnDestroy`
 - ✅ Box2D 真实 2D 物理：重力、碰撞、`addForce`、`setVelocity`、`freeze`、`gravityScale`

{melon_lua-5.2.1 → melon_lua-5.2.4}/melon_lua/__init__.py

@@ -29,14 +29,14 @@ from .melsave_writer import (
     resolve_gate_key,
 )
 from .session import MelsaveSession
-from .melsave_builder import MelsaveBuilder
+from .melsave_builder import MelsaveBuilder, list_item_gates
 from .uicontrol_builder import (
     UIControllerBuilder, UIElement, ElementHandle, element_schema,
     BUTTON, PEDAL, SLIDER, INPUT_FIELD, STEERING_WHEEL,
     POINTER, TOGGLE, SCREEN, CUSTOM_ICON, JOYSTICK,
 )
 
-__version__ = "5.2.0"
+__version__ = "5.2.4"
 
 __all__ = [
     "MelonScriptRunner",
@@ -53,6 +53,7 @@ __all__ = [
     "get_profile_by_object_id",
     "get_profile_by_name",
     "list_spawnables",
+    "list_item_gates",
     "object_id_for_name",
     "resolve_spawn_name",
     "load_melmod_pack",

{melon_lua-5.2.1 → melon_lua-5.2.4}/melon_lua/backend/spawn_backend.py

@@ -9,7 +9,9 @@ from ..world import WorldContext
 
 
 def _format_items(lua, items_dict, sep=None):
-    arr = [f"{k}|{v}" for k, v in items_dict.items()]
+    # Device format is "DisplayName|alias" (see official SpawnCatalog example:
+    # alias = entry:match("|([^|]+)$")). Catalog dict is alias → display name.
+    arr = [f"{v}|{k}" for k, v in items_dict.items()]
     if sep is None:
         return lua.table_from(arr)
     return sep.join(arr)

melon_lua-5.2.4/melon_lua/data/item_templates/892993856.json

@@ -0,0 +1 @@
+{"objectId":892993856,"instanceId":0,"modedObjectId":"","localId":0,"originLocalId":0,"parentId":-1,"position":{"x":0.0,"y":0.0,"z":0.0},"rotation":{"x":0.0,"y":0.0,"z":0.0},"scale":{"x":1.0,"y":1.0,"z":1.0},"color":{"r":0.0,"g":0.0,"b":0.0,"a":0.0},"intensity":0.0,"bottomColor":{"r":0.0,"g":0.0,"b":0.0,"a":0.0},"isGradientActive":false,"layer":0,"sortingLayer":"Default","orderLayer":0,"gravity":true,"freezed":false,"ballooned":false,"glued":false,"rotationFrozen":false,"notBreakable":false,"isVisible":false,"isMeltable":false,"isHuman":false,"isMutationPart":false,"isActivationForced":true,"prohibitDrag":false,"prohibitBrokeByWater":false,"interactionType":"Physic","hasInvisible":false,"fluorescentIntensity":0.0,"fluorescentColor":{"r":0.0,"g":0.0,"b":0.0,"a":0.0},"TreeBranch":null,"LightSaveData":{"IsActive":false,"ColorIsChanged":true,"Color":{"r":0.0,"g":0.0,"b":0.0,"a":0.0},"IsBrokenByWater":false,"ChildrenSaveData":null,"<IsActive>k__BackingField":false,"<ColorIsChanged>k__BackingField":true,"<Color>k__BackingField":{"r":0.0,"g":0.0,"b":0.0,"a":0.0},"<IsBrokenByWater>k__BackingField":false,"<ChildrenSaveData>k__BackingField":null},"BreakableSaveData":null,"SpikeComponentData":null,"TakenObjectData":null,"humanData":[],"mechanicData":[{"activationInput":1.0,"floatParameters":[1.0,0.0,0.0,1.0,1.0,1.0],"mechanicSerializedInputs":"[{\"Key\":\"activation\",\"DataType\":2,\"DataName\":\"activation\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":1.0,\\\"Default\\\":1.0,\\\"Min\\\":-3.40282347e+38,\\\"Max\\\":3.40282347e+38,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"shiftX\",\"DataType\":2,\"DataName\":\"shift x\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":0.0,\\\"Default\\\":0.0,\\\"Min\\\":-3.40282347E+38,\\\"Max\\\":3.40282347E+38,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"shiftY\",\"DataType\":2,\"DataName\":\"shift y\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":0.0,\\\"Default\\\":0.0,\\\"Min\\\":-3.40282347E+38,\\\"Max\\\":3.40282347E+38,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"hide\",\"DataType\":2,\"DataName\":\"hide\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":1.0,\\\"Default\\\":0.0,\\\"Min\\\":0.0,\\\"Max\\\":1.0,\\\"IsCheckbox\\\":true}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"sizeX\",\"DataType\":2,\"DataName\":\"width\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":1.0,\\\"Default\\\":0.0,\\\"Min\\\":0.0,\\\"Max\\\":2.14748365E+09,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"sizeY\",\"DataType\":2,\"DataName\":\"height\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":1.0,\\\"Default\\\":0.0,\\\"Min\\\":0.0,\\\"Max\\\":2.14748365E+09,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null}]","mechanicSerializedOutputs":"[{\"Key\":\"entity\",\"DataType\":1,\"DataName\":\"entity\",\"CanBeEdit\":true,\"GateData\":null,\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"activation\",\"DataType\":2,\"DataName\":\"activation\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":0.0,\\\"Default\\\":0.0,\\\"Min\\\":-3.40282347E+38,\\\"Max\\\":3.40282347E+38,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"trigger\",\"DataType\":2,\"DataName\":\"trigger\",\"CanBeEdit\":true,\"GateData\":\"{\\\"Value\\\":0.0,\\\"Default\\\":0.0,\\\"Min\\\":-3.40282347E+38,\\\"Max\\\":3.40282347E+38,\\\"IsCheckbox\\\":false}\",\"GroupId\":null,\"Group\":0,\"GroupName\":null},{\"Key\":\"entity array\",\"DataType\":1024,\"DataName\":\"entity array\",\"CanBeEdit\":true,\"GateData\":null,\"GroupId\":null,\"Group\":0,\"GroupName\":null}]"}],"brokenJoints":[],"hingeJoints":[],"distJoints":[],"constraints":[],"collisionIgnores":[],"addData":[],"saveMetaDatas":[{"key":"Radar_selected_entities","boolValue":false,"stringValue":"[\"62\",\"66\",\"64\",\"63\",\"186\",\"214\",\"245\",\"268\",\"782893376\",\"sliced pumpkin20253215052763\",\"69\",\"105\",\"101\",\"72\",\"171\",\"266\",\"771882688\",\"54\",\"27\",\"18\",\"37\",\"166\",\"255\",\"12\",\"11\",\"9\",\"85\",\"45\",\"168\",\"516882112\",\"1083703616\",\"103\",\"221\",\"240\",\"578486592\",\"864551232\",\"1243939136\",\"855703232\",\"691011904\",\"1795555008\",\"109772480\",\"256507584\",\"578683200\",\"86\",\"7\",\"44\",\"95\",\"100\",\"8\",\"116\",\"98\",\"83\",\"79\",\"119\",\"169\",\"170\",\"39\",\"47\",\"46\",\"52\",\"135\",\"51\",\"175\",\"2029059776\",\"782762304\",\"1921777984\",\"1118961344\",\"1124925760\",\"42\",\"93\",\"89\",\"65\",\"142\",\"173\",\"259\",\"271\",\"1054473920\",\"2046361280\",\"692650304\",\"141426368\",\"717356736\",\"100598080\",\"1649148224\",\"1462698304\",\"1275330240\",\"2010382016\",\"49\",\"104\",\"48\",\"32\",\"70\",\"92\",\"80\",\"182\",\"26\",\"41\",\"227\",\"228\",\"243\",\"491388608\",\"117\",\"136\",\"1705378112\",\"1516633792\",\"1841692992\",\"1091894976\",\"402784576\",\"238\",\"241\",\"242\",\"277\",\"315\",\"1499070784\",\"1061749056\",\"1263993152\",\"396754624\",\"316735168\",\"108\",\"110\",\"106\",\"109\",\"112\",\"107\",\"111\",\"231\",\"237\",\"236\",\"239\",\"263\",\"2098987328\",\"294\",\"297\",\"289\",\"295\",\"300\",\"293\",\"299\",\"291\",\"290\",\"292\",\"296\",\"298\",\"1307115200\",\"29\",\"77\",\"78\",\"30\",\"28\",\"61\",\"84\",\"4\",\"58\",\"59\",\"60\",\"55\",\"128\",\"73\",\"144\",\"143\",\"56\",\"31\",\"118\",\"97\",\"34\",\"113\",\"68\",\"20\",\"43\",\"127\",\"126\",\"19\",\"160\",\"187\",\"188\",\"190\",\"191\",\"189\",\"196\",\"194\",\"195\",\"317\",\"318\",\"508100928\",\"1075642688\",\"2137784000\",\"243007168\",\"848888128\",\"1283587776\",\"139787968\",\"983360\",\"592117440\",\"1016725824\",\"37945024\",\"1571488064\",\"2047672000\",\"665190720\",\"918879936\",\"347341120\",\"153\",\"157\",\"156\",\"264\",\"287\",\"288\",\"312\",\"311\",\"313\",\"1882193600\",\"2086732096\",\"1902116544\",\"635109056\",\"1056375104\",\"612958528\",\"1925710144\",\"27262656\",\"36\",\"197\",\"198\",\"199\",\"200\",\"203\",\"204\",\"206\",\"207\",\"208\",\"209\",\"210\",\"212\",\"211\",\"2043937088\",\"403964224\",\"1612054208\",\"1008599360\",\"743833920\",\"410255680\",\"215089472\",\"167903552\",\"1769996608\",\"248\",\"249\",\"250\",\"251\",\"2046689600\",\"1464992064\",\"507707712\",\"130\",\"131\",\"272\",\"132\",\"237371712\",\"133\",\"134\",\"1\",\"10\",\"33\",\"53\",\"184\",\"185\",\"247\",\"897581376\",\"246\",\"274\",\"275\",\"310\",\"278\",\"1131085504\",\"1321336512\",\"1428160192\",\"783810240\",\"436732224\",\"687931072\",\"892600640\",\"257\",\"256\",\"13\",\"252\",\"258\",\"253\",\"254\",\"261\",\"262\",\"276\",\"1353580864\",\"1971846848\",\"1978203840\",\"892993856\",\"1202192704\",\"596836672\",\"1441136320\",\"824246592\",\"176\",\"177\",\"178\",\"179\",\"180\",\"181\",\"235\",\"232\",\"234\",\"233\",\"303\",\"302\",\"229\",\"230\",\"555482816\",\"812646720\",\"1294925504\",\"1795489472\",\"651755840\",\"167117120\",\"1658847552\",\"543686336\",\"1296564544\",\"1683226304\",\"159\",\"172\",\"174\",\"192\",\"213\",\"260\",\"1223557440\",\"1988100416\",\"1978663232\",\"1046479168\",\"109642048\",\"1993933120\",\"379453120\",\"154\",\"17\",\"102\",\"57\",\"408355136\",\"758447808\",\"984350400\",\"85130944\",\"1220804928\",\"498597568\",\"1729888576\",\"2098855616\",\"1141964480\",\"357105984\",\"1853423296\",\"1014890176\",\"1189151040\",\"1860173504\",\"1374748352\",\"1214251328\",\"35454656\",\"1096548672\",\"23\",\"123\",\"183\",\"115\",\"76\",\"125\",\"121\",\"120\",\"94\",\"35\",\"3\",\"114\",\"88\",\"270\",\"81\",\"269\",\"319\",\"267\",\"316\",\"2059338048\",\"Untitled2026417234856744\",\"2044067520\",\"162005312\",\"820510400\",\"1097400000\",\"1616970048\",\"162070848\",\"491913536\",\"657718976\",\"232783552\",\"1163656896\",\"1665007296\",\"1422786880\",\"335151424\",\"137\",\"138\",\"139\",\"155\",\"140\",\"141\",\"201\",\"202\",\"205\",\"223\",\"40\",\"129\",\"87\",\"22\",\"21\",\"25\",\"24\",\"15\",\"14\",\"122\",\"50\",\"222\",\"226\",\"225\",\"224\",\"161\",\"162\",\"163\",\"164\",\"165\",\"279\",\"301\",\"307\",\"309\",\"308\",\"304\",\"305\",\"306\",\"314\",\"193\",\"220\",\"158\",\"74\",\"90\",\"38\",\"2\",\"216\",\"217\",\"218\",\"219\",\"265\",\"834993856\",\"648412864\",\"582877504\",\"1007812928\",\"993919296\",\"1121583424\",\"683278016\",\"1532362432\",\"328072896\",\"193724096\",\"1127612736\",\"6\",\"67\",\"1946157376\",\"0\",\"5\",\"16\",\"71\",\"75\",\"82\",\"91\",\"96\",\"99\",\"124\",\"145\",\"146\",\"147\",\"148\",\"149\",\"150\",\"151\",\"152\",\"167\",\"215\",\"244\",\"273\",\"280\",\"281\",\"282\",\"283\",\"284\",\"285\",\"286\",\"320\",\"321\",\"322\",\"323\",\"324\",\"325\",\"326\",\"327\",\"328\",\"329\",\"330\",\"331\",\"332\",\"333\",\"334\",\"335\",\"336\",\"337\",\"338\",\"339\",\"340\",\"341\",\"342\",\"343\",\"344\",\"345\",\"346\",\"347\",\"348\",\"349\",\"350\",\"351\",\"352\",\"353\",\"354\",\"355\",\"356\",\"357\",\"358\",\"359\",\"360\",\"361\",\"362\",\"363\",\"364\",\"365\",\"366\",\"367\",\"368\",\"369\",\"370\",\"371\",\"372\",\"373\",\"374\",\"375\",\"376\",\"377\",\"378\",\"379\",\"380\",\"381\",\"382\",\"383\",\"384\",\"385\",\"386\",\"387\",\"388\",\"389\",\"390\",\"391\",\"392\",\"393\",\"394\",\"395\",\"396\",\"397\",\"398\",\"399\",\"400\",\"401\",\"402\",\"403\",\"404\",\"405\",\"406\",\"407\",\"408\",\"409\",\"410\",\"411\",\"412\",\"413\",\"414\",\"415\",\"416\",\"417\",\"418\",\"419\",\"420\",\"421\",\"422\",\"423\",\"424\",\"425\",\"426\",\"427\",\"428\",\"429\",\"430\",\"431\",\"432\",\"433\",\"434\",\"435\",\"436\",\"437\",\"438\",\"439\",\"440\",\"441\",\"442\",\"443\",\"444\",\"445\",\"446\",\"447\",\"448\",\"449\",\"450\",\"451\",\"452\",\"453\",\"454\",\"455\"]","intValue":0,"floatValue":0.0,"vector2Value":{"x":0.0,"y":0.0},"vector3Value":{"x":0.0,"y":0.0,"z":0.0},"vector4Value":{"x":0.0,"y":0.0,"z":0.0,"w":0.0,"magnitude":0.0,"sqrMagnitude":0.0},"texture2DValue":null}],"ContextMenuActionsRestrictionSaveData":null,"pixelTargetColor":{"r":0.0,"g":0.0,"b":0.0,"a":0.0},"isPixelTextureWasChanged":false,"activationInput":1.0}

melon_lua-5.2.4/melon_lua/data/radar_select_all_ids.json

@@ -0,0 +1 @@
+["62","66","64","63","186","214","245","268","782893376","sliced pumpkin20253215052763","69","105","101","72","171","266","771882688","54","27","18","37","166","255","12","11","9","85","45","168","516882112","1083703616","103","221","240","578486592","864551232","1243939136","855703232","691011904","1795555008","109772480","256507584","578683200","86","7","44","95","100","8","116","98","83","79","119","169","170","39","47","46","52","135","51","175","2029059776","782762304","1921777984","1118961344","1124925760","42","93","89","65","142","173","259","271","1054473920","2046361280","692650304","141426368","717356736","100598080","1649148224","1462698304","1275330240","2010382016","49","104","48","32","70","92","80","182","26","41","227","228","243","491388608","117","136","1705378112","1516633792","1841692992","1091894976","402784576","238","241","242","277","315","1499070784","1061749056","1263993152","396754624","316735168","108","110","106","109","112","107","111","231","237","236","239","263","2098987328","294","297","289","295","300","293","299","291","290","292","296","298","1307115200","29","77","78","30","28","61","84","4","58","59","60","55","128","73","144","143","56","31","118","97","34","113","68","20","43","127","126","19","160","187","188","190","191","189","196","194","195","317","318","508100928","1075642688","2137784000","243007168","848888128","1283587776","139787968","983360","592117440","1016725824","37945024","1571488064","2047672000","665190720","918879936","347341120","153","157","156","264","287","288","312","311","313","1882193600","2086732096","1902116544","635109056","1056375104","612958528","1925710144","27262656","36","197","198","199","200","203","204","206","207","208","209","210","212","211","2043937088","403964224","1612054208","1008599360","743833920","410255680","215089472","167903552","1769996608","248","249","250","251","2046689600","1464992064","507707712","130","131","272","132","237371712","133","134","1","10","33","53","184","185","247","897581376","246","274","275","310","278","1131085504","1321336512","1428160192","783810240","436732224","687931072","892600640","257","256","13","252","258","253","254","261","262","276","1353580864","1971846848","1978203840","892993856","1202192704","596836672","1441136320","824246592","176","177","178","179","180","181","235","232","234","233","303","302","229","230","555482816","812646720","1294925504","1795489472","651755840","167117120","1658847552","543686336","1296564544","1683226304","159","172","174","192","213","260","1223557440","1988100416","1978663232","1046479168","109642048","1993933120","379453120","154","17","102","57","408355136","758447808","984350400","85130944","1220804928","498597568","1729888576","2098855616","1141964480","357105984","1853423296","1014890176","1189151040","1860173504","1374748352","1214251328","35454656","1096548672","23","123","183","115","76","125","121","120","94","35","3","114","88","270","81","269","319","267","316","2059338048","Untitled2026417234856744","2044067520","162005312","820510400","1097400000","1616970048","162070848","491913536","657718976","232783552","1163656896","1665007296","1422786880","335151424","137","138","139","155","140","141","201","202","205","223","40","129","87","22","21","25","24","15","14","122","50","222","226","225","224","161","162","163","164","165","279","301","307","309","308","304","305","306","314","193","220","158","74","90","38","2","216","217","218","219","265","834993856","648412864","582877504","1007812928","993919296","1121583424","683278016","1532362432","328072896","193724096","1127612736","6","67","1946157376","0","5","16","71","75","82","91","96","99","124","145","146","147","148","149","150","151","152","167","215","244","273","280","281","282","283","284","285","286","320","321","322","323","324","325","326","327","328","329","330","331","332","333","334","335","336","337","338","339","340","341","342","343","344","345","346","347","348","349","350","351","352","353","354","355","356","357","358","359","360","361","362","363","364","365","366","367","368","369","370","371","372","373","374","375","376","377","378","379","380","381","382","383","384","385","386","387","388","389","390","391","392","393","394","395","396","397","398","399","400","401","402","403","404","405","406","407","408","409","410","411","412","413","414","415","416","417","418","419","420","421","422","423","424","425","426","427","428","429","430","431","432","433","434","435","436","437","438","439","440","441","442","443","444","445","446","447","448","449","450","451","452","453","454","455"]