Home Point

插件

· 作者 Vaelit

一款简单的服务端模组,添加了便捷的 /home 系统,支持跨维度传送和自动补全。无需安装客户端!

0 本站下载 0 关注 更新于 7 个月前

最新 1.5.6 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? 家园点

一个轻量级、交互式的 Minecraft 服务器传送系统。


?️ 关于模组

Home Point 是一个仅服务端模组,彻底重构了标准的 /home 命令体验。它不再使用笨拙的物品栏 GUI,也不强制你输入冗长的命令,而是通过聊天框中简洁的点击界面进行管理。由于它是仅服务端模组,你的玩家无需下载任何内容即可游玩!

✨ 功能特性

  • ? 分享你的基地 (/home share): 对自己的建筑感到自豪?在公共聊天频道分享你的家园。其他玩家将看到一个绿色的 [Add Home](添加家园)按钮,点击即可将你的坐标瞬间保存到他们的列表中。1.5.6 新增: 现在支持 @a、@p、@r 选择器,可一次性分享给多名玩家!
  • ⌨️ 智能自动补全: 开始输入 /home tp ,按下 TAB 键,模组将自动建议并安全地用引号包裹你的家园名称,即使名称中包含空格或西里尔字母也是如此!
  • ⚔️ 战斗标记 (防 PvP): 再也不用从战斗中逃跑。如果玩家造成伤害或受到伤害,他们将被置于战斗模式,从而阻止其进行传送。
  • ? 维度控制: 只想让玩家在主世界使用家园?你可以轻松地在配置文件中通过白名单或黑名单限制传送。
  • ?️ 100% 可配置: 调整模组的几乎各个方面。想要 5 秒的热身延迟?自定义粒子效果?严格的家园数量上限?一切皆有可能。

? 技术性能

Home Point 专为大型多人在线服务器设计:

  • 零 TPS 影响: 传送等待计时器不使用标准的服务器 onTick 事件循环。所有操作都依赖于高度高效的计划任务调度器。
  • 异步 I/O 保存: 当模组保存玩家坐标时,它将保存过程卸载到后台线程 (system_async_saving)。它永远不会冻结或卡顿主服务器线程!

? 命令与参数

所有内容均通过 /home 命令运行,完全支持 TAB 自动补全。如果你的家园名称包含空格,不用担心——模组会自动为你在名称周围添加引号!

? 基本导航

命令 描述
/home 打开交互式聊天菜单,包含可点击的 [TP]、[Ren]、[Del]、[Share] 按钮
/home list <page> 显示你家园列表的指定页码
/home <name> 立即传送到指定的家园
/home set <name> 在当前位置创建一个新的家园
/home del <name> 删除现有的家园
/home rename <old_name> <new_name> 重命名现有的家园

? 分享

在分享家园时,你可以选择指定分享对象(使用玩家名称或实体选择器 @a、@p、@r),并控制是否包含可点击的 [Add Home] 按钮。

命令 描述
/home share <name> 向公共聊天频道广播你的家园,并附带 [Add Home] 按钮
/home share <name> <target> 向特定玩家发送你的家园。支持 @a(全部)、@p(最近)、@r(随机)
/home share <name> <target> true 向目标玩家分享包含 [Add Home] 按钮
/home share <name> <target> false 向目标玩家分享不包含 [Add Home] 按钮(仅坐标)
/home share_coords <name> 以纯文本坐标形式向公共聊天频道广播你的家园(无按钮)
/home share_coords <name> <target> 向特定玩家发送纯文本坐标

示例: /home share "My Base" @a false — 向所有在线玩家发送 "My Base" 的坐标,不带任何可点击按钮。

? 权限等级与限制

配置文件允许你设置特定的配额,如 homes_limit_vip 和 homes_limit_admin。模组会根据标准权限级别或管理员状态自动确定这些配额。如果将 homes_unlimited_for_operators 设置为 true,你可以原生授予 OP 状态来即时绕过所有限制。


⚙️ 服务器配置 (v1.5.6+)

文件位置: config/home_mod.json

配置文件非常详细但易于阅读。如果你更新模组,新设置会安全地添加,而不会破坏你现有的配置!以下是你可以调整的每个设置的完整说明:

