LandClaimPlugin

插件

· 作者 AyoSynk

Minecraft 终极领地保护

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

最新 3.4.0 · 26.3 · Folia / Paper

一键开服(送7天)

landclaimlogo

? LandClaimPlugin

高级领地保护插件

一款功能强大、特性丰富的基于区块的领地保护插件,适用于 Paper 服务器。创建领地档案、保护你的建筑、通过精细的角色权限管理成员、建立联盟、设置传送点,并自定义领地的方方面面。


⚠️ 开发构建版本

开发构建版本由最新的提交自动生成,可能包含未完成的功能、破坏性更改或实验性代码。不建议在生产环境中使用这些构建版本。

如果你选择运行开发版:

  • 请预期会出现 Bug、崩溃或不完整的功能。
  • 配置文件和数据格式可能会在未经通知的情况下发生变化。
  • 不保证向后兼容性。

仅用于测试、抢先体验或提供反馈。 ? 下载最新的开发构建版本: GitHub Releases


✨ 功能特性

核心领地系统

  • 领地档案 (Claim Profiles) — 使用领地档案管理你的土地。根据服务器配置,玩家可拥有单个档案,或使用多档案系统来管理多个独立的基地,并通过交互式 GUI 快速切换。
  • 基于区块的领地 (Chunk-Based Claims) — 16×16 方块的保护区域,简单直观。
  • 自动认领 (Auto-Claim) — 行走时自动认领所在的区块。
  • 相连领地 (Connected Claims) — 可选要求领地必须相邻(支持对角线连接)。
  • 手持领土地图 (小地图) — 在主手/副手或物品展示框中显示实时的 128×128 像素雷达地图,展示区块边界、领地颜色以及玩家实时朝向。
  • 交互式选择器 (Interactive Selectors) — 通过玩家的头像以编程方式在线选择玩家,用于信任、成员和盟友的管理。
  • 脱困指令 (Unstuck Command) — 安全的 /claim unstuck 功能,可将被困玩家传送到最近的未被占领的安全荒野方块处。

权限系统

  • 4 级优先级链 — 所有者 > 角色 > 受信任者 > 访客 — 第一个匹配的层级决定权限
  • 自定义角色 (Custom Roles) — 创建和配置自定义角色(例如 Member、CoOwner),具有基于标志位的细粒度权限
  • 受信任玩家 (Trusted Players) — 授予特定玩家特定的权限覆盖
  • 访客设置 (Visitor Settings) — 配置非成员在你的领地中可以做什么
  • 25+ 权限标志位 — 门、陷阱门、容器、工作站、动物、载具、红石等更多功能

社交系统

  • 成员系统 (Member System) — 邀请玩家加入你的领地,分配角色并管理访问权限
  • 联盟系统 (Ally System) — 在领地之间建立相互联盟,并配置跨领地权限
  • 信任系统 (Trust System) — 授予个别玩家针对该玩家的权限覆盖
  • 封禁系统 (Ban System) — 完全禁止玩家进入或与你的领地交互。被封禁的玩家在到达领地边界时会被物理推开,并且(如果在封禁时在线)会被传送至外部。此状态在服务器重启后依然保留。
  • 传送点系统 (Warp System) — 在你的领地内设置带有自定义图标和每个玩家限制命名的传送点
  • 公共传送点 (Public Warps) — 将你的任意传送点发布到全服务器的公共列表中。其他玩家可以浏览并通过 /claim publicwarps 进行传送。

保护机制

  • 方块保护 (Block Protection) — 防止未授权的破坏和放置
  • 实体保护 (Entity Protection) — 保护动物、盔甲架和物品展示框
  • 爆炸保护 (Explosion Protection) — 阻止 TNT、苦力怕和其他爆炸伤害
  • 交互保护 (Interaction Protection) — 控制门、容器和工作站的访问
  • 物品保护 (Item Protection) — 防止未授权的拾取和丢弃
  • 活塞保护 (Piston Protection) — 阻止活塞跨越领地边界推/拉方块
  • PvP 保护 (PvP Protection) — 禁用领地内的 PvP
  • 战斗标记 PvP 绕过 (Combat Tag PvP Bypass) — 被积极战斗标记的玩家暂时失去对攻击的领地保护,防止在战斗中滥用安全区
  • 闲置领地自动衰减 (Inactive Claim Auto-Decay) — 自动清理超过配置时长未活跃的玩家的领地,同时为 VIP 和管理员提供豁免选项
  • 载具保护 (Vehicle Protection) — 防止未授权使用和破坏载具
  • 指令屏蔽 (Command Blocking) — 在其他玩家的领地内屏蔽特定指令
  • 荒野保护 (Wilderness Protection) — 启用 wildernessProtection.enabled 标志位反转默认设置:玩家只能在领地内建造/破坏,永远不能在未占领的区块中建造。专为公会/城镇风格服务器设计。

