# FZ-sDataPack

A Minecraft Datapack

[![mc版本](https://img.shields.io/badge/Minecraft-1.17+-blue.svg)](https://minecraft.net/)
[![carpet版本](https://img.shields.io/badge/fabric_carpet-1.4.24+-blue.svg)](https://fabricmc.net/)

#### @Author: Harvey_Husky

#### This project is licensed under the terms of the GNU General Public License v3.0

#### Copyright (C) 2019-2021 Harvey_Husky

[B站链接](https://www.bilibili.com/read/cv4267319)

## 太长不看说明直接安装教程

- 前往 [发行页面](https://gitee.com/harvey-husky/FZ-sDatapack/releases) 下载此数据包
- 从zip文件中提取出几个`.sc`文件
- 将主体`zip`文件放入 `world/datapacks` 中（在客户端位于 `.minecraft/saves/<存档名>/datapacks`）
- 将提取出来的`.sc`文件放到 `world/scripts` 中（在客户端位于 `.minecraft/saves/<存档名>/scripts`）
- 在控制台输入`/reload`（客户端则是重新进入世界）

## 总览

![release版本](https://img.shields.io/badge/发行版-2.1.2-blue.svg)

![开发版本](https://img.shields.io/badge/开发中-2.1.3_pre1-blue.svg)

![设置界面](./图片示例：设置界面.png)

- 抬头并按一下 `Shift` 来打开设置界面

- 提供玩家挖掘、死亡、击杀、受伤、交易、钓鱼、滑翔和（破基岩）的数据榜单

- 提供扫地机

- 无需配置即可支持该铁头功破基岩榜 Mod：[FZ-BBL](https://gitee.com/harvey-husky/FZ-BBL/releases)

  - 破基岩榜的分数和订阅设置会在铁头功记分板的总分大于 0 时显示，以免未添加该 Mod 的服务器显示破基岩榜

  - [B站链接](https://www.bilibili.com/read/cv9178207)
  
- 记分板对照表：

  | Object Name | 内容 |
	| - | - |
	| activation | 活跃时间(h) |
  | damageTaken | 受伤害榜 |
  | deathCounter | 死亡榜 |
  | digCounter | 挖掘榜 |
  | fishingCounter | 钓鱼榜 |
  | killCounter | 击杀榜 |
  | tradingCounter | 交易榜 |
  | totalList | 总 量 |
  | bedrockBreaked | [铁头功破基岩](https://www.bilibili.com/video/BV1KJ411b73z) |
  | fz.aviate1m | 滑翔距离 |

- 提供一些[地毯脚本](#地毯脚本)（`.sc` 文件）：***请在升级数据包的同时替换这些工具！！！***

## 更新记录

更新记录可在[此处](./CHANGELOG.md)找到

## 使用

### 注意事项

- 需要 [Carpet](https://github.com/gnembon/fabric-carpet/releases) Mod **1.4.24** 及以上版本

- **版本的兼容性**
  - `v2.1.x` 支持 `Minecraft 1.17+`
  - `v2.0.x` 支持 `Minecraft 1.16.3-1.16.5`

### 安装

- 前往 [发行页面](https://gitee.com/harvey-husky/FZ-sDatapack/releases) 下载此数据包

>请下载以 `FZ'sDatapack` 开头的 `.zip` 文件

- **将其放入 `world/datapacks` 中（在客户端位于 `.minecraft/saves/<存档名>/datapacks`）**

- 载入数据包

  - 如果是单人存档，请保存并退出，再打开存档

  - 如果是服务器，可使用 `/reload` 指令或重启服务器以载入数据包

- 计分板的数据迁移

  - 请使用 [restore_scores.sc](#restore_scoressc) 地毯脚本

## 地毯脚本

- **以下脚本皆在数据包（`.zip` 文件）中，请将其（`.sc` 文件）提取，并将其放入 `world/scripts` （在客户端位于 `.minecraft/saves/<存档名>/scripts`） **  
- 可使用 `/reload` 指令或重启服务器以载入脚本（或使用 Carpet Mod 的指令 `/script load <脚本名>` 载入）

### `here.sc`

- `/here` 向所有人发送自己的位置和所在维度

  - 发送的消息使用 [VoxelMap](https://www.curseforge.com/minecraft/mc-mods/voxelmap) 可识别的数组格式
  - 安装 [VoxelMap](https://www.curseforge.com/minecraft/mc-mods/voxelmap/files) Mod 后，左键高亮该坐标，`Ctrl+左键` 新建坐标点

### `c.sc`

- `/c` 修改玩家模式为旁观模式

### `s.sc`

- `/s` 修改玩家模式为生存模式

### `tagplayer.sc`

- 这个工具可以防止将地毯 Mod 生成的假人计入记分板
- 可以通过自定义文件名来自定义游戏内命令
- 配置文件：
  - `allow_bot_tp`：用于控制是否允许传送假人
  - `allow_spawning_whitelist_players`：用于控制是否允许生成白名单内的玩家
- 使用方法：
  - 安装 [Carpet](https://github.com/gnembon/fabric-carpet/releases) Mod
  - 输入`/script load tagplayer`加载工具
  - 包含全部地毯假人自带的功能，如：
    - `/tagplayer use xxx once`让假人xxx按一次使用键
  - 包含新功能，如：
    - `/tagplayer check xxx`：检查玩家的状态
    - `/tagplayer checkall`：检查所有玩家的状态
    - `/tagplayer killall`：清除所有假人
  - 其他用法可以在游戏内输入 `/tagplayer` 查看

### `restore_scores.sc`

- 从数据包 `v1.4` 升级时也需要使用这个工具
- 这个工具可以从白名单读取玩家列表，逐一召唤假人，读取统计信息并赋值给记分板
  - 如未开启白名单，请把 `usercache.json` 复制一份改成 `whitelist.json` 再进行操作
- ***注意：原有的记分板会被删除***
- 使用方法：
  - 输入 `/script load restore_scores` 加载工具
  - 输入 `/restore_scores by_whitelist` 开始数据迁移
  - 输入 `/script unload restore_scores` 卸载工具
  - 记得用完就删掉它！