? 1. 玩家限制 (homes_limit_*)

  • homes_limit_default [整数, 默认: 3]:普通玩家可以设置的最大家园数量。
  • homes_limit_vip [整数, 默认: 10]:通常分配给 VIP 玩家的扩展限制(例如通过 LuckPerms)。
  • homes_limit_admin [整数, 默认: 50]:管理员或版主的大容量限制。
  • homes_unlimited_for_operators [布尔值, 默认: true]:如果设置为 true,拥有 OP 状态的玩家将完全绕过所有限制。如果你希望管理员遵守 homes_limit_admin,请将其设置为 false。

? 2. 防 PvP 保护 (pvp_block_*)

  • pvp_block_teleport_in_combat [布尔值, 默认: true]:如果为 true,参与战斗(受到伤害或造成伤害)将立即锁定 /home 命令,防止战斗登出。
  • pvp_combat_duration_seconds [整数, 默认: 15]:玩家在最后一次受到攻击后保持“战斗中”状态的持续时间,之后才允许再次传送。

⏱ 3. 传送机制与冷却时间 (teleport_*)

  • teleport_wait_seconds [Int, 默认值: 3]: 传送前的站立预热延迟。设置为 0 可实现即时传送。
  • teleport_cooldown_seconds [Int, 默认值: 10]: 限制玩家使用 /home 命令的频率,防止刷屏。
  • teleport_cancel_if_player_moves [Boolean, 默认值: true]: 如果为 true,当玩家在等待期间移动时,预热过程将取消。
  • teleport_cancel_if_hurt [Boolean, 默认值: true]: 如果为 true,当玩家在等待期间受到任何伤害时,预热过程将取消。
  • teleport_cancel_if_attacking [Boolean, 默认值: false]: 如果为 true,当玩家在等待期间攻击实体时,预热过程将取消。
  • teleport_auto_dismount_vehicles [Boolean, 默认值: true]: 在传送前自动移除玩家所骑乘的马匹或矿车等载具,以防止出现严重的同步错误(desync)。
  • teleport_allow_between_dimensions [Boolean, 默认值: true]: 如果为 false,玩家只能传送到与其当前所在维度相同的家中。
  • teleport_check_destination_safety [Boolean, 默认值: true]: 检查目的地是否有实心方块,以防止玩家到达时卡在方块内窒息。
  • teleport_keep_velocity [Boolean, 默认值: false]: 如果为 true,以终端速度下落的玩家在传送后将继续快速下落(极其危险)。
  • teleport_center_camera [Boolean, 默认值: false]: 如果为 true,玩家到达时将强制看向正前方(俯仰角 pitch 0)。
  • teleport_max_y_limit [Int, 默认值: 320]: 防止设置家位于地图上方(例如末地顶部的例外情况)。
  • teleport_min_y_limit [Int, 默认值: -64]: 防止设置家位于基岩层下方。

? 4. 世界与维度 (world_*)

  • world_use_whitelist [Boolean, 默认值: false]: 如果为 true,玩家仅能在白名单列出的维度中使用 /home 命令。
  • world_whitelist [List of Strings, 默认值: ["minecraft:overworld", "minecraft:the_nether", "minecraft:the_end"]]: 允许的维度 ID 列表。
  • world_use_blacklist [Boolean, 默认值: false]: 如果为 true,禁止玩家在黑名单列出的任何维度中设置或使用家。
  • world_blacklist [List of Strings, 默认值: []]: 禁止设置家的维度 ID 列表。

? 5. 聊天界面功能 (chat_* & button_*)

  • chat_enable_gui [Boolean, 默认值: true]: 切换聊天中的交互式可点击按钮。如果为 false,模组仅通过文本命令运行。
  • chat_homes_per_page [Int, 默认值: 5]: 每页显示的家数量,超出后将滚动至 /home list 2。
  • chat_prefix [String, 默认值: "§6[Home] §r"]: 玩家在看到任何模组消息前看到的标签前缀。
  • chat_color_primary / secondary / error / accent [String]: 界面中使用的标准 Minecraft 颜色代码(§a, §e, §c, §b)。
  • chat_share_button_enabled [Boolean, 默认值: true]: 启用每个家旁边的 [Share](分享)按钮。
  • chat_share_button_default [Boolean, 默认值: true]: 通过 GUI 分享家时,此选项决定是否在消息末尾附加交互式 [Add Home](添加家)按钮,以便其他玩家点击。
  • button_text_tp / _rename / _delete / _add_home [String]: 完全自定义交互式括号文本(例如,你可以将 [TP] 翻译为 [Телепорт])。

