[未知之域]SlimeFun教程 - 联机教程

寂

本帖最后由 1582952890 于 2016-11-12 15:23 编辑

SlimeFun 插件教程

————来自小组未知之域

前言：

我在联机教程板块翻了一下，发现站内的两个SlimeFun教程基本上都在讲基础，而SlimeFun插件作为一个非常优秀的插件却没有详细一些的中文教程，于是很多腐竹望而却步，正好我所在的服务器需要用到这个插件，于是我准备去写一篇详细的教程讲述SlimeFun的各个方面，遂决定将其公开，方便更多腐竹及玩家。这篇教程现在正在处于编写期间（并未完成），本人会时不时的进行更新，教程内容并非全部依照SlimeFun官方的Wiki进行翻译，大部分内容是我根据我的体验总结出来的，如果有什么不对的地方，欢迎指出。
本教程基于SlimeFun 4.0.13 进行编写，也适合4.x.x的任意版本，
由于SlimeFun未提供语言文件，其物品封装在SlimefunItems类里面，还有一些菜单内容也封装在别的一些类里面，导致无法直接汉化。目前汉化版本已发布，地址：http://www.mcbbs.net/thread-634045-1-1.html
楼主最近在沉迷学习和备战中考，更新可能不是那么快，问问题的请认真阅读帖子后再来问，如果帖子中可以找到答案的问题我将会不再理会。
再次重申，请勿因为SlimeFun问题加我QQ。

插件的一些信息：

官网地址：https://dev.bukkit.org/bukkit-plugins/slimefun/
汉化版插件地址： http://www.mcbbs.net/thread-634045-1-1.html

SlimeFun插件简介：

来自于官网：

SlimeFun是一个Bukkit插件。它旨在基本上成为一个mod，使bukkit服务器也可以使用类似mod的插件。它提供了你可以想象的一切。从背包到喷气背包…
它还增加了一个API，允许你轻松安装/配置这个插件的附属插件。
你的服务器里，玩家是不是已经厌倦了玩生存？
然而你绝对会喜欢这个插件！通过添加400+多个新的物品，为你的服务器的生存提供了更多的乐趣。

个人意见：这个插件基本上相当于一个小型的工业，可以比较完美的解决1.9-1.10服务器原版趣味性不多的问题，里面的一些物品的合成方式耗资很大，解锁靠大量的经验，可以防止玩家过快致富导致对服务器的兴趣减少，电力系统也是个非常有趣的系统，玩家通过不同的方式发电，不同的方式用电，实现许多原版不能实现的东西，极大的增加了趣味性。

目录：

1. SlimeFun的安装与配置。
2. SlimeFun向导的使用。
3. SlimeFun全部物品的介绍。
4. SlimeFun电力讨论
 5. SlimeFun附属插件制作
 5. 腐竹需要注意的地方
6.常见问题及其解答

注意事项：

由于插件经过修改源码进行汉化，可能会导致一些原版插件中不存在的BUG（比如，万用工具无法充电（已经修复）），如果诸位腐竹或玩家发现，请及时告诉我，谢谢合作。
另外该插件可能有一些物品有潜在的危险性（比如爆炸镐，无视领地炸毁边缘），这些物品以及解决方案我将在下方提到，如果有其他的建议欢迎提出。
如果发现其他的一些BUG，比如@jiongjionger 在这里说的请与原作者进行反馈。

刷物品、刷金钱、卡掉玩家物品、崩服等BUG

另外：本教程与汉化版插件与jiongjionger的服务器没有任何关联
一些常见的问题和解答在这里，请不要再提问这里列举的常见问题的解答。

其他的一些事情

这个教程的所有图片都在腾讯云的对象储存下作为服务器，应该可以保证稳定。
请勿催更，我目前初三，如果没有特殊情况每周末都会更新一些，直到基本完成。
由于部分内容是我个人总结出来的，所以难免会有一些不对的地方，欢迎指出。
~~排版很渣请谅解，我发现我的那套排版不适合教程版（太啰嗦~~

来自群组: Unknown Domain

寂

本帖最后由 1582952890 于 2016-11-12 15:10 编辑

SlimeFun的安装与配置

1. 插件主体的下载与安装

1.1：服务端版本的确认：

SlimeFun 4.0.13 仅仅支持1.9.x-1.10.x的Bukkit及其衍生版本（Spigot PaperSpigot等），如果你的服务端版本是1.8.x，请去论坛自行搜索3.6.6版本，我曾经测试过可以使用。

1.2：插件的下载与初步安装：

