- 版权类型
- 原创
- 插件中文名称
- AL玩家地标
- 插件英文名称
- ALwarp
- 原帖地址
- #
- 支持的核心（服务端）
- Paper
- Folia
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- PlaceholderAPI（可选）：https://www.minebbs.com/resources/8229
Vault（可选，用于支持金币类型货币）：https://www.minebbs.com/resources/7869
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
- 1.20
ALwarp
玩家地标 / 收费传送 / 评价收藏 / 置顶曝光 / 名称颜色 / 跨服同步
不是简单的 /warp 命令，而是一套围绕玩家地标运营设计的 GUI 系统。
适用于：生存服 / 城镇服 / RPG服 / 科技服 / 综合服 / 商业服 / BungeeCord 或 Velocity 跨服网络
购买插件附带送某饭Warp插件的数据导出功能
让你无缝切换本插件
购买插件送原版贴图，让你的warp界面更加美观
玩家地标 / 收费传送 / 评价收藏 / 置顶曝光 / 名称颜色 / 跨服同步
不是简单的 /warp 命令，而是一套围绕玩家地标运营设计的 GUI 系统。
适用于：生存服 / 城镇服 / RPG服 / 科技服 / 综合服 / 商业服 / BungeeCord 或 Velocity 跨服网络
购买插件附带送某饭Warp插件的数据导出功能
让你无缝切换本插件
购买插件送原版贴图，让你的warp界面更加美观
插件简介
ALwarp 是一款面向 Paper / Purpur / Folia / Luminol 等服务端的玩家地标插件。它让玩家可以自己创建、维护、展示和经营服务器里的地点，并通过 GUI 完成浏览、传送、收藏、评分、置顶、管理和跨服传送。
传统 warp 插件通常只解决“从 A 点传送到 B 点”的问题；ALwarp 更偏向服务器运营场景：让玩家的基地、商店、资源点、公会驻地、活动场地和景点都能变成可发现、可收费、可评价、可推广的内容。
- 玩家可自行创建地标，减少管理员手动维护 warp 的工作量
- 地标可以设置传送价格，传送收入进入待领取账户
- 支持评分、评论、举报和收藏，优质地点更容易被玩家发现
- 支持主菜单置顶位购买，让商店、活动点和热门地点获得曝光
- 支持地标管理员、私有地标和黑名单，适合公会、城镇、团队建筑
- 支持地标名称/描述颜色、十六进制颜色、渐变色和加粗权限
- 支持 SQLite 单服使用，也支持 MySQL + Redis 多服共享和跨服传送
- 支持中文/英文消息与菜单文件，GUI 菜单可通过 yml 自定义
核心亮点
| 模块 | 说明 | 适合场景 |
|---|---|---|
| 玩家地标 | 玩家在当前位置创建地标，并可后续修改名称、描述、图标、分类、价格和位置 | 基地、商店、农场、景点、活动场 |
| GUI 菜单 | 主菜单、我的地标、收藏地标、管理地标、评价、分类、颜色选择等界面 | 降低玩家学习成本，不需要记复杂命令 |
| 收费传送 | 地标拥有者可设置传送价格，玩家点击地标支付费用后传送 | 玩家商店、资源点、交通枢纽 |
| 待领取收入 | 传送收入不会直接到账，而是进入待领取收入，由拥有者手动领取 | 收入记录更清晰，方便经济控制 |
| 领取扣税 | 领取收入时按配置或权限税率扣税，支持最低税额 | 经济回收、手续费、VIP差异税率 |
| 评分评论 | 玩家访问后才能评分，支持 1-5 分、评论、删除自己的评价、举报评论 | 筛选优质地标，减少低质量内容 |
| 收藏热度 | 玩家可右键收藏地标，热度用于菜单排序和展示 | 常用地点快速访问，热门内容自然上浮 |
| 置顶曝光 | 玩家可购买主菜单置顶位，按配置天数展示，到期自动释放 | 商店推广、活动入口、服务器广告位 |
| 管理员协作 | 每个地标可添加协作者共同管理，但不允许协作者删除地标或管理管理员列表 | 城镇、公会、团队建筑 |
| 私有与黑名单 | 地标可设为私有，也可禁止指定玩家传送、收藏或评论 | 保护玩家私有内容，减少骚扰 |
| 跨服同步 | MySQL 共享数据，Redis 同步刷新、心跳和跨服传送请求 | BungeeCord / Velocity 群组服 |
| 自定义图标 | 支持原版物品、CustomModelData、CraftEngine、ItemsAdder、Oraxen 和部分 YiyunCEskin 场景 | 资源包服、RPG服、菜单美化 |
| Folia 兼容 | 使用兼容调度处理数据库、GUI 和传送逻辑 | Folia / Luminol 区域线程服务端 |
- 作者 QQ：1422163791
- 售前交流群：870052304
- 联系方式：QQ 搜索作者号码后添加咨询
- 也可以加入售前交流群，提前了解插件功能、适配情况和购买相关信息
- 咨询时建议说明服务器核心、Minecraft 版本，以及是否使用 Folia 核心，CraftEngine、PlaceholderAPI 等相关插件，方便确认适配方案
玩家如何使用
打开主菜单：
代码：
/alwarp- 左键：传送到地标
- 右键：收藏 / 取消收藏
- Shift + 左键：查看地标评论
代码：
/alwarp create- 输入地标名称
- 再次输入“确认创建”
- 插件在玩家当前位置生成地标
- 创建后可在“我的地标”中继续设置描述、图标、分类、价格、位置、私有状态、管理员和黑名单
- 左键“设置地标名称”：修改名称
- 右键“设置地标名称”：设置名称颜色
- 左键“设置地标描述”：修改描述
- 右键“设置地标描述”：设置描述颜色
- 手持物品后可把手上物品设置为地标图标
- 可设置传送价格、分类、传送点、私有状态、管理员、黑名单
- 修改后需要点击“确认保存”写入正式数据
颜色系统
地标名称/描述颜色系统。
颜色不是让玩家直接输入 `&a` 或 MiniMessage 标签，而是通过 GUI 和权限系统统一控制。
颜色菜单操作：
- 左键颜色：使用该颜色
- Shift + 右键颜色：购买该颜色权限
- 左键加粗按钮：切换加粗
- Shift + 右键加粗按钮：购买加粗权限
- 点击默认颜色：清除自定义颜色和加粗
- Minecraft 16 个基础颜色：&0 到 &f
- 十六进制颜色示例：天蓝 #66ccff
- 多种渐变色：日落、海洋、极光、糖果、烈焰、森林、冰霜、星辉、彩虹、银河、樱花、薄荷、晨曦、暮光、熔岩、翡翠、蓝宝石、霓虹、珍珠、青铜
代码：
plugins/ALwarp/menus/landmark-color-select.yml
代码：
landmark:
color_system:
enabled: true
unlock:
enabled: true
currencies:
vault:
name: "金币"
playerpoints:
name: "点券"
color:
enabled: true
currency: "playerpoints"
price: 500
bold:
enabled: true
currency: "playerpoints"
price: 500
permission_grant:
commands:
- "lp user %player% permission set %permission% true"| 变量 | 说明 |
|---|---|
| %player% | 玩家名 |
| %uuid% | 玩家 UUID |
| %permission% | 颜色或加粗对应权限 |
| %unlock_name% | 解锁显示名 |
| %unlock_type% | color 或 bold |
| %color_id% | 颜色 ID，加粗时为空 |
经济、收入与税务
ALwarp 使用“传送时进入待领取，领取时扣税”的收入模型。
- 玩家传送收费地标时，传送者支付完整传送费用
- 地标拥有者不会立刻到账，而是增加到待领取收入
- 拥有者在“我的地标”中点击领取收入
- 领取时按配置税率或权限税率计算税额
- 发钱失败时待领取收入会恢复
- 传送失败时会退款，不产生收入
代码：
地标价格：500
传送者支付：500
地标拥有者待领取：500
税率：10%
点击领取后到账：450
扣税：50
代码：
economy:
teleport_confirm_threshold: 50.0置顶位系统
主菜单上方可以配置多个置顶位。空置顶位显示为可购买按钮；玩家购买后，自己的地标会在主菜单固定展示一段时间。
- 置顶位数量由 `menus/main.yml` 中的 `pin_slot: true` 按钮决定
- 每个置顶位可单独配置价格和持续天数
- 购买成功后从当前时间开始计算到期时间
- 到期后自动释放，其他玩家可再次购买
- 管理员可使用命令手动清除指定置顶位
代码：
1:
type: OAK_SIGN
name: "&6置顶位 #1"
pin_slot: true
pin_slot_id: 1
action: "pin_slot:%pin_slot%"
right_action: "pin_slot_favorite:%pin_slot%"
shift_left_action: "pin_slot_reviews:%pin_slot%"
cost: 1000.0
duration_days: 7评分、收藏与黑名单
评分评论：
- 玩家必须先访问过地标，才能评分和评论
- 评分范围默认 1-5 分
- 可配置评分冷却、评论最短/最长字符数、评论自动换行
- 玩家可删除自己的评价
- 管理员可删除任意评价
- 支持评论举报，达到阈值后自动删除评论和评分
- 地标列表右键即可收藏或取消收藏
- 主菜单有独立“收藏地标”入口
- 收藏热度会影响地标展示排序
- 私有地标不会被其他玩家收藏
- 地标创建者可把指定玩家加入黑名单
- 黑名单玩家无法传送、收藏或评论该地标
- 拉黑后会自动取消该玩家对此地标的收藏
- 如果被拉黑玩家原本是地标管理员，会自动移除管理员身份
跨服同步
单服默认使用 SQLite，不需要额外数据库。
跨服网络推荐使用：
- MySQL：所有子服共享同一份地标数据
- Redis：实时同步地标、收入、收藏、评分、心跳和跨服传送请求
- BungeeCord / Velocity：用于把玩家连接到目标子服
- 所有子服连接同一个 MySQL 数据库
- 所有子服连接同一个 Redis 频道
- `serverid` 必须和 BungeeCord / Velocity 配置里的服务器名一致
- `serverName` 用于菜单显示，可写成“生存服”“资源服”“主城服”等
- 可通过 `server_permissions` 为不同子服设置访问权限
代码：
plugins/ALwarp/database.yml
plugins/ALwarp/config.yml安装说明
推荐环境：
| 项目 | 说明 |
|---|---|
| Java | Java 21 |
| 服务端 | Paper / Purpur / Folia / Luminol 等 1.20+ 服务端，推荐 1.21.x |
| 数据库 | 单服 SQLite，跨服推荐 MySQL |
| 跨服通信 | Redis，跨服时推荐启用 |
- 将 `ALwarp.jar` 放入服务器 `plugins` 文件夹
- 启动服务器，生成 `plugins/ALwarp/` 配置目录
- 按需求修改 `config.yml`、`database.yml`、`menus/*.yml`
- 安装所需经济/权限插件，例如 Vault、PlayerPoints、LuckPerms
- 使用 `/alwarp reload` 重载配置，或重启服务器
依赖与兼容
| 依赖 | 是否必须 | 用途 |
|---|---|---|
| Vault + 经济插件 | 经济功能需要 | 创建扣费、收费传送、收入领取、置顶购买等金币功能 |
| PlayerPoints | 可选 | 用于点券购买颜色/加粗权限，也可改用 Vault 金币 |
| LuckPerms | 可选 | 默认颜色授权命令适配 LuckPerms，可换成其他权限插件命令 |
| MySQL | 跨服推荐 | 多子服共享地标数据 |
| Redis | 跨服推荐 | 跨服传送、缓存刷新、收入同步、在线心跳 |
| CraftEngine | 可选 | 自定义物品/菜单图标 |
| ItemsAdder | 可选 | 自定义物品/菜单图标 |
| Oraxen | 可选 | 自定义物品/菜单图标 |
| YiyunCEskin | 可选 | 部分 CE 皮肤物品场景兼容 |
常用命令
代码：
/alwarp
/alwarp help
/alwarp create
/alwarp admin
/alwarp reload
/alwarp export [文件名]
/alwarp import [文件名]
/alwarp clearpin <置顶位编号>
/alwarp pin clear <置顶位编号>
/alwarp purge landmarks <玩家名>
/alwarp purge records <玩家名>| 命令 | 说明 | 权限 |
|---|---|---|
| /alwarp | 打开地标主菜单 | alwarp.use |
| /alwarp create | 创建地标 | alwarp.create |
| /alwarp admin | 打开管理员地标菜单 | alwarp.admin |
| /alwarp reload | 重载配置、语言和菜单 | alwarp.admin |
| /alwarp export [文件名] | 导出地标数据 | alwarp.export |
| /alwarp import [文件名] | 导入地标数据 | alwarp.import |
| /alwarp clearpin <编号> | 清除指定置顶位 | 仅 OP |
| /alwarp pin clear <编号> | 同上 | 仅 OP |
| /alwarp purge landmarks <玩家名> | 删除指定玩家名下全部地标 | alwarp.admin |
| /alwarp purge records <玩家名> | 删除指定玩家收藏、评分和评论记录 | alwarp.admin |
常用权限
| 权限 | 默认 | 说明 |
|---|---|---|
| alwarp.use | 所有玩家 | 使用基础菜单 |
| alwarp.create | 所有玩家 | 创建地标 |
| alwarp.admin | OP | 管理员功能 |
| alwarp.free | OP | 免费传送所有收费地标 |
| alwarp.export | OP | 导出数据 |
| alwarp.import | OP | 导入数据 |
| alwarp.limit.<数量> | 手动配置 | 设置玩家可创建地标数量，例如 alwarp.limit.5 |
| alwarp.limit.unlimited | OP | 无限创建地标 |
| alwarp.delay.<秒数> | 手动配置 | 设置玩家传送延迟，例如 alwarp.delay.0 |
| alwarp.delay.bypass | OP | 跳过传送延迟 |
| alwarp.tax.<百分比> | 手动配置 | 设置领取收入税率，例如 alwarp.tax.5 |
| alwarp.tax.bypass | OP | 完全免税 |
| alwarp.color.all | OP | 拥有所有颜色权限 |
| alwarp.color.bold | 手动配置 | 允许使用加粗 |
| alwarp.color.green | 手动配置 | 示例：允许使用绿色 |
| alwarp.color.gradient.rainbow | 手动配置 | 示例：允许使用彩虹渐变 |
数据导入导出
ALwarp 支持把核心业务数据导出为 yml 文件，适合迁服、备份、升级前留档。
导出内容包括：
- 分类
- 地标
- 收藏
- 评分和评论
- 地标管理员
- 地标黑名单
- 主菜单置顶位
- 交易记录
- 待领取收入
- 地标名称颜色、描述颜色、加粗状态
- 图标、CustomModelData、自定义物品数据
代码：
/alwarp export before-update
/alwarp import before-update.yml
代码：
plugins/ALwarp/exports/适合购买的人群
- 你希望玩家自己创建和维护服务器地点
- 你希望玩家商店、基地、景点、资源点能被更多人看到
- 你希望传送系统接入经济，而不是完全免费的消耗品
- 你希望有评分、评论、收藏机制，让玩家筛选优质地点
- 你希望地标支持置顶曝光，形成可运营的菜单广告位
- 你需要 Folia / Luminol 兼容
- 你需要 MySQL + Redis 跨服同步能力
- 你希望菜单图标支持 CustomModelData / CraftEngine / ItemsAdder / Oraxen
- 你只需要一个极简 `/warp <名字>` 命令
- 你不打算让玩家创建公开地标
- 你不需要经济、评分、收藏、分类、置顶或跨服功能
- 你不愿意配置权限、经济和菜单文件
购买前建议：
- 确认你的服务器使用 Java 21
- 确认服务端为 Paper / Purpur / Folia / Luminol 等兼容服务端
- 如果需要经济功能，请安装 Vault 和对应经济插件
- 如果需要点券购买颜色，请安装 PlayerPoints
- 如果使用默认授权命令，请安装 LuckPerms；否则请修改授权命令配置
- 跨服使用前请先规划好 `serverid`、MySQL 和 Redis，避免上线后频繁迁移
ALwarp
让玩家自己建设、经营、评价和宣传服务器里的每一个地点。
让玩家自己建设、经营、评价和宣传服务器里的每一个地点。
