查看“PlotSquared”的源代码

[[Category:安全]]
[[Category:传送]]
[[Category:管理]]
[[Category:创世]]
{{待翻译}}
{{待完善}}
你不能在没有一个合适的地皮插件的情况下使你的服务器上线。PlotSquared 快速，高效，有很高的扩展性。

它有一个世界生成器和一个完整的地皮管理系统。

有许多酷炫的特性，完整的控制和配置，和一个[[https://github.com/IntellectualSites/PlotSquared/wiki/Developer-documentation-(WIP) 为其他插件准备的API]]。

为什么不尝试下呢？

如果你现在正在使用PlotMe，地皮的转换系统十分的快速且简单，它在下方介绍了。

==特性==
*快速高效
*支持多世界
*支持 PlotMe 的转化
*MySQL 和 SQLite 的整合
*地皮合并
*地皮瞬间清空
*怪物保护
*地皮大量的标志系统
*四种地皮权限 (主人 援建者 信任者 黑名单)
*可以从网页上上传/下载地皮模型
*可配置的语言文件
*可配置的地皮生成
*地皮名字
*具有API
*WE在地皮中有限制
下面的需要对应扩展支持
*VoxelSniper 在地皮中有限制
*支持WG的标志
*支持不是方形的地皮
*支持动态地图
*支持统计
*PlotMe 可以转换

==安装==
下载文件[在文件页面]

如果你下载下来的是zip文件的话，解压

把"PlotSquared.jar"放到你的plugins目录里

开启服务器以生成必要的文件

===数据库设置===
Database: SQLite

如果你没有 MySQL 数据库的话，数据库的值会自动设置为SQLite，然后你可以跳过这一步了。

Database: MySQL

请注意你既可以使用 MySQL 也可以使用 SQLite ，但两者不能同时使用。

请注意你可以使用 /plot database 命令来转换到MySql

前往"storage.yml",来配置你的 MySQL 数据库。

===与Plotme的转换===

请确保你完成了上面的步骤。

如果所有事情都是对的，就会开始转换地皮，覆盖配置，然后覆盖你的多世界设置[平均10W地皮/分钟]

第一步：安装 PlotSquared  删除 PlotMe.jar

删除 PlotMe.jar 这样的原因是如果你的Plotme版本在 0.15 及以上的话，插件会防止你覆盖。当你装载两个插件开启服务器，Plotme会自动替换掉本插件。

如果你有问题的话，请联系我们。 

第二步：选择地形创建器

有时 PlotSquared 不能为你的地皮选择合适的地形创建器。如果你遇到了这种情况，你需要在服务器关闭时手动选择地形创建器。

如果你有多世界插件的话，你可以在配置中改变地形创建器。其他你也可以在"Bukkit.yml"中把地形创建器改为"PlotSquared"。

如果你没有选择地形创建器就开启服务器，你会看到一条消息刷出： Plot 'X;Z' in DB for world 'plotworld' does not exist!

请创建这个世界，或移除DB的地皮！这就是一个提醒，你需要切换世界的地形生成器。 

第三步：权限

另一件事是配置权限。如果你是一个典型的创造服务器的话，你需要这些权限。

plots.permpack.basic

plots.plot.#

把#替换成你想要玩家拥有几块地皮。

====第四步：配置你的世界====
减少你的地皮世界的大小



==使用==
===自定义===
====翻译====
=====主要的语句=====
翻译在这个位置: plugins\PlotSquared\translations\PlotSquared.use_THIS.yml

你可以在这个文件中为每个消息改变文本。(后台指令也能配置)
=====颜色代码=====
要想改变颜色代码[默认是$]，在这里配置: plugins\PlotSquared\translations\style.yml
====命令别称====
开启地皮别称

如果你想要像 /plotme 的指令工作，请在 settings.yml 中开启 plotme-alias 。这不会模仿PLOTME的子指令。

在这个文件 commands.yml 里你可以改变子命令的别称。

commands.yml 可以在这里 plugins/PlotSquared/config/commands.yml 找到，并且允许你改变命令的别称。
====网页接口====
=====安装=====
默认 PlotSquared 的接口是我们的域名。下载是匿名的，并且你不需要在你的终端上设置什么。

免责声明:

Metrics 必须启用。所有你上传到公共网页接口上的东西都会变成公共的，如果你觉得这有问题的话你可以把公共接口设为你自己的主机。

设置你自己的端口:

[[https://github.com/boy0001/plotupload 资源]]
[[https://github.com/boy0001/plotupload/archive/master.zip 下载]]

配置的位置: config/settings.yml
<pre>
web:
  url: http://empcraft.com/plots/
  server-ip: your.ip.here
</pre>
=====下载=====

/plot download

这会从你设置的端口处下载文件，会生成一个随机秘钥。

恢复下载

/plot schematic paste url:秘钥

秘钥是你在下载时生成的随机秘钥。

保存

/plot save

读取

/plot load

[[https://youtu.be/w-0VushTSz4  视频教程]]
===世界设置===
====世界边界====

为了防止跑图，世界边界可以在每个地皮世界启用。选项可以在 worlds.yml 中的 worlds.<world>.world.border

地皮边界会处在里中心地皮 (0,0) 最远的地皮上，而且会防止区域外的区块读取。

如果你在边界之外已经有了地皮，世界边界不会很有效。你可以使用地皮的过时系统： 

在settings.yml中寻找以下节
<pre>
enabled-components:
  plot-expiry: false
</pre>
<pre>
#这是一个实例
auto-clear:
  task1:
    threshold: 1
    required-plots: -1
    confirmation: true
    days: 7
    worlds: 
    - "*"
    # See: https://github.com/IntellectualSites/PlotSquared/wiki/Plot-analysis
    calibration:
      variety: 0
      variety-sd: 0
      changes: 0
      changes-sd: 1
      faces: 0
      faces-sd: 0
      data-sd: 0
      air: 0
      air-sd: 0
      data: 0
</pre>
要启用地皮过时管理，把 'enabled' 改为true，然后设置过时的天数。如果玩家超过这个天数没有上线，地皮会被清除。

要想知道更高级的知识，请去:[[#地皮分析]]

====地皮冷却 (2.7.5加入) (加强版)====

这项工程与世界相关。这会把地皮移动到在中心附近的半径中。要想知道有多少地皮再边界外，请使用

/plot condense <world> info <radius>

它还将显示您可以指定的最小半径。

如果你在边界外有数以千计的地皮的话，就会用很长一段时间。

然后可以使用

/plot condense <world> start <radius>

来使用更改

====世界修剪====

这个世界修剪器会尝试删除一些没有地皮的区块，同时也会缩减硬盘中世界的大小。

这是一个加强版指令，所以推荐你一周用一次。

你可以使用这个指令来修剪

 /plot trim <world>

====区块处理====
 
=====免责声明=====

这是一个新的特性，不是一个能解决你所有问题的魔法解决方案。区块处理器不完美，并且如果它不能预防卡顿的话也是你的锅[即使你可以反馈给我]

这并不是很奏效，因为当没有区块处理时，不会留下足迹。

=====例子=====
<pre>
chunk-processor:
// If the processor is enabled
  enabled: true
// The maximum number of blockstates allowed per chunk
  max-blockstates: 4096
/// The maximum number of entities required in a chunk before it is deemed a source of lag
  max-entities: 512
// If you also want to disable all physics
// (formerly there was a physics limiter, however that lead to confusion when important things like redstone were limited, so now it is just a blanket disable option)
  disable-physics: false
// Auto trim will not save chunks on unload if they do not belong to a claimed plot
// As chunks may save without unloading, it is recommended to disable world autosaving, or enable auto-unload
  auto-trim: true
// This will replace chunk unloading with something a bit more aggressive.
  auto-unload: true
// See here: https://github.com/IntellectualSites/PlotSquared/wiki/WorldEdit-processing
  experimental-fast-async-worldedit: true
更多来这儿: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/package-tree.html (or do a google search)
</pre>

====WE处理====
=====总览=====
PlotSquared 提供了一些关于WE的选项，如果你没有额外权限的话，默认会：

在地皮中限制WE的运行

禁止使用潜在危险的指令

限制一些笔刷的功能以防止使服务器崩溃

限制一次最大执行的方块数为5千万

额外的权限是 plots.worldedit.bypass 如果你有权限的话，使用 /plot toggle worldedit 或 /plot wea

进一步扩展， PlotSquared 有一个你可以启用的 WE 处理器。

在编辑时限制最大的方块数和实体数(启用 chunk-processor)

WE 的快速和异步处理 (启用 experimental-fast-async-worldedit) (通过 /plot wea 来跳过)
====地皮分析====
这项功能正在发展中： 如果你遇到问题的话欢迎发张[[https://github.com/IntellectualSites/PlotSquared/issues TICKET]]

这也是新功能，它可能不会被优化的特别好。但如果你有问题的话请发TICKET让我们知道。

地皮分析是啥？

地皮分析是为了更好的决定地皮的清除。它可以被手动配置，或根据地皮的评分来作为校准的基础。

它是地皮过期系统的一种，并且你可选择检查上面的地皮清除中大于设置天数的地皮。

为什么这比之前的方块修改更好？

改变的方块数目不是一个衡量地皮品质的精确方式。玩家可以无脑的刷方块数量，或者使用WE把地皮全部设置为石头。

地皮分析有10个不同的度量方法来手动检测清除的地皮。

我怎么手动校准地皮分析？

请注意下面也有一个自动校准的方式：

在 settings.yml 中有一节是专门为了自动清除而设立的：

<pre>

clear:
  auto:
    # If auto clearing is enabled
    enabled: true

    # If the threshold is set to -1, all plots will be cleared
    # Otherwise, any expired plot less than this threshold will be cleared
    threshold: -1

    # This section can be auto calibrated, or done yourself
    calibration:
      changes_sd: 64
      variety_sd: 1
      faces_sd: 32
      air: 0
      faces: 2
      changes: 1
      data_sd: 1
      variety: 1
      air_sd: 0
      data: 32

    # The interval at which plots are cleared (lower is faster)
    clear-interval-seconds: 10

    # Any plot older than this will be checked and possibly cleared
    days: 7

</pre>
如果你想要改变地皮的话，把除了 changes 以外的所有方式都设置为 0 。

然后各自设置，改变的方式是每个 column * 100 的平均值。 

Column 是什么？ Column是一个方块垂直的位置，如，你站在一个方块上，Column就是直接在这个方块上下的所有东西。每个Column可以有256个方块[因为世界的最大高度是256格]。 

如果你想要清除每个Column的值小于7的地皮的话。你可以这样设置 [注意 7 写为 700]
<pre>
clear:
  auto:
    # Please note how the threshold is set to 100 * 7 or 700
    threshold: 700

    # This section has be calibrated to only care about blocks changed
    calibration:
      changes_sd: 0
      variety_sd: 0
      faces_sd: 0
      air: 0
      faces: 0
      changes: 1
      data_sd: 0
      variety: 0
      air_sd: 0
      data: 0

    # Set these to whatever you want
    enabled: true
    clear-interval-seconds: 10
    days: 7
</pre>
如何自动校准地皮分析？

地皮分析也可以通过地皮所得票数来校准。地皮的票越多，校准系统就会越精准。

<pre>
投票:
/plot rate next - 前往下一个地皮
/plot rate <票值> - 为地皮投票

要想获得好的数据，最好的办法就是鼓励玩家在服务器中投票，这样你的校准器会越来越精准。

要想校准使用:
/plot debugexec calibrate-analysis <percentage>
Percentage 请替换为你想校准的百分比，即你想清除多少地皮。如果你只想清除一些低品质的地皮的话，使用较小的百分比。如 清除 7%：
/plot debugexec calibrate-analysis 7

要想查看当前地皮的复杂性请使用 /plot debugexec analyze - 同时也是查看分析的同样的命令。

要想去除分析：
你可以去除当前地皮的分析：
(可选) /plot debugexec remove-flag analysis
(必需) /plot debugexec calibrate-analysis <percentage>
</pre>
===世界类型[发展中]===
====加强版地皮世界====
使用 /plot area 命令
<pre>
/plot area create ＜world＞:＜area name＞ type=2 terrain=? ＜modifiers＞
/plot area create pos1
/plot area create pos2
/plot confirm
</pre>
更改[可选项]:

* size
* gap
* terrain (0 = flat, 1=flat + ores, 2=roads, 3=no change)
* type (0 = standard, 1 = augmented full, 2 = augmented partial)
* main
* floor
* wall
* border
你也可以这样来重新生成地皮  /plot area regen (如果你想改变设置的话)

一张图片

[[文件: PS.1.png]]
===模型===
====认领模型====
认领时的模型看起来很奇怪，并且难于理解。

很久以前我决定创建这个简单的向导来教你如何使用这个好用的特性。

A.确保你拥有你整个地皮的模型 [例如你的地皮是32 * 32的，你的模型也必须是32 * 32大小]。我推荐你使用WE来储存这个模型。

B.选择地皮区域【从最低到最上面】 然后使用 //copy 指令当你选好地方之后，你可以使用 //schematic save mce {schematic_name} 指令来存储。

C.当你拥有 .schematic 文件的时候，把它放到 /plugins/PlotSquared/schematics ，如果这个目录没有创建的话你需要手动创建它。

D.要使这个地皮类型合法 /plot schematic test {schematic_name}。你现在可以使用 /plot schematic paste {schematic_name} 来测试它了。

E.现在你就有一个可以工作的模型文件了。若要把它变为认领模型你需要配置你的 worlds.yml ，这儿是一个简单的说明。

<pre>
# The following is a slice from the plotworld settings, change this for each plotworld
schematic:
    # File name (没有 .schematic)
    file: '{schematic_name}' 
    # If you want it on claim
    on_claim: true`
</pre>
你可以用这个模型在多于一个世界工作。
====模型输出====
第一步： 选择路径‘

下面的一行是你输出模型时的路径，这个路径可以为 C:/xampp/htdocs/schematics/ 或 C:/wamp/www/schematics 或 C:/minecraft/plugins/PlotSquared/schematics
<pre>
schematics:
  save_path: /var/www/schematics
</pre>
第二步： 输出模型

使用指令 /plot schematic save 输出当前你在的地皮为模型。要想输出所有的地皮使用 /plot schematic exportall [仅可从控制台使用]

===地皮部分===

==命令和权限==

==扩展插件==
*[[http://empcraft.com/plotsquared/plotwebphp.zip PlotWebPHP]] (PlotSquared 网页界面)

*[[https://www.spigotmc.org/resources/plot2dynmap.1292/ Plot2Dynmap]] (需要dynmap 集成)

*[[https://www.spigotmc.org/resources/advplots-%CE%B2.1500/ AdvPlots (关于世界基础生成的模型)]]

*[[https://www.spigotmc.org/resources/basicplots.6901/ BasicPlots]] (每个区块一个地皮)

*[[https://www.spigotmc.org/resources/biomegenerator.1663/ BiomeGenerator]] (在你的地皮中生成自然生物群系)

*[[https://www.spigotmc.org/resources/plotrankup.1571/ PlotRankup]] (地皮升级系统)

*[[https://dev.bukkit.org/bukkit-plugins/vsr/ VoxelSniperRegions]] (支持在地皮中限制 VoxelSniper)

*[[https://www.spigotmc.org/resources/holoplots.4880/ HoloPlots]] (全息显示地皮信息)

*[[https://www.spigotmc.org/resources/redstone-clock-preventer-2.6678/ RedstoneClockPreventer2]] (预防高频红石)

*[[https://dev.bukkit.org/bukkit-plugins/worldedit/ WorldEdit]] (在地皮中受限)

*[[https://dev.bukkit.org/bukkit-plugins/plotme/ PlotMe]] (简单的转换)