RMMZ ModLoader - modloader.js

Plugin desc : [Open Source] RMMZ ModLoader v4 — In-Game Mod Manager for RPG Maker MZSharing an open-source project I've been maintaining: RMMZ ModLoader, an in-game mod manager for RPG Maker MZ. No more hand-editing plugins.js.Highlights:In-game UI: toggle mods, edit parameters, drag-and-drop reorder (F5 to apply) Local mods + Steam Workshop support (v4) Dependency checks via @base / @orderAfter Drag-and-drop install for .js files or a mods/ folder Multilingual UI (zh-CN / zh-TW / EN) + dark/warm themes Config saved in mod_config.json — survives official plugins.js resets Includes example mods and docs for mod authors (struct/table, @text, etc.).

License : MIT License

Author : Jokerbbc

Website : https://github.com/jokerBBC/rpg-maker-mz-mod-loader

Desc page : https://github.com/jokerBBC/rpg-maker-mz-mod-loader/blob/main/README-en.md

Download Page : https://github.com/jokerBBC/rpg-maker-mz-mod-loader/releases

File name : modloader.js

Help of plugin :

/*:
 * @target MZ
 * @plugindesc 游戏内模组管理器（DOM化UI & 现代交互 & 拖放添加Mod & 滑动条/长文本/数据库引用）
 * @author joker创意 / GLM核心代码
 * @version V4.0.0
 *
 * @param Mod Button X
 * @type number
 * @default 20
 * @desc 模组管理按钮距离屏幕左侧的 X 坐标
 *
 * @param Mod Button Y
 * @type number
 * @default 20
 * @desc 模组管理按钮距离屏幕顶部的 Y 坐标
 *
 * @help
 * 【功能及使用方式】
 * 1. 管理游戏内 Mod 的开启与关闭，采用现代 DOM 化 UI 界面。
 * 2. 支持带有 @default 的参数修改（数值、开关、文本、单选下拉、颜色、长文本、数据库引用）。
 * 3. 严苛规则：若 Mod 存在任何未设置 @default 的参数，则该 Mod 所有参数禁止修改！(兼容适配偷懒倒逼：mod作者规范写参数，提升整体Mod质量)
 * 4. 在Mod管理器中点击带有[⚙]标志的Mod名称旁的齿轮图标可唤起参数编辑面板。修改参数后，需保存后实装修改。
 * 5. 布尔开关参数与RMMZ官方对齐，存储为 "true"/"false"。
 * 6. 支持恢复该插件所有参数为默认值(不保存)。
 * 7. 支持 @type color 标签：@color[#ff0000]红色文字@/color、@color[24]RMMZ色号@/color、@color[red]CSS颜色@/color
 * 8. F5刷新游戏后，游戏才能读取新的mod开关状态及参数值。
 * 9. 支持导入Mod、删除Mod、排序Mod
 * 10. Mod 运行时加载，不再写入 plugins.js（仅 mod_config.json 为配置源）
 * 11.支持一键全关Mod
 * 12.标签读取支持：@version @base @orderAfter @orderBefore @author @help
 * 13.依赖检测：自动检测@base/@orderAfter前置插件是否满足，UI颜色警告提示
 * 
 * 【前置必要操作 - 两种模式】
 * 
 * 【模式1：注入模式 】
 * 玩家需对游戏的index.html注入代码。modloader.js文件直接放入 /js/mods 目录即可。
 * 
 * index.html注入结构参考：
 *     
 *     
 *     <!-- 只要注入下面这一行，把控制权完全交给插件内部 -->
 *     
 *     
 *     
 * 
 * 【模式2：插件模式 】
 * 游戏作者可以直接通过 RMMZ 官方插件管理器启用 ModLoader，不需要修改 index.html！
 * - 在插件管理器中将 ModLoader.js 添加到列表中
 * - 修改 Mod 开关或排序后，需要 F5 刷新才能生效！
 * 
 * 【铁律合规性自检】
 * [✓] 本补丁已通过铁律合规检查：无顶层 $dataXxx 依赖 / 所有 Alias 均已做前置存在性检查 / 所有使用的参数均已配置 @default。
 * 
 * 【开源协议】
 * ============================================================================
 * MIT License (MIT 许可证)
 * ============================================================================
 * 版权所有 (c) 2026 joker
 *
 * 特此免费授予任何获得本软件及相关文档文件（下称"软件"）副本的人
 * 不受限制地处置本软件的权利，包括但不限于使用、复制、修改、合并、
 * 出版、分发、再许可及/或销售本软件副本的权利，并允许被提供本软件
 * 的人士如此行事，但须符合以下条件：
 *
 * 上述版权声明和本许可声明应包含在本软件的所有副本或实质部分中。
 *
 * 本软件按"原样"提供，不作任何明示或暗示的保证，包括但不限于对
 * 适销性、特定用途的适用性及不侵权的保证。在任何情况下，作者或版
 * 权持有人均不对因本软件或本软件中的使用或其他交易而产生或与之相
 * 关的任何索赔、损害或其他责任负责，无论是合同、侵权还是其他行为。
 *
 * ====================== 英文原版======================
 *
 * Copyright (c) 2026 joker
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 * ============================================================================
 * 
 * 【更新日志】请查看 docs/modloader_CHANGELOG.md 文件
 */

Jokerbbc