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