描述
此插件允许你创建特殊的物品,你可以将其给予服务器上的玩家。当玩家放置这些物品时,它们会变成预先创建好的结构。这些物品被称为“盒装结构”(Structures-in-a-Box),简称 SiB。
该插件使用 WorldEdit 将 MCEdit 原理图(schematics)粘贴到游戏中的机制。这意味着任何被复制并保存为原理图文件的内容,都可以用作结构。
例如,你可以给玩家一个箱子,放置后会变成一个小基地;以及另一个不同的箱子,放置后会变成一个小金库。
创建 SiB(管理员)
要创建新的 SiB,请遵循以下步骤:
- 建造结构。如果该结构有“入口”或正面,请确保它朝东。
- 使用 WorldEdit 选择结构(你可以为此目的使用
//wand)。确保不要选中结构下方的地面。
- 尽可能靠近你希望结构相对于已放置的 SiB 生成的位置。然后,输入
//copy 来创建剪贴板。此时,你通常应该面朝西方。
- 输入
//schematic save MCEdit <schematic id> 以保存原理图。
- 输入 /sib create <schematic id> 以创建 SiB 物品。
结构的前方必须朝东非常重要。这样,插件就能根据玩家放置 SiB 时的朝向正确自动旋转结构。
放置 SiB(玩家)
要生成 SiB,玩家只需放置 SiB 物品即可。如果没有空间容纳该结构,玩家将保留 SiB,且结构不会粘贴到游戏中。
套装(Kits)
SiB 物品可以添加到套装中。它们本质上是具有独特背景文本(lore)的箱子物品(默认为普通箱子)。任何支持指定物品背景文本的套装插件,都将随之支持 SiB。
保护
该插件支持 WorldGuard。结构(其任意角落)不能放置在玩家无法建造的区域内。此外,如果路径上有实心方块阻挡,结构永远不会被放置。
命令
- /structureinabox version - 获取插件版本
- /structureinabox create <schematic-id> - 为给定的原理图 ID 创建一个 SiB
- /structureinabox help - 显示如何使用该插件的说明(仅限管理员)
你可以使用 /sib 别名。
玩家还可以使用以下命令:
- /sibundo - 拾取你最后放置的一个 SiB 并收回物品,只要会话未过期
权限
- structureinabox.admin - 允许你使用盒装结构的管理员命令(默认:仅限管理员)。
- structureinabox.use - 允许你放置盒装结构物品(默认:所有人)。
- structureinabox.undo - 允许你撤销(拾取)最后一个 SiB(默认:所有人)。
配置
你可以在 config.yml 中更改以下设置:
- box-material - 用于 SiB 物品的材质(默认为 CHEST)。
- max-sib-size - SiB 的最大尺寸(默认为 10000)。
- display-name - SiB 物品的显示名称。
- lore-instruction - 作为背景文本添加到 SiB 物品的说明行。
- lore-identifier - 在 SiB 物品上使用的唯一背景文本标识符。
- free-space-check - 在放置结构前检查是否有空位(默认为 yes)。
- check-all-solid-blocks - 当 free-space-check 开启且此选项也开启时,检查所有实心方块。
- check-just-specific-blocks - 当 free-space-check 开启时,列出需要检查的方块。
- world-guard-check - 检查是否与 WorldGuard 区域冲突(默认为 yes)。
- permission-per-sib - 如果设置为 yes,放置 SiB 将需要权限 structureinabox.use_{sib-name}(默认为 no)。
- cooldown-time-ms - 玩家需要等待多少毫秒才能再次放置 SiB(默认 5000)。
- cleanup-interval-ticks - 会话清理时间任务的间隔(以刻为单位)(默认 300)。
- expired-session-time-ms - 会话 TTL(生存时间),单位为毫秒(默认 30000)。
致谢
本插件由 WonderlandGaming 团队设计并测试,专为 PvP 和追踪服务器使用。
Description
This plugin lets you create special items that you can give to the players on your server. When players place these items, they will turn into a structure created in advance. These items are called “Structures-in-a-Box” or just SiBs.
The plugin uses the WorldEdit mechanism of pasting MCEdit schematics into the game. This means that anything copied and saved as a schematic file, can be used as the structure.
For example, you can give the players a chest that turns into a small base when placed, and a different chest, which will turn into a small vault.
Creating SiBs (admins)
To create a new SiB, follow these steps:
- Build the structure. If that structure has an “entrance” or front, make sure it is facing east.
- Using WorldEdit, select the structure (you may use
//wand for that purpose). Make sure not to select the ground beneath the structure.
- Get as close as possible to the position where you want the structure to spawn in relation to the placed SiB. Then, type
//copy to create the clipboard. At this point, you should normally face to the west.
- Type
//schematic save MCEdit <schematic id> to save the schematics
- Type /sib create <schematic id> to create a SiB item.
It is important that the structure’s front will face the east. That way, the plugin will correctly auto-rotate the structure based on the direction the player is facing when placing the SiB.
Placing SiBs (players)
To spawn the SiB, the players only need to place the SiB item. If there is no space for the structure, they will keep the SiB and the structure will not be pasted into the game.
Kits
The SiB items can be added to kits. They are simply chest items (by default) with unique lore. Any kit plugin, which supports specifying lore on items, will consequently support SiBs.
Protection
The plugin supports WorldGuard. The structure (any corner of it) cannot be placed in regions where the player cannot build. In addition, the structure will never be placed if there is a solid block in the way.
Commands
- /structureinabox version - Get the plugin's version
- /structureinabox create <schematic-id> - Create a SiB for a given schematic id
- /structureinabox help - Display instructions on how to use the plugin (for admins)
You may use the /sib alias.
Players may also use the following command:
- /sibundo - Pick up the last SiB you placed and get the item back, as long as the session is not expired
Permissions
- structureinabox.admin - Allows you to use the Structure-in-a-Box admin command (default: admins only).
- structureinabox.use - Allows you to place Structure-in-a-Box items (by default everyone).
- structureinabox.undo - Allows you to undo (pick up) the last SiB (by default everyone).
Configuration
You may change the following settings in config.yml:
- box-material - The material used for the SiBs items (CHEST by default).
- max-sib-size - The maximum size of SiBs (10000 by default).
- display-name - The SiB item display name.
- lore-instruction - The instruction line added as lore to the SiB item.
- lore-identifier - The unique lore identifier used on the SiB item.
- free-space-check - Check for free space before placing down the structure (default is yes).
- check-all-solid-blocks - When free-space-check is on and so is this, check against all solid blocks.
- check-just-specific-blocks - When free-space-check is on, list the blocks to check against.
- world-guard-check - Check for collision with WorldGuard areas (default is yes).
- permission-per-sib - If this is set to yes, placing the SiB will require the permission structureinabox.use_{sib-name} (default is no).
- cooldown-time-ms - The number of milliseconds that need to pass before a player can place a SiB again (default 5000).
- cleanup-interval-ticks - Session cleanup time task interval in ticks (default 300).
- expired-session-time-ms - Session TTL in MS (default 30000).
Kudos
This plugin was designed and tested by the folks at WonderlandGaming for PvP and tracking servers.
评论 0
登录后参与评分
还没有评论,来抢沙发吧