自定义选项

  • 所有者别名 (Owner Alias) — 设置自定义显示名称,以替换 UI 元素、地图钩子和标题中的 Minecraft 用户名
  • 领地颜色 (Claim Colors) — 为你的领地选择自定义十六进制颜色,用于地图和边框显示
  • 可视化模式 (Visualization Modes) — 在显示实体或基于粒子的边界渲染之间切换
  • 进出标题 (Entry/Exit Titles) — 当玩家进入或离开你的领地时显示的自定义 MiniMessage 格式标题
  • 重命名领地 (Rename Claims) — 随时更改你领地的显示名称
  • 完整消息自定义 (Full Message Customization) — 所有插件消息均可通过 Okaeri Configs 进行配置

? 支持的集成

LandClaimPlugin 无缝集成多种流行的服务器插件,提供开箱即用的互联体验。

?️ Web Map Plugins

在服务器的网络地图上直观展示领地!领地将绘制为与所选颜色匹配的多边形,并包含所有者和面积信息。

  • BlueMap
  • Dynmap
  • Squaremap
  • Pl3xMap

⚔️ Combat Tagger Plugins

防止在活跃战斗状态下进行战斗利用和命令滥用。自动检测战斗标记状态:

  • DeluxeCombat
  • CombatLogX
  • PvPManager
  • EternalCombat
  • Claim Protection Bypass: 处于活跃战斗标记状态的玩家无法逃入领地以躲避 PvP 战斗 —— 领地的 PvP 保护对该玩家暂时失效,直到其标记过期(combatTag.combatTagBypass: true)。
  • Command Blocking: 防止被标记的玩家在战斗期间传送或放弃领地。

?️ WorldGuard

尊重 WorldGuard 区域,当玩家尝试圈地时进行检查。

  • Volumetric Intersection Check: 100% 准确的 3D 边界检查,防止玩家在你的出生点或受保护区域上圈地。
  • Gap Enforcement: 可配置的领地与 WorldGuard 区域之间的最小距离要求。
  • Custom Flag Support: 对区域应用自定义 allow-land-claims WorldGuard 状态标志(例如 Wilderness/Warzone),明确允许玩家在区域内圈地,从而覆盖间隙和交叉保护设置!

? Bedrock / Geyser Support

安装 Geyser 2.x 后,基岩版玩家将获得定制的 UI。无硬性 Geyser 依赖 —— 插件使用反射来检测表单 API,如果未安装 Geyser 则回退到仅 Java 版的聊天提示。

  • CustomForm text input 用于基于铁砧的提示(重命名、着色、角色名称)
  • ModalForm confirmation 用于破坏性操作(放弃、取消所有圈地、封禁)
  • 可视化效果会自动切换为粒子模式以适应基岩版客户端

Technical

  • Cloud Command Framework — 异步命令执行,配备专用线程池
  • Modular Architecture — 分离的命令组、监听器和管理器
  • Eager Class Preloading — 消除 GUI 类首次执行时的延迟峰值

? Addons

插件的公共 API (LandClaimAPI) 和事件总线 (ClaimCreateEvent, ClaimDeleteEvent, PlayerEnterClaimEvent, PlayerLeaveClaimEvent) 允许你在同级 Maven 项目中构建独立的附加组件。软依赖 LandClaimPlugin,以确保仅在父插件存在时才加载附加组件。

Official Addons

Addon Description Repository
LandClaimPlugin-Economy 收取圈地、传送点和成员邀请的费用;按区块每日税收并自动取消圈地;全服领地市场 + 带 GUI 浏览器的限时拍卖。基于 Vault。 synkfr/LandClaimPlugin-Eco-Addon

Building Your Own

API 暴露了以下功能:

  • getClaimAt(...), getClaimsByOwner(UUID), getClaimByName(String), getClaimById(UUID)
  • getAllClaimProfiles() — 每个已加载的领地,用于全局迭代(税收、排行榜等)
  • transferClaim(Player actor, UUID profileId, UUID newOwnerId) and unclaimAll(Player actor, UUID profileId) — 编程方式的所有权/领地管理(actor 是新所有者或拥有 landclaim.admin 权限)
  • addBonusBlocks(UUID, int) and getBonusBlocks(UUID) — 用于付费领地块插件
  • isInCombat(Player) — 战斗标记器挂钩接口
  • 完整的领地配置文件模型 — getOwnedChunks(), getRoles(), getTrustedPlayerFlags() 等

