Telecraft - 传送工艺

Telecraft 是一款基于合成与物品交互的传送系统插件，旨在通过纯游戏玩法实现传送功能，无需依赖指令，为生存模式玩家提供原版风格的沉浸式体验。

💡核心特性

• 无需指令：所有功能均通过物品合成与交互实现，无需管理员后台操作。
• 多样化传送方式：通过合成新的物品（如奇异方块、箭矢、药水等）来传送玩家与生物。
• 一键存储：使用 ChestRune 可一键存储整个箱子的内容。
• 多世界支持：支持跨世界传送。
• 自定义名称：可在铁砧中为物品重命名，放置为奇异方块后会以全息文字显示。
• 所有者控制：奇异方块的所有者可以将其停用。
• 临时返回门：药水和奇异方块可生成临时返回传送门（可选功能）。
• 红石支持：奇异方块支持红石信号触发（实验性/可选功能）。
• 地图迁移友好：结合 StrangeRune 与 ChestRune，便于地图迁移。
• 尊重保护区：与领地保护插件（如 LWC）兼容，不会在保护区内违规操作。
• 高度可配置：提供丰富的配置选项与权限节点，以适应不同服务器需求。
• 无数据库：仅使用备份文件用于启动时验证 StrangeRune。
• 非破坏性：禁用插件后，奇异方块物品会正常消失；重新启用插件后，它们会被重新激活。

🎮物品与使用指南

Strange Rune（奇异符文）

一种刻有符文绿宝石，可以记忆玩家位置。

• 记忆坐标：潜行 + 右键点击方块，将当前位置存入符文。
• 重命名：可在铁砧中重命名（若合成为奇异方块，此名称会以全息文字显示）。
• 传送至坐标：手持已记忆坐标的符文，右键点击一个已放置的奇异方块，可传送至符文记忆的位置。
• 直接传送：若启用权限 telecraft.player.rune.teleport，可直接使用符文传送（为保持游戏平衡，不推荐启用）。

Strange Block（奇异方块）

可使用合成时所用的 Strange Rune 中存储的坐标，来传送玩家和生物。

• 合成要求：必须使用已记忆坐标的 Strange Rune 合成。
• 传送附近实体：左键点击奇异方块，传送附近的实体。
• 停用/变色：右键点击可停用方块或改变显示名称的颜色。
• 静音模式：在其下方放置灵魂沙可使其激活时静音。
• 破坏回收：潜行状态下破坏方块，会掉落其内部的符文。

Piece of Rune（符文碎片）

将 Strange Rune、Death Rune 或 Bed Rune 分解成多片，用于制作药水。

Spawn Rune（出生点符文）

使用一个未记忆坐标的 Strange Rune 合成，会将其记忆坐标设置为当前世界的出生点。

Rune Potion（符文药水）

以粗制药水为基础，加入 Piece of Rune 合成。饮用后将玩家传送至该符文碎片所记忆的位置。

Splash Rune Potion & Lingering Rune Potion（喷溅型与滞留型符文药水）

• 喷溅型：在药水落点附近传送实体。
• 滞留型：在药水云区域内传送实体。

Strange Arrow（奇异箭）

命中后，在落点附近传送实体。

Death Rune（死亡符文）

• 返回死亡点：手持死亡符文右键点击奇异方块，可传送至上一次死亡的位置。
• 无法用于合成奇异方块。

Bed Rune（床符文）

• 返回重生点：手持床符文右键点击奇异方块，可传送至你的床的重生点。
• 无法用于合成奇异方块。

ChestRune（箱子符文）

可以存储物品堆栈的记忆。

• 存储内容：潜行 + 右键点击箱子，将其内容存入符文。
• 取出内容：左键点击一个空箱子，将符文内存放的物品放入箱子。
• 浏览内容：潜行 + 点击一个非箱子的方块，打开符文的虚拟库存界面（需要权限）。
• 个人传送枢纽：若启用权限 telecraft.player.chestrune.tp，可潜行 + 右键点击符文，使用其中存储的 StrangeRune 进行即时传送（默认关闭）。
• 存储限制：无法放入潜影盒、另一个 ChestRune 或自定义插件的虚拟容器（如背包）。
• 尊重保护：与领地保护插件兼容。

Voodoo Doll（巫毒娃娃）

