1.0.0
This commit is contained in:
xiaobai
255
README.md
Normal file
255
README.md
Normal file
@@ -0,0 +1,255 @@
|
|||||||
|
# PlayerBlockLife
|
||||||
|
|
||||||
|
## English Version
|
||||||
|
|
||||||
|
### 🎮 Introduction
|
||||||
|
PlayerBlockLife is a unique Minecraft plugin that adds a novel gameplay mechanic to servers. Each player has 5 life blocks buried underground, which use the player's skin as their texture. When other players dig up all these blocks, the player dies.
|
||||||
|
|
||||||
|
### ✨ Features
|
||||||
|
- 🎭 Uses player skins as block textures
|
||||||
|
- ⚡ Real-time skin loading without pre-generation
|
||||||
|
- 🔄 Asynchronous data processing for optimal performance
|
||||||
|
- 📊 Complete health system and status effects
|
||||||
|
- 🎯 Beautiful particle effects and sounds
|
||||||
|
- 🔧 Highly configurable game rules
|
||||||
|
- 🗺️ Multi-world and region protection support
|
||||||
|
- 💾 Multiple data storage options
|
||||||
|
- 👨💼 Comprehensive admin tools
|
||||||
|
|
||||||
|
### 🚀 Quick Start
|
||||||
|
|
||||||
|
#### Installation
|
||||||
|
1. Download the plugin from the ./Releases folder
|
||||||
|
2. Place the JAR file in your server's `plugins` folder
|
||||||
|
3. Restart your server
|
||||||
|
|
||||||
|
#### Player Commands
|
||||||
|
```bash
|
||||||
|
# Set your life blocks
|
||||||
|
/setlifeblocks
|
||||||
|
|
||||||
|
# View block locations
|
||||||
|
/checklifeblocks
|
||||||
|
|
||||||
|
# Reset block positions
|
||||||
|
/setlifeblocks reset
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Admin Commands
|
||||||
|
```bash
|
||||||
|
# Reload configuration
|
||||||
|
/pblreload
|
||||||
|
|
||||||
|
# Delete player blocks
|
||||||
|
/pbldelete <playername>
|
||||||
|
|
||||||
|
# Revive eliminated player
|
||||||
|
/pblrevive [playername]
|
||||||
|
|
||||||
|
# View plugin statistics
|
||||||
|
/pblstats
|
||||||
|
|
||||||
|
# Set blocks for other player
|
||||||
|
/setlifeblocks other <playername>
|
||||||
|
```
|
||||||
|
|
||||||
|
### ⚙️ Configuration
|
||||||
|
The plugin configuration is located at `plugins/PlayerBlockLife/config.yml`. Key sections include:
|
||||||
|
- **blocks**: Block-related settings
|
||||||
|
- **game**: Game rules and mechanics
|
||||||
|
- **skin**: Skin system configuration
|
||||||
|
- **storage**: Data storage options
|
||||||
|
- **messages**: Customizable messages
|
||||||
|
- **effects**: Visual and audio effects
|
||||||
|
- **protection**: Protection and security settings
|
||||||
|
|
||||||
|
### 🛠️ Building from Source
|
||||||
|
If you want to build the plugin yourself:
|
||||||
|
|
||||||
|
#### Prerequisites
|
||||||
|
- Java 17 or higher
|
||||||
|
- Gradle 8.7 or higher
|
||||||
|
- IntelliJ IDEA (recommended) or another Java IDE
|
||||||
|
|
||||||
|
#### Build Steps
|
||||||
|
1. Clone or download the source code
|
||||||
|
2. Open the project in IntelliJ IDEA
|
||||||
|
3. Wait for Gradle to sync dependencies
|
||||||
|
4. Run the `shadowJar` task in the Gradle panel
|
||||||
|
5. The compiled JAR will be in `build/libs/`
|
||||||
|
|
||||||
|
### 📦 Releases
|
||||||
|
Pre-compiled versions are available in the ./Releases folder. We recommend downloading from there for stable builds.
|
||||||
|
|
||||||
|
### 🎯 Gameplay
|
||||||
|
|
||||||
|
#### Basic Rules
|
||||||
|
1. Each player starts with 5 life blocks
|
||||||
|
2. Blocks are buried underground near the player's location
|
||||||
|
3. Blocks use the player's skin as their texture
|
||||||
|
4. Other players can dig up these blocks
|
||||||
|
5. When all blocks are dug up, the player dies
|
||||||
|
6. Players can move freely while their blocks remain
|
||||||
|
|
||||||
|
#### Strategies
|
||||||
|
- 🎮 Hide your blocks in hard-to-find locations
|
||||||
|
- 🔍 Search for other players' blocks
|
||||||
|
- ⚔️ Form alliances or engage in competition
|
||||||
|
- 🏃 Keep moving to avoid being tracked
|
||||||
|
- 🎯 Target the most threatening players first
|
||||||
|
|
||||||
|
### 🐛 Troubleshooting
|
||||||
|
|
||||||
|
#### Common Issues
|
||||||
|
1. **Skins not loading**
|
||||||
|
- Check network connectivity
|
||||||
|
- Ensure players have been online before
|
||||||
|
- Verify skin cache directory permissions
|
||||||
|
|
||||||
|
2. **Blocks not placing**
|
||||||
|
- Ensure there's enough space around
|
||||||
|
- Check world protection settings
|
||||||
|
- Review console error messages
|
||||||
|
|
||||||
|
3. **Plugin not loading**
|
||||||
|
- Verify Java version compatibility
|
||||||
|
- Check server version matches
|
||||||
|
- Ensure dependencies are complete
|
||||||
|
|
||||||
|
### 🤝 Contributing
|
||||||
|
We welcome contributions! Please:
|
||||||
|
1. Fork the repository
|
||||||
|
2. Create a feature branch
|
||||||
|
3. Make your changes
|
||||||
|
4. Submit a pull request
|
||||||
|
|
||||||
|
### 📄 License
|
||||||
|
This project is licensed under the MIT License. See the LICENSE file for details.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 中文版本
|
||||||
|
|
||||||
|
### 🎮 简介
|
||||||
|
PlayerBlockLife 是一个独特的Minecraft插件，为服务器增加了一种新颖的游戏玩法。每个玩家拥有5个生命方块，这些方块埋藏在地下，并使用玩家的皮肤作为材质。当其他玩家挖完这些方块时，该玩家就会死亡。
|
||||||
|
|
||||||
|
### ✨ 特色功能
|
||||||
|
- 🎭 使用玩家皮肤作为方块材质
|
||||||
|
- ⚡ 实时皮肤加载，无需预生成
|
||||||
|
- 🔄 异步数据处理，不影响服务器性能
|
||||||
|
- 📊 完整的生命值系统和状态效果
|
||||||
|
- 🎯 精美的粒子效果和音效
|
||||||
|
- 🔧 高度可配置的游戏规则
|
||||||
|
- 🗺️ 支持多世界和地区保护
|
||||||
|
- 💾 多种数据存储方式
|
||||||
|
- 👨💼 完善的管理员工具
|
||||||
|
|
||||||
|
### 🚀 快速开始
|
||||||
|
|
||||||
|
#### 安装方法
|
||||||
|
1. 从./Releases文件夹下载插件
|
||||||
|
2. 将JAR文件放入服务器的`plugins`文件夹
|
||||||
|
3. 重启服务器
|
||||||
|
|
||||||
|
#### 玩家命令
|
||||||
|
```bash
|
||||||
|
# 设置你的生命方块
|
||||||
|
/setlifeblocks
|
||||||
|
|
||||||
|
# 查看方块位置
|
||||||
|
/checklifeblocks
|
||||||
|
|
||||||
|
# 重置方块位置
|
||||||
|
/setlifeblocks reset
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 管理员命令
|
||||||
|
```bash
|
||||||
|
# 重载配置
|
||||||
|
/pblreload
|
||||||
|
|
||||||
|
# 删除玩家方块
|
||||||
|
/pbldelete <玩家名>
|
||||||
|
|
||||||
|
# 复活被淘汰的玩家
|
||||||
|
/pblrevive [玩家名]
|
||||||
|
|
||||||
|
# 查看插件统计
|
||||||
|
/pblstats
|
||||||
|
|
||||||
|
# 为其他玩家设置方块
|
||||||
|
/setlifeblocks other <玩家名>
|
||||||
|
```
|
||||||
|
|
||||||
|
### ⚙️ 配置说明
|
||||||
|
插件配置文件位于 `plugins/PlayerBlockLife/config.yml`。主要配置项包括：
|
||||||
|
- **blocks**: 方块相关设置
|
||||||
|
- **game**: 游戏规则和机制
|
||||||
|
- **skin**: 皮肤系统配置
|
||||||
|
- **storage**: 数据存储选项
|
||||||
|
- **messages**: 可自定义的消息
|
||||||
|
- **effects**: 视觉和音频效果
|
||||||
|
- **protection**: 保护和安全性设置
|
||||||
|
|
||||||
|
### 🛠️ 从源码构建
|
||||||
|
如果你想自己构建插件：
|
||||||
|
|
||||||
|
#### 环境要求
|
||||||
|
- Java 17 或更高版本
|
||||||
|
- Gradle 8.7 或更高版本
|
||||||
|
- IntelliJ IDEA（推荐）或其他Java IDE
|
||||||
|
|
||||||
|
#### 构建步骤
|
||||||
|
1. 克隆或下载源代码
|
||||||
|
2. 在IntelliJ IDEA中打开项目
|
||||||
|
3. 等待Gradle同步依赖
|
||||||
|
4. 在Gradle面板中运行 `shadowJar` 任务
|
||||||
|
5. 编译后的JAR文件位于 `build/libs/`
|
||||||
|
|
||||||
|
### 📦 发布版本
|
||||||
|
预编译的版本可以在 ./Releases 文件夹中找到。我们建议从这里下载以获得稳定版本。
|
||||||
|
|
||||||
|
### 🎯 游戏玩法
|
||||||
|
|
||||||
|
#### 基本规则
|
||||||
|
1. 每个玩家初始有5个生命方块
|
||||||
|
2. 方块埋藏在玩家位置附近的地下
|
||||||
|
3. 方块使用玩家的皮肤作为材质
|
||||||
|
4. 其他玩家可以挖掘这些方块
|
||||||
|
5. 当所有方块被挖光时，玩家死亡
|
||||||
|
6. 玩家在方块未被挖完时可以自由移动
|
||||||
|
|
||||||
|
#### 策略技巧
|
||||||
|
- 🎮 将方块隐藏在难以找到的地方
|
||||||
|
- 🔍 寻找其他玩家的方块
|
||||||
|
- ⚔️ 与其他玩家结盟或对抗
|
||||||
|
- 🏃 保持移动，避免被追踪
|
||||||
|
- 🎯 优先攻击威胁最大的玩家
|
||||||
|
|
||||||
|
### 🐛 故障排除
|
||||||
|
|
||||||
|
#### 常见问题
|
||||||
|
1. **皮肤无法加载**
|
||||||
|
- 检查网络连接
|
||||||
|
- 确保玩家之前在线过
|
||||||
|
- 检查皮肤缓存目录权限
|
||||||
|
|
||||||
|
2. **方块无法放置**
|
||||||
|
- 确保周围有足够空间
|
||||||
|
- 检查世界保护设置
|
||||||
|
- 查看控制台错误信息
|
||||||
|
|
||||||
|
3. **插件无法加载**
|
||||||
|
- 确认Java版本兼容性
|
||||||
|
- 检查服务器版本匹配
|
||||||
|
- 确保依赖完整
|
||||||
|
|
||||||
|
### 🤝 贡献指南
|
||||||
|
我们欢迎贡献！请按以下步骤：
|
||||||
|
1. Fork 代码仓库
|
||||||
|
2. 创建功能分支
|
||||||
|
3. 进行修改
|
||||||
|
4. 提交拉取请求
|
||||||
|
|
||||||
|
### 📄 许可证
|
||||||
|
本项目采用 MIT 许可证。详见 LICENSE 文件。
|
||||||
24
REDME.md
24
REDME.md
@@ -1,24 +0,0 @@
|
|||||||
# PlayerBlockLife 插件
|
|
||||||
|
|
||||||
## 🎮 简介
|
|
||||||
PlayerBlockLife 是一个独特的Minecraft插件，为服务器增加了一种新颖的游戏玩法。每个玩家拥有5个生命方块，这些方块埋藏在地下，并使用玩家的皮肤作为材质。当其他玩家挖完这些方块时，该玩家就会死亡。
|
|
||||||
|
|
||||||
## ✨ 特色功能
|
|
||||||
- 🎭 使用玩家皮肤作为方块材质
|
|
||||||
- ⚡ 实时皮肤加载，无需预生成
|
|
||||||
- 🔄 异步数据处理，不影响服务器性能
|
|
||||||
- 📊 完整的生命值系统和状态效果
|
|
||||||
- 🎯 精美的粒子效果和音效
|
|
||||||
- 🔧 高度可配置的游戏规则
|
|
||||||
- 🗺️ 支持多世界和地区保护
|
|
||||||
- 💾 多种数据存储方式
|
|
||||||
- 👨💼 完善的管理员工具
|
|
||||||
|
|
||||||
## 🚀 快速开始
|
|
||||||
|
|
||||||
### 1. 安装插件
|
|
||||||
1. 下载插件JAR文件
|
|
||||||
2. 放入服务器的`plugins`文件夹
|
|
||||||
3. 重启服务器
|
|
||||||
|
|
||||||
### 2. 玩家操作
|
|
||||||
Reference in New Issue
Block a user