BetterChunkUnload/README.md

# BetterChunkUnload

## 自定义区块卸载规则

## 说明

在 Minecraft 单机版中，一个实体进入地狱门后会使得另一侧的区块加载300游戏刻（15秒） ，利用此机制可以实现一些双维度刷怪塔（如凋零农场）。
但是在 Paper 系的服务端中，实体在通过地狱门后并不会触发另一测的区块加载。因此导致了一些双维度刷怪塔无法正常工作，因此诞生了区块加载器。
但是在一些更特殊的环境下即便使用了区块加载器加载了区块，也无法实现双维度刷怪塔的效果。
因为在某些服务端中使用区块加载器无法使区块加载等级达到“实体计算”的等级，此情况下的实体在通过门后会被立刻删除。
本插件通过设置区块强制加载标签，保证区块的加载等级达到实体计算等级，以此来还原在服务端的原版双纬度刷怪塔特性。

## 实现逻辑

1. 插件会记录玩家经过的每一个区块，并为这些区块添加“强制加载”标签；
2. 被添加了强制加载标签的区块会保持高等级的常加载，此加载等级与玩家在区块中的实体计算等级相同；
3. 当一个玩家拥有的强制加载区块数量超过了配置文件中的最大值时，会将最早的区块取消强制加载标签；
4. 被取消标签的区块会按照服务端常规的区块卸载规则进行卸载；
5. 玩家退出游戏后会自动为其取消所有区块的强制加载标签，避免过多的区块被强制加载；

## 支持版本

- Folia 1.20.1+

## 安装方法

1. 将插件放入服务器的 `plugins` 目录下
2. 重启服务器
3. 在 `plugins/BetterChunkUnload/config.yml` 中配置
4. 重启服务器

## 使用方法

无

## 管理员指南

提示：请合理设置每个玩家能拥有的的最多强加载区块数量，避免因为过多的强加载区块导致服务器内存占用过高。

## 指令

### 玩家指令

无

### 管理员指令

无

## 配置文件参考

```yaml
# 启动时清除已有的强加载区块延迟 秒
# 建议设置为10秒 太低可能在世界加载完成前触发操作引起报错
# -1 为不清除 如果你的服务器有其他插件会在启动时加载区块建议设置为-1
ClearLoadedChunksOnStartupDelay: 10

# 每个玩家拥有的最多强加载区块数
MaxDelayChunkPerPlayer: 10

# tps最低阈值 低于此值将会开始自动取消强加载区块
MinimumTpsThreshold: 15.0

# 每次检查tps的间隔 单位为tick 20tick=1s
TpsCheckIntervalTicks: 600

Debug: false
```

## TODO