? 6. 悬停文本与消息 (hover_* & msg_*)

翻译或自定义每一个工具提示和错误警报!

  • hover_tp / _rename / _share / _copy_coords [String]: 聊天按钮的鼠标悬停工具提示。
  • msg_home_not_found / msg_limit_reached / msg_tp_in_combat [String]: 标准错误广播。
  • msg_cooldown_active [String]: 包含 %time% 占位符,用于动态显示剩余秒数。
  • msg_tp_cancelled_moved / _damage [String]: 如果传送预热被中断,则发送此消息。

? 7. 视觉效果与音频 (effect_* & sound_*)

  • effect_spawn_particles [Boolean, 默认值: true]: 在传送序列期间为玩家生成视觉粒子效果。
  • effect_teleport_end_particle [String, 默认值: "minecraft:dragon_breath"]: 到达目的地时生成的确切粒子类型。
  • effect_teleport_particle_count [Int, 默认值: 30]: 粒子云的密度。
  • effect_teleport_particle_radius [Double, 默认值: 1.5]: 粒子的扩散半径。
  • sound_enabled [Boolean, 默认值: true]: 切换所有与传送相关的音频提示。
  • sound_teleport_start [String, 默认值: "entity.enderman.teleport"]: 预热期间播放的声音。
  • sound_teleport_success [String, 默认值: "block.portal.travel"]: 到达目的地时播放的声音。
  • sound_teleport_cancel [String, 默认值: "block.note_block.bass"]: 如果预热被中断,则播放的声音。
  • sound_teleport_start_volume / _success_volume / _cancel_volume [Float, 默认值: 1.0f / 0.8f / 1.0f]: 独立的音量控制。

? 8. 文件备份与引擎 (system_*)

  • system_save_interval_minutes [Int, 默认值: 15]: 服务器自动将玩家家园数据库保存到磁盘的频率,以防止数据回滚。
  • system_async_saving [Boolean, 默认值: true]: 关键:强制在后台线程上保存数据库记录,而不会占用服务器主线程 tick。保证在大型网络中绝对零 TPS 下降。除非正在诊断 I/O 冲突,否则请保持 true。
  • system_debug_mode [Boolean, 默认值: false]: 启用后将在服务器控制台打印高度技术性的诊断日志(仅限开发者/调试用途)。

❓ 常见问题 (FAQ)

Q: 我的玩家需要下载这个模组吗? A: 不需要! 该模组深度注入服务器核心。玩家可以使用完全原版的客户端加入游戏,并开箱即用所有可点击功能!

问:从 1.4.0 升级到 1.5.6 会丢失玩家的旧家吗? 答:不会。 我们的自定义 Gson 配置管理器能够完美处理迁移。你的 homes.json 文件绝对安全!

问:这与 EssentialsX 或其他传送模组冲突吗? 答:不冲突。Mod 加载器能正确捕获命令执行。如果与其他模组在 /home 命令上存在轻微的身份冲突,标准的原生优先级系统会自动动态处理。


?️ 安装说明

重要提示: 此模组仅需放入服务器的 mods 文件夹中。玩家加入服务器时无需下载此模组!

  1. 根据你的加载器(Fabric、Forge、NeoForge 或 Quilt)下载对应的 .jar 文件。
  2. 将其放入服务器的 mods 文件夹中。
  3. 启动一次服务器。config/home_mod.json 配置文件将自动生成,供你进行编辑。

⚠️ 关于旧版本(1.12.2, 1.8.9)的说明

如果你运行的是 1.12.2 或 1.8.9 版本的服务器,该模组仅限使用 1.0.0 版本。旧版本完全基于命令实现,不具备可点击的聊天界面或 JSON 配置文件功能。


? 版本备注

最新版本:1.5.6 本描述及列出的配置设置均基于该模组的最新版本。如果你下载的是较旧的发行版(例如适用于早期 Minecraft 版本的 v1.3.0 或 v1.4.0),部分最新的配置选项或聊天功能可能不会出现在你的配置文件中。请务必始终尝试使用与你特定的 Minecraft 加载器兼容的最新可用版本!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源