fz-survival-datapack/README.md
延皓 f282dd764d
update README.md.
Signed-off-by: 延皓 <harvey_husky@foxmail.com>
2023-07-24 12:45:29 +00:00

147 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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://github.com/gnembon/fabric-carpet/releases)
#### @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)
## 说明太长不想看·直接安装教程
- 1.前往 [发行页面](https://gitee.com/harvey-husky/FZ-sDatapack/releases) 下载此数据包
- 2.从zip文件中挑选你需要的`.sc`文件
- 3.在`world`文件夹中创建`datapacks`和`scripts`两个文件夹
- 4.将主体`zip`文件放入 `world/datapacks` 中(在客户端位于 `.minecraft/saves/<存档名>/datapacks`
- 5.将挑选出来的`.sc`文件放到 `world/scripts` 中(在客户端位于 `.minecraft/saves/<存档名>/scripts`
- 6.在控制台输入`/reload`(客户端则是重新进入世界)
## 总览
[![release版本](https://img.shields.io/badge/发行版-2.1.2-blue.svg)](https://gitee.com/harvey-husky/FZ-sDatapack/releases/2.1)
![设置界面](./图片示例:设置界面.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` 文件):***请在升级数据包的同时替换这些工具!!!***
- 还有一个用于`census`脚本转移数据的python脚本`score_move`
## 更新记录
更新记录可在[此处](./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` 卸载工具
- 记得用完就删掉它!
### `Census.sc`
- `/census`
- 一个还在测试的脚本,可以输出挖掘榜