Описание
### **Still troubled by the hidden trades of scamming villagers?**
Want to preview what treasures villagers will offer in the future before leveling them up? **Villager Trade Preview** is the solution for you! Now available in both a **Data Pack Version** and a **Fabric Version**, so you can choose freely based on your server or singleplayer environment.
## 📖 Overview
This project is inspired by the well-known mod [Visible Traders](https://modrinth.com/mod/visible-traders), but has been redesigned for different environments. It allows all players, when viewing a **level 1 villager**, to directly preview all the trades that villager will unlock at all subsequent levels (levels 2–5).
Two versions are now available:
- **Data Pack Version**: For vanilla-only environments, such as Vanilla, Paper, Spigot servers, and singleplayer saves.
- **Fabric Version**: For Fabric servers and Fabric singleplayer, requiring Fabric Loader.
## ✨ Main Features
- **🔮 Trade Preview**: When interacting with a level 1 villager, their trade interface directly displays the trade options they would only unlock after future level-ups (shown as locked).
- **🧩 Two Versions Available**: The Data Pack Version is suitable for vanilla / Paper / Spigot; the Fabric Version is suitable for Fabric servers or Fabric singleplayer.
- **⚙️ Server-side Friendly**:
- Data Pack Version: Players do not need to install any mods or resource packs.
- Fabric Version: When installed on a Fabric server, vanilla client players do not need to install anything extra; for singleplayer, it must be installed on the Fabric client.
- **🌿 Fully Compatible**: Works with all vanilla villager professions and biome variants.
- **🔄 Works Out of the Box**: After installation, both existing villagers and newly generated villagers on the server automatically gain the trade preview feature.
## 🎯 Supported Versions
- **Minecraft Java Edition: 26.1+**
- **Data Pack Version**: Suitable for Vanilla, Paper, Spigot, and other mainstream servers and singleplayer saves.
- **Fabric Version**: Requires the corresponding version of Fabric Loader; if the mod depends on Fabric API, please install it as well.
## 💡 Differences from the Visible Traders Mod
Unlike the `Visible Traders` mod, which requires installation on both client and server, this project offers more flexible choices:
- **Data Pack Version**: Built specifically for vanilla-only servers or singleplayer games where mods cannot be installed, implementing the core functionality through the data pack system.
- **Fabric Version**: Suitable for servers or singleplayer players already using Fabric; when used as a server-side mod, vanilla client players do not need to install anything extra.
Both the Data Pack Version and the Fabric Version are independent projects inspired by `Visible Traders` and developed for different environments. They are **not directly affiliated with** the `Visible Traders` mod.
## 📥 Installation
### Data Pack Version
1. Download the data pack file (`.zip`).
2. Place the file into the `world/datapacks` folder of your server or singleplayer save.
3. Restart the server or run `/reload`.
4. All done! Now your villager trades are more transparent and interesting!
### Fabric Version
1. Install Fabric Loader for the corresponding Minecraft version.
2. Download the Fabric Version `.jar` file.
3. Place the `.jar` into the `mods` folder.
4. If used for a Fabric server: only the server needs it installed; vanilla client players do not need to install anything extra.
5. If used for singleplayer: it must be installed on the Fabric client.
6. Restart the game or server.
7. Done!
> The Data Pack Version and the Fabric Version have identical functionality. Please choose one to install according to your environment; usually there is no need to install both.
## ⚠️ Important Notice
This data pack and Fabric Version are **not directly affiliated with** the `Visible Traders` mod. They are independent projects inspired by it and developed for vanilla / Fabric environments.
---
# **「村民交易预览」模组介绍**
### **还在为奸商村民的隐藏交易而烦恼？**
想在升级村民前，就能预览他们未来会提供哪些宝藏吗？「**村民交易预览**」正是为你准备的解决方案！现在同时提供 **数据包版** 与 **Fabric 版**，可根据你的服务端或单人环境自由选择。
## 📖 概述
本项目灵感来源于知名模组 [Visible Traders](https://modrinth.com/mod/visible-traders)，但针对不同环境进行了重新设计。它允许所有玩家在查看**等级为1的村民**时，直接预览该村民在后续所有等级（2-5级）将会解锁的全部交易项目。
现在提供两种版本：
- **数据包版**：面向纯原版环境，如 Vanilla、Paper、Spigot 服务器和单人存档。
- **Fabric 版**：面向 Fabric 服务端与 Fabric 单人游戏，需安装 Fabric Loader。
## ✨ 主要特性
- **🔮 交易预览**：与等级1的村民互动时，其交易界面会直接显示他未来升级后才会解锁的交易选项（以锁定状态呈现）。
- **🧩 双版本可选**：数据包版适合纯原版 / Paper / Spigot；Fabric 版适合 Fabric 服务端或 Fabric 单人游戏。
- **⚙️ 纯服务端友好**：
- 数据包版：无需玩家安装任何模组或资源包。
- Fabric 版：在 Fabric 服务端安装后，原版客户端玩家无需额外安装；单人游戏则需在 Fabric 客户端中安装。
- **🌿 完全兼容**：适用于所有原版村民职业和生物群系变种。
- **🔄 即装即用**：安装后服务器中已有的村民和新生成的村民都会自动获得交易预览功能。
## 🎯 适用版本
- **Minecraft Java 版：26.1+**
- **数据包版**：适用于 Vanilla、Paper、Spigot 等主流服务端和单人存档。
- **Fabric 版**：需对应版本的 Fabric Loader；如模组依赖 Fabric API，请一并安装。
## 💡 与 Visible Traders 模组的区别
与需要客户端和服务端同时安装的 `Visible Traders` 模组不同，本项目提供更灵活的选择：
- **数据包版**：专为无法安装模组的纯原版服务端或单人游戏打造，通过数据包机制实现核心功能。
- **Fabric 版**：适合已经使用 Fabric 的服务器或单人玩家；作为服务端侧模组使用时，原版客户端玩家无需额外安装。
本数据包与 Fabric 版均为受 `Visible Traders` 启发并针对不同环境开发的独立项目，与 `Visible Traders` 模组**没有直接关联**。
## 📥 安装方法
### 数据包版
1. 下载数据包文件（`.zip`）。
2. 将文件放入服务器或单人游戏存档的 `world/datapacks` 文件夹中。
3. 重启服务器或执行 `/reload`。
4. 大功告成！现在你的村民交易更加透明、有趣了！
### Fabric 版
1. 安装对应 Minecraft 版本的 Fabric Loader。
2. 下载 Fabric 版 `.jar` 文件。
3. 将 `.jar` 放入 `mods` 文件夹。
4. 如果用于 Fabric 服务端：只需服务端安装，原版客户端玩家无需额外安装。
5. 如果用于单人游戏：需在 Fabric 客户端中安装。
6. 重启游戏或服务器。
7. 完成！
> 数据包版与 Fabric 版功能一致，请根据你的环境二选一安装，通常无需同时安装。
## ⚠️ 重要提示
本数据包及 Fabric 版与 `Visible Traders` 模组**没有直接关联**，是受其启发并针对原版 / Fabric 环境开发的独立项目。