# TablePlays
**TablePlays** 是一个专为小型/私人服务器设计的插件，它赋予玩家玩不同桌面游戏的能力！
### 请注意，所有希望使用该插件的玩家**必须**安装资源包
## 功能
- 俄语翻译。
- 与 Minecraft 1.21 至 1.21.4 兼容（在 1.21、1.21.1 和 1.21.4 上已完全测试）。
- 易于使用的翻译系统，允许您将插件翻译成您的语言。
- 无需担心与原始资源包的兼容性即可更改资源包。
- 轻松创建任何自定义项目用于您的游戏 _(有点)_
- 支持服务器端保存，允许您创建**非常**大的捆绑包
## 项目 & 制作
TablePlays 允许您创建自定义项目，但也提供了一些默认的项目：
点击！
- **[纸牌](https://en.wikipedia.org/wiki/French-suited_playing_cards)**
3 种不同的纸牌，各有 36 张（排除 2-5）、[52](https://en.wikipedia.org/wiki/Standard_52-card_deck) 张和 54 张（+2 张小丑）
- **[骰子](https://en.wikipedia.org/wiki/Dice)**
最多可堆叠 4 个普通 D6。
-
- **[跳棋](https://en.wikipedia.org/wiki/Dominoes)**
- **[棋盘](https://en.wikipedia.org/wiki/Chessboard)**
- **[棋子](https://en.wikipedia.org/wiki/Chess_piece)**
- **[跳棋](https://en.wikipedia.org/wiki/Checkers)**
- **[筹码](https://en.wikipedia.org/wiki/Casino_chip)**
有 8 种筹码变化，所有筹码都可以还原为原始材料，默认制作方式如下：
要将筹码还原为材料，您需要在制作网格中放置它，它将立即分解。 您可以在下方看到所有 8 种变体：
所有筹码
- **筹码捆绑包**
筹码捆绑包允许您在一个项目中存储不同的筹码。
有 9 种筹码捆绑包变化，默认制作方式如下：
您可以将顶部的砾石替换为染料来制作具有不同纹理的捆绑包：
筹码捆绑包
## 使用方法
点击！
使用方法取决于具体的物品，但通常您可以期望以下操作：
1) 使用带有物品的主手点击方块（或棋盘）来放置它
2) 使用空手点击物品以拾取它
3) 要从捆绑包中获取物品，您应该将其带到主手中并点击空气或方块
4) 要将物品放回捆绑包中，您应该将捆绑包带到左手中并将物品带到主手中。
再说一遍，每个*物品都有一些特定的用法，所以我将在这里介绍一些例外情况：
1) 使用 Shift + 空击带有纸牌捆绑包的手将隐藏卡牌的值，从而允许玩家在不担心玩家作弊的情况下玩扑克等游戏。
2) 使用 Shift + 点击方块或筹码带有筹码的手，以在不旋转的情况下放置筹码。
3) 使用 Shift + 点击方块带有棋子或跳棋**左手**将放置它在地面上，否则它们只能放置在棋盘上。
4) 要拾取棋盘，您需要点击其碰撞盒子的底部，或者简单地点击底部。
5) 如果您按住 Shift 并点击它们，则可以翻转卡牌，或者按住 Shift 并放置以旋转它们。
6) 如果您按住 Shift，则可以放置捆绑包。
7) 如果您按住 Shift，则可以改变跳棋成为皇后。
## 安装 & 配置
点击！
客户端
1. 下载与您版本匹配的资源包。
对于 Minecraft 1.21–1.21.3，使用 1.21.1 包；对于更新的版本（例如 1.21.4），使用 1.21.4 包。
2. 将 ZIP 文件放在游戏的资源包文件夹中。
3. 在 Minecraft 设置中启用资源包。
**注意：** 所有希望拥有自定义视觉效果的玩家**必须**安装资源包。 或者，您可以直接从服务器提供资源包，以便玩家自动下载。
**服务器端**
1. 下载并安装插件，就像安装任何其他插件一样。
2. 如果需要，配置插件：
插件首次加载时，将创建一个名为 `TablePlays` 的文件夹，其中包含：
- **saved.yml** — 存储物品 NBT 之外的数据。 除非您知道自己在做什么，否则请避免编辑此文件。
- **config.yml** — 主配置文件，包含详细的注释。 主要字段包括：
- `lang` — 设置要使用的语言文件（默认为 `en`）。
- `items` — 除非您知道自己在做什么，否则不要触碰，否则可能会破坏所有内容。
- `allow_files` - 允许在服务器上保存数据，我推荐 `true`，但请注意，这个功能 **可能** 会在您拥有非常大的筹码捆绑包（96+ 个物品）时导致延迟。
- **en.yml** — 英语的默认翻译文件。 如有必要，修改或添加新的翻译。
**更改物品名称**
如果更改翻译文本，物品不会自动更新其名称。 要应用更改，请重启服务器或重新加载插件。 现有物品将保留其旧名称，而新生成的物品将使用更新的文本。
## 资源包鸣谢
- **fergust (Discord)** — 大部分纹理和模型。
- **m3vtg (Discord)** — 原始资源和数据包组装。
- **miniking1000 (我)** — 对插件进行的的技术更改，以及额外的纹理/模型更新。
## 许可
### 请在使用前阅读许可，我对插件的合法使用有一些最严格的条件，例如：
您的年龄的平方**必须**大于 0 年。
如果您只穿一只袜子，则不得使用该插件。
## 已知问题
- 与 [Dynamic lights 数据包](https://modrinth.com/datapack/dynamic-lights) 冲突
- 如果您安装了此数据包，则所有物品将不会移动到其位置，而会停留在您的头部，删除数据包以使插件正常工作。