• 链接实体：右键点击一个生物以链接娃娃。
• 传送至实体：手持已链接的巫毒娃娃，左键点击奇异方块，可传送至该生物的位置。
• 链接方块：右键点击一个奇异方块，可将其与娃娃当前链接的生物绑定。之后可直接使用该方块传送到生物位置。再次右键点击可解除链接。
• 无法用于合成奇异方块。

🔧基础使用流程

• 获取一个 Strange Rune（奇异符文）。
• 潜行并右键点击一个方块，将你的当前位置存入符文。
• 使用该符文合成一个 Strange Block（奇异方块）并放置。
• 左键点击该方块，即可将附近的实体传送至符文记忆的位置。

✨配置选项

你可以在配置文件中自定义物品/方块名称、插件消息及各项功能。

主要配置项摘要

• ATR_RuneMaterial: EMERALD：设置基础符文的材料。
• ATR_CoolDownType: RESISTANCE：设置传送后施加的药水效果类型，推荐 NAUSEA 或 HUNGER 以维持角色扮演体验。
• ATR_TeleportDelay_PLAYER: 200：玩家两次传送之间的冷却时间（刻）。
• ATR_TeleportMobs: true：是否允许传送生物。
• ATR_EnableDeathRune: false：是否启用死亡符文。
• ATR_EnableBedRune: false：是否启用床符文。
• ATR_EnableVoodooRune: false：是否启用巫毒娃娃。
• ATR_EnableChestRune: true：是否启用箱子符文。
• ATR_ChestRuneSize: 54：箱子符文的虚拟库存大小（必须是9的倍数，最大54）。
• ATR_CostToUse: true：使用传送功能是否需要代价。
• ATR_CostToUseType: HUNGER：代价类型（HUNGER / EXP / LIFE）。
• ATR_StrangeBlocRedstone: true：是否启用奇异方块的红石触发功能（注意可能增加服务器负载）。
• ATR_allowedWorld: []：允许使用插件功能的世界列表。
• ATR_forbiddenWorld: []：禁止使用插件功能的世界列表。
• ATR_StrangeRuneCustomRecipe: false：是否启用奇异符文的自定义合成配方。

自定义配方示例：

ATR_StrangeRuneCustomRecipe: true
ATR_StrangeRuneRecipeShape:
- GRG
- IEI
- AGA
ATR_StrangeRuneRecipeIngredients:
E: EMERALD
G: GOLD_BLOCK
R: REDSTONE_BLOCK
I: IRON_BLOCK
A: AIR

❓权限节点

默认权限为平衡的游戏体验而设，但你可以按需调整。

• telecraft.player.*：玩家使用插件的基础权限（默认 true）。
• telecraft.player.rune.*：符文使用权限。

- `telecraft.player.rune.teleport: false`：允许直接使用符文传送（默认关闭）。

• telecraft.player.block.*：奇异方块使用权限（默认 true）。
• telecraft.player.potion.*：药水使用权限（默认 true）。
• telecraft.player.chestrune.tp: false：允许使用 ChestRune 作为传送枢纽（默认关闭）。
• telecraft.nocost.*：免除传送代价的权限（默认 OP）。
• telecraft.admin.*：管理权限（默认 OP），包含重载、清理、调试等。

⭐管理员指令 (仅OP)

• /runesreload：重载插件配置。
• /runesclean：清除世界中损坏的符文数据，并修复被其他插件清除的奇异方块。
• /runesdebug：开启调试信息（会在控制台产生大量输出，仅用于开发）。
• /runescopy [数量]：复制主手持有的物品。

💡已知问题与解决方案

• 与 ClearLagg 等实体清理插件的冲突：这类插件可能会清除掉落状态的奇异方块（绿宝石物品）。
• 解决方案：

1.  将 Telecraft 更新至 1.3.7 或更高版本。

2.  定期使用 `/runesclean` 命令修复被清除的方块。

3.  在实体清理插件中设置过滤，避免清除绿宝石物品。如果无法设置，建议不要在服务器中同时使用该清理插件与 Telecraft。

🔧统计与支持

• 本插件使用 bStats 收集匿名统计数据，以帮助改进插件。
• Bug 反馈与帮助：请访问 Discord 频道 #plugin-telecraft：https://discord.gg/DVX38rs

致谢：感谢 Jai 的英文翻译修正，以及 DarkSumrak 的教程。