{"id":20267562,"url":"https://github.com/way-zer/scriptagent4mindustryext","last_synced_at":"2025-04-06T02:07:55.744Z","repository":{"id":41530406,"uuid":"249199059","full_name":"way-zer/ScriptAgent4MindustryExt","owner":"way-zer","description":"A Plugin for Mindustry to load kotlin scripts \u0026\u0026 lots of feature scripts including vote/permission.","archived":false,"fork":false,"pushed_at":"2025-03-23T08:26:03.000Z","size":1756,"stargazers_count":96,"open_issues_count":1,"forks_count":27,"subscribers_count":3,"default_branch":"7.5","last_synced_at":"2025-03-30T01:12:55.644Z","etag":null,"topics":["essitial","kotlin","kts","mindustry","mindustry-mod","mindustry-plugin","plugin","script","scriptagent","server"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/way-zer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-22T14:19:52.000Z","updated_at":"2025-03-23T08:26:06.000Z","dependencies_parsed_at":"2024-01-06T09:20:15.777Z","dependency_job_id":"d61dc8ce-b6f7-4a4f-bf76-f36422e63e2f","html_url":"https://github.com/way-zer/ScriptAgent4MindustryExt","commit_stats":null,"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/way-zer%2FScriptAgent4MindustryExt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/way-zer%2FScriptAgent4MindustryExt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/way-zer%2FScriptAgent4MindustryExt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/way-zer%2FScriptAgent4MindustryExt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/way-zer","download_url":"https://codeload.github.com/way-zer/ScriptAgent4MindustryExt/tar.gz/refs/heads/7.5","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423513,"owners_count":20936626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["essitial","kotlin","kts","mindustry","mindustry-mod","mindustry-plugin","plugin","script","scriptagent","server"],"created_at":"2024-11-14T12:14:58.047Z","updated_at":"2025-04-06T02:07:55.696Z","avatar_url":"https://github.com/way-zer.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"![For Mindustry](https://img.shields.io/badge/For-Mindustry-orange)\n![Lang CN](https://img.shields.io/badge/Lang-ZH--CN-blue)\n![Support 7.5](https://img.shields.io/badge/Support_Version-7.5(136+)-success)\n![GitHub Releases](https://img.shields.io/github/downloads/way-zer/ScriptAgent4MindustryExt/latest/total)\n[![BuildPlugin](https://github.com/way-zer/ScriptAgent4MindustryExt/actions/workflows/buildPlugin.yml/badge.svg)](https://github.com/way-zer/ScriptAgent4MindustryExt/actions/workflows/buildPlugin.yml)\n[![CheckScript](https://github.com/way-zer/ScriptAgent4MindustryExt/actions/workflows/checkScripts.yml/badge.svg)](https://github.com/way-zer/ScriptAgent4MindustryExt/actions/workflows/checkScripts.yml)\n\n\u003e For English README see [README_en](./README_en.md)\n\n## ScriptAgent\n一套基于Kotlin脚本(kts)的模块化框架\n- 强大：基于Kotlin，可以访问所有Java接口（所有插件能实现的功能，脚本都能实现）\n- 高效：脚本加载后转换为JVM字节码，与Java插件性能无异\n- 灵活：模块和脚本具有完整生命周期，支持热加载和热重载\n- 快速开发：提供大量实用辅助函数，无需编译即可快速部署到服务器\n- 智能：开发时支持IDEA或Android Studio的智能补全\n- 可定制：除核心部分外，插件功能均通过脚本实现，可根据需求自由修改，模块定义脚本还可扩展DSL\n\n加载器（jar）本身无具体功能，仅负责脚本的加载与管理，所有功能均由脚本实现。\n\n### ScriptAgent for Mindustry (SA4MDT)\n该框架针对Mindustry的实现，包含加载器（Loader）和一系列功能脚本，具体分为以下6个模块：\n- coreLib（coreLibrary）：框架的标准库\n- core（coreMindustry）：针对Mindustry的具体实现\n- main模块：用于存放简单脚本\n- wayzer模块：一套完整的Mindustry服务器基础插件（By: WayZer）\n  - 交流QQ群：1033116078 或直接在Discussions讨论\n  - 插件测试服务器：cn.mindustry.top\n- mapScript：专为MDT设计的特殊脚本，生命周期与单局游戏绑定，仅在需要时加载\n- ~~mirai模块：QQ机器人库mirai的脚本封装（因上游不可控因素，计划移除）~~\n\n### 客户端预览\n![image](https://user-images.githubusercontent.com/15688938/132090295-59a57f81-cc72-4ab5-8c10-deadf7ae452a.png)\n![image](https://user-images.githubusercontent.com/15688938/132090317-cc62339d-8ce5-4906-90d0-e8fda1bacf36.png)\n\n### 服务器后台预览\n![image](https://user-images.githubusercontent.com/15688938/132090197-e041d11c-e09a-49ee-94e8-d2cdae30038f.png)\n![image](https://user-images.githubusercontent.com/15688938/132090212-1f924326-4ba7-43be-bbb8-e055599fa75c.png)\n![image](https://user-images.githubusercontent.com/15688938/132090238-bbfcaf2e-154a-446c-9d1f-92f391835f0a.png)\n\n## 快速入门\n### 插件安装（推荐普通用户使用）\nallInOne版本在加载器内集成了编译好的脚本\n1. 从Release页面下载`xxx.allinone.jar`文件，并将其放置在`config/mods`目录下\n2. 启动服务器（首次启动会从网络下载依赖，耗时较长）\n\n### 加载器+脚本安装（高级用户）\n1. 从Release页面下载预编译的jar和脚本包zip\n2. 将jar文件放置在`config/mods`文件夹下，将脚本包解压到`config/scripts`文件夹（需自行创建）\n3. 启动服务器（首次启动会从网络下载依赖，耗时较长）\n4. 等待插件加载完成（脚本首次运行会进行编译，耗时较长，编译完成后会保存缓存）\n\n### 独立运行/脚本开发 \n请查阅[Wiki](https://github.com/way-zer/ScriptAgent4MindustryExt/wiki)\n\n## 版权说明\n- 加载器：免费使用，未经许可禁止转载和用作其他用途\n- 本仓库脚本：\n  - 默认允许私人修改并使用，但禁止修改原作者版权信息，公开使用需注明出处（fork或引用该仓库）\n  - mirai模块及依赖该模块的所有代码，遵循AGPLv3协议\n- 其他脚本：归脚本作者所有，作者可自行声明开源协议，不受加载器版权影响","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fway-zer%2Fscriptagent4mindustryext","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fway-zer%2Fscriptagent4mindustryext","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fway-zer%2Fscriptagent4mindustryext/lists"}