查看“Lockette”的源代码

{{Bukkit Plugin Infobox
|插件名=Lockette
|版本=v1.8.21
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/lockette/
}}

== '''<big>Lockette</big>''' ==
 好吧，还是我，[http://mineplugin.org/%E7%94%A8%E6%88%B7:JACV JACV]为大家带来'''Lockette'''插件百科

 '''Lockette'''是众所周知的锁箱插件了。当然现在还有一款'''LWC'''也是非常优秀的锁箱插件。很多人会问，一款锁箱插件有什么好介绍的？别大意，了解自己服务器的每一款插件，才能真正做到'''遇事不慌、心定神闲'''的境界

 翻译自：https://bukkit.org/threads/sec-lockette-simple-chest-and-door-lock-no-databases-moved-to-bukkitdev.4336/ （没错其实根本不是百科）
----
=== '''<big>支持插件：</big>''' ===
*Permissions - 权限插件
*GroupManager - 权限插件
*PermissionsBukkit - 权限插件
*PermissionsEx - '''超级'''权限插件（广告：[[PEX|PermissionsEX]]）
*bPermissions- '''超级'''权限插件
*Towny - 城镇插件
*SimpleClans - 组插件
*mcMMO - 组插件（但是现在不支持了，具体去Bukkit看Lockette大辩论）
*Factions - 组插件
*LWC - 一款专注于'''抢生意'''的插件
*Register - 经济插件
----

=== '''<big>支持语言：</big>''' ===
*French by Misa
*German by Efstajas
*Polish by Kamild1996
*Dutch by Tofun
*Danish by Dumle29
*Slovenian by LiqouRiiCe
*Spanish by Agubelu
*Norwegian by Tio1999
*Swedish by TheMineKraftor
*Italian by Nikkolo_DTU
'''PS:上面就不翻译啦'''
----

=== '''<big>注意事项：</big>''' ===
 '''测试兼容的插件'''：[https://bukkit.org/threads/edit-colorsign-v1-2-568.6923/ ColorSign]、[https://bukkit.org/threads/mech-speedsign-v0-8-2-now-with-groups-1317.10418/ SpeedSign]
 '''不兼容插件'''：[https://bukkit.org/threads/econ-chestshop-3-7-18-iconomychestshop-chest-sign-shop-for-economy-plugins-1-8.4150/ ChestShop]、以及大多数的牌子编译插件！
----
=== '''<big>总览</big>''' ===
'''PS：以后再翻译，反正也不是很重要'''

The purpose of this plugin is to restrict access to the contents of chests, dispensers, furnaces, and doors without the use of a database to track containers.

To use, simply place a signpost on the floor directly beside a chest or other container to be locked. Enter [Private] as the first line. Your own name will automatically be entered on line 2 as the chest owner. Optionally type in the full names of two other users allowed to access the chest's inventory on lines 3 and 4.

When done correctly, the sign will automatically fix itself to the side the target chest, protecting it from unauthorized access! Only the chest's owner can then break the sign or chest. (Warning: Anyone with permission to use WorldEdit commands or similar can circumvent the protection by removing the sign.)

dditionally, you can enter [Everyone] on lines 3 or 4 instead of a user name to allow everyone access to the contents of a private container, or [Operators] to allow ops access. If a Permissions plugin is available, you can use groups like [Moderator] or [Admins] or others as defined in the Permissions settings files.

The owner of a container can add more users by placing additional signs beside the container with the heading [More Users], where lines 2-4 specify the names of the additional users. You can edit the users on previously placed signs by right clicking the sign, and using the command '/lockette <line number> <text>' to change it.

Working with Doors:

To protect a door, you can use the same method as protecting a container, the sign will attach to the door automatically. In addition, you can attach a [Private] wall sign to any side of the blocks just above or just below a door. For double doors only one side needs a sign. Door support is enabled by default in the config file.

Once a door is protected it will only open for someone listed as a user, and will not respond to redstone power or switches unless [Everyone] is listed as a user. Iron doors which usually won't open from clicking will work just as wooden doors. In addition, double doors will open together automatically!

You can also use [More Users] signs as with containers, with the caveat that the sign cannot be placed on the block above the door if the [Private] sign is not above the door as well! (This is done to prevent a security uncertainty issue.)

Protected doors will be closed automatically if a timer is set. A timer can be set globally with a configuration option, or individually for each door by using the tag [Timer: #] on line 3 or 4 of the [Private] sign, where # is the number of seconds that the door should remain open. If the timer is set to 0, this means the door will never automatically close. If no timer is specified, protected doors will use a global timer set in the configuration file. If the server is shut down cleanly any open doors will be closed, but in the event of a server crash while a door is open, it may remain so. Note that the initial state of a door is assumed to be closed.

Care must me taken to place protected doors on a stable block. Building a door on sand, gravel, leaves, TNT and et cetera are allowed by the plugin, but cannot be secured fully. :3 Additionally, it should be noted that most status messages still refer to locked blocks as containers, so for the purpose of simplicity, doors should be considered as a type of container.
----
=== '''<big>特色</big>''' ===
*完全不需要密码或者是数据库支持！
*不管放置了多少个Lockette箱子，权限的检查都会如期进行，绝不出错！
**单个箱子，一个所有者最多可以分享给另外11个人！（如果是大箱子则可以分享给另外17个人！）
**你可以将权限设置为[Everyone]，但是即便如此，别人也不能敲碎你的箱子！
**允许应用权限插件中的组权限，你可以为每一个组做特别定制！
*给予OP和管理员特别的权力！在config中可以自行调配
**如果哪个管理员想捣蛋，也会在后台通报哦~
*保护小箱子和大箱子，外加酿药台、火炉等等
**保护爆炸、破坏对箱子和木牌的伤害
***甚至可以设置让所有的箱子（不管有没上锁）都能免遭爆炸侵扰！
*对门也是绝对支持，木门、铁门都不在话下；
**如果你建立了双门，并且没有使用红石，Lockette会自动为其提供保护；
**你也可以取消自动保护，甚至设置在哪些时候进行保护！
**使用红石来入侵门的行为可以完全被阻止；
*防止超过2格的超级大箱子生成；
*当使用Lockette时，会提供善良亲切的提示
**当箱子被放下时，就会显示上锁的信息；
**可以在配置文件中设置各种各样的信息
**支持各种语言
----

=== '''<big>初始设置</big>''' ===
 目前，你只能设置Lockette中的其中一小部分功能，按照这个路径找到配置文件：<code>plugins → Lockette </code>，当你第一次加载Lockette之后，就能够在其中找到两个文件，分别是：
 <code>config.yml</code> 以及 <code>strings.yml</code>，第一个文件掌控着下列功能：

==== '''<big>Config</big>''' ====
*enable-permissions → 
 允许玩家使用命令语句。如果这个功能为false，你定义的组不受影响（组一定可以使用命令），但管理员将无法使用命令调查箱子。
 玩家默认是关闭命令使用的。（设置为true普通玩家需要在权限插件中进行配置方可使用）
*enable-messages-*  →
 开启/关闭<code>strings.yml</code>文件中的消息提示。不包括特别消息
*broadcast-*-target →
 这个是专门用来设置对普通玩家/定制组发送特别消息的。当然，你也可以设置为<nowiki>""</nowiki>来表示不发送特别消息
*explosion-protection-all →
 开启/关闭全服箱子防爆炸机制，开启之后，即使不是[private]的箱子也会防爆。该功能默认关闭。
*allow-admin-bypass →
 允许/不允许管理穿过保护的门。默认是允许的（true）
*allow-admin-snoop →
 允许/不允许管理打开受保护的箱子。虽然这个功能默认是关闭的。但强烈推荐你打开！当管理打开他人箱子时，Lockette就会向所有者发送一条特别信息（这设置很智障==）
 但是，这条特别信息可以在其他地方的设置中自定义。如果这个功能关闭，管理仍然可以敲碎保护牌。
*enable-protection-doors →
 开启/关闭保护门的功能，默认开启
*default-door-timer →
 设置保护门的特定关闭时长。这是针对服务器所有的保护门设定的。只有设置了特别权限的木牌，才能让门在特定时长内不关闭。默认为0，表示不设置关闭时长。

----
==== '''<big>String</big>''' ====

<pre style="white-space: pre-wrap; 
white-space: -moz-pre-wrap; 
white-space: -pre-wrap; 
white-space: -o-pre-wrap; 
word-wrap: break-word;"> 
 在string.yml文件内，你可以自定义提示信息，甚至用你本国的语言！注意，如果你编译的是标签（例如[private]这种），编码必须使用ANSI；当然如果你的语言不属于ANSI，
 
 你也可以选择UTF-8，但那可能会导致一些奇怪的现象…默认的标签语言为法语，但是当然，你完全可以在后台自定义<code>string.yml</code>文件，
 
 如果你真的这么做了，欢迎你把翻译文本反馈给我~:3 （不是JACV==理论上是这货 https://bukkit.org/members/acru.12037/ 如果你想关闭特别信息提示，只需要设置为<nowiki>""</nowiki>
 
 然后，重新读取配置
</pre>

----
==== '''<big>Attention</big>''' ====
<pre style="white-space: pre-wrap; 
white-space: -moz-pre-wrap; 
white-space: -pre-wrap; 
white-space: -o-pre-wrap; 
word-wrap: break-word;"> 
 如果你并没有激活权限插件，或者你将enable-permissions设置为false。那么，Lockette就会根据ops.yml文件判断谁是管理。

 管理可以敲碎保护木牌，或者查看箱子内容（如果你打开了allow-admin-snoop这个功能），当然也可以使用reload命令让Lockette应用最新配置；所有的玩家都可以创建保护箱子。
</pre>

<pre style="white-space: pre-wrap; 
white-space: -moz-pre-wrap; 
white-space: -pre-wrap; 
white-space: -o-pre-wrap; 
word-wrap: break-word;"> 
 但如果你激活了权限插件，并且将enable-permissions设置为true，Lockette将会把下列Node应用于OP玩家以及拥有“*”权限的普通玩家身上。
</pre>
*lockette.user.create.* →
 允许创造保护箱子、门等
 其中，*可以被chest（箱子）、dispenser（酿药台）、 furnace（火炉）、door（门）取代。
 (当然你设置为lockette.user.create.all也行，但它几乎已经被淘汰了；用lockette.user.create.*不是更加方便吗？
*lockette.admin.create.*  →
 允许管理为其他人创造保护箱、门
 其中，*可以被chest、dispenser、furnace、door取代
 使用时，你可以将第二行设置为空，或者写下你想提供给的玩家名称。注意大小写！
*lockette.admin.break →
 允许管理破坏保护牌（破锁）
*lockette.admin.bypass →
 允许管理通过保护门
*lockette.admin.snoop  →
 允许管理打开上锁的箱子（解锁）（但是，只有在allow-admin-snoop这个功能设置为true才有效）
*lockette.admin.reload  →
 允许管理重置插件
----

=== '''<big>技术支持：</big>'''===
 '''不得不承认，这个插件历时已久，经过无数次测试和接坑……（CraftBucket对这个插件的贡献最大），由于现在Lockette的很多版本都面临着各种各样的问题，
 '''我（不是JACV）也参与到了编号561的代码构造工作之中。所以如果你们使用的是老版本的Lockette插件并遇到了问题，这很可能不是我的锅。但如果你们谁将问题寄送给我，'''
 '''我也一定会尝试去修复。我一直都接近全力地保持Lockette处于最新版本的状态，但是，我也是普通人嘛，生活中难免会有事情搁置（丫的我翻译这些干嘛==）。'''
 '''你们提出了问题之后可能真的需要等上一段时间了。不管怎样，Lockette已经趋向成熟。'''

 If there are multiple containers by the placed sign, the plugin will use the NESW rule to choose the first container that is not yet private. 
 To elaborate, the plugin will check to the north of the sign first, and if no container or door is available to the north, 
 it will continue checking clockwise around the sign

 Due to the current implementation of the explosion event, this plugin will cancel all explosions that would damage the container or sign, 
 rather than just remove the container and sign from the blocks to be damaged. Canceled explosions still knock signs off the walls. 
 Canceled explosions leave signs looking blank, but this is just a graphic glitch, reconnect to fix.

 Bonus: This plugin will prevent chests bigger than 2 blocks from being created via glitches. 
 (Again, this could be circumvented using WorldEdit commands, so take care who has access to such a plugin.)

 This plugin was inspired by the old hmod plugins Lock by Roman "kingseta" Pramberger and ChestCapsule by Fernando "Fergo".