miniworld-scripts

《迷你世界》(Mini World) UGC 脚本合集 —— 自己写的各种游戏脚本，以及游戏脚本运行环境的导出/分析资料。

脚本按引擎版本分目录：

2.0/   旧版 UGC 2.0 脚本（单文件、全局函数风格）
3.0/   新版 UGC 3.0 脚本（组件化，基于 Mini API）

---

3.0 — UGC 3.0 组件化脚本

路径	说明
ActLog.lua	行为日志组件。订阅游戏 / 世界 / 方块 / 容器 / 玩家等事件，按可配置的模板把玩家行为记录到日志，常用于服务器审计与回放。
DumpTable.lua	表序列化 / 打印工具。递归打印 table（含循环引用、userdata、__tostring 处理），用于调试输出。
Freecam.lua	自由相机组件。空中自由飞行的观察相机，支持 /fc、/freecam 指令切换模式、开关与调速。
Leaderboard.lua	排行榜 UI 组件。支持玩家变量 / 房间 KV / 全服 KV 三种数据源，固定间隔或流水线刷新，可滚动、可切换排行榜。
MiniMatica.lua	原理图（Schematic）编辑器。类似 WorldEdit 的选区、复制、粘贴、保存/加载原理图工具，供玩家建造使用。
PermSys/	权限系统（LuckPerms 风格）。
JitDemo/	LuaJIT 热循环探针实验。用反 JIT / 可 JIT 两个自校准探针推断脚本环境是否真正启用了 trace JIT。
environments/	游戏脚本环境导出与分析。见下方。

environments — 环境导出与分析

文件	说明
dump_env.lua	环境导出脚本（在游戏内运行）。导出 dev / official / motion 三套沙盒环境面，外加 ScriptEnvMgr 运行时配置，输出 mwenviron/1 格式。
devenv.lua	脚本（第三方 Mod / 本地地图）环境导出，对应 ScriptEnvMgr.servicesDev
officialenv.lua	官方脚本环境导出，对应 ScriptEnvMgr.services
motionenv.lua	空中动作（Motion）环境导出，对应 ScriptEnvMgr.servicesMotion
mgrenv.lua	ScriptEnvMgr 运行时配置：limitcfg（限频/白名单真值）、modServices、scriptEnum、scriptEnvList
tests/stub_env.lua	离线桩：伪造 ScriptEnvMgr / Service / DevApiCfg / 枚举全局，不启动游戏也能跑通 dump_env.lua
devapicfg.lua	引擎 DevApiCfg.lua（API 权限控制与频率限制配置）反编译源码
devapicfg_analysis.md	对 DevApiCfg 限制体系（对象方法白名单、Service 黑白名单、调用类型等）的分析

mwenviron/1 导出格式

文件是一个合法的 Lua chunk（return 一张表），键已排序，不含内存地址，因此可以：

• 用 loadstring / loadfile 直接还原成表；
• 用 git diff 看出「哪个 API 加了、哪个方法签名变了、哪个方法的调用类型或限频改了」。

写法	含义
["$meta"]	该表的元表（debug.getmetatable）
["$ref"] = {k1, k2}	指向别处已导出的表（键路径），替代旧格式的 table: 0xADDR
["$userdata"]	userdata / thread 的占位字符串
["$truncated"]	达到深度上限被截断
["$$foo"]	真实键名是 $foo（多一个 $ 作转义）
function(a, b) end, --[[…]]	函数只保留签名，尾部注释给出来源与调用限制

函数尾部的 --[[…]] 注释用 ; 分隔，可能包含：

注释	含义
@<路径>:<行号>	真实服务函数所在的 Lua 源文件位置
@service Service.Method	这个包装函数转发到的真实服务方法
@mtype <类型>	调用类型 DevApiMType：Normal / Block / Sync / SyncPack / ClientData / HostAndClient / BoardCast / ReportHost / Mod（决定要不要走网络同步、会注入哪些额外参数）
@rtype <类型>=<值>	调用限制 DevApiRType：Uin_TimeLimit（按 UIN 冷却）/ TimeLimit（全局冷却）/ WhiteList（白名单 key）/ CompareParam / ResetCompareParam / ResendMsg
@C / @builtin	原生函数
@unresolved <key>	包装函数找不到对应真实方法（参数名不可信）

例子：

["GetFriendList"] = function(self, reportid, uin, index, size) end,
--[[@F:/.../services/Player.lua:1234; @service Player.GetFriendList; @mtype ClientData; @rtype Uin_TimeLimit=(10,"调用频繁，请稍后尝试！")]]

导出方式（MWRC 控制台一行，Z: 映射到宿主根目录）：

local p="Z:/home/yuey1ng/mini/miniworld-scripts/3.0/environments/dump_env.lua" local f=io.open(p,"rb") local s=f:read("*a") f:close() return loadstring(s,"dump_env")()

环境导出从游戏运行时 dump 得到，采用 CC BY 4.0 许可。

---

2.0 — 旧版 UGC 2.0 脚本

文件	说明
actlog.lua	行为日志（2.0 版），记录游戏 / 世界 / 容器等事件。
allrandomskyblock.lua	随机空岛：定时把区域内方块随机替换。
apihook.lua	挂钩 Mini 的 UI / 聊天输出接口，拦截并改写打印内容。
getblock.lua	方块信息查询工具：选中方块后查看定义名、描述、数据、开关、电力状态等。
hookpcall.lua	包装 pcall，记录脚本报错的参数与结果，便于排错。
hookprint.lua	挂钩打印输出，把 Print2Wnd 等重定向到自定义日志。
moonlib.lua	基础工具库（base64 编解码、logger 等）。
permissionsystem.lua	简易权限系统。
res-port.lua	领地系统（ResPort）：领地创建、成员管理、权限、传送等。
scriptloader.lua	脚本加载器：模块化加载 / 管理其他脚本。
tickfly.lua	按键飞行 / tick 飞行控制。

---

开发环境

• 语言：Lua（运行于 LuaJIT）
• 类型检查：配合 LuaLS 使用迷你世界 UGC 3.0 类型定义库（见本地 .luarc.json，指向 miniworld-code-3.0/library/）
• 2.0/ 为旧脚本，不在类型检查范围内

---

许可证

除非特殊说明，否则默认 MIT License。

3.0/environments/ 下的环境导出采用 CC BY 4.0 许可。