对于希望在领地生命周期中采取行动附加组件,请监听 org.ayosynk.landClaimPlugin.api.event.* 事件。


? Installation

  1. 下载最新版本并将 LandClaimPlugin.jar 放入你的 plugins/ 文件夹。
  2. 重启服务器。
  3. 根据需要配置 plugins/LandClaimPlugin/config.yml。

Requirements: Paper 26.2+ | Java 25+


? Commands

所有命令均以 /claim(别名:/c)为基础。

General Commands

Command Description
/claim 圈下你当前所在的区块
/claim radius <1-5> 圈下以当前区块为中心的方形区域区块(例如 1 = 3×3,2 = 5×5)
/claim profiles 打开活动配置文件选择器(如果启用了多配置文件功能)
/claim create <name> 使用给定名称创建一个新的领地配置文件
/claim auto 切换自动圈地模式(行走时自动圈地)
/claim map 获取当前持有的领土地图物品(别名:/claim minimap)
/claim menu 打开主要的领地管理 GUI
/claim info 查看你所在位置领地的信息
/claim visible 切换领地边界可视化
/claim toggle <mode> 切换可视化模式(display_entities, particles, off)
/claim visualization <mode> /claim toggle 的别名
/claim notify 切换进入和离开领地的聊天通知(别名:/claim chatnotify)
/claim rename <name> 重命名你的活动领地配置文件(3-32 个字母数字字符)
/claim color <color> 使用命名颜色或十六进制代码更改领地颜色(例如 red, #FF5500)
/claim unstuck 如果被困住,安全传送到最近的荒野方块
/claim abandon 删除整个活动领地配置文件及其所有区块
/claim pvp <on/off> [time] 在全局范围内切换领地内的 PvP,可选时间持续时间(秒)
/unclaim 取消圈下你当前所在的区块
/unclaim auto 切换自动取消圈地模式(行走时取消你拥有的区块)
/unclaim radius <1-5> 取消方形半径内所有你拥有的区块(例如 1 = 3×3,2 = 5×5)
/unclaim all 取消属于你活动配置文件的所有区块(会提示确认)
/unclaim all confirm 确认取消所有区块

Menu Shortcuts

无需通过主菜单导航,直接跳转到特定的 GUI 面板。

命令 描述
/claim menu settings 打开领地设置(颜色、PvP、可见性等)
/claim menu members 打开成员管理
/claim menu roles 打开角色管理
/claim menu trusted 打开受信任玩家管理
/claim menu visitors 打开访客设置
/claim menu allies 打开盟友管理
/claim menu map 获取手持的领土地图
/claim menu warps 打开传送点管理

管理命令

成员
命令 描述
/claim member invite <player> 邀请一名玩家加入你的领地
/claim member kick <player> 将一名成员从你的领地中移除
/claim member list 列出所有成员及其角色
/claim accept <name> 接受待处理的成员邀请
/claim deny <name> 拒绝待处理的成员邀请
信任
命令 描述
/claim trust invite <player> 向一名玩家发送信任邀请
/claim trust accept 接受待处理的信任邀请
/claim trust deny 拒绝待处理的信任邀请
/claim trust remove <player> 移除受信任的玩家
/claim trust list 列出所有受信任的玩家及其权限标志
盟友
命令 描述
/claim ally invite <name> 向其他领地发送结盟请求
/claim ally accept <name> 接受结盟请求
/claim ally deny <name> 拒绝结盟请求
/claim ally remove <name> 解除现有的联盟关系
传送点与管理员
命令 描述
`/claim setwarp <name> [public private]`
/claim delwarp <name> 删除一个传送点
/claim warp <name> [warpName] 传送至你的传送点,或公共传送点(/claim warp <name> 或 /claim warp <owner>:<name>)
/claim publicwarps 打开服务器范围的公共传送点浏览器 GUI
/claim warps 打开当前领地的传送点管理 GUI
/claim admin check 查看详细的领地信息(所有者 UUID、配置文件名称)
/claim admin unclaim 强制取消你当前所在区块的领地归属
/claim admin edit <player> 打开任意玩家的领地管理 GUI(支持 @p, @s, @r)
/claim admin add chunk <player> <amount> 为玩家的领地上限增加额外的可领取区块 (控制台 & 玩家)。支持选择器(@p, @s, @r, @a)、反向参数顺序(<amount> <player>)以及自我授予(<amount>)。
/claim admin setalias <claim> <alias> 设置或重置所有者的自定义别名 (控制台 & 玩家)
/claim admin trust list <owner> 列出该所有者信任的玩家 (控制台 & 玩家,支持选择器)
/claim admin trust who <player> 列出该玩家受到信任的领地 (控制台 & 玩家,支持选择器)
/claim admin decay run 触发手动扫描以处理不活跃领地的衰减 (控制台 & 玩家)
/claim admin decay exempt <player> [true|false] 切换或设置玩家是否豁免领地衰减 (控制台 & 玩家,支持选择器)
/claim admin decay list 列出所有手动豁免领地衰减的玩家 (控制台 & 玩家)
/claim admin reload 重新加载配置和消息 (控制台 & 玩家)
/claim reload 重新加载配置和消息的快捷方式 (控制台 & 玩家)

? 权限

权限 描述 默认值
landclaim.* 所有 LandClaim 权限 false
landclaim.claim 基本领地领取能力 ✅ true
landclaim.minimap 访问手持领土地图 ✅ true
landclaim.auto 使用自动领取模式 ✅ true
landclaim.admin 管理员命令 & 绕过所有保护 op
landclaim.decay.exempt 使玩家免于自动领地衰减 op
landclaim.update.notify 在加入时接收更新通知 op
landclaim.limit.<n> 覆盖区块领取上限(例如 landclaim.limit.50) false
landclaim.list 列出领地 ✅ true
landclaim.warps.limit.<n> 覆盖传送点上限(例如 landclaim.warps.limit.10) false
landclaim.createrole.<n> 覆盖自定义角色的最大数量 false

? 商店与 NPC 集成 (DeluxeMenus & Citizens 2)

LandClaimPlugin 与 DeluxeMenus 和 Citizens 2 无缝集成,允许玩家使用物品(如金块)或经济货币购买额外的领地区块。

1. DeluxeMenus GUI 商店

在你的 DeluxeMenus 配置中(例如 plugins/DeluxeMenus/gui_menus/claimshop.yml):

menu_title: '&8购买领地区块'
open_command: claimshop
size: 27
items:
  buy_chunk:
    material: GOLD_BLOCK
    slot: 13
    display_name: '&e&l购买 1 个额外区块'
    lore:
      - '&7费用: &630x 金块'
      - '&7你的区块: &a%landclaim_chunks% &7/ &b%landclaim_limit%'
      - ''
      - '&a&l点击 &f以购买 1 个领地区块!'
    left_click_commands:
      - '[console] clear %player_name% gold_block 30'
      - '[console] claim admin add chunk %player_name% 1'
      - '[message] &a成功交易 30 个金块换取 1 个额外领地区块!'
      - '[sound] ENTITY_PLAYER_LEVELUP 1 1'
      - '[refresh]'
    left_click_requirement:
      requirements:
        has_gold_blocks:
          type: has item
          material: GOLD_BLOCK
          amount: 30
      deny_commands:
        - '[message] &c你需要背包中有 30 个金块才能购买此项!'
        - '[sound] BLOCK_ANVIL_LAND 1 1'

2. Citizens 2 NPC 设置

  • 选项 A:将 NPC 链接到 DeluxeMenus(推荐)

    /npc create "Territory Surveyor" --type player
    /npc select
    /npc command add -p "claimshop"
    

    (右键点击该 NPC 将为玩家打开 /claimshop GUI!)

  • 选项 B:直接控制台命令

    /npc select
    /npc command add -c "claim admin add chunk <p> 1"
    

    (Citizens 占位符 <p> 和 Minecraft 实体选择器 @p 均受支持!)

如需完整的设置指南和 Vault 经济系统示例,请参阅我们的 集成文档。


? 披露与透明度声明

为符合平台准则及 Modrinth 披露政策:

? AI 辅助声明

本项目在维护者的直接设计、审查和测试下,使用 AI 辅助(大型语言模型)进行代码起草、重构、优化和文档编写。所有游戏逻辑、安全机制和数据库事务均由人工架构并经过审计。

? 外部网络调用与遥测数据

LandClaimPlugin 会与以下外部端点进行通信:

  • Modrinth API (https://api.modrinth.com):在启动时查询公共 Modrinth v2 API 以检查新版本。仅发送标准的 User-Agent 标头(LandClaimPlugin/{version})。不共享任何玩家或服务器识别数据。退出方式:在 config.yml 中设置 updateChecker.enabled: false。
  • bStats 分析 (https://bstats.org):通过 bStats 收集匿名使用指标(Java 版本、服务器软件、在线玩家数量)。不收集任何个人可识别信息。退出方式:在 plugins/bStats/config.yml 中设置 enabled: false。
  • Redis 与远程 MySQL(可选):仅连接到用户配置的端点,用于跨服务器发布/订阅同步或集中式数据库存储。

? 快速链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源