# LiteCommandEditor

**Repository Path**: theredcreative/lite-command-editor

## Basic Information

- **Project Name**: LiteCommandEditor
- **Description**: 这里是Spigot & Bukkit 服务端插件“LiteCommandEditor”的中文仓库，
在这里你可以查看本插件的介绍、使用方法，访问wiki等，
希望本页面能够帮助到你使用此插件。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2023-10-15
- **Last Updated**: 2024-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 什么是 LiteCommandEditor
LiteCommandEditor，又称“轻量命令编辑器”，是一款用于管理命令、自由创建与编辑命令的插件。不需要对编程或者脚本语言有一定了解，配置文件编辑难度约等于编辑一个箱子界面的自定义菜单，只要根据插件的帮助和Wiki中的说明，即可在服务器中创建一个符合自己功能需要的新命令。
命令本身可以是中文字符，支持一个配置文件创建多个功能相同名字不同的命令，命令执行器可以有无限层子命令函数/功能，执行触发效果除了最基本的发送消息、执行其他命令、播放声音等，还支持使用部分根据BukkitAPI进行预设后的玩家函数、世界函数等。
除了自定义命令执行器这个主要功能，插件还有其他的辅助功能，例如设置简易命令（命令别名）、隐藏或删除服务器上的命令（甚至可以删掉/op、/stop等系统级命令）等。

## 插件前置
- Java8或更高版本的运行环境
- PlaceholderAPI（可选）

---

### 创建一个新的自定义命令：[**点击这里开始**](https://gitee.com/theredcreative/lite-command-editor/wikis/基本配置文档)

---

## 插件功能

### 自定义命令（主要功能）
**通过一个简单的YAML配置文件，就可以实现以下功能:**
- 基本命令参数：命令前缀、命令名字、命令别名、权限、使用帮助等
- **命令执行器**（策略可自定义，命令函数/功能可无限嵌套）
  - **函数功能**:
    - 发送消息 `Messages`
    - 发送广播 `Broadcast`
    - 执行命令 `Commands`
    - 给予物品 `Reward-Items`
    - 取走物品 `Take-Items`
    - 跨服传送 `Server-Teleport` （需要BungeeCord或Velocity）
    - 标题消息 `Titles` （需要是玩家执行命令）
    - 动作栏消息 `Action-Bars` （需要是玩家执行命令）
    - 播放声音 `Sounds` （需要是玩家执行命令）
    - 设置占位符 `Set-Placeholders` （存入或删除一个可在其他函数运行时使用的占位符）
    - 更多玩家函数 `Player-Functions` （基于BukkitAPI提供的更多以某个玩家为实例的函数/功能）
    - 更多世界函数 `World-Functions` （基于BukkitAPI提供的更多以某个世界为实例的函数/功能）
    - 复合函数 `Compound-Functions` （将多个**函数功能**打包在一个列表中顺序运行）
    - 子函数模块 `Functions` （也就是将本函数作为母函数，继续往下进行子函数嵌套）
	- *更多的函数功能等待添加...*
  - **函数属性**:
    - 结束函数遍历 `Break`
    - 函数触发权限 `Permission` 
    - 函数优先级 `Priority`
    - 函数执行顺序 `Sequence`
    - 函数触发条件 `Conditions`
	  - 比较对象 `Comparison`
	  - 拥有物品 `HasItem`
	  - 拥有权限 `Permission`
	  - 存在占位符 `HasPlaceholder`
	  - 玩家属性 `Player` （BukkitAPI提供的更多以某个玩家为实例的属性状态）
	  - 世界属性 `World` （BukkitAPI提供的更多以某个玩家为实例的属性状态）
	  - *更多的预设条件等待添加...*
- **TAB填充器**（策略可自定义，配方函数/功能可无限嵌套）
  - *执行完所有函数后，将返回其所有配方的合并结果作为本次的自动填充内容*
  - **函数功能**:
    - 自动填充的配方 `Recipes`
	  - 固定文字 `Text` （也可以是占位符/变量）
	  - 在线玩家名字 `Players` （支持正则表达式筛选）
	  - 物品ID `Items` （支持正则表达式筛选）
	  - 声音ID `Sounds` （支持正则表达式筛选）
	  - 指定命令 `Commands` （即继承某个命令的TAB填充结果） 
	  - *更多的预设配方等待添加...*
	- 例外的配方内容 `Exceptions` （配方中存在相同的内容将被移除，使用方法同上）
    - 子函数模块 `Functions` （也就是将本函数作为母函数，继续往下进行子函数嵌套）
  - **函数属性**:
    - 函数使用权限 `Permission` 
    - 结束函数遍历 `Break`
    - 函数触发条件 `Conditions`
	  - 比较对象 `Comparison`
	  - 拥有物品 `HasItem`
	  - 拥有权限 `Permission`
	  - 存在占位符 `HasPlaceholder`
	  - 玩家属性 `Player` （BukkitAPI提供的更多以某个玩家为实例的属性状态）
	  - 世界属性 `World` （BukkitAPI提供的更多以某个玩家为实例的属性状态）
	  - *更多的预设条件等待添加...*
- 自定义JSON消息组件（相当于内置在命令配置文件里的JSON组件设置选项，用于区分插件的JSON组件与本命令配置文件的JSON组件）
> JSON元件是一种作用于聊天栏上的功能型文本，例如鼠标悬停在文本时显示的窗口、点击文本执行命令等。
- 物品收藏夹（可以在游戏里使用命令进行添加，也可以直接自定义一个物品的参数与属性）
> 添加到收藏夹的物品，可以根据你为其定义的名字（不是显示在物品上的名字）将其使用在一些与物品ID有关的设置中。
- *更多的命令配置文件功能等待添加...*

### 其他功能
- 管理、列出、查看、删除指定的命令执行器（可以删除其他插件或者系统命令，如/op、/plugins、甚至是/stop）
- 命令别名/简易命令设置（创建一个新的命令，将其指向某个现有的命令或其子命令）
- 命令冷却设置（对其他插件的命令也能够生效，支持为子命令添加冷却）
- 支持使用PlaceholderAPI的占位符/变量
- 自定义JSON消息组件（可在插件的部分语言配置文件、自定义命令配置文件中通过一个占位符/变量进行调用）
- 调试模式（追踪并记录自定义命令的函数运行情况，并反馈给管理员）
- 热加载、卸载自定义命令配置文件
- 物品收藏夹（将手上物品序列化保存到配置文件中以方便在自定义命令配置文件中直接使用该物品的NBT等数据）
- *还有许多小功能...*
---

### 插件命令
|命令（主命令为 /litecommandeditor 或 /lce） |功能 
|:- |:- 
|/litecommandeditor reload |重载所有配置文件 
|/litecommandeditor info |查看某个命令的信息 
|/litecommandeditor load |加载某个命令配置文件 
|/litecommandeditor unload |卸载某个命令配置文件 
|/litecommandeditor delete |删除一个命令
|/litecommandeditor itemcollection |管理命令配置文件的物品收藏夹 
|/litecommandeditor debug |调试模式综合命令 
|/litecommandeditor list |列出所有由本插件加载的命令 
|/litecommandeditor listall |列出本服务器所有已启用的命令 

---
[![BigImage](https://bstats.org/signatures/bukkit/LiteCommandEditor.svg)](https://bstats.org/plugin/bukkit/LiteCommandEditor/16521)