查看“服务器搭建2”的源代码

===服务器搭建（2）————ScriptAgent4MindustryExt插件的安装===

=依旧的B话=
虽然在看到这一篇时你的服务器大概率是已经架设完毕了，但是如此蹩脚的host、完全不存在的管理系统、游戏内换图都换不了<br>
不觉得，需要一种辅助插件来帮助你完成各种事情吗？<br>
而现在，推荐你这个大多数国内公共服务器都在用的插件————ScriptAgent4MindustryExt（由于其作者名为Wayzer，民间对这个插件的黑话就叫WZ插件，接下来图方便也会这么说）<br>
WZ插件具有目前完善的管理系统、投票系统、控制系统、辅助系统，甚至还有高度可拓展性，允许用户自行编写自己的脚本来使用<br>
接下来，本篇内容就是来教你如何安装WZ插件至你的服务器，令你服务器的可玩性再次提升。

=前期的准备=

==下载WZ插件==
WZ插件也是开源在github上的，所以先丢个传送门吧[https://github.com/way-zer/ScriptAgent4MindustryExt/releases <span>WZ插件下载</span>]<br>
依旧是点开Releases界面，找到最新版的WZ插件，然后你会发现下方有几个不同却类似的文件、一个jar文件可供下载：<br>
[[文件:服务器教程2-1.png]]<br>

下方的那个jar文件毋庸置疑就是<b>WZ插件的启动核心</b>，是一定要安装在服务器的mods文件夹中的（allInOne安装方式除外，allInOne已经集成了核心本身）<br>
上方几个看起来相同的文件是什么？<br>
<pre>
allInOne：捆绑了启动核心，只需单独把该文件丢入mods文件夹，在启动时会直接解压已经编译好的脚本。适合没有任何经验且不愿意推敲代码的小白用户
precompile.packed：需要在/configs文件夹中新建"scripts"空文件夹后再解压至里面，内置了已经编译好的脚本，省去了初次启动所花费的大量时间，与上方allInOne的区别就是可放入新文件二次编辑。适合省时间或者将来有编辑需求的普通用户
scripts：脚本的最原始未编译版本，也是需要在/configs文件夹中新建"scripts"空文件夹后再解压至里面，初次启动后需要花费大量时间编译，但是至此之后里面的脚本都可高度编辑。适合需要各种魔改或创造新家伙的极客用户
</pre>
尤其注意的是，WZ插件本质不是一个单纯的独立插件，而是有许多碎片化零散化的一个个脚本堆积起来的，每一个脚本都可以对应了一个功能，在服务器后台界面是可以选择单独开启关闭的。<b>这也是WZ插件的强大之处，方便管理也可自行拓展</b><br>
<br>
那现在，你选择完了属于自己的那份文件，该准备好安装插件了！<br>


=正式开搞=

==安装WZ插件的核心==
打开你的服务器文件夹，并进入<b>[服务器根目录]\config\mods</b>文件夹界面，并将首要的<b>ScriptAgent4MindustryExt-[版本号].jar</b>丢进去，如果你是allInOne的话，只需把<b> ScriptAgent4MindustryExt-[版本号]-allInOne.jar</b>单独放入即可<br>
[[文件:服务器教程2-2.png]]<br>

==安装WZ插件的脚本==
<b>如果你为AllInOne方式安装，可以直接跳过该章节</b><br>
同时，回到<b>/configs</b>文件夹，右键并新建一个名叫<b>scripts</b>的文件夹，新建完后再次点进该文件夹，把你的压缩包准备好，并解压在里头<br>
[[文件:服务器教程2-2.png]]<br>
不出意外的话，应该是这样<br>

==启动WZ插件==
回到服务器根目录，再次启动服务器。<br>
在首次启动的时候，WZ插件需要各类前置运行库以确保脚本的正常使用，不过有一说一，部分运行库似乎部署在了外网，可能也会出现无法下载而无法启动部分脚本的情况，最好开启魔法再进行下载<br>
在下载完运行库后，如果你是最返璞归真的scripts方式安装，估计还会再来一次三四分钟的编译脚本，效率取决于你的服务器cpu能力<br>
在完成了一切前置步骤后，如果你的后台日志长的类似这样，那么大概率是成功了。
<pre>
[02-01-2026 23:28:33] [I] ===========================
[02-01-2026 23:28:33] [I]      ScriptAgent 3.3.2
[02-01-2026 23:28:33] [I]            By WayZer
[02-01-2026 23:28:33] [I] 插件官网: https://git.io/SA4Mindustry
[02-01-2026 23:28:33] [I] QQ交流群: 1033116078
[02-01-2026 23:28:33] [I] 共找到95脚本,加载成功90,启用成功74,出错1
[02-01-2026 23:28:33] [I] ===========================
[2026-02-01 | 23:28:33 | 信息] [coreMindustry.console] Overwrite ServerControl.serverInput
[02-01-2026 23:28:33] [I] Server loaded. Type 'help' for help.
> [DefaultDispatcher-worker-1] INFO Exposed - Finish check upgrade for 1 tables, costs 9 ms
[2026-02-01 | 23:28:42 | 信息] [wayzer.maps] loadMap MapInfo(name='[#87ceebff]永冬[white]—[#bfbfbfff]航天基地[white]— 工业区', author='刻刻刻刻刻俄柏', mode=???mode.survival.name???, id=22856, provider=ResourceSite)
[02-01-2026 23:28:42] [I] Opened a server on port 11451.
</pre>
<br>
<h4>为什么下方还多了一条"未找到启动脚本(bootStrap/default),请下载安装脚本包,以发挥本插件功能"</h4>
未正确安装脚本包导致的问题，请自行查阅上方安装脚本的章节。如果你是AllInOne方式安装还能显示出该内容，请把mods文件夹中的原启动核心删除，这两者在一起启动的时候会优先加载原启动核心。<br>

<h4>怎么找到了一堆脚本后，加载成功了0个？</h4>
大概率是前面有运行库没成功下载，导致脚本无法正确编译，再想想办法下载吧。<br>

==大功告成！==
到了这步，你的WZ插件已经部署完毕了！<br>
如果你还想进一步完善服务器，最好先给你自己添加管理<br>
先在游戏里进入你自己的服务器，并在后台确认你自己的uuid，这就是你在mdt中唯一的身份证号，小心别泄露了！<br>
<pre>
[02-01-2026 23:39:44] [I] [游客]xem8k5殷紫恶魔 AU7 has connected. [???????AAAAA??????==]
</pre>
复制后面方框中的uuid内容，并在控制台中输入<b>admin add [你的uuid]</b>以添加自己为管理员<br>
现在是真的大功告成了！在游戏中输入<b>/help</b>，进行你的新探索吧！<br>
<br>
<b>以后更多的更好的控制服务器以及脚本的方法将会留到下一节讲解，敬请期待！</b>