WanderingPlus
WanderingPlus 通过为每位玩家提供独立的生成周期,改善了多人服务器上原版流浪商人体验。
该插件保留了 Minecraft 原生的商人、交易、物品和实体行为。它不会引入自定义交易、货币、稀有度系统、声望或其他非原版的进度机制。
功能
-
独立生成周期
每位在线玩家都会获得独立的流浪商人计时器和生成概率。
-
兼容原版生成
使用原生的流浪商人和商人羊驼,同时遵守游戏规则(gamerules)、生物群系限制、有效地形、旁观者模式以及原版风格的位置搜索逻辑。
-
钟铃定位
优先选择附近的钟铃作为商人的漫游目标,玩家则作为备选方案。
-
状态持久化
玩家的计时器、生成概率、所有权以及当前活跃访问记录会在服务器重启后保留。离线时间不会推进生成周期。
-
支持 Paper 和 Folia
区域安全的调度机制使得同一个插件 JAR 文件可以在两个平台上运行。
-
可配置的消息
所有面向玩家显示的文字均存储在 message.yml 中,并支持 MiniMessage 格式。
-
管理员控制
可以检查玩家状态、强制生成商人,并在无需重启服务器的情况下重新加载配置。
-
公共 API 1.1
其他插件可以请求生成商人、查询活跃商人、取消或修改生成位置,并观察生成与移除事件。
命令
-
/wanderingplus info [player]
显示商人状态、生成概率、计时器和管理中的商人容量。
-
/wanderingplus spawn <player>
为指定在线玩家强制生成一个 WanderingPlus 商人。
-
/wanderingplus reload
重新加载 config.yml 和 message.yml。
兼容性
- Paper 和 Folia
- Minecraft 1.21.x 至 26.2+
- Java 21 字节码
- 无 NMS 或 CraftBukkit 依赖
WanderingPlus v0.2.0 已在 Paper 1.21.1、1.21.5、1.21.8 和 26.2,以及 Folia 1.21.11 和 26.2 上经过测试。
安装
- 下载 WanderingPlus JAR 文件。
- 将其放入服务器的
plugins/ 目录。
- 重启服务器。
- 根据需要编辑
config.yml 和 message.yml。
- 在配置更改后运行
/wanderingplus reload。
开发者 API
公共 API 已包含在主 WanderingPlus 插件中。无需单独的 API 插件。
文档和集成示例可在 GitHub 仓库 中找到。
支持
请通过 GitHub Issue 跟踪器 报告漏洞和兼容性问题。
WanderingPlus
WanderingPlus improves the vanilla Wandering Trader experience on multiplayer servers by giving each player an independent spawn cycle.
The plugin preserves Minecraft's native traders, trades, items, and entity behavior. It does not introduce custom trades, currencies, rarity systems, reputation, or other non-vanilla progression.
Features
-
Per-player spawn cycles
Every online player receives an independent Wandering Trader timer and spawn chance.
-
Vanilla-friendly spawning
Uses native Wandering Traders and Trader Llamas while respecting gamerules, biome restrictions, valid terrain, spectator mode, and vanilla-style location searching.
-
Bell targeting
Nearby bells are preferred as the trader's wandering target, with the player used as a fallback.
-
Persistent state
Player timers, spawn chances, ownership, and active visits survive server restarts. Offline time does not advance the spawn cycle.
-
Paper and Folia support
Region-safe scheduling allows the same plugin JAR to run on both platforms.
-
Configurable messages
All player-facing text is stored in message.yml and supports MiniMessage formatting.
-
Administrator controls
Inspect player status, force trader spawning, and reload configuration without restarting the server.
-
Public API 1.1
Other plugins can request trader spawns, query active traders, cancel or modify spawn locations, and observe spawn and removal events.
Commands
-
/wanderingplus info [player]
Displays trader status, spawn chance, timer, and managed trader capacity.
-
/wanderingplus spawn <player>
Forces a WanderingPlus trader spawn for an online player.
-
/wanderingplus reload
Reloads config.yml and message.yml.
Compatibility
- Paper and Folia
- Minecraft 1.21.x through 26.2+
- Java 21 bytecode
- No NMS or CraftBukkit dependencies
WanderingPlus v0.2.0 has been tested on Paper 1.21.1, 1.21.5, 1.21.8 and 26.2, as well as Folia 1.21.11 and 26.2.
Installation
- Download the WanderingPlus JAR.
- Place it in the server's
plugins/ directory.
- Restart the server.
- Edit
config.yml and message.yml as needed.
- Run
/wanderingplus reload after configuration changes.
Developer API
The public API is included in the main WanderingPlus plugin. No separate API plugin is required.
Documentation and integration examples are available in the GitHub repository.
Support
Please report bugs and compatibility problems through the GitHub issue tracker.
评论 0
登录后参与评分
还没有评论,来抢沙发吧