[MD]
## 📖 插件概述
**IKTrans** 是一款适用于 LeviLamina (lse-quickjs) 平台的轻量跨服传送插件。玩家可通过 `/iktrans` 指令或 NPC 按钮，一键跳转至其他基岩版服务器，轻松构建群组网络。
| 项目 | 内容 |
|------|------|
| 插件名称 | IKTrans |
| 当前版本 | v1.0.0 |
| 运行平台 | LeviLamina (lse-quickjs) |
| 核心依赖 | LiteLoaderBDS |
| 核心标签 | 轻量 / 跨服传送 / 群组服 / NPC 支持 |
---
## 🚀 快速开始
### 安装步骤
1. 将 `IKTrans.js` 放入服务端 `plugins/` 目录
2. 启动服务器，插件自动注册 `/iktrans` 命令
3. 配合 NPC 或命令方块使用，即可实现点击跨服
### 玩家指令
| 指令 | 权限 | 功能 |
|------|------|------|
| `/iktrans <ip> <port> [target]` | GameMasters | 将玩家传送至指定服务器 |
---
## ⚙️ 命令参数详解
| 参数 | 类型 | 说明 |
|------|------|------|
| `IP` | 字符串 | 目标服务器 IP 或域名 |
| `端口` | 整数 | 目标服务器端口（默认 19132） |
| `目标玩家` | 玩家选择器（可选） | 支持 `@p`、`@a`、`@r` 或玩家名。不填则传送自己 |
---
## 🛒 使用场景
| 场景 | 示例命令 |
|------|----------|
| 大厅跳转子服 | `/iktrans survival.example.com 19132 @p` |
| 管理员手动调度 | `/iktrans 192.168.1.100 19132 Steve` |
| 全服紧急转移 | `/iktrans lobby.example.com 19132 @a` |
| NPC 按钮触发 | 在 NPC 按钮中填入 `/iktrans play.xxx.com 19132 @p` |
---
## 🎮 使用流程
1. **直接使用命令**
输入 `/iktrans <IP> <端口>` 即可传送自己
2. **传送他人**
输入 `/iktrans <IP> <端口> <玩家名/@p/@a>` 传送指定玩家
3. **配合 NPC**
召唤 NPC → 编辑按钮 → 命令栏填写 `/iktrans <IP> <端口> @p`，玩家点击按钮即传走
---
## 🎨 推荐配套资源
### NPC 插件
**车万NPC - TouHou NPC**
自定义模型、皮肤、动作和对话，让你的传送 NPC 直接变身东方角色，告别原版村民造型。
- 获取地址：https://www.minebbs.com/resources/npc-touhou-npc.4616/
### 材质包推荐
| 材质包名称 | 适用场景 | 推荐理由 | 获取方式 |
|-----------|---------|---------|---------|
| **Faithful 64x** | 全服基础材质 | 经典高清，提升整体画质，不改变原版风格 | MCPEDL / 官方市场 |
| **Bare Bones** | 宣传图/视频 | 官方宣传片同款，简洁干净，适合截图展示 | MCPEDL |
| **Actions & Stuff** | 动作美化 | 流畅玩家动画，NPC 不再僵硬 | 官方市场 |
| **Clarity** | 高配光影 | 仿光影效果，高端质感 | MCPEDL |
| 自定义 NPC 皮肤包 | NPC 专属 | 配合车万 NPC 使用，东方角色皮肤 | 自行制作 / 社区下载 |
---
## 🏗️ 系统架构
┌─────────────────────────────┐
│ /iktrans 命令 │
└─────────────┬───────────────┘
│
▼
┌─────────────────────────────┐
│ cmd.setCallback │
│ · 解析参数 │
│ · 选择目标玩家 │
│ · 调用 transServer API │
└─────────────┬───────────────┘
│
▼
┌─────────────────────────────┐
│ transServer(ip, port) │
│ (LLSE 内置) │
└─────────────────────────────┘
### 模块说明
| 模块 | 说明 |
|------|------|
| 命令注册 | 使用 `mc.newCommand` 注册 `/iktrans`，权限为 GameMasters |
| 参数解析 | 强制 `ip`、`port`，可选 `target`，支持多选 |
| 传送核心 | 调用 LLSE 的 `pl.transServer(ip, port)` 实现跨服 |
---
## ⚡ 性能设计
- 零定时任务：仅命令触发，无后台循环，不占 CPU
- 无文件读写：不产生额外配置文件，即装即用
- 轻量级：全部代码 < 1KB，加载极速
---
## 📦 注意事项
- 目标服务器必须在线且允许传入连接（端口开放）
- 传送功能依赖基岩版 `transServer` API，仅支持 BDS 服务端
- 命令执行者必须拥有 **GameMasters** 权限（普通玩家不可用）
- 当目标玩家选择器为空且执行者不是玩家时，会返回错误提示
- 配合 NPC 使用时，确保 NPC 所在世界已开启作弊或教育版编辑功能
---
## 💬 常见问题
**Q: 为什么我输入 /iktrans 提示未知命令？**
A: 请确认已安装 LiteLoaderBDS 并正确加载了 IKTrans 插件，且客户端与服务端版本 ≥1.20.30。
**Q: 传送失败，提示“服务器无响应”怎么办？**
A: 检查目标服务器是否在线、IP 和端口是否正确，以及本服务器是否能正常访问外网。
**Q: 如何让普通玩家也能使用跨服？**
A: 不建议直接开放，可通过 NPC 按钮间接调用，或修改插件权限常量（需谨慎）。
**Q: 可以批量传送吗？**
A: 可以，使用 `@a` 选择所有玩家，插件会依次调用传送接口。
---
## 🔧 扩展建议
- 可结合 **车万NPC - TouHou NPC** 制作东方风格传送员
- 可配合菜单插件，将跨服选项做成 GUI 表单
- 可在其他行为包中通过命令方块自动化执行传送逻辑
- 安装高清材质包提升服务器整体视觉体验，吸引更多玩家入驻
[/MD]