请去这里（http://www.mcbbs.net/thread-634045-1-1.html），下载已经汉化完成的插件，然后放入服务端的/plugins，然后下载适合你服务端版本的CS-CoreLib插件（地址：https://dev.bukkit.org/bukkit-plugins/cs-corelib/），这个插件类似于一个数据库，是SlimeFun的前置插件（必须安装），放入服务端的/plugins，重启服务器，待你看到服务端加载完成后，出现这样或类似于这样的消息，那么恭喜你，加载成功

1.3：设置禁止自动跟新：

由于插件汉化的特殊性（直接修改Class文件），如果允许了SlimeFun插件自动跟新，会直接覆盖插件本体，导致汉化失效，故我们要阻止其自动跟新。
打开/plugins/slimefun/config.yml，找到如下选项：

options:

auto-update: false
复制代码
设置成false，（如上所示），然后打开plugins/CS-CoreLib/config.yml
options:

auto-update: false
复制代码

同样设置成false，即可彻底关闭更新。

我测试过，如果仅关闭SlimeFun的config中的自动更新，那么是照样自动更新的，故我们需要两个都设置下。

2.Config的配置：

文件位置：/plugins/slimefun/config.yml

3. Items.yml的配置：这个文件定义了物品的一些可选的选项。

由于插件的特殊性，一些物品可能会危害到服务器的安全或破坏服务器的平衡，这个配置文件内可以设置全局禁用一个物品。
全局禁用，顾名思义就是让玩家在任何世界都无法使用这个物品。
打开/plugins/Slimefun/Items.yml ，这里面包含了全部SlimeFun物品的一些必要配置信息，一般来说格式是这样的：

物品内部名称:
enabled: true
can-be-used-in-workbenches: false
required-permission: '

复制代码

enabled节点表示是否开启这个物品，即当值为false的时候这个物品将不能再被玩家使用，也不会出现在向导里面，更不会被合成。
can-be-used-in-workbenches节点表示这个物品是否允许当作原版物品在工作台中合成。比如钴锭，他的材质其实是对应着铁锭，如果开启这项，将会在普通工作台中可以用钴锭当铁锭合成铁镐。
required-permission节点表示了是否验证玩家含有这个权限，默认为空，即不验证权限，腐竹们可以根据服务器需要自行设定。

两个可选通用附加的节点：

提示：在封禁物品前，可以输入/sf give 物品内部名称来给予一下，看看是否是想要封禁的物品。

wiki:

复制代码

wiki节点定义了该物品的百科，表现在向导的合成方法界面的右上角，如图所示以压缩机为例

点击后会向你发送一个网址

按T打开对话框，点击那个网址即可访问。

部分物品自带官网的wiki，不过是英文的，对新手玩家来说没有什么帮助，服主可以根据自己服务器的需要改成其他的地址，比如自建论*坛为每个物品的使用方式发个帖，wiki里面写上相应帖子的地址，请注意带有

http://

复制代码

要不然可能会导致MC客户端无法解析，导致无法直接点击。未自带wiki节点的物品可以自行增加wiki节点，指向自己定义的地址。

youtube:

复制代码

youtube节点定义了这个物品的官方youtube视频教程，其位置也在右上角，与Wiki功能类似，发送给你网址让你可以打开。但是介于国内的”墙“的问题，可能部分人需要翻墙才能访问youtube，并且非常卡，所以建议有能力的腐竹自行录制视频放到优酷或bilibili或其他视频站上，然后修改这个值。

其他根据物品的不同可能还有一些特殊的节点，将会在后面提到。
4.whilelist.yml的配置

这个配置文件中详细定义了物品在每个世界是否开启，格式如下：

世界名称:
enabled-items:
物品内部名称1： true
物品内部名称2： true

复制代码

将物品内部名称的相应节点修改为false即可关闭物品在该世界使用，一般用于特殊世界，比如副本等，防止玩家带进去SlimeFun武器破坏平衡。

寂

本帖最后由 1582952890 于 2016-11-12 15:19 编辑

SlimeFun向导使用方式介绍

这部分内容可以在服务器群内留个链接，方便玩家查看。

由于其书本的界面并不十分的好，而且我运行一直莫名其妙报错。所以这一章将只讨论普通界面也就是箱子界面的向导书。

1. 向导书的获取：

输入/slimefun guide 即可获取一本向导书，不需要任何权限，如图所示。

由于向导书是通过判断lore的，所以可以将该向导书通过QuickShop Shopkeeper等商店插件进行出售，用BossShop之类的菜单出售也不是不可以，只是需要保证报酬的物品与插件生成的完全一致，所以一般情况下不建议这样做，其实可以直接报酬设置为指令，然后玩家花费XX的价格获取一本向导。

2. 向导书的使用

2.1 主菜单：

有了向导书，我们该如何使用呢？
手持向导书，右键，即可打开界面，如图所示，

经过我的验证，在1.9下副手并不支持打开向导书，所以应该放在主手打开。
物品分类栏代表着物品按照功能等分成的不同的类，原版默认共18个可见类，3个隐藏类，鼠标移动到相应的物品上即可查看名称，左键单击即可打开。三个隐藏类指的是只有到特殊的日子才会出现的特殊类，分别是圣诞节（12月25号）情人节（2月14号） mrCookieSlime的生日（10月26号）。判断方式是服务器的本地时间，也就说VPS或独立机的腐竹可以通过修改系统本地时间来体验这三个节日的特殊物品。
上一页和下一页，顾名思义，即为翻页，这主要是针对于其他附属插件的其他分类数量过多导致一页容不下，如果没有附属插件则不需要考虑这个。
最后四个分别是护身符II，能源和电力，GPS，货物管理，护身符II必须在解锁护身符I所有物品后自动解锁，能源和电力，GPS，货物管理必须在解锁了机器设备下的所有机器后自动解锁。
解锁的含义：玩家使用SlimeFun物品必须将指定物品解锁，玩家之间可以进行物品交易，也可以使用系统商店进行购买，但是必须解锁后才能发挥效果。如果一个物品的合成方式中含有SlimeFun的物品，玩家在获得这个物品时候不必解锁合成材料。以元素法杖-火为例，玩家通过交易等途径获得了元素法杖后，只需要解锁元素法杖-火物品而不需要解锁合成所需的熔岩晶体和元素法杖。

2.2 分类菜单：

所有的SlimeFun的物品及其合成方式均在其分类菜单中，如图所示，以”武器“为例，
我们会看到其都是屏障的图标，这样表示你还没有解锁这个技能，鼠标移动到该物品上，以”奶奶的手杖“为例，我们会看到这样的叙述：
注意看到最下方的“花费：1级经验” 就是这个物品的解锁费用了。

2.3: 合成方式：

解锁物品后，我们会看到，相应的物品的屏障的图标变成了其物品的材质，例如以”奶奶的手杖为例“
备注：一个系列的物品会在这个系列物品解锁的同时一起解锁，比如在解锁”奶奶的手杖“的同时爷爷的手杖也会自行解锁，其他的还类似于加强熔炉之类的，这些在下面会被列出。
单击对应的图标，我们会看到如下所示：
左上角的附魔书图标代表返回到上级菜单或主菜单。
第二列的第二行代表合成所需要的机器设备或合成方式。
中间的3*3代表合成的序列摆放，一些特殊的机器或合成方式的含义可能有所不同，这些将在下面列出。
倒数第二列的第二行是合成的最终物品展示。
倒数第一列的第一行表示这个物品的Wiki地址（如果有的话。关于Wiki更多的配置请向上翻）。

寂

本帖最后由 1582952890 于 2016-11-27 07:52 编辑

SlimeFun 机器及物品介绍：

1.基础机器部分：

本章只讨论基础机器分类里面的机器，电力机器在下一大章。SlimeFun插件包含了众多的机器，这些机器用来合成一些SlimeFun物品。基本的机器都在主菜单的基本机器的分类菜单里列出。（如图所示）。
每一个机器都需要一定的经验来解锁，如果你未解锁，就使用机器，是无法打开界面的。但是注意：加强工作台（第一个）是默认已经解锁的。
大多数机器的建造方法均为在空地上按照一定的形状摆放方块。点开以后可以看到相应的建造方法。但是一些是例外的，比如——高级熔炉。
以下是每个机器的摆放方法和使用方法。

未完待续

寂

SlimeFun电力讨论备注：暂时占楼以备后用，如果版主认为违反版规请删除楼层（雾

寂

SlimeFun附属插件制作暂时占楼以备后用，如果版主认为违反版规请删除楼层（雾

寂

本帖最后由 1582952890 于 2016-11-12 15:11 编辑

腐竹需要注意的地方

这里列举了SlimeFun的一些漏洞。请腐竹们悉知，认真阅读这里，以免因此对服务器造成不可挽回的损失。

危险物品：

翻译名称：爆炸镐

内部名称： EXPLOSIVE_PICKAXE

漏洞叙述：直接在挖掉方块后产生一个可以破坏周围方块的爆炸，可以炸毁领地边缘。

漏洞评级：高

解决方案：在Items.yml 中将EXPLOSIVE_PICKAXE节点下的enabled: false，或添加使用权限

翻译名称：地震镐

提供者：wei_shao

内部名称： SEISMIC_AXE

漏洞叙述：对范围内生物直接击退，可以改变Citizens插件所创建的NPC的位置。

漏洞评级：中

解决方案：在Items.yml 中将SEISMIC_AXE节点下的enabled: false，或添加使用权限

若发现其他的BUG物品或机器，请在下方回帖详细叙述触发过程，谢谢支持。