[feat] add enter-message and cancel-collision settings

Author: xiaomu18

README.md

@@ -1,17 +1,31 @@
 <div align="center">
-<h1>WorldUtils</h1>
-
-[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/StarCodeClub/WorldUtils) [![Version](https://img.shields.io/badge/version-1.3.3--SNAPSHOT-blue.svg)](https://github.com/StarCodeClub/WorldUtils/releases) [![Minecraft](https://img.shields.io/badge/minecraft-1.20.X--latest-green.svg)](https://www.spigotmc.org/) [![Folia](https://img.shields.io/badge/folia-supported-pink)](https://papermc.io/downloads/folia) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+  <h1>WorldUtils</h1>
+
+<div>
+  <a href="https://github.com/StarCodeClub/WorldUtils/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/StarCodeClub/WorldUtils" alt="License" />
+  </a>
+  <a href="https://github.com/StarCodeClub/WorldUtils/actions">
+    <img src="https://img.shields.io/github/actions/workflow/status/StarCodeClub/WorldUtils/build.yml?branch=master" alt="Build status" />
+  </a>
+  <a href="https://github.com/StarCodeClub/WorldUtils/releases">
+    <img src="https://img.shields.io/github/release/StarCodeClub/WorldUtils" alt="latest version" />
+  </a>
+  <a href="https://papermc.io/downloads/folia">
+    <img src="https://img.shields.io/badge/folia-supported-pink" alt="folia supported" />
+  </a>
+  <img src="https://img.shields.io/badge/minecraft-1.20.x--Latest-green.svg" alt="Minecraft version" />
+</div>
 
-<h4>适用于高版本 Paper、Folia 的 Minecraft 服务端的插件，提供许多有关世界的实用功能和设置</h4>
-<h4>Language: 简体中文 | [English](README_en.md)</h4>
+  <h4>适用于高版本 Paper、Folia 的 Minecraft 服务端的插件，提供许多有关世界的实用功能和设置</h4>
+  <h4>Language: 简体中文 | [Switch to English](./README_en.md)</h4>
 </div>
 
 ## ✨ 特性
 
 - **🔧 灵活**：层次化配置系统，支持配置继承，简单明确地完成功能设置
 - **🔒 世界保护**：提供 9 种世界保护
-- **🌍 独立世界属性**: 为每个世界设置单独的 GameMode
+- **🌍 独立世界属性**: 为每个世界调整独立的设置
 - **💬 消息**：支持使用下一代 MiniMessage 格式，ActionBar 提示玩家更加优雅，已做频繁触发优化
 - **⚡ High Performance**：极度轻量，无冗余代码，插件大小仅65KB
 - **🎯 权限系统**：精细的权限控制，支持使用权限绕过特定保护
@@ -45,67 +59,94 @@ mvn clean package
 
 ```yaml
 # 插件前缀 (MiniMessage 格式)
-plugin-prefix: "<shadow:#000000FF><gradient:#ff7300:#ff3c00><b>[WU]</b></gradient></shadow>"
+plugin-prefix: "<gradient:#00eec0:#00c5ff><b>[WU]</b></gradient>"
 
 # 世界配置文件
 configs:
-  # 配置文件必须包含 default 节点，请勿删除！！！
+  # default 为默认配置，同时也是[配置模版]，请勿删除！！！
   default:
-    # 禁止玩家修改世界（放置方块，填充水、岩浆，放置画，修改物品展示框和花盆...）
+    # 阻止玩家修改世界（放置方块，填充水、岩浆，放置画，修改物品展示框和花盆...）
     anti-world-edit: false
-    # 禁止玩家 pvp (玩家互相伤害)
+    # 阻止玩家在此世界进行 PVP (玩家互相伤害)
     anti-pvp: false
-    # 禁止玩家进入世界 (folia 上无法立刻拦截，但于在2s内将会传送至 Fallback World)
+    # 阻止玩家进入该世界 (folia 上无法立刻拦截，但于在2s内将会传送至 Fallback World)
     anti-player-enter: false
     # 如果发现玩家处于禁止进入的世界，将会将玩家传送至该世界出生点
     world-enter-fallback: "world"
-    # 使爆炸在该世界不破坏方块 (EntityExplodeEvent)
+    # 使爆炸在该世界不破坏方块 (仍可造成伤害)
     anti-explosion: false
-    # 禁止玩家与该世界的方块交互 (打开容器，使用工作台等) (PlayerInteractEvent)
+    # 阻止玩家与该世界的方块交互 (打开容器，使用工作台等)
     anti-block-interaction: false
-    # 禁止玩家在此世界使用物品 (丢雪球、鸡蛋，射箭，使用刷怪蛋等)
+    # 阻止玩家在此世界使用物品 (丢雪球、鸡蛋，射箭，使用刷怪蛋，打火石等)
     anti-use-item: false
-    # 禁止玩家攻击该世界的实体 (不包含玩家互相伤害)
+    # 阻止玩家对该世界的实体造成伤害 (不包含玩家互相伤害)
     anti-attack-entity: false
-    # 禁止玩家在该世界与实体交互 (骑乘坐骑，与村民交易等) (onPlayerInteractEntity)
+    # 阻止玩家在该世界与实体交互 (骑乘坐骑，使用栓绳，与村民交易等)
     anti-entity-interaction: false
-    # 禁止玩家在该世界捡起或丢弃物品 (PlayerPickupItemEvent, PlayerDropItemEvent)
+    # 阻止玩家在该世界捡起或丢弃物品
     anti-pickup-drop-items: false
-
-    # 为每个世界切换单独的游戏模式, 设置为空则为不更改
+    # 为世界设置独立的游戏模式 (设置为空则使用默认游戏模式)
     world-gamemode: ""
-    # 强制保持玩家在此世界的游戏模式
-    # 需设置 world-gamemode 才会生效
+    # 是否强制禁止玩家在此世界修改游戏模式
     force-world-gamemode: false
+    # 取消玩家碰撞 (禁止玩家推动该世界的实体使其位置改变), 玩家自身仍可被其他实体推动 (由客户端计算)
+    cancel-player-collision: false
 
-    # 玩家无权限时 ActionBar 显示的提示 (MiniMessage 格式)
+    # 在玩家进入该世界时向玩家发送提示, 设置为空则不发送
+    enter-message:
+      chat-message: ""
+      action-bar: ""
+
+      title: "" # 使用 \n 分隔 title 和 subtitle
+      duration: 2 # 显示持续时间，仅对 Title 起效
+
+    # 玩家无权限时 actionbar 显示的提示 (MiniMessage 格式)
     # 已做频繁触发优化，1s 内只会发送一次, 填空字符串 "" 则不会向玩家发送
-    message:
+    messages:
       anti-world-edit: "{plugin-prefix} <red>你没有权限修改这个世界.</red>"
       anti-pvp: "{plugin-prefix} <red>已禁止在该世界 PVP.</red>"
-      # ... 其他消息
+      anti-player-enter: "{plugin-prefix} <red>你没有权限进入这个世界.</red>"
+      anti-block-interaction: "{plugin-prefix} <red>你没有权限与这个世界的方块交互.</red>"
+      anti-attack-entity: "{plugin-prefix} <red>已禁止对此世界的实体造成伤害.</red>"
+      anti-entity-interaction: "{plugin-prefix} <red>已禁止与此世界的生物交互.</red>"
+      anti-pickup-drop-items: "{plugin-prefix} <red>已禁止在此世界捡起或丢弃物品.</red>"
+      anti-use-item: "{plugin-prefix} <red>已禁止在此世界使用物品.</red>"
+      player-gamemode-change: "{plugin-prefix} <red>游戏模式已与该世界统一</red>"
 
-  # 继承配置示例
   common:
-    parent: default  # 继承 default 配置
-    anti-world-edit: true
+    # 仅需添加你想调整的设置，其他设置默认继承 default
+    # 你也可以手动指定 parent，继承其他配置
+    # parent: default
     anti-explosion: true
 
-  hub-config:
-    parent: common  # 继承 common 配置
+  hub:
+    parent: common
+    # 仅需添加你想在 common 基础上调整的设置
+    anti-world-edit: true
     anti-block-interaction: true
     anti-attack-entity: true
 
+    messages:
+      anti-world-edit: "{plugin-prefix} <red>你不能修改主城的任何方块.</red>"
+
+    enter-message:
+      title: "<b>欢迎来到主城</b>\n<yellow>祝您在此服务器玩的开心！</yellow>"
+      duration: 3
+
+
+
 # 指定哪些世界使用哪个配置
+# 未指定的默认使用 default 配置
+# 指定为 disable 则将在该世界禁用 WorldUtils
 world-config:
-  "world": common        # world 世界使用 common 配置
-  "hub": hub-config      # hub 世界使用 hub-config 配置
-  "world_the_end": disable  # 在此世界禁用 WorldUtils
+  "world": common
+  "hub": hub # 使世界使用 hub 配置
+  "world_the_end": disable
 ```
 
 ### 功能说明
 
-| 保护类型                      | 说明        | 涵盖事件                    | Folia 支持                         |
+| 保护类型                      | 描述        | 涵盖事件                    | Folia 支持                         |
 |---------------------------|-----------|-------------------------|----------------------------------|
 | `anti-world-edit`         | 禁止修改世界    | 禁止方块放置/破坏、桶操作、画/物品展示框交互 | 完整支持✅                            |
 | `anti-pvp`                | 禁止玩家之间战斗  | 取消玩家间伤害                 | 完整支持✅                            |
@@ -117,6 +158,7 @@ world-config:
 | `anti-pickup-drop-items`  | 禁止丢弃/拿取物品 | 禁止玩家在该世界捡起或丢弃物品         | 完整支持✅                            |
 | `anti-use-item`           | 禁止使用物品    | 拦截丢雪球、鸡蛋，射箭，使用刷怪蛋等      | 完整支持✅                            |
 | `world-gamemode`          | 独立世界游戏模式  | 切换世界时更改游戏模式             | 完整支持✅                            |
+| `cancel-player-collision` | 取消玩家碰撞    | 禁止玩家推动该世界的实体使其位置改变      | 完整支持✅                            |
 
 ## 🎮 命令与权限
 
@@ -146,7 +188,8 @@ world-config:
 - `wu.bypass.<world>.anti-entity-interaction` - 绕过指定世界的实体交互保护
 - `wu.bypass.<world>.anti-pickup-drop-items` - 绕过指定世界的丢弃/拿取物品保护
 - `wu.bypass.<world>.anti-use-item` - 绕过指定世界的使用物品保护
-- `wu.bypass.change-gamemode` - 拥有次权限 WU 将不会修改您的游戏模式
+- `wu.bypass.change-gamemode` - 拥有此权限 WU 将不会修改您的游戏模式
+- `wu.bypass.cancel-player-collision` - 拥有此权限 WU 将不会调整您的碰撞效果
 ---
 
 如果您遇到问题或有功能建议，请在 [GitHub Issues](https://github.com/StarCodeClub/WorldUtils/issues) 提交。