PokeTrail 玩家与服主使用说明

PokeTrail让精灵球拥有飞行拖尾和落地动画，也能在放出的宝可梦周围显示环绕微光。玩家可以选择效果、为不同精灵球单独设置，并决定自己是否看见环绕粒子。

一、安装与更新

适用环境

1. 服主先停服，备份世界和config文件夹；玩家退出游戏。
2. 将PokeTrail-1.2.0.jar放入服务端和客户端各自的mods文件夹。它不是插件，不要放进plugins。
3. 确认两端都已安装对应的Pixelmon，不需要另外安装Cobblemon。
4. 更新时移走旧PokeTrail，mods中只留一份；不要删除原世界或配置。
5. 启动后生成config/poketrail.cfg。已有正确配置会保留原数值，只更新说明。

现有1.2.0客户端和服务端可以互相连接。旧1.1.0及更早版本不能与1.2.0混用。为了让服务端配置说明也变成中文，服主应更新服务端文件并重启。

二、玩家怎么用

选择全局效果

1. 在游戏聊天栏输入/poketrail。
2. 点击效果按钮，右侧查看预览；悬停可看完整名字。
3. 用“上一页”“下一页”浏览更多效果。
4. 设置目标为“全部精灵球（默认）”，点击“设为全局”。
5. 等待提示保存成功。菜单只显示当前有权限且服主已启用的效果。

“飞行预览/碰地预览”用于切换右侧展示内容。修改只是选择外观，不消耗精灵球或额外物品。正常投球后显示拖尾，碰地后播放落地动画。

给不同精灵球单独设置

1. 点击顶部“设置目标”，进入球种列表。
2. 通过球图标和名称找到要设置的球，点击进入。
3. 选择喜欢的效果，再点“应用到此球”。
4. 保存成功后自动返回球种列表，可继续设置其他球。

没有单独设置的球跟随全局效果。想取消某球的专属设置，进入此球后点“跟随全局”，原全局选择不会丢失。

控制自己是否看见宝可梦环绕

主界面顶部右侧有“环绕粒子：开启/关闭”。

• 关闭后，本机隐藏所有宝可梦环绕粒子；投球拖尾、落地动画和右侧预览照常。
• 不影响其他玩家看见的效果，也不修改服务器权限。
• 设置自动保存在客户端config/poketrail-client.json，重启或换服后保留。
• 开回后仍须满足服主开关和权限条件，并不是强制显示按钮。
• 若提示本地保存失败，本次仍会切换，重启前请检查客户端文件夹是否可写。

宝可梦环绕对应哪种效果

• 使用默认或调色预设时，默认根据这只宝可梦实际的捕获球显示同族微光。
• 为该球种或全局明确选择某个资源效果时，环绕使用所选效果同族的微光。例如设置为“碧浪冲击环”，环绕就是同族碧浪微光。
• 环绕会跟随宝可梦移动和体型；收回、不可见、死亡或主人离线时停止。
• 野生和NPC宝可梦不会使用玩家的环绕设置。
• GS球没有同族微光资源，默认不套用其他球素材。需要效果时，可为GS球明确选择一个已有资源作为替代。

权限失去或效果被服主关闭后，原选择可能回到默认，或对应环绕不再出现。

三、服主怎么管理

配置文件分工

服务端或客户端修改poketrail.cfg后，需要重启对应一端。菜单中切换个人环绕显示则立即生效。此版本没有配置重载命令。

完整选项、默认值和范围见《配置说明.md》。示例文件供对照，不要直接覆盖已经调好的配置。

权限规则

默认·经典星芒始终公开，普通玩家可以使用；不能用禁止权限或效果开关将默认效果移除。

**纯Forge服：**没有另装权限管理模组时，OP可使用已启用效果，普通玩家默认只能选默认效果。需要给普通玩家更多选择，请用支持Forge权限系统的权限管理模组授予对应节点，具体授权命令以该模组说明为准。

**带Bukkit权限的混合服：**按现有权限插件授权，下表节点与纯Forge一致。请确认玩家在该权限系统中确实有对应节点；不要只凭OP身份判断。

其余171个资源效果的编号和节点见《粒子名称与权限.md》。中文名字只是显示名，授权时请复制固定权限节点，不要把中文名字当作节点。

注意：

• “启用效果”和“给玩家权限”是两件事，仅把enabled改为true不会自动授权。
• OP也不能选择服主关闭的非默认效果。
• 普通玩家不要为了使用粒子而获得OP。原版/op和/deop只是管理OP身份，并不是逐项授权工具。
• 不要假设通配权限在所有权限工具上都有效，以你所用工具的规则为准。

常用管理

**关闭全服投球效果：**在服务端general中设enabled=false后重启。

**只关闭宝可梦环绕：**在服务端general中设pokemonAuraEnabled=false后重启；投球效果仍可保留。

**减少环绕密度：**降低pokemonAuraParticles，例如从12改为8；允许4–24。这样会减少每只宝可梦周围的动画粒子。

**关闭某个非默认效果：**找到effects下对应固定编号，将该效果的enabled设为false后重启。请先备份，勿更改编号或整段结构。

**设置新玩家初始效果：**修改defaultParticle，填写固定编号而不是中文名字；玩家仍必须有对应权限，否则使用默认。此项不是强制覆盖所有老玩家的选择。

四、想调整外观时看这里

客户端的clientvisuals中优先调整以下项目，修改后重启客户端：

粒子数量增大、间距减小、拖尾加长和显示距离增大，通常会增加负担。先一次改一个选项，再观察实际游戏。标为“保留设置”的项目保持默认即可，不用于当前默认效果。

五、常见问题

输入命令没打开菜单？ 确认人在游戏内、两端均已安装匹配版本，并重新输入/poketrail。控制台不能打开玩家菜单。

菜单里只有默认，或想要的效果找不到？ 先查服务端是否启用了该效果，再查玩家权限。纯Forge服未另装权限工具时，非OP默认没有额外效果权限。

应用后没有改变？ 确认收到保存成功提示，且设置目标是你要的球。未单独设置的球跟随全局。检查使用的客户端是否已经更新。

放出宝可梦后没有环绕？ 检查个人显示按钮、服主环绕开关、选择权限及资源效果开关。这只宝可梦还需属于在线玩家并已放出。GS球的默认同族资源缺失，可以明确选择已有替代效果。

关闭个人环绕后，别人仍能看到？ 这是正常的。个人按钮只控制自己客户端的显示；全服关闭由服主设置pokemonAuraEnabled。

参数修改不生效？ 确认改的是正确一端的配置并已重启。投球长度/粗细等外观主要改客户端；服主的效果开关和广播范围改服务端。不要把保留设置当作当前外观选项。

效果卡顿或粒子变少？ 先关闭个人环绕，减少密度/距离。客户端达到粒子上限时会减少显示，环绕使用投球效果之后的剩余容量。

配置改坏了？ 停服或退出游戏，恢复先前备份。只改等号右边的值，保留括号、字段前的B:/I:/S:、分组和固定编号。不要把true/false或固定键名翻译成中文。

六、更新提醒

替换旧PokeTrail时保留世界、config和个人显示文件。不要同时装两份PokeTrail。正常更新不需要重新设置每种球，也不需要清空玩家选择。