CreativeRequests 插件
适用于 Minecraft 1.21.4 的 Paper 插件,允许玩家申请创造模式,管理员可以通过直观的命令系统进行批准或拒绝。
功能
- 玩家请求系统:玩家可以申请创造模式,并可选择提供理由
- 加入消息:玩家加入时,会收到关于创造模式请求的相关信息
- 管理员管理:管理员可以通过简单的命令查看、批准和拒绝请求
- 增强的列表命令:可以查看待处理、已批准、已拒绝或所有请求的详细历史记录
- 持久化存储:所有请求均保存至 YAML 文件中,确保服务器重启后数据不丢失
- 可配置设置:通过 config.yml 自定义插件行为
- 基于权限:安全的权限系统以控制访问
- 现代 Adventure API:使用最新的 Minecraft 文本组件实现丰富的格式化效果
安装
- 下载
CreativeRequests-x.y.z.jar 文件
- 将其放入你的 Paper 1.21.4 服务器的
plugins/ 文件夹中
- 启动或重启服务器
- 为球员和管理员配置权限
- (可选)编辑生成的位于
plugins/CreativeRequests/ 中的 config.yml 文件
命令
玩家使用
/request creative [reason]
- 描述:向管理员申请创造模式
- 权限:
creativerequests.request(默认:true)
- 用法示例:
/request creative - 无理由申请创造模式
/request creative Building a new spawn area - 附带特定理由申请
- 注意:
- 已经在创造模式下的玩家无法发起请求
- 每个玩家只能有一个待处理的请求
- 除非另有配置,否则理由是可选的
管理员/工作人员使用
/requests [list [type]]
- 描述:按类型查看创造模式请求
- 权限:
creativerequests.admin(默认:op)
- 用法示例:
/requests - 查看所有待处理请求(默认)
/requests list - 查看所有待处理请求
/requests list pending - 仅查看待处理请求
/requests list approved - 仅查看已批准请求
/requests list denied - 仅查看已拒绝请求
/requests list all - 查看所有请求(包括待处理、已批准和已拒绝)
- 显示内容:玩家名称、理由(如果提供)、时间戳以及每个请求的操作日期
/requests approve <player>
- 描述:批准玩家的创造模式请求
- 权限:
creativerequests.admin(默认:op)
- 用法示例:
/requests approve Steve
- 效果:
- 将玩家设置为创造模式
- 从待处理列表中移除该请求
- 通知玩家其请求已被批准
- 安排自动返回生存模式(如果已配置)
/requests deny <player>
- 描述:拒绝玩家的创造模式请求
- 权限:
creativerequests.admin(默认:op)
- 用法示例:
/requests deny Steve
- 效果:
权限
| 权限 |
描述 |
默认值 |
creativerequests.request |
允许玩家申请创造模式 |
true |
creativerequests.admin |
允许管理创造模式请求 |
op |
配置
插件会在 plugins/CreativeRequests/ 目录下生成一个 config.yml 文件,包含以下选项:
# 当有新请求时通知在线管理员
notify-admins: true
# 要求玩家在请求时提供理由
allow-reason: true
# 在自动返回生存模式之前的持续时间(分钟)(0 = 永不)
creative-duration: 60
配置选项说明
- notify-admins:当值为
true 时,所有拥有管理员权限的在线工作人员将在玩家提出新请求时收到通知
- allow-reason:当值为
true 时,玩家可以提供可选的理由;当值为 false 时,则必须提供理由
- creative-duration:自动将已批准的玩家切换回生存模式前的分钟数。设置为
0 可禁用自动切换
文件结构
插件会创建以下文件:
plugins/CreativeRequests/
├── config.yml # 插件配置
└── requests.yml # 存储的待处理请求(自动生成)
工作流程示例
-
玩家加入服务器:
Welcome! Need creative mode? Use /request creative to get creative!
-
玩家发起请求:
Player: /request creative Building a castle for the community
System: ✅ Your creative mode request has been submitted!
-
管理员收到通知(如果启用):
[Admin] Steve has requested creative mode: Building a castle for the community
-
管理员审查请求:
Admin: /requests
System: === Pending Creative Requests ===
Steve: Building a castle for the community (2 minutes ago)
Admin: /requests list approved
System: === Approved Creative Requests ===
Alex: Building spawn area (approved 1 hour ago)
Admin: /requests list all
System: === ALL CREATIVE MODE REQUESTS ===
[Shows pending, approved, and denied requests]
-
管理员批准请求:
Admin: /requests approve Steve
System: ✅ Steve's creative mode request has been approved
Player receives: ✅ Your creative mode request has been approved!
-
自动返回生存模式(如果已配置):
After 60 minutes: Steve has been returned to survival mode
故障排除
常见问题
玩家无法使用 /request creative
- 检查他们是否拥有
creativerequests.request 权限
- 确保他们尚未处于创造模式
- 验证他们是否已有待处理的请求
管理员无法查看或管理请求
- 验证他们是否拥有
creativerequests.admin 权限
- 使用
/requests 检查是否存在实际的待处理请求
插件未加载
- 确保你正在运行 Paper 1.21.4 或兼容版本
- 检查服务器控制台是否有错误消息
- 确认插件 JAR 文件位于正确的
plugins/ 文件夹中
支持
如有问题、建议或贡献:
- 在项目仓库中创建 Issue
- 联系 SkyeNetwork 团队
技术详情
- Minecraft 版本: 1.21.4+
- 服务端软件: Paper(必需)
- Java 版本: 21+
- API 版本: 1.21
- 依赖项: 无(仅使用 Paper API)
作者
版本
当前版本:1.2.0
本插件是为 SkyeNetwork 服务器社区而创建的。
CreativeRequests Plugin
A Paper plugin for Minecraft 1.21.4 that allows players to request creative mode, which staff members can approve or deny through an intuitive command system.
Features
- Player Request System: Players can request creative mode with optional reasoning
- Join Message: Players are welcomed with information about creative requests when they join
- Admin Management: Staff can view, approve, and deny requests through simple commands
- Enhanced List Command: View pending, approved, denied, or all requests with detailed history
- Persistent Storage: All requests are saved to YAML files for persistence across server restarts
- Configurable Settings: Customize plugin behavior through config.yml
- Permission-Based: Secure permission system to control access
- Modern Adventure API: Uses the latest Minecraft text components for rich formatting
Installation
- Download the
CreativeRequests-x.y.z.jar file
- Place it in your Paper 1.21.4 server's
plugins/ folder
- Start or restart your server
- Configure permissions for your players and staff
- Optionally edit the generated
config.yml file in plugins/CreativeRequests/
Commands
For Players
/request creative [reason]
- Description: Request creative mode from staff
- Permission:
creativerequests.request (default: true)
- Usage Examples:
/request creative - Request creative mode without a reason
/request creative Building a new spawn area - Request with a specific reason
- Notes:
- Players already in creative mode cannot make requests
- Only one pending request per player is allowed
- Reasons are optional unless configured otherwise
For Staff/Admins
/requests [list [type]]
- Description: View creative mode requests by type
- Permission:
creativerequests.admin (default: op)
- Usage Examples:
/requests - View all pending requests (default)
/requests list - View all pending requests
/requests list pending - View only pending requests
/requests list approved - View only approved requests
/requests list denied - View only denied requests
/requests list all - View all requests (pending, approved, and denied)
- Shows: Player name, reason (if provided), timestamp, and action dates for each request
/requests approve <player>
- Description: Approve a player's creative mode request
- Permission:
creativerequests.admin (default: op)
- Usage Example:
/requests approve Steve
- Effect:
- Sets the player to creative mode
- Removes the request from pending list
- Notifies the player of approval
- Schedules automatic return to survival mode (if configured)
/requests deny <player>
- Description: Deny a player's creative mode request
- Permission:
creativerequests.admin (default: op)
- Usage Example:
/requests deny Steve
- Effect:
- Removes the request from pending list
- Notifies the player of denial
Permissions
| Permission |
Description |
Default |
creativerequests.request |
Allows players to request creative mode |
true |
creativerequests.admin |
Allows managing creative mode requests |
op |
Configuration
The plugin generates a config.yml file in plugins/CreativeRequests/ with the following options:
# Notify online admins when a new request is made
notify-admins: true
# Require players to provide a reason for their request
allow-reason: true
# Duration in minutes before automatically returning to survival mode (0 = never)
creative-duration: 60
Configuration Options
- notify-admins: When
true, all online staff members with admin permissions will be notified when a player makes a new request
- allow-reason: When
true, players can optionally provide a reason. When false, reasons are required
- creative-duration: Number of minutes before automatically switching approved players back to survival mode. Set to
0 to disable automatic switching
File Structure
The plugin creates the following files:
plugins/CreativeRequests/
├── config.yml # Plugin configuration
└── requests.yml # Stored pending requests (auto-generated)
Workflow Example
-
Player joins the server:
Welcome! Need creative mode? Use /request creative to get creative!
-
Player makes a request:
Player: /request creative Building a castle for the community
System: ✅ Your creative mode request has been submitted!
-
Admin receives notification (if enabled):
[Admin] Steve has requested creative mode: Building a castle for the community
-
Admin reviews requests:
Admin: /requests
System: === Pending Creative Requests ===
Steve: Building a castle for the community (2 minutes ago)
Admin: /requests list approved
System: === Approved Creative Requests ===
Alex: Building spawn area (approved 1 hour ago)
Admin: /requests list all
System: === ALL CREATIVE MODE REQUESTS ===
[Shows pending, approved, and denied requests]
-
Admin approves the request:
Admin: /requests approve Steve
System: ✅ Steve's creative mode request has been approved
Player receives: ✅ Your creative mode request has been approved!
-
Automatic return to survival (if configured):
After 60 minutes: Steve has been returned to survival mode
Troubleshooting
Common Issues
Players can't use /request creative
- Check that they have the
creativerequests.request permission
- Ensure they're not already in creative mode
- Verify they don't have a pending request already
Admins can't see or manage requests
- Verify they have the
creativerequests.admin permission
- Check that there are actually pending requests with
/requests
Plugin not loading
- Ensure you're running Paper 1.21.4 or compatible
- Check the server console for any error messages
- Verify the plugin JAR is in the correct
plugins/ folder
Support
For issues, suggestions, or contributions:
- Create an issue on the project repository
- Contact the SkyeNetwork Team
Technical Details
- Minecraft Version: 1.21.4+
- Server Software: Paper (required)
- Java Version: 21+
- API Version: 1.21
- Dependencies: None (uses Paper API only)
Authors
- NobleSkye
- SkyeNetwork Team
Version
Current version: 1.2.0
This plugin was created for the SkyeNetwork server community.
评论 0
登录后参与评分
还没有评论,来抢沙发吧