序
辅助生存建筑的一个插件,消耗物品栏内的物品快速建造,目前有复制粘贴和填充区域两个功能。
创意来源于Java版同名mod。(我脑海里设想的第一个插件也是同样功能来着)
因为在生存模式下,一些方块的物品状态是无法获取的,插件提供了修复办法,但并没有完全修复,请关注后续更新的“BuildingGadgets\data\block2Item.json"。
注意:目前插件还没经过多少测试,可能会存在一些bug,请仅在小部分可以信任的玩家间使用。
一、配置指南1. 解压文件;
2. 将“BuildingGadgets_x.x.x_Add-On.zip”移入"plugins/AddonsHelper/";
3. 将"BuildingGadgets.js"和"BuildingGadgets"文件夹移入"plugins/";
4. 配置config.json:
JSON:
{
"autoPermission": false, // 自动给予权限, 开启后玩家入服自动获得权限
"landPlugin": "iLand", // 领地插件,目前只支持iLand,若没有使用这个插件,则改成不是"iLand"的字符串即可
"dataPath": "plugins/BuildingGadgets/", // 数据文件的路径,包括玩家档案(Profile)、日志(logs)、数据(data)
"money": {
"type": "score", // 金钱种类,可为"score"或"LLMoney"
"name": "money" // 当金钱种类为"score"时,指定计分项的名称
},
"tool": {
"wand": "wheat:kami", // 选区工具,默认为附带行为包中的"御币"
"menu": "wheat:yinyang_orb" // 菜单工具,默认为附带行为包中的"阴阳玉"
},
"copy": {
"cost": 2, // 粘贴选区时,每成功放置一个方块消耗的金钱
"maxSize": 1024 // 复制选区时,长方体区域的最大大小
},
"fill": {
"cost": 1, // 填充选区时,每成功放置一个方块消耗的金钱
"maxSize": 1024 // 填充选区时,长方体区域的最大大小
}
}
5. (可选) “BuildingGadgets\data\backgroundBlocks.json":
这个文件定义了“背景方块”,这些方块在粘贴和填充时会被直接覆盖,默认有:空气、水、流动水。
每项有两个值,前一个是命名空间,后一个是特殊值,为-1时表示不需要考虑特殊值。
如:["minecraft:air", -1] 表示:任意特殊值的空气。
6. (可选) “BuildingGadgets\data\block2Item.json":
方块对应的物品。
有的方块对应的物品并不能在生存中获取(如上半砖),这个文件建立方块与物品的映射。
每项有两组值,前一组代表方块,后一组代表放置它需要消耗的物品。
如:[["minecraft:grass", -1], ["minecraft:dirt", -1]] 表示:要放置一个任意特殊值的草方块,则需要消耗一个任意特殊值的泥土。
二、维护指南1. 管理指令
这些指令仅能被管理员使用,均带有"/bgop"前缀,可以对离线玩家生效。
① bgop setbuilder [玩家名]
将一名玩家设为建筑者,只有建筑者能使用插件的功能。
② bgop removebuilder [玩家名]
取消一名玩家的建筑者身份。
③ bgop resetprofile [玩家名]
重置一名玩家的档案。
2. 对接领地
仅需要增加一个函数,输入一个区域的对角点和维度id,和玩家xuid,输出玩家没有权限放置方块的区域数组。
然后将这个函数加入Land.getNoPermissionAreas()即可。
三、使用指南(玩家)
插件提供了指令和工具两种操作方式,二者均可独立完成所有任务。
1. (可选)合成工具
选区工具:使用三根木棍和两张纸合成,长按方块选择点1,单击方块选择点2;
菜单工具:使用四个红石粉、四个下界石英和一个末影之眼合成,单击方块可打开菜单。
2. 选择区域
工具:手持选区工具,长按方块选择点1,单击方块选择点2;
指令:/bg pos1 选择点1,/bg pos2 选择点2。
3. 复制(copy)
工具:手持菜单工具单击方块,点击"copy",将会弹出确认信息,无误则再单击方块,点击"confirm",有误则点击“deny”;
指令:发送"/bg copy",将会弹出确认信息,无误则发送“/bg confirm”,有误则发送“/bg deny”。
注意,记住“确认”时站的位置,这将用于定位粘贴时建筑的位置。
4. 粘贴(paste)
工具:手持菜单工具单击方块,点击"paste",将会弹出确认信息,无误则再单击方块,点击"confirm",有误则点击“deny”;
指令:发送"/bg paste",将会弹出确认信息,无误则发送“/bg confirm”,有误则发送“/bg deny”。
粘贴后建筑与玩家的相对位置,和复制时原建筑与玩家的相对位置是相同的。
5. 填充(fill)
工具:手持菜单工具单击方块,点击"fill",将会弹出确认信息,无误,将用来填充的方块放在物品栏第一格,再用菜单工具单击方块,点击"confirm",有误则点击“deny”;
指令:发送"/bg fill",将会弹出确认信息,无误,将用来填充的方块放在物品栏第一格,发送“/bg confirm”,有误则发送“/bg deny”。