5 Commits

Author SHA1 Message Date
33ca8abd2a fix: 修复模块加载并调整构建以兼容 Paper 26.1.2 2026-04-22 03:27:19 +08:00
1863d04c65 fix: use inventory holders for menus and rework shulker box handling 2026-04-22 00:35:57 +08:00
22708cf75d Merge branch 'main' into dev-26.1 2026-04-21 17:31:52 +08:00
505c59fb68 docs(readme): 添加项目完整文档和使用指南
- 创建了详细的 README.md 文件介绍 EssentialsC 插件
- 添加了核心特性和功能方块使用说明
- 包含了安装步骤和系统要求文档
- 提供了完整的命令列表和权限节点说明
- 添加了配置文件说明和多语言支持介绍
- 包含了从源码构建和贡献指南信息
2026-04-21 17:24:17 +08:00
Coldsmile_7
29c456d4bd 更新项目配置和新增功能 2026-04-21 16:20:12 +08:00
23 changed files with 1854 additions and 497 deletions

13
.gitignore vendored
View File

@@ -13,20 +13,9 @@
*.tar.gz *.tar.gz
*.rar *.rar
# Maven
target/
pom.xml.tag
pom.xml.releaseBackup
pom.xml.versionsBackup
pom.xml.next
release.properties
dependency-reduced-pom.xml
buildNumber.properties
.mvn/timing.properties
.mvn/wrapper/maven-wrapper.jar
# Gradle # Gradle
.gradle/ .gradle/
.gradle-user-home/
build/ build/
!gradle-wrapper.jar !gradle-wrapper.jar
!**/src/main/**/build/ !**/src/main/**/build/

View File

@@ -18,9 +18,9 @@
- **织布机** (`/loom`) - **织布机** (`/loom`)
- **锻造台** (`/smithingtable`, `/st`) - **锻造台** (`/smithingtable`, `/st`)
- **切石机** (`/stonecutter`, `/sc`) - **切石机** (`/stonecutter`, `/sc`)
- **末影箱** (`/enderchest`, `/ec`)
### 📦 智能容器管理 ### 📦 智能容器管理
- **末影箱** (`/enderchest`, `/ec`) - 参考 EssentialsX 实现100% 数据安全
- **潜影盒快捷打开** - 潜行+右键直接打开(类似 CMI - **潜影盒快捷打开** - 潜行+右键直接打开(类似 CMI
- ✅ 支持自定义标题(可配置) - ✅ 支持自定义标题(可配置)
- ✅ 防刷物品机制(快照验证 + 数量检查) - ✅ 防刷物品机制(快照验证 + 数量检查)
@@ -167,10 +167,10 @@ essentialsc.* # 所有权限
```bash ```bash
git clone https://github.com/Coldsmiles/EssentialsC.git git clone https://github.com/Coldsmiles/EssentialsC.git
cd EssentialsC cd EssentialsC
mvn clean package ./gradlew build
``` ```
编译后的文件位于 `target/essentialsc-*.jar` 编译后的文件位于 `build/libs/essentialsc-*.jar`
## 🤝 贡献 ## 🤝 贡献
@@ -181,9 +181,6 @@ mvn clean package
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件 本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
## 👨‍💻 作者 ## 👨‍💻 作者
**Coldsmiles_7**
- GitHub: [@Coldsmiles](https://github.com/Coldsmiles) - GitHub: [@Coldsmiles](https://github.com/Coldsmiles)
- 网站: www.infstar.cn - 网站: www.infstar.cn

207
build.gradle Normal file
View File

@@ -0,0 +1,207 @@
import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
import org.gradle.language.jvm.tasks.ProcessResources
import java.util.Collections
plugins {
id 'java'
id 'io.papermc.paperweight.userdev' version '2.0.0-beta.21'
id 'com.gradleup.shadow' version '8.3.6'
}
group = 'cn.infstar'
version = '1.3.0'
repositories {
mavenCentral()
maven {
name = 'papermc'
url = uri('https://repo.papermc.io/repository/maven-public/')
}
}
dependencies {
paperweight.paperDevBundle('1.21.11-R0.1-SNAPSHOT')
}
java {
toolchain.languageVersion.set(JavaLanguageVersion.of(21))
}
def moduleExcludes = [
'blocks': [
'**/commands/WorkbenchCommand.java',
'**/commands/AnvilCommand.java',
'**/commands/CartographyTableCommand.java',
'**/commands/GrindstoneCommand.java',
'**/commands/LoomCommand.java',
'**/commands/SmithingTableCommand.java',
'**/commands/StonecutterCommand.java',
'**/commands/EnderChestCommand.java',
'**/commands/BlocksMenuCommand.java',
'**/listeners/ShulkerBoxListener.java'
],
'player': [
'**/commands/FlyCommand.java',
'**/commands/HealCommand.java',
'**/commands/FeedCommand.java',
'**/commands/VanishCommand.java',
'**/commands/SeenCommand.java',
'**/commands/HatCommand.java',
'**/commands/SuicideCommand.java',
'**/commands/RepairCommand.java'
],
'jei-fix': [
'**/listeners/JeiRecipeSyncListener.java'
],
'mob-drops': [
'**/listeners/MobDropListener.java',
'**/listeners/MobDropMenuListener.java',
'**/commands/MobDropCommand.java'
]
]
def variantDefinitions = [
standard: [
archiveFileName: "EssentialsC-${project.version}.jar",
excludedModules: ['mob-drops']
],
all: [
archiveFileName: "EssentialsC-all-${project.version}.jar",
excludedModules: []
],
lite: [
archiveFileName: "EssentialsC-lite-${project.version}.jar",
excludedModules: ['blocks']
]
]
if (project.hasProperty('excludeModules')) {
def customExcludedModules = project.property('excludeModules')
.split(',')
.collect { it.trim() }
.findAll { !it.isEmpty() }
variantDefinitions.custom = [
archiveFileName: "EssentialsC-custom-${project.version}.jar",
excludedModules: customExcludedModules
]
}
def resolveExcludePatterns = { Collection<String> modules ->
modules.collectMany { module -> moduleExcludes.get(module, Collections.emptyList()) }.unique()
}
variantDefinitions.each { variantName, variantConfig ->
def unknownModules = variantConfig.excludedModules.findAll { !moduleExcludes.containsKey(it) }
if (!unknownModules.isEmpty()) {
throw new GradleException("Unknown modules for variant '${variantName}': ${unknownModules.join(', ')}")
}
}
def variantSourceSets = [:]
variantDefinitions.each { variantName, variantConfig ->
def sourceSet = sourceSets.create(variantName)
sourceSet.java.srcDirs = sourceSets.main.java.srcDirs
sourceSet.resources.srcDirs = sourceSets.main.resources.srcDirs
resolveExcludePatterns(variantConfig.excludedModules).each { pattern ->
sourceSet.java.exclude(pattern)
}
sourceSet.compileClasspath += sourceSets.main.compileClasspath
sourceSet.runtimeClasspath += sourceSet.output + sourceSet.compileClasspath
variantSourceSets[variantName] = sourceSet
}
tasks.withType(JavaCompile).configureEach {
options.encoding = 'UTF-8'
}
tasks.withType(ProcessResources).configureEach {
filteringCharset = 'UTF-8'
}
variantDefinitions.keySet().each { variantName ->
def sourceSet = variantSourceSets[variantName]
def processTaskName = sourceSet.processResourcesTaskName
tasks.named(processTaskName, ProcessResources).configure {
inputs.property('version', project.version)
filesMatching('paper-plugin.yml') {
expand('version': project.version)
}
}
}
tasks.named('jar').configure {
enabled = false
}
tasks.named('shadowJar').configure {
enabled = false
}
def variantJarTasks = variantDefinitions.collect { variantName, variantConfig ->
def taskName = "shadowJar${variantName.capitalize()}"
def sourceSet = variantSourceSets[variantName]
tasks.register(taskName, ShadowJar) {
group = 'build'
description = "Builds the ${variantName} plugin jar."
archiveFileName.set(variantConfig.archiveFileName as String)
from(sourceSet.output)
configurations = [project.configurations.runtimeClasspath]
dependsOn(tasks.named(sourceSet.classesTaskName))
}
}
tasks.named('assemble').configure {
dependsOn(variantJarTasks)
}
tasks.register('buildAllVersions') {
group = 'build'
description = 'Builds standard, all, and lite plugin jars.'
dependsOn(variantJarTasks)
}
tasks.register('deployToPaper12111', Copy) {
group = 'deployment'
description = 'Deploys the all variant to the local Paper 1.21.11 test server.'
def artifact = tasks.named('shadowJarAll').flatMap { it.archiveFile }
dependsOn(tasks.named('shadowJarAll'))
from(artifact)
into(layout.projectDirectory.dir('test-server/paper-1.21.11/plugins'))
}
tasks.register('deployToPaper26') {
group = 'deployment'
description = 'Deploys the all variant to the local Paper 26.1.2 test server.'
dependsOn(tasks.named('shadowJarAll'))
doFirst {
def pluginsDir = file("${projectDir}/test-server/paper-26.1.2/plugins")
if (!pluginsDir.exists()) {
return
}
fileTree(pluginsDir).matching {
include 'EssentialsC*.jar'
}.each { pluginJar ->
pluginJar.delete()
}
}
doLast {
def artifact = tasks.named('shadowJarAll').flatMap { it.archiveFile }
copy {
from(artifact)
into("${projectDir}/test-server/paper-26.1.2/plugins")
}
}
}
tasks.register('buildAndDeployToPaper26') {
group = 'deployment'
description = 'Builds and deploys the all variant to the local Paper 26.1.2 test server.'
dependsOn(tasks.named('clean'), tasks.named('deployToPaper26'))
}

BIN
gradle/wrapper/gradle-wrapper.jar vendored Normal file

Binary file not shown.

View File

@@ -0,0 +1,7 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/v9.1.0/gradle-9.1.0-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

248
gradlew vendored Normal file
View File

@@ -0,0 +1,248 @@
#!/bin/sh
#
# Copyright © 2015 the original authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# SPDX-License-Identifier: Apache-2.0
#
##############################################################################
#
# Gradle start up script for POSIX generated by Gradle.
#
# Important for running:
#
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
# noncompliant, but you have some other compliant shell such as ksh or
# bash, then to run this script, type that shell name before the whole
# command line, like:
#
# ksh Gradle
#
# Busybox and similar reduced shells will NOT work, because this script
# requires all of these POSIX shell features:
# * functions;
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
# * compound commands having a testable exit status, especially «case»;
# * various built-in commands including «command», «set», and «ulimit».
#
# Important for patching:
#
# (2) This script targets any POSIX shell, so it avoids extensions provided
# by Bash, Ksh, etc; in particular arrays are avoided.
#
# The "traditional" practice of packing multiple parameters into a
# space-separated string is a well documented source of bugs and security
# problems, so this is (mostly) avoided, by progressively accumulating
# options in "$@", and eventually passing that to Java.
#
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
# see the in-line comments for details.
#
# There are tweaks for specific operating systems such as AIX, CygWin,
# Darwin, MinGW, and NonStop.
#
# (3) This script is generated from the Groovy template
# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
# within the Gradle project.
#
# You can find Gradle at https://github.com/gradle/gradle/.
#
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
app_path=$0
# Need this for daisy-chained symlinks.
while
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
[ -h "$app_path" ]
do
ls=$( ls -ld "$app_path" )
link=${ls#*' -> '}
case $link in #(
/*) app_path=$link ;; #(
*) app_path=$APP_HOME$link ;;
esac
done
# This is normally unused
# shellcheck disable=SC2034
APP_BASE_NAME=${0##*/}
# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD=maximum
warn () {
echo "$*"
} >&2
die () {
echo
echo "$*"
echo
exit 1
} >&2
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "$( uname )" in #(
CYGWIN* ) cygwin=true ;; #(
Darwin* ) darwin=true ;; #(
MSYS* | MINGW* ) msys=true ;; #(
NONSTOP* ) nonstop=true ;;
esac
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD=$JAVA_HOME/jre/sh/java
else
JAVACMD=$JAVA_HOME/bin/java
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD=java
if ! command -v java >/dev/null 2>&1
then
die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
fi
# Increase the maximum file descriptors if we can.
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
case $MAX_FD in #(
max*)
# In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
# shellcheck disable=SC2039,SC3045
MAX_FD=$( ulimit -H -n ) ||
warn "Could not query maximum file descriptor limit"
esac
case $MAX_FD in #(
'' | soft) :;; #(
*)
# In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
# shellcheck disable=SC2039,SC3045
ulimit -n "$MAX_FD" ||
warn "Could not set maximum file descriptor limit to $MAX_FD"
esac
fi
# Collect all arguments for the java command, stacking in reverse order:
# * args from the command line
# * the main class name
# * -classpath
# * -D...appname settings
# * --module-path (only if needed)
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
# For Cygwin or MSYS, switch paths to Windows format before running java
if "$cygwin" || "$msys" ; then
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
JAVACMD=$( cygpath --unix "$JAVACMD" )
# Now convert the arguments - kludge to limit ourselves to /bin/sh
for arg do
if
case $arg in #(
-*) false ;; # don't mess with options #(
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
[ -e "$t" ] ;; #(
*) false ;;
esac
then
arg=$( cygpath --path --ignore --mixed "$arg" )
fi
# Roll the args list around exactly as many times as the number of
# args, so each arg winds up back in the position where it started, but
# possibly modified.
#
# NB: a `for` loop captures its iteration list before it begins, so
# changing the positional parameters here affects neither the number of
# iterations, nor the values presented in `arg`.
shift # remove old arg
set -- "$@" "$arg" # push replacement arg
done
fi
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Collect all arguments for the java command:
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
# and any embedded shellness will be escaped.
# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
# treated as '${Hostname}' itself on the command line.
set -- \
"-Dorg.gradle.appname=$APP_BASE_NAME" \
-jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
"$@"
# Stop when "xargs" is not available.
if ! command -v xargs >/dev/null 2>&1
then
die "xargs is not available"
fi
# Use "xargs" to parse quoted args.
#
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
#
# In Bash we could simply go:
#
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
# set -- "${ARGS[@]}" "$@"
#
# but POSIX shell has neither arrays nor command substitution, so instead we
# post-process each arg (as a line of input to sed) to backslash-escape any
# character that might be a shell metacharacter, then use eval to reverse
# that process (while maintaining the separation between arguments), and wrap
# the whole thing up as a single "set" statement.
#
# This will of course break if any of these variables contains a newline or
# an unmatched quote.
#
eval "set -- $(
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
xargs -n1 |
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
tr '\n' ' '
)" '"$@"'
exec "$JAVACMD" "$@"

93
gradlew.bat vendored Normal file
View File

@@ -0,0 +1,93 @@
@rem
@rem Copyright 2015 the original author or authors.
@rem
@rem Licensed under the Apache License, Version 2.0 (the "License");
@rem you may not use this file except in compliance with the License.
@rem You may obtain a copy of the License at
@rem
@rem https://www.apache.org/licenses/LICENSE-2.0
@rem
@rem Unless required by applicable law or agreed to in writing, software
@rem distributed under the License is distributed on an "AS IS" BASIS,
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
@rem SPDX-License-Identifier: Apache-2.0
@rem
@if "%DEBUG%"=="" @echo off
@rem ##########################################################################
@rem
@rem Gradle startup script for Windows
@rem
@rem ##########################################################################
@rem Set local scope for the variables with windows NT shell
if "%OS%"=="Windows_NT" setlocal
set DIRNAME=%~dp0
if "%DIRNAME%"=="" set DIRNAME=.
@rem This is normally unused
set APP_BASE_NAME=%~n0
set APP_HOME=%DIRNAME%
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
@rem Find java.exe
if defined JAVA_HOME goto findJavaFromJavaHome
set JAVA_EXE=java.exe
%JAVA_EXE% -version >NUL 2>&1
if %ERRORLEVEL% equ 0 goto execute
echo. 1>&2
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
echo. 1>&2
echo Please set the JAVA_HOME variable in your environment to match the 1>&2
echo location of your Java installation. 1>&2
goto fail
:findJavaFromJavaHome
set JAVA_HOME=%JAVA_HOME:"=%
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
if exist "%JAVA_EXE%" goto execute
echo. 1>&2
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
echo. 1>&2
echo Please set the JAVA_HOME variable in your environment to match the 1>&2
echo location of your Java installation. 1>&2
goto fail
:execute
@rem Setup the command line
@rem Execute Gradle
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
:end
@rem End local scope for the variables with windows NT shell
if %ERRORLEVEL% equ 0 goto mainEnd
:fail
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
rem the _cmd.exe /c_ return code!
set EXIT_CODE=%ERRORLEVEL%
if %EXIT_CODE% equ 0 set EXIT_CODE=1
if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
exit /b %EXIT_CODE%
:mainEnd
if "%OS%"=="Windows_NT" endlocal
:omega

75
pom.xml
View File

@@ -1,75 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>cn.infstar</groupId>
<artifactId>essentialsc</artifactId>
<version>1.2.0</version>
<packaging>jar</packaging>
<name>essentialsc</name>
<properties>
<java.version>21</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<test.server.path>${project.basedir}/test-server/plugins</test.server.path>
</properties>
<build>
<defaultGoal>clean package</defaultGoal>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.5.3</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
</resource>
</resources>
</build>
<repositories>
<!-- 阿里云 Maven 镜像 -->
<repository>
<id>aliyunmaven</id>
<url>https://maven.aliyun.com/repository/public</url>
</repository>
<!-- PaperMC 仓库 -->
<repository>
<id>papermc-repo</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>io.papermc.paper</groupId>
<artifactId>paper-api</artifactId>
<version>1.21.11-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
</dependencies>
</project>

18
settings.gradle Normal file
View File

@@ -0,0 +1,18 @@
pluginManagement {
repositories {
// 阿里云 Gradle 插件镜像(优先)
maven {
name = 'aliyun-gradle-plugin'
url = uri('https://maven.aliyun.com/repository/gradle-plugin')
}
// Gradle 官方插件仓库
gradlePluginPortal()
// PaperMC 官方仓库(用于 paperweight 插件)
maven {
name = 'papermc'
url = uri('https://repo.papermc.io/repository/maven-public/')
}
}
}
rootProject.name = 'EssentialsC'

View File

@@ -1,7 +1,8 @@
package cn.infstar.essentialsC; package cn.infstar.essentialsC;
import cn.infstar.essentialsC.commands.*; import cn.infstar.essentialsC.commands.BaseCommand;
import cn.infstar.essentialsC.listeners.ShulkerBoxListener; import cn.infstar.essentialsC.commands.CommandRegistry;
import cn.infstar.essentialsC.commands.HelpCommand;
import org.bukkit.Bukkit; import org.bukkit.Bukkit;
import org.bukkit.command.Command; import org.bukkit.command.Command;
import org.bukkit.command.CommandSender; import org.bukkit.command.CommandSender;
@@ -15,81 +16,85 @@ public final class EssentialsC extends JavaPlugin {
@Override @Override
public void onEnable() { public void onEnable() {
// 初始化语言管理器
langManager = new LangManager(this); langManager = new LangManager(this);
registerPluginChannels();
// 注册监听器
registerListeners(); registerListeners();
// 注册命令
registerCommands(); registerCommands();
getLogger().info("EssentialsC 插件已启用!"); getLogger().info("EssentialsC enabled. Version: " + getDescription().getVersion());
getLogger().info("当前语言: " + langManager.getCurrentLanguage());
} }
@Override @Override
public void onDisable() { public void onDisable() {
getLogger().info("EssentialsC 插件已禁用!"); getLogger().info("EssentialsC disabled.");
} }
/**
* 获取语言管理器实例
*/
public static LangManager getLangManager() { public static LangManager getLangManager() {
return langManager; return langManager;
} }
/** private void registerPluginChannels() {
* 注册所有监听器 org.bukkit.plugin.messaging.Messenger messenger = getServer().getMessenger();
*/ messenger.registerOutgoingPluginChannel(this, "fabric:recipe_sync");
messenger.registerOutgoingPluginChannel(this, "neoforge:recipe_content");
}
private void registerListeners() { private void registerListeners() {
// 注册潜影盒右键打开监听器 if (registerListener("cn.infstar.essentialsC.listeners.ShulkerBoxListener")) {
new ShulkerBoxListener(this); getLogger().info("- Shulker box module");
getLogger().info("成功注册监听器!"); }
if (registerListener("cn.infstar.essentialsC.listeners.JeiRecipeSyncListener")) {
getLogger().info("- JEI recipe sync");
}
if (registerListener("cn.infstar.essentialsC.listeners.MobDropListener")) {
createOptionalInstance("cn.infstar.essentialsC.listeners.MobDropMenuListener");
getLogger().info("- Mob drop control");
}
}
private boolean registerListener(String className) {
try {
Class<?> listenerClass = Class.forName(className);
Object listenerInstance = listenerClass.getConstructor(EssentialsC.class).newInstance(this);
getServer().getPluginManager().registerEvents((org.bukkit.event.Listener) listenerInstance, this);
return true;
} catch (Exception ignored) {
return false;
}
}
private void createOptionalInstance(String className) {
try {
Class<?> targetClass = Class.forName(className);
targetClass.getConstructor(EssentialsC.class).newInstance(this);
} catch (Exception ignored) {
}
} }
private void registerCommands() { private void registerCommands() {
try { try {
// 获取 CommandMap
Field bukkitCommandMap = Bukkit.getServer().getClass().getDeclaredField("commandMap"); Field bukkitCommandMap = Bukkit.getServer().getClass().getDeclaredField("commandMap");
bukkitCommandMap.setAccessible(true); bukkitCommandMap.setAccessible(true);
org.bukkit.command.CommandMap commandMap = (org.bukkit.command.CommandMap) bukkitCommandMap.get(Bukkit.getServer()); org.bukkit.command.CommandMap commandMap = (org.bukkit.command.CommandMap) bukkitCommandMap.get(Bukkit.getServer());
// 注册所有命令(使用 CMI 风格:独立命令 + 别名) for (CommandRegistry.CommandSpec spec : CommandRegistry.getCommandSpecs()) {
registerCommandWithAliases(commandMap, "workbench", new WorkbenchCommand(), "wb"); BaseCommand executor = CommandRegistry.getCommand(spec.name());
registerCommandWithAliases(commandMap, "anvil", new AnvilCommand()); if (executor == null) {
registerCommandWithAliases(commandMap, "cartographytable", new CartographyTableCommand(), "ct", "cartography"); continue;
registerCommandWithAliases(commandMap, "grindstone", new GrindstoneCommand(), "gs"); }
registerCommandWithAliases(commandMap, "loom", new LoomCommand()); registerCommandWithAliases(commandMap, spec.name(), executor, spec.aliases().toArray(String[]::new));
registerCommandWithAliases(commandMap, "smithingtable", new SmithingTableCommand(), "st", "smithing"); }
registerCommandWithAliases(commandMap, "stonecutter", new StonecutterCommand(), "sc");
registerCommandWithAliases(commandMap, "enderchest", new EnderChestCommand(), "ec");
registerCommandWithAliases(commandMap, "hat", new HatCommand());
registerCommandWithAliases(commandMap, "suicide", new SuicideCommand(), "die");
registerCommandWithAliases(commandMap, "fly", new FlyCommand());
registerCommandWithAliases(commandMap, "heal", new HealCommand());
registerCommandWithAliases(commandMap, "vanish", new VanishCommand(), "v");
registerCommandWithAliases(commandMap, "seen", new SeenCommand(), "info");
registerCommandWithAliases(commandMap, "feed", new FeedCommand());
registerCommandWithAliases(commandMap, "repair", new RepairCommand(), "rep");
registerCommandWithAliases(commandMap, "essentialsc", new HelpCommand(), "essc");
getLogger().info("成功注册所有命令!"); registerCommandWithAliases(commandMap, "essentialsc", new HelpCommand(), "essc");
} catch (Exception e) { } catch (Exception e) {
getLogger().severe("无法注册命令: " + e.getMessage()); getLogger().severe("Failed to register commands: " + e.getMessage());
e.printStackTrace(); e.printStackTrace();
} }
} }
/** private void registerCommandWithAliases(org.bukkit.command.CommandMap commandMap, String name, BaseCommand executor, String... aliases) {
* 注册命令并支持别名
* @param commandMap Bukkit CommandMap
* @param name 主命令名
* @param executor 命令执行器
* @param aliases 别名列表(可选)
*/
private void registerCommandWithAliases(org.bukkit.command.CommandMap commandMap, String name, cn.infstar.essentialsC.commands.BaseCommand executor, String... aliases) {
Command command = new Command(name) { Command command = new Command(name) {
@Override @Override
public boolean execute(CommandSender sender, String commandLabel, String[] args) { public boolean execute(CommandSender sender, String commandLabel, String[] args) {
@@ -98,18 +103,16 @@ public final class EssentialsC extends JavaPlugin {
@Override @Override
public java.util.List<String> tabComplete(CommandSender sender, String alias, String[] args) throws IllegalArgumentException { public java.util.List<String> tabComplete(CommandSender sender, String alias, String[] args) throws IllegalArgumentException {
if (executor instanceof org.bukkit.command.TabCompleter) { if (executor instanceof org.bukkit.command.TabCompleter completer) {
return ((org.bukkit.command.TabCompleter) executor).onTabComplete(sender, this, alias, args); return completer.onTabComplete(sender, this, alias, args);
} }
return super.tabComplete(sender, alias, args); return super.tabComplete(sender, alias, args);
} }
}; };
command.setPermission(executor.getPermission()); command.setPermission(executor.getPermission());
// 注册到默认命名空间,使玩家可以直接使用 /workbench 而不是 /essentialsc:workbench
commandMap.register("", command); commandMap.register("", command);
// 注册别名
for (String alias : aliases) { for (String alias : aliases) {
Command aliasCmd = new Command(alias) { Command aliasCmd = new Command(alias) {
@Override @Override
@@ -118,11 +121,11 @@ public final class EssentialsC extends JavaPlugin {
} }
@Override @Override
public java.util.List<String> tabComplete(CommandSender sender, String alias, String[] args) throws IllegalArgumentException { public java.util.List<String> tabComplete(CommandSender sender, String label, String[] args) throws IllegalArgumentException {
if (executor instanceof org.bukkit.command.TabCompleter) { if (executor instanceof org.bukkit.command.TabCompleter completer) {
return ((org.bukkit.command.TabCompleter) executor).onTabComplete(sender, this, alias, args); return completer.onTabComplete(sender, this, label, args);
} }
return super.tabComplete(sender, alias, args); return super.tabComplete(sender, label, args);
} }
}; };
aliasCmd.setPermission(executor.getPermission()); aliasCmd.setPermission(executor.getPermission());

View File

@@ -1,5 +1,6 @@
package cn.infstar.essentialsC; package cn.infstar.essentialsC;
import org.bukkit.ChatColor;
import org.bukkit.configuration.file.FileConfiguration; import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.configuration.file.YamlConfiguration; import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.plugin.java.JavaPlugin; import org.bukkit.plugin.java.JavaPlugin;
@@ -147,6 +148,6 @@ public class LangManager {
* 翻译颜色代码 * 翻译颜色代码
*/ */
private String translateColorCodes(String text) { private String translateColorCodes(String text) {
return text.replace("&", "§"); return text == null ? "" : ChatColor.translateAlternateColorCodes('&', text);
} }
} }

View File

@@ -6,7 +6,6 @@ import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor; import org.bukkit.command.CommandExecutor;
import org.bukkit.command.CommandSender; import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player; import org.bukkit.entity.Player;
import org.jetbrains.annotations.NotNull;
public abstract class BaseCommand implements CommandExecutor { public abstract class BaseCommand implements CommandExecutor {
@@ -32,21 +31,24 @@ public abstract class BaseCommand implements CommandExecutor {
} }
@Override @Override
public boolean onCommand(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, String[] args) { public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
if (!(sender instanceof Player player)) { if (sender instanceof Player player) {
sender.sendMessage(getLang().getString("messages.player-only")); if (!player.hasPermission(permission)) {
return true; String message = getLang().getString("messages.no-permission",
java.util.Map.of("permission", permission));
player.sendMessage(message);
return true;
}
return execute(player, args);
} else {
return executeConsole(sender, args);
} }
if (!player.hasPermission(permission)) {
String message = getLang().getString("messages.no-permission",
java.util.Map.of("permission", permission));
player.sendMessage(message);
return true;
}
return execute(player, args);
} }
protected abstract boolean execute(Player player, String[] args); protected abstract boolean execute(Player player, String[] args);
protected boolean executeConsole(CommandSender sender, String[] args) {
sender.sendMessage(getLang().getString("messages.player-only"));
return true;
}
} }

View File

@@ -1,6 +1,7 @@
package cn.infstar.essentialsC.commands; package cn.infstar.essentialsC.commands;
import org.bukkit.Bukkit; import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.Material; import org.bukkit.Material;
import org.bukkit.NamespacedKey; import org.bukkit.NamespacedKey;
import org.bukkit.entity.Player; import org.bukkit.entity.Player;
@@ -8,41 +9,63 @@ import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener; import org.bukkit.event.Listener;
import org.bukkit.event.inventory.InventoryClickEvent; import org.bukkit.event.inventory.InventoryClickEvent;
import org.bukkit.inventory.Inventory; import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.InventoryHolder;
import org.bukkit.inventory.ItemStack; import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.meta.ItemMeta; import org.bukkit.inventory.meta.ItemMeta;
import org.bukkit.persistence.PersistentDataType; import org.bukkit.persistence.PersistentDataType;
import org.jetbrains.annotations.NotNull;
import java.util.List;
public class BlocksMenuCommand extends BaseCommand implements Listener { public class BlocksMenuCommand extends BaseCommand implements Listener {
private static final int MENU_SIZE = 36; private static final int MENU_SIZE = 36;
private static boolean listenerRegistered = false;
private final NamespacedKey blockKey; private final NamespacedKey blockKey;
private static final class BlocksMenuHolder implements InventoryHolder {
private final Inventory inventory;
private BlocksMenuHolder(String title) {
this.inventory = Bukkit.createInventory(this, MENU_SIZE, title);
}
@Override
public Inventory getInventory() {
return inventory;
}
}
public BlocksMenuCommand() { public BlocksMenuCommand() {
super("essentialsc.command.blocks"); super("essentialsc.command.blocks");
plugin.getServer().getPluginManager().registerEvents(this, plugin); if (!listenerRegistered) {
blockKey = new NamespacedKey(plugin, "block_key"); plugin.getServer().getPluginManager().registerEvents(this, plugin);
listenerRegistered = true;
}
this.blockKey = new NamespacedKey(plugin, "block_key");
} }
@Override @Override
protected boolean execute(@NotNull Player player, String[] args) { protected boolean execute(Player player, String[] args) {
openMenu(player); openMenu(player);
return true; return true;
} }
private void openMenu(Player player) { private void openMenu(Player player) {
String title = plugin.getConfig().getString("blocks-menu.title", "&6&lEssentialsC &8- &e&l功能方块菜单"); String title = plugin.getConfig().getString("blocks-menu.title", "&6&lEssentialsC &8- &e&lBlocks Menu");
Inventory menu = Bukkit.createInventory(null, MENU_SIZE, translateColor(title)); Inventory menu = new BlocksMenuHolder(translateColor(title)).getInventory();
// 从配置中读取所有物品
var itemsConfig = plugin.getConfig().getConfigurationSection("blocks-menu.items"); var itemsConfig = plugin.getConfig().getConfigurationSection("blocks-menu.items");
if (itemsConfig == null) return; if (itemsConfig == null) {
return;
}
for (String key : itemsConfig.getKeys(false)) { for (String key : itemsConfig.getKeys(false)) {
var section = itemsConfig.getConfigurationSection(key); var section = itemsConfig.getConfigurationSection(key);
if (section == null) continue; if (section == null) {
continue;
}
// 检查权限
String permission = section.getString("permission"); String permission = section.getString("permission");
if (permission != null && !player.hasPermission(permission)) { if (permission != null && !player.hasPermission(permission)) {
continue; continue;
@@ -50,12 +73,14 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
int slot = section.getInt("slot"); int slot = section.getInt("slot");
Material material = Material.matchMaterial(section.getString("material", "STONE")); Material material = Material.matchMaterial(section.getString("material", "STONE"));
if (material == null) material = Material.STONE; if (material == null) {
material = Material.STONE;
}
String name = translateColor(section.getString("name", "&fItem")); String name = translateColor(section.getString("name", "&fItem"));
java.util.List<String> lore = section.getStringList("lore").stream() List<String> lore = section.getStringList("lore").stream()
.map(this::translateColor) .map(this::translateColor)
.collect(java.util.stream.Collectors.toList()); .toList();
addItem(menu, slot, material, name, lore, key); addItem(menu, slot, material, name, lore, key);
} }
@@ -63,7 +88,7 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
player.openInventory(menu); player.openInventory(menu);
} }
private void addItem(Inventory inv, int slot, Material material, String name, java.util.List<String> lore, String key) { private void addItem(Inventory inv, int slot, Material material, String name, List<String> lore, String key) {
ItemStack item = new ItemStack(material); ItemStack item = new ItemStack(material);
ItemMeta meta = item.getItemMeta(); ItemMeta meta = item.getItemMeta();
if (meta != null) { if (meta != null) {
@@ -77,30 +102,28 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
@EventHandler @EventHandler
public void onMenuClick(InventoryClickEvent event) { public void onMenuClick(InventoryClickEvent event) {
// 动态获取配置的标题 if (!(event.getView().getTopInventory().getHolder(false) instanceof BlocksMenuHolder)) {
String configTitle = plugin.getConfig().getString("blocks-menu.title", "&6&lEssentialsC &8- &e&l功能方块菜单"); return;
String actualTitle = translateColor(configTitle); }
if (!(event.getWhoClicked() instanceof Player player)) {
if (!event.getView().getTitle().equals(actualTitle)) return; return;
if (!(event.getWhoClicked() instanceof Player player)) return; }
event.setCancelled(true); event.setCancelled(true);
ItemStack clicked = event.getCurrentItem(); ItemStack clicked = event.getCurrentItem();
if (clicked == null || !clicked.hasItemMeta()) return; if (clicked == null || !clicked.hasItemMeta()) {
return;
}
ItemMeta meta = clicked.getItemMeta(); ItemMeta meta = clicked.getItemMeta();
String key = meta.getPersistentDataContainer().get(this.blockKey, PersistentDataType.STRING); String key = meta.getPersistentDataContainer().get(this.blockKey, PersistentDataType.STRING);
BaseCommand blockCommand = CommandRegistry.getCommand(key);
// 点击后执行对应命令并播放音效(如果有) if (blockCommand != null) {
if (key != null && HelpCommand.COMMAND_CACHE.containsKey(key)) {
playBlockOpenSound(player, key); playBlockOpenSound(player, key);
HelpCommand.COMMAND_CACHE.get(key).execute(player, new String[]{}); blockCommand.execute(player, new String[0]);
} }
} }
/**
* 播放对应方块的打开音效(优先使用交互音效)
*/
private void playBlockOpenSound(Player player, String key) { private void playBlockOpenSound(Player player, String key) {
org.bukkit.Sound sound = switch (key) { org.bukkit.Sound sound = switch (key) {
case "workbench" -> org.bukkit.Sound.BLOCK_WOOD_HIT; case "workbench" -> org.bukkit.Sound.BLOCK_WOOD_HIT;
@@ -119,10 +142,7 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
} }
} }
/**
* 转换颜色代码 & -> §
*/
private String translateColor(String text) { private String translateColor(String text) {
return text.replace("&", "§"); return text == null ? "" : ChatColor.translateAlternateColorCodes('&', text);
} }
} }

View File

@@ -0,0 +1,111 @@
package cn.infstar.essentialsC.commands;
import java.lang.reflect.Constructor;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
public final class CommandRegistry {
private static final Map<String, CommandSpec> COMMANDS = new LinkedHashMap<>();
private static final Map<String, String> ALIAS_TO_COMMAND = new HashMap<>();
private static final Map<String, BaseCommand> COMMAND_CACHE = new HashMap<>();
private static final Set<String> UNAVAILABLE_COMMANDS = new java.util.HashSet<>();
static {
register("workbench", "essentialsc.command.workbench", "cn.infstar.essentialsC.commands.WorkbenchCommand", "wb");
register("anvil", "essentialsc.command.anvil", "cn.infstar.essentialsC.commands.AnvilCommand");
register("cartographytable", "essentialsc.command.cartographytable", "cn.infstar.essentialsC.commands.CartographyTableCommand", "ct", "cartography");
register("grindstone", "essentialsc.command.grindstone", "cn.infstar.essentialsC.commands.GrindstoneCommand", "gs");
register("loom", "essentialsc.command.loom", "cn.infstar.essentialsC.commands.LoomCommand");
register("smithingtable", "essentialsc.command.smithingtable", "cn.infstar.essentialsC.commands.SmithingTableCommand", "st", "smithing");
register("stonecutter", "essentialsc.command.stonecutter", "cn.infstar.essentialsC.commands.StonecutterCommand", "sc");
register("enderchest", "essentialsc.command.enderchest", "cn.infstar.essentialsC.commands.EnderChestCommand", "ec");
register("blocks", "essentialsc.command.blocks", "cn.infstar.essentialsC.commands.BlocksMenuCommand");
register("hat", "essentialsc.command.hat", "cn.infstar.essentialsC.commands.HatCommand");
register("suicide", "essentialsc.command.suicide", "cn.infstar.essentialsC.commands.SuicideCommand", "die");
register("fly", "essentialsc.command.fly", "cn.infstar.essentialsC.commands.FlyCommand");
register("heal", "essentialsc.command.heal", "cn.infstar.essentialsC.commands.HealCommand");
register("vanish", "essentialsc.command.vanish", "cn.infstar.essentialsC.commands.VanishCommand", "v");
register("seen", "essentialsc.command.seen", "cn.infstar.essentialsC.commands.SeenCommand", "info");
register("feed", "essentialsc.command.feed", "cn.infstar.essentialsC.commands.FeedCommand");
register("repair", "essentialsc.command.repair", "cn.infstar.essentialsC.commands.RepairCommand", "rep");
register("mobdrops", "essentialsc.mobdrops.enderman", "cn.infstar.essentialsC.commands.MobDropCommand");
}
private CommandRegistry() {
}
private static void register(String name, String permission, String className, String... aliases) {
List<String> aliasList = List.of(aliases);
CommandSpec spec = new CommandSpec(name, permission, className, aliasList);
COMMANDS.put(name, spec);
ALIAS_TO_COMMAND.put(name, name);
for (String alias : aliasList) {
ALIAS_TO_COMMAND.put(alias, name);
}
}
public static Collection<CommandSpec> getCommandSpecs() {
return Collections.unmodifiableCollection(COMMANDS.values());
}
public static String resolveCommandName(String input) {
if (input == null) {
return null;
}
return ALIAS_TO_COMMAND.get(input.toLowerCase());
}
public static boolean isAvailable(String name) {
return getCommand(name) != null;
}
public static String getPermission(String name) {
CommandSpec spec = COMMANDS.get(name);
return spec == null ? null : spec.permission();
}
public static BaseCommand getCommand(String name) {
String resolvedName = resolveCommandName(name);
if (resolvedName == null) {
return null;
}
BaseCommand cached = COMMAND_CACHE.get(resolvedName);
if (cached != null) {
return cached;
}
if (UNAVAILABLE_COMMANDS.contains(resolvedName)) {
return null;
}
CommandSpec spec = COMMANDS.get(resolvedName);
if (spec == null) {
return null;
}
try {
Class<?> rawClass = Class.forName(spec.className());
if (!BaseCommand.class.isAssignableFrom(rawClass)) {
UNAVAILABLE_COMMANDS.add(resolvedName);
return null;
}
Constructor<? extends BaseCommand> constructor = rawClass.asSubclass(BaseCommand.class).getDeclaredConstructor();
BaseCommand command = constructor.newInstance();
COMMAND_CACHE.put(resolvedName, command);
return command;
} catch (ReflectiveOperationException | LinkageError ignored) {
UNAVAILABLE_COMMANDS.add(resolvedName);
return null;
}
}
public record CommandSpec(String name, String permission, String className, List<String> aliases) {
}
}

View File

@@ -7,131 +7,125 @@ import org.bukkit.command.Command;
import org.bukkit.command.CommandSender; import org.bukkit.command.CommandSender;
import org.bukkit.command.TabCompleter; import org.bukkit.command.TabCompleter;
import org.bukkit.entity.Player; import org.bukkit.entity.Player;
import org.jetbrains.annotations.NotNull;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.Arrays;
import java.util.List; import java.util.List;
import java.util.Map;
public class HelpCommand extends BaseCommand implements TabCompleter { public class HelpCommand extends BaseCommand implements TabCompleter {
// 缓存命令实例,避免重复创建
static final java.util.Map<String, BaseCommand> COMMAND_CACHE = new java.util.HashMap<>();
static {
COMMAND_CACHE.put("workbench", new WorkbenchCommand());
COMMAND_CACHE.put("anvil", new AnvilCommand());
COMMAND_CACHE.put("cartographytable", new CartographyTableCommand());
COMMAND_CACHE.put("grindstone", new GrindstoneCommand());
COMMAND_CACHE.put("loom", new LoomCommand());
COMMAND_CACHE.put("smithingtable", new SmithingTableCommand());
COMMAND_CACHE.put("stonecutter", new StonecutterCommand());
COMMAND_CACHE.put("enderchest", new EnderChestCommand());
COMMAND_CACHE.put("hat", new HatCommand());
COMMAND_CACHE.put("suicide", new SuicideCommand());
COMMAND_CACHE.put("fly", new FlyCommand());
COMMAND_CACHE.put("heal", new HealCommand());
COMMAND_CACHE.put("vanish", new VanishCommand());
COMMAND_CACHE.put("seen", new SeenCommand());
COMMAND_CACHE.put("feed", new FeedCommand());
COMMAND_CACHE.put("repair", new RepairCommand());
COMMAND_CACHE.put("blocks", new BlocksMenuCommand());
}
public HelpCommand() { public HelpCommand() {
super("essentialsc.command.help"); super("essentialsc.command.help");
} }
@Override @Override
protected boolean execute(@NotNull Player player, String[] args) { protected boolean execute(Player player, String[] args) {
return handleCommand(player, player, args);
}
@Override
protected boolean executeConsole(CommandSender sender, String[] args) {
if (args.length > 0 && args[0].equalsIgnoreCase("reload")) {
if (!sender.hasPermission("essentialsc.command.reload")) {
sender.sendMessage(getLang().getString("messages.no-permission"));
return true;
}
plugin.reloadConfig();
EssentialsC.getLangManager().reload();
sender.sendMessage(getLang().getString("prefix") + "Configuration reloaded.");
return true;
}
sender.sendMessage(getLang().getString("messages.player-only"));
return true;
}
private boolean handleCommand(CommandSender sender, Player player, String[] args) {
if (args.length > 0) { if (args.length > 0) {
String subCommand = args[0].toLowerCase(); String subCommand = args[0].toLowerCase();
// 管理相关
if (subCommand.equals("reload")) { if (subCommand.equals("reload")) {
if (!player.hasPermission("essentialsc.command.reload")) { if (!sender.hasPermission("essentialsc.command.reload")) {
player.sendMessage(getLang().getString("messages.no-permission")); sender.sendMessage(getLang().getString("messages.no-permission"));
return true; return true;
} }
plugin.reloadConfig(); plugin.reloadConfig();
EssentialsC.getLangManager().reload(); EssentialsC.getLangManager().reload();
player.sendMessage("§a配置已重载"); sender.sendMessage(getLang().getString("prefix") + "Configuration reloaded.");
return true; return true;
} }
// 功能方块和其他命令 - 使用别名映射
String actualCommand = getActualCommand(subCommand); String actualCommand = getActualCommand(subCommand);
if (actualCommand != null && COMMAND_CACHE.containsKey(actualCommand)) { BaseCommand targetCommand = CommandRegistry.getCommand(actualCommand);
String permission = getPermissionForCommand(actualCommand); if (actualCommand != null && targetCommand != null) {
if (!player.hasPermission(permission)) { String permission = CommandRegistry.getPermission(actualCommand);
if (permission != null && !player.hasPermission(permission)) {
player.sendMessage(getLang().getString("messages.no-permission")); player.sendMessage(getLang().getString("messages.no-permission"));
return true; return true;
} }
// seen 需要特殊处理参数
if (actualCommand.equals("seen")) { if (actualCommand.equals("seen")) {
if (args.length < 2) { if (args.length < 2) {
player.sendMessage("§c用法: /essc seen <玩家名>"); player.sendMessage(getLang().getString("prefix") + getLang().getString("messages.seen-usage-console"));
return true; return true;
} }
COMMAND_CACHE.get("seen").execute(player, new String[]{args[1]}); targetCommand.execute(player, new String[]{args[1]});
} else { } else {
COMMAND_CACHE.get(actualCommand).execute(player, new String[]{}); targetCommand.execute(player, new String[0]);
} }
return true; return true;
} else if (subCommand.equals("version") || subCommand.equals("v")) { }
player.sendMessage("§6EssentialsC §fv" + plugin.getDescription().getVersion());
player.sendMessage("§7运行在 Paper " + Bukkit.getVersion()); if (subCommand.equals("version") || subCommand.equals("v")) {
return true; player.sendMessage(getLang().getString("prefix") + "EssentialsC v" + plugin.getDescription().getVersion());
} else { player.sendMessage(getLang().getString("prefix") + "Running on Paper " + Bukkit.getVersion());
// 未知子命令
player.sendMessage("§c未知子命令: " + subCommand);
player.sendMessage("§7使用 §f/essc help §7查看所有可用命令");
return true; return true;
} }
player.sendMessage(getLang().getString("prefix") + getLang().getString("messages.unknown-subcommand",
Map.of("command", subCommand)));
player.sendMessage(getLang().getString("prefix") + getLang().getString("messages.help-usage"));
return true;
} }
// 显示帮助
LangManager lang = getLang(); LangManager lang = getLang();
String version = plugin.getDescription().getVersion(); String version = plugin.getDescription().getVersion();
player.sendMessage(lang.getString("help.title")); player.sendMessage(lang.getString("help.title"));
player.sendMessage(lang.getString("help.version", player.sendMessage(lang.getString("help.version", Map.of("version", version)));
java.util.Map.of("version", version)));
player.sendMessage(""); player.sendMessage("");
// 功能方块命令(检查权限后显示)
boolean hasBlockCommands = false; boolean hasBlockCommands = false;
StringBuilder blockCommands = new StringBuilder(); StringBuilder blockCommands = new StringBuilder();
if (player.hasPermission("essentialsc.command.workbench")) { if (CommandRegistry.isAvailable("workbench") && player.hasPermission("essentialsc.command.workbench")) {
blockCommands.append(lang.getString("help.commands.workbench")).append("\n"); blockCommands.append(lang.getString("help.commands.workbench")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.anvil")) { if (CommandRegistry.isAvailable("anvil") && player.hasPermission("essentialsc.command.anvil")) {
blockCommands.append(lang.getString("help.commands.anvil")).append("\n"); blockCommands.append(lang.getString("help.commands.anvil")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.cartographytable")) { if (CommandRegistry.isAvailable("cartographytable") && player.hasPermission("essentialsc.command.cartographytable")) {
blockCommands.append(lang.getString("help.commands.cartographytable")).append("\n"); blockCommands.append(lang.getString("help.commands.cartographytable")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.grindstone")) { if (CommandRegistry.isAvailable("grindstone") && player.hasPermission("essentialsc.command.grindstone")) {
blockCommands.append(lang.getString("help.commands.grindstone")).append("\n"); blockCommands.append(lang.getString("help.commands.grindstone")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.loom")) { if (CommandRegistry.isAvailable("loom") && player.hasPermission("essentialsc.command.loom")) {
blockCommands.append(lang.getString("help.commands.loom")).append("\n"); blockCommands.append(lang.getString("help.commands.loom")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.smithingtable")) { if (CommandRegistry.isAvailable("smithingtable") && player.hasPermission("essentialsc.command.smithingtable")) {
blockCommands.append(lang.getString("help.commands.smithingtable")).append("\n"); blockCommands.append(lang.getString("help.commands.smithingtable")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.stonecutter")) { if (CommandRegistry.isAvailable("stonecutter") && player.hasPermission("essentialsc.command.stonecutter")) {
blockCommands.append(lang.getString("help.commands.stonecutter")).append("\n"); blockCommands.append(lang.getString("help.commands.stonecutter")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
if (player.hasPermission("essentialsc.command.enderchest")) { if (CommandRegistry.isAvailable("enderchest") && player.hasPermission("essentialsc.command.enderchest")) {
blockCommands.append(lang.getString("help.commands.enderchest")).append("\n"); blockCommands.append(lang.getString("help.commands.enderchest")).append("\n");
hasBlockCommands = true; hasBlockCommands = true;
} }
@@ -142,31 +136,30 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
player.sendMessage(""); player.sendMessage("");
} }
// 其他命令(检查权限后显示)
boolean hasOtherCommands = false; boolean hasOtherCommands = false;
StringBuilder otherCommands = new StringBuilder(); StringBuilder otherCommands = new StringBuilder();
if (player.hasPermission("essentialsc.command.hat")) { if (CommandRegistry.isAvailable("hat") && player.hasPermission("essentialsc.command.hat")) {
otherCommands.append(lang.getString("help.commands.hat")).append("\n"); otherCommands.append(lang.getString("help.commands.hat")).append("\n");
hasOtherCommands = true; hasOtherCommands = true;
} }
if (player.hasPermission("essentialsc.command.suicide")) { if (CommandRegistry.isAvailable("suicide") && player.hasPermission("essentialsc.command.suicide")) {
otherCommands.append(lang.getString("help.commands.suicide")).append("\n"); otherCommands.append(lang.getString("help.commands.suicide")).append("\n");
hasOtherCommands = true; hasOtherCommands = true;
} }
if (player.hasPermission("essentialsc.command.fly")) { if (CommandRegistry.isAvailable("fly") && player.hasPermission("essentialsc.command.fly")) {
otherCommands.append(lang.getString("help.commands.fly")).append("\n"); otherCommands.append(lang.getString("help.commands.fly")).append("\n");
hasOtherCommands = true; hasOtherCommands = true;
} }
if (player.hasPermission("essentialsc.command.heal")) { if (CommandRegistry.isAvailable("heal") && player.hasPermission("essentialsc.command.heal")) {
otherCommands.append(lang.getString("help.commands.heal")).append("\n"); otherCommands.append(lang.getString("help.commands.heal")).append("\n");
hasOtherCommands = true; hasOtherCommands = true;
} }
if (player.hasPermission("essentialsc.command.vanish")) { if (CommandRegistry.isAvailable("vanish") && player.hasPermission("essentialsc.command.vanish")) {
otherCommands.append(lang.getString("help.commands.vanish")).append("\n"); otherCommands.append(lang.getString("help.commands.vanish")).append("\n");
hasOtherCommands = true; hasOtherCommands = true;
} }
if (player.hasPermission("essentialsc.command.seen")) { if (CommandRegistry.isAvailable("seen") && player.hasPermission("essentialsc.command.seen")) {
otherCommands.append(lang.getString("help.commands.seen")).append("\n"); otherCommands.append(lang.getString("help.commands.seen")).append("\n");
hasOtherCommands = true; hasOtherCommands = true;
} }
@@ -181,38 +174,16 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
return true; return true;
} }
/**
* 将别名映射到实际命令名
*/
private String getActualCommand(String alias) { private String getActualCommand(String alias) {
return switch (alias) { return CommandRegistry.resolveCommandName(alias);
case "wb" -> "workbench";
case "cartography", "ct" -> "cartographytable";
case "gs" -> "grindstone";
case "smithing", "st" -> "smithingtable";
case "sc" -> "stonecutter";
case "ec" -> "enderchest";
case "die" -> "suicide";
case "info" -> "seen";
case "rep" -> "repair";
default -> alias;
};
}
/**
* 获取命令对应的权限节点
*/
private String getPermissionForCommand(String command) {
return "essentialsc.command." + command;
} }
@Override @Override
public List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, String[] args) { public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
if (args.length == 1) { if (args.length == 1) {
List<String> completions = new ArrayList<>(); List<String> completions = new ArrayList<>();
String partial = args[0].toLowerCase(); String partial = args[0].toLowerCase();
// 所有可能的子命令及其权限(包括别名)
String[][] subCommands = { String[][] subCommands = {
{"reload", "essentialsc.command.reload"}, {"reload", "essentialsc.command.reload"},
{"blocks", "essentialsc.command.blocks"}, {"blocks", "essentialsc.command.blocks"},
@@ -244,20 +215,27 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
{"feed", "essentialsc.command.feed"}, {"feed", "essentialsc.command.feed"},
{"repair", "essentialsc.command.repair"}, {"repair", "essentialsc.command.repair"},
{"rep", "essentialsc.command.repair"}, {"rep", "essentialsc.command.repair"},
{"mobdrops", "essentialsc.mobdrops.enderman"},
{"version", null}, {"version", null},
{"help", null} {"help", null}
}; };
for (String[] subCmd : subCommands) { for (String[] subCmd : subCommands) {
if (subCmd[0].startsWith(partial)) { if (!subCmd[0].startsWith(partial)) {
if (subCmd[1] == null || sender.hasPermission(subCmd[1])) { continue;
completions.add(subCmd[0]); }
}
String actualCommand = getActualCommand(subCmd[0]);
boolean available = actualCommand == null || CommandRegistry.isAvailable(actualCommand);
if (available && (subCmd[1] == null || sender.hasPermission(subCmd[1]))) {
completions.add(subCmd[0]);
} }
} }
return completions; return completions;
} else if (args.length == 2) { }
if (args.length == 2) {
String subCmd = args[0].toLowerCase(); String subCmd = args[0].toLowerCase();
if ((subCmd.equals("seen") || subCmd.equals("info")) && sender.hasPermission("essentialsc.command.seen")) { if ((subCmd.equals("seen") || subCmd.equals("info")) && sender.hasPermission("essentialsc.command.seen")) {
List<String> players = new ArrayList<>(); List<String> players = new ArrayList<>();

View File

@@ -0,0 +1,81 @@
package cn.infstar.essentialsC.commands;
import cn.infstar.essentialsC.EssentialsC;
import org.bukkit.Bukkit;
import org.bukkit.Material;
import org.bukkit.entity.Player;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.InventoryHolder;
import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.meta.ItemMeta;
import java.util.Arrays;
/**
* 生物掉落物控制命令
* /mobdrops - 打开控制菜单
*/
public class MobDropCommand extends BaseCommand {
public static final class MobDropMenuHolder implements InventoryHolder {
private final Inventory inventory;
public MobDropMenuHolder(String title) {
this.inventory = Bukkit.createInventory(this, 27, title);
}
@Override
public Inventory getInventory() {
return inventory;
}
}
public MobDropCommand() {
super("essentialsc.mobdrops.enderman");
}
@Override
protected boolean execute(Player player, String[] args) {
openMobDropMenu(player);
return true;
}
/**
* 打开生物掉落控制菜单
*/
private void openMobDropMenu(Player player) {
// 读取当前配置
boolean endermanEnabled = plugin.getConfig().getBoolean("mob-drops.enderman.enabled", true);
// 创建菜单
Inventory menu = new MobDropMenuHolder("§6§l生物掉落控制").getInventory();
// 末影人控制项
ItemStack endermanItem = new ItemStack(Material.ENDER_PEARL);
ItemMeta endermanMeta = endermanItem.getItemMeta();
endermanMeta.setDisplayName("§d末影人掉落");
endermanMeta.setLore(Arrays.asList(
"§7当前状态: " + (endermanEnabled ? "§a✅ 开启" : "§c❌ 关闭"),
"",
"§e点击切换状态"
));
endermanItem.setItemMeta(endermanMeta);
// 放置在中间
menu.setItem(13, endermanItem);
// 装饰物品
ItemStack glass = new ItemStack(Material.BLACK_STAINED_GLASS_PANE);
ItemMeta glassMeta = glass.getItemMeta();
glassMeta.setDisplayName(" ");
glass.setItemMeta(glassMeta);
for (int i = 0; i < 27; i++) {
if (menu.getItem(i) == null) {
menu.setItem(i, glass);
}
}
player.openInventory(menu);
}
}

View File

@@ -0,0 +1,391 @@
package cn.infstar.essentialsC.listeners;
import cn.infstar.essentialsC.EssentialsC;
import io.netty.buffer.Unpooled;
import net.minecraft.core.registries.BuiltInRegistries;
import net.minecraft.network.RegistryFriendlyByteBuf;
import net.minecraft.network.protocol.common.ClientboundCustomPayloadPacket;
import net.minecraft.network.protocol.common.custom.DiscardedPayload;
import net.minecraft.resources.Identifier;
import net.minecraft.server.MinecraftServer;
import net.minecraft.server.level.ServerPlayer;
import net.minecraft.world.item.crafting.RecipeHolder;
import net.minecraft.world.item.crafting.RecipeMap;
import net.minecraft.world.item.crafting.RecipeSerializer;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.craftbukkit.entity.CraftPlayer;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerJoinEvent;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
/**
* JEI 配方同步监听器
* 解决 Minecraft 1.21.2+ 配方不同步问题
* 支持 Fabric 和 NeoForge 客户端
*/
public class JeiRecipeSyncListener implements Listener {
private final EssentialsC plugin;
private final boolean enabled;
private final boolean debug;
private final boolean sendPlayerMessage;
public JeiRecipeSyncListener(EssentialsC plugin) {
this.plugin = plugin;
FileConfiguration config = plugin.getConfig();
this.enabled = config.getBoolean("jei-sync.enabled", true);
this.debug = config.getBoolean("jei-sync.debug", false);
this.sendPlayerMessage = config.getBoolean("jei-sync.send-player-message", true);
}
@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
if (!enabled) {
return;
}
Player player = event.getPlayer();
String clientBrand = player.getClientBrandName();
if (debug) {
plugin.getLogger().info("========================================");
plugin.getLogger().info("玩家 " + player.getName() + " 加入");
plugin.getLogger().info("客户端品牌: '" + (clientBrand != null ? clientBrand : "null") + "'");
plugin.getLogger().info("JEI 同步功能: " + (enabled ? "启用" : "禁用"));
plugin.getLogger().info("========================================");
}
if (clientBrand == null || clientBrand.isEmpty()) {
if (debug) {
plugin.getLogger().info("跳过 " + player.getName() + ":客户端品牌为空");
}
return;
}
// 统一转换为小写进行比较,支持更多变体
String brandLower = clientBrand.toLowerCase();
if (brandLower.contains("fabric")) {
if (debug) {
plugin.getLogger().info("检测到 Fabric 客户端,开始发送配方同步...");
}
sendPlayerMessage(player, "Fabric");
sendFabricRecipeSync(player);
} else if (brandLower.contains("neoforge") || brandLower.contains("forge")) {
if (debug) {
plugin.getLogger().info("检测到 NeoForge/Forge 客户端,开始发送配方同步...");
}
sendPlayerMessage(player, "NeoForge");
sendNeoForgeRecipeSync(player);
} else {
if (debug) {
plugin.getLogger().info("跳过 " + player.getName() + ":不支持的客户端类型 '" + clientBrand + "'");
}
}
}
/**
* 发送提示消息给玩家
*/
private void sendPlayerMessage(Player player, String clientType) {
if (!sendPlayerMessage) {
return;
}
String messageKey;
if (clientType.equalsIgnoreCase("fabric")) {
messageKey = "messages.jei-sync-fabric";
} else if (clientType.equalsIgnoreCase("neoforge")) {
messageKey = "messages.jei-sync-neoforge";
} else {
return;
}
// 使用统一前缀 + 消息内容
String prefix = EssentialsC.getLangManager().getString("prefix");
String message = EssentialsC.getLangManager().getString(messageKey);
String fullMessage = prefix + " " + message;
net.kyori.adventure.text.Component component = net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer.legacyAmpersand().deserialize(fullMessage);
player.sendMessage(component);
}
/**
* 发送 Fabric 格式的配方同步数据包
*/
@SuppressWarnings({"unchecked", "deprecation"})
private void sendFabricRecipeSync(Player player) {
try {
ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
MinecraftServer server = serverPlayer.level().getServer();
if (server == null) {
if (debug) plugin.getLogger().warning("服务器实例为 null");
return;
}
RecipeMap recipeMap = server.getRecipeManager().recipes;
if (debug) {
plugin.getLogger().info("开始构建 Fabric 配方数据");
}
// 创建 Fabric Payload与参考插件完全一致
var list = new ArrayList<FabricRecipeEntry>();
var seen = new HashSet<RecipeSerializer<?>>();
for (RecipeSerializer<?> serializer : BuiltInRegistries.RECIPE_SERIALIZER) {
if (!seen.add(serializer)) continue;
List<RecipeHolder<?>> recipes = new ArrayList<>();
for (RecipeHolder<?> holder : recipeMap.values()) {
if (holder.value().getSerializer() == serializer) {
recipes.add(holder);
}
}
if (!recipes.isEmpty()) {
RecipeSerializer<?> entrySerializer = recipes.get(0).value().getSerializer();
list.add(new FabricRecipeEntry(entrySerializer, recipes));
}
}
var payload = new FabricRecipeSyncPayload(list);
if (debug) {
plugin.getLogger().info("Fabric 配方条目数: " + list.size());
}
// 构建 buffer
RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(
Unpooled.buffer(),
server.registryAccess()
);
// 使用 CODEC 编码(与参考插件完全一致)
var codec = getFabricCodec();
codec.encode(buffer, payload);
// 发送数据包
byte[] bytes = new byte[buffer.writerIndex()];
buffer.getBytes(0, bytes);
Identifier id = Identifier.fromNamespaceAndPath("fabric", "recipe_sync");
DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
if (debug) {
plugin.getLogger().info("已发送 Fabric 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
}
} catch (Exception e) {
plugin.getLogger().warning("发送 Fabric 配方同步失败: " + e.getMessage());
e.printStackTrace();
}
}
/**
* 获取 Fabric Codec
*/
@SuppressWarnings({"unchecked", "deprecation"})
private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeSyncPayload> getFabricCodec() {
return FabricRecipeEntry.CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list())
.map(FabricRecipeSyncPayload::new, FabricRecipeSyncPayload::entries);
}
/**
* 发送 NeoForge 格式的配方同步数据包
*/
@SuppressWarnings({"unchecked", "deprecation"})
private void sendNeoForgeRecipeSync(Player player) {
try {
ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
MinecraftServer server = serverPlayer.level().getServer();
if (server == null) {
if (debug) plugin.getLogger().warning("服务器实例为 null");
return;
}
RecipeMap recipeMap = server.getRecipeManager().recipes;
if (debug) {
plugin.getLogger().info("开始构建 NeoForge 配方数据");
}
// 获取所有配方类型
java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> allRecipeTypes =
BuiltInRegistries.RECIPE_TYPE.stream().toList();
if (debug) {
plugin.getLogger().info("NeoForge 配方类型数: " + allRecipeTypes.size());
}
// 创建 NeoForge Payload与参考插件完全一致
var payload = createNeoForgePayload(allRecipeTypes, recipeMap);
// 构建 buffer
RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(
Unpooled.buffer(),
server.registryAccess()
);
// 使用 STREAM_CODEC 编码(与参考插件完全一致)
var streamCodec = getNeoForgeStreamCodec();
streamCodec.encode(buffer, payload);
// 发送数据包
byte[] bytes = new byte[buffer.writerIndex()];
buffer.getBytes(0, bytes);
Identifier id = Identifier.fromNamespaceAndPath("neoforge", "recipe_content");
DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
// 发送 Tags 同步NeoForge 需要)
serverPlayer.connection.send(new net.minecraft.network.protocol.common.ClientboundUpdateTagsPacket(
net.minecraft.tags.TagNetworkSerialization.serializeTagsToNetwork(server.registries())
));
if (debug) {
plugin.getLogger().info("已发送 NeoForge 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
}
} catch (Exception e) {
plugin.getLogger().warning("发送 NeoForge 配方同步失败: " + e.getMessage());
e.printStackTrace();
}
}
/**
* 创建 NeoForge 配载对象
*/
private NeoForgeRecipeSyncPayload createNeoForgePayload(
java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
RecipeMap recipeMap) {
var recipeTypeSet = new java.util.HashSet<>(recipeTypes);
if (recipeTypeSet.isEmpty()) {
return new NeoForgeRecipeSyncPayload(recipeTypeSet, java.util.List.of());
} else {
var recipeSubset = recipeMap.values().stream()
.filter(h -> recipeTypeSet.contains(h.value().getType()))
.toList();
return new NeoForgeRecipeSyncPayload(recipeTypeSet, recipeSubset);
}
}
/**
* 获取 NeoForge StreamCodec
*/
@SuppressWarnings({"unchecked", "deprecation"})
private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, NeoForgeRecipeSyncPayload> getNeoForgeStreamCodec() {
return net.minecraft.network.codec.StreamCodec.composite(
net.minecraft.network.codec.ByteBufCodecs.registry(net.minecraft.core.registries.Registries.RECIPE_TYPE)
.apply(net.minecraft.network.codec.ByteBufCodecs.collection(java.util.HashSet::new)),
NeoForgeRecipeSyncPayload::recipeTypes,
RecipeHolder.STREAM_CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list()),
NeoForgeRecipeSyncPayload::recipes,
NeoForgeRecipeSyncPayload::new
);
}
/**
* Fabric 配方条目
*/
@SuppressWarnings("deprecation")
private static class FabricRecipeEntry {
final Object serializer; // 使用 Object 避免 NMS 类型不兼容
final List<RecipeHolder<?>> recipes;
FabricRecipeEntry(Object serializer, List<RecipeHolder<?>> recipes) {
this.serializer = serializer;
this.recipes = recipes;
}
static final net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeEntry> CODEC =
net.minecraft.network.codec.StreamCodec.ofMember(
FabricRecipeEntry::write,
FabricRecipeEntry::read
);
@SuppressWarnings("unchecked")
private static FabricRecipeEntry read(RegistryFriendlyByteBuf buf) {
Identifier recipeSerializerId = buf.readIdentifier();
RecipeSerializer<?> recipeSerializer = BuiltInRegistries.RECIPE_SERIALIZER.getValue(recipeSerializerId);
if (recipeSerializer == null) {
throw new RuntimeException("Tried syncing unsupported packet serializer '" + recipeSerializerId + "'!");
}
int count = buf.readVarInt();
var list = new ArrayList<RecipeHolder<?>>();
for (int i = 0; i < count; i++) {
net.minecraft.resources.ResourceKey<net.minecraft.world.item.crafting.Recipe<?>> id =
buf.readResourceKey(net.minecraft.core.registries.Registries.RECIPE);
// 使用反射获取 streamCodec避免 NMS 类型不兼容
try {
var streamCodecMethod = recipeSerializer.getClass().getMethod("streamCodec");
var streamCodec = streamCodecMethod.invoke(recipeSerializer);
net.minecraft.world.item.crafting.Recipe<?> recipe =
((net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>) streamCodec)
.decode(buf);
list.add(new RecipeHolder<>(id, recipe));
} catch (Exception e) {
throw new RuntimeException("Failed to decode recipe: " + e.getMessage(), e);
}
}
return new FabricRecipeEntry(recipeSerializer, list);
}
private void write(RegistryFriendlyByteBuf buf) {
// 使用反射获取 key避免 NMS 类型不兼容
try {
var getKeyMethod = BuiltInRegistries.RECIPE_SERIALIZER.getClass().getMethod("getKey", Object.class);
Identifier identifier = (Identifier) getKeyMethod.invoke(BuiltInRegistries.RECIPE_SERIALIZER, this.serializer);
buf.writeIdentifier(identifier);
} catch (Exception e) {
throw new RuntimeException("Failed to get serializer key: " + e.getMessage(), e);
}
buf.writeVarInt(this.recipes.size());
// 使用反射获取 streamCodec避免 NMS 类型不兼容
try {
var streamCodecMethod = this.serializer.getClass().getMethod("streamCodec");
@SuppressWarnings("unchecked")
var codec = (net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>)
streamCodecMethod.invoke(this.serializer);
for (RecipeHolder<?> recipe : this.recipes) {
buf.writeResourceKey(recipe.id());
codec.encode(buf, recipe.value());
}
} catch (Exception e) {
throw new RuntimeException("Failed to encode recipe: " + e.getMessage(), e);
}
}
}
/**
* Fabric 配方同步 Payload
*/
private record FabricRecipeSyncPayload(List<FabricRecipeEntry> entries) {
}
/**
* NeoForge 配方同步 Payload
*/
private record NeoForgeRecipeSyncPayload(
java.util.Set<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
java.util.List<RecipeHolder<?>> recipes) {
}
}

View File

@@ -0,0 +1,63 @@
package cn.infstar.essentialsC.listeners;
import cn.infstar.essentialsC.EssentialsC;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.entity.EntityType;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.entity.EntityDeathEvent;
/**
* 生物掉落物控制监听器
* 当前仅支持末影人
*/
public class MobDropListener implements Listener {
private final EssentialsC plugin;
private boolean endermanDropEnabled;
public MobDropListener(EssentialsC plugin) {
this.plugin = plugin;
loadConfig();
// 注册监听器
}
/**
* 加载配置
*/
private void loadConfig() {
FileConfiguration config = plugin.getConfig();
config.addDefault("mob-drops.enderman.enabled", true);
config.options().copyDefaults(true);
try {
config.save(plugin.getDataFolder().toPath().resolve("config.yml").toFile());
} catch (Exception e) {
plugin.getLogger().warning("无法保存配置文件: " + e.getMessage());
}
this.endermanDropEnabled = config.getBoolean("mob-drops.enderman.enabled", true);
}
@EventHandler
public void onEntityDeath(EntityDeathEvent event) {
if (event.getEntityType() != EntityType.ENDERMAN) {
return;
}
boolean enabled = plugin.getConfig().getBoolean("mob-drops.enderman.enabled", true);
if (!enabled) {
event.getDrops().clear();
}
}
/**
* 重新加载配置
*/
public void reload() {
loadConfig();
plugin.getLogger().info("生物掉落物配置已重载(末影人: " + (endermanDropEnabled ? "开启" : "关闭") + "");
}
}

View File

@@ -0,0 +1,101 @@
package cn.infstar.essentialsC.listeners;
import cn.infstar.essentialsC.EssentialsC;
import org.bukkit.Bukkit;
import org.bukkit.Material;
import org.bukkit.configuration.file.FileConfiguration;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.inventory.InventoryClickEvent;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.meta.ItemMeta;
import java.util.Arrays;
public class MobDropMenuListener implements Listener {
private final EssentialsC plugin;
public MobDropMenuListener(EssentialsC plugin) {
this.plugin = plugin;
plugin.getServer().getPluginManager().registerEvents(this, plugin);
}
@EventHandler
public void onInventoryClick(InventoryClickEvent event) {
if (!(event.getView().getTopInventory().getHolder(false) instanceof cn.infstar.essentialsC.commands.MobDropCommand.MobDropMenuHolder)) {
return;
}
event.setCancelled(true);
if (!(event.getWhoClicked() instanceof Player player)) {
return;
}
ItemStack clickedItem = event.getCurrentItem();
if (clickedItem == null) {
return;
}
if (event.getSlot() == 13) {
toggleEndermanDrops(player);
Bukkit.getScheduler().runTaskLater(plugin, () -> openMobDropMenu(player), 2L);
}
}
private void toggleEndermanDrops(Player player) {
FileConfiguration config = plugin.getConfig();
boolean currentValue = config.getBoolean("mob-drops.enderman.enabled", true);
boolean newValue = !currentValue;
config.set("mob-drops.enderman.enabled", newValue);
try {
config.save(plugin.getDataFolder().toPath().resolve("config.yml").toFile());
} catch (Exception e) {
player.sendMessage(EssentialsC.getLangManager().getString("prefix") +
EssentialsC.getLangManager().getString("messages.mobdrop-save-failed",
java.util.Map.of("error", e.getMessage())));
return;
}
String status = newValue ? "§a开启" : "§c关闭";
player.sendMessage(EssentialsC.getLangManager().getString("prefix") +
EssentialsC.getLangManager().getString("messages.mobdrop-toggled",
java.util.Map.of("status", status)));
}
private void openMobDropMenu(Player player) {
boolean endermanEnabled = plugin.getConfig().getBoolean("mob-drops.enderman.enabled", true);
Inventory menu = new cn.infstar.essentialsC.commands.MobDropCommand.MobDropMenuHolder("§6§l生物掉落控制").getInventory();
ItemStack endermanItem = new ItemStack(Material.ENDER_PEARL);
ItemMeta endermanMeta = endermanItem.getItemMeta();
endermanMeta.setDisplayName("§d末影人掉落");
endermanMeta.setLore(Arrays.asList(
"§7当前状态: " + (endermanEnabled ? "§a✅ 开启" : "§c❌ 关闭"),
"",
"§e点击切换状态"
));
endermanItem.setItemMeta(endermanMeta);
menu.setItem(13, endermanItem);
ItemStack glass = new ItemStack(Material.BLACK_STAINED_GLASS_PANE);
ItemMeta glassMeta = glass.getItemMeta();
glassMeta.setDisplayName(" ");
glass.setItemMeta(glassMeta);
for (int i = 0; i < 27; i++) {
if (menu.getItem(i) == null) {
menu.setItem(i, glass);
}
}
player.openInventory(menu);
}
}

View File

@@ -2,17 +2,27 @@ package cn.infstar.essentialsC.listeners;
import cn.infstar.essentialsC.EssentialsC; import cn.infstar.essentialsC.EssentialsC;
import org.bukkit.Bukkit; import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.Material; import org.bukkit.Material;
import org.bukkit.block.ShulkerBox; import org.bukkit.block.ShulkerBox;
import org.bukkit.entity.Player; import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler; import org.bukkit.event.EventHandler;
import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener; import org.bukkit.event.Listener;
import org.bukkit.event.block.Action; import org.bukkit.event.block.Action;
import org.bukkit.event.inventory.ClickType;
import org.bukkit.event.inventory.InventoryClickEvent; import org.bukkit.event.inventory.InventoryClickEvent;
import org.bukkit.event.inventory.InventoryCloseEvent; import org.bukkit.event.inventory.InventoryCloseEvent;
import org.bukkit.event.inventory.InventoryDragEvent;
import org.bukkit.event.player.PlayerInteractEvent; import org.bukkit.event.player.PlayerInteractEvent;
import org.bukkit.event.player.PlayerQuitEvent;
import org.bukkit.event.server.PluginDisableEvent;
import org.bukkit.inventory.EquipmentSlot;
import org.bukkit.inventory.Inventory; import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.InventoryHolder;
import org.bukkit.inventory.InventoryView;
import org.bukkit.inventory.ItemStack; import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.PlayerInventory;
import org.bukkit.inventory.meta.BlockStateMeta; import org.bukkit.inventory.meta.BlockStateMeta;
import java.util.HashMap; import java.util.HashMap;
@@ -22,11 +32,8 @@ import java.util.UUID;
public class ShulkerBoxListener implements Listener { public class ShulkerBoxListener implements Listener {
private final EssentialsC plugin; private static final int SHULKER_SIZE = 27;
// 存储玩家打开的潜影盒玩家UUID -> (原始物品快照, 当前物品引用)
private final Map<UUID, ShulkerBoxData> openShulkerBoxes = new HashMap<>();
// 预定义所有潜影盒材质(性能优化)
private static final Set<Material> SHULKER_BOX_MATERIALS = Set.of( private static final Set<Material> SHULKER_BOX_MATERIALS = Set.of(
Material.SHULKER_BOX, Material.SHULKER_BOX,
Material.WHITE_SHULKER_BOX, Material.WHITE_SHULKER_BOX,
@@ -47,55 +54,136 @@ public class ShulkerBoxListener implements Listener {
Material.BLACK_SHULKER_BOX Material.BLACK_SHULKER_BOX
); );
/** private final EssentialsC plugin;
* 潜影盒数据记录 private final Map<UUID, OpenShulkerSession> openShulkerBoxes = new HashMap<>();
*/
private static class ShulkerBoxData {
ItemStack originalSnapshot; // 打开时的物品快照(用于验证)
ItemStack currentItem; // 当前物品引用(用于更新)
int totalItems; // 打开时的物品总数(用于防刷)
ShulkerBoxData(ItemStack snapshot, ItemStack current, int items) { private static final class ShulkerBoxHolder implements InventoryHolder {
this.originalSnapshot = snapshot; private final Inventory inventory;
this.currentItem = current;
this.totalItems = items; private ShulkerBoxHolder(String title) {
this.inventory = Bukkit.createInventory(this, SHULKER_SIZE, title);
}
@Override
public Inventory getInventory() {
return this.inventory;
}
}
private static final class OpenShulkerSession {
private final ItemStack sourceItem;
private final EquipmentSlot sourceHand;
private final int preferredSlot;
private OpenShulkerSession(ItemStack sourceItem, EquipmentSlot sourceHand, int preferredSlot) {
this.sourceItem = sourceItem;
this.sourceHand = sourceHand;
this.preferredSlot = preferredSlot;
} }
} }
public ShulkerBoxListener(EssentialsC plugin) { public ShulkerBoxListener(EssentialsC plugin) {
this.plugin = plugin; this.plugin = plugin;
plugin.getServer().getPluginManager().registerEvents(this, plugin);
} }
@EventHandler @EventHandler(priority = EventPriority.HIGHEST)
public void onPlayerInteract(PlayerInteractEvent event) { public void onPlayerInteract(PlayerInteractEvent event) {
// 只处理右键点击空气或方块的事件
if (event.getAction() != Action.RIGHT_CLICK_AIR && event.getAction() != Action.RIGHT_CLICK_BLOCK) { if (event.getAction() != Action.RIGHT_CLICK_AIR && event.getAction() != Action.RIGHT_CLICK_BLOCK) {
return; return;
} }
Player player = event.getPlayer(); Player player = event.getPlayer();
if (!player.isSneaking() || !player.hasPermission("essentialsc.shulkerbox.open")) {
// 检查权限
if (!player.hasPermission("essentialsc.shulkerbox.open")) {
return; return;
} }
ItemStack item = event.getItem(); if (openShulkerBoxes.containsKey(player.getUniqueId())) {
if (item == null || !isShulkerBox(item)) {
return; return;
} }
// 只有潜行+右键才打开潜影盒 EquipmentSlot hand = event.getHand() == EquipmentSlot.OFF_HAND ? EquipmentSlot.OFF_HAND : EquipmentSlot.HAND;
if (!player.isSneaking()) { ItemStack sourceItem = getItemFromHand(player, hand);
if (!isShulkerBox(sourceItem)) {
return; return;
} }
// 取消默认行为(防止放置潜影盒) if (!(sourceItem.getItemMeta() instanceof BlockStateMeta blockStateMeta)) {
event.setCancelled(true); return;
}
if (!(blockStateMeta.getBlockState() instanceof ShulkerBox shulkerBox)) {
return;
}
// 打开潜影盒 event.setUseItemInHand(org.bukkit.event.Event.Result.DENY);
openShulkerBox(player, item); event.setUseInteractedBlock(org.bukkit.event.Event.Result.DENY);
ItemStack sourceSnapshot = sourceItem.clone();
plugin.getServer().getScheduler().runTask(plugin, () -> {
if (!player.isOnline() || openShulkerBoxes.containsKey(player.getUniqueId())) {
return;
}
openShulkerBox(player, hand, sourceSnapshot, shulkerBox);
});
}
@EventHandler(priority = EventPriority.HIGHEST, ignoreCancelled = true)
public void onInventoryClick(InventoryClickEvent event) {
if (!(event.getWhoClicked() instanceof Player player)) {
return;
}
InventoryView view = event.getView();
Inventory topInventory = view.getTopInventory();
if (!(topInventory.getHolder(false) instanceof ShulkerBoxHolder)) {
return;
}
int topSize = topInventory.getSize();
boolean clickTopInventory = event.getRawSlot() >= 0 && event.getRawSlot() < topSize;
if (clickTopInventory && isShulkerBox(event.getCursor())) {
event.setCancelled(true);
sendNestedMessage(player);
return;
}
if (clickTopInventory && event.getClick() == ClickType.NUMBER_KEY) {
ItemStack hotbarItem = player.getInventory().getItem(event.getHotbarButton());
if (isShulkerBox(hotbarItem)) {
event.setCancelled(true);
sendNestedMessage(player);
return;
}
}
if (event.isShiftClick() && isShulkerBox(event.getCurrentItem())) {
event.setCancelled(true);
sendNestedMessage(player);
}
}
@EventHandler(priority = EventPriority.HIGHEST, ignoreCancelled = true)
public void onInventoryDrag(InventoryDragEvent event) {
InventoryView view = event.getView();
Inventory topInventory = view.getTopInventory();
if (!(topInventory.getHolder(false) instanceof ShulkerBoxHolder)) {
return;
}
if (!isShulkerBox(event.getOldCursor())) {
return;
}
int topSize = topInventory.getSize();
for (int rawSlot : event.getRawSlots()) {
if (rawSlot >= 0 && rawSlot < topSize) {
event.setCancelled(true);
if (event.getWhoClicked() instanceof Player player) {
sendNestedMessage(player);
}
return;
}
}
} }
@EventHandler @EventHandler
@@ -104,131 +192,131 @@ public class ShulkerBoxListener implements Listener {
return; return;
} }
UUID playerId = player.getUniqueId(); commitOpenShulker(player, event.getInventory());
ShulkerBoxData data = openShulkerBoxes.remove(playerId);
if (data == null) {
return;
}
Inventory closedInventory = event.getInventory();
ItemStack currentItem = data.currentItem;
// 验证物品是否还存在
if (currentItem == null || currentItem.getType().isAir()) {
// 物品已不存在,丢弃 inventory 中的所有物品
for (ItemStack item : closedInventory.getContents()) {
if (item != null && !item.getType().isAir()) {
player.getWorld().dropItemNaturally(player.getLocation(), item);
}
}
return;
}
// 更新潜影盒物品中的内容
if (currentItem.getItemMeta() instanceof BlockStateMeta blockStateMeta) {
if (blockStateMeta.getBlockState() instanceof ShulkerBox shulkerBox) {
// 将 inventory 的内容复制回潜影盒
ItemStack[] contents = closedInventory.getContents();
for (int i = 0; i < 27 && i < contents.length; i++) {
shulkerBox.getInventory().setItem(i, contents[i]);
}
// 更新物品元数据
blockStateMeta.setBlockState(shulkerBox);
currentItem.setItemMeta(blockStateMeta);
}
}
} }
@EventHandler @EventHandler
public void onInventoryClick(InventoryClickEvent event) { public void onPlayerQuit(PlayerQuitEvent event) {
if (!(event.getWhoClicked() instanceof Player player)) { Player player = event.getPlayer();
commitOpenShulker(player, player.getOpenInventory().getTopInventory());
}
@EventHandler
public void onPluginDisable(PluginDisableEvent event) {
if (event.getPlugin() != plugin) {
return; return;
} }
// 检查是否是玩家打开的潜影盒(使用 get 避免两次查找) for (Player player : Bukkit.getOnlinePlayers()) {
if (openShulkerBoxes.get(player.getUniqueId()) == null) { commitOpenShulker(player, player.getOpenInventory().getTopInventory());
return;
}
// 获取点击的物品
ItemStack clickedItem = event.getCurrentItem();
if (clickedItem == null) {
return;
}
// 检查是否是潜影盒,如果是则阻止放置
if (isShulkerBox(clickedItem)) {
event.setCancelled(true);
player.sendMessage("§c不能在潜影盒中放入另一个潜影盒");
} }
} }
private void commitOpenShulker(Player player, Inventory inventory) {
if (!(inventory.getHolder(false) instanceof ShulkerBoxHolder)) {
return;
}
OpenShulkerSession session = openShulkerBoxes.remove(player.getUniqueId());
if (session == null) {
return;
}
/** ItemStack updatedShulker = session.sourceItem.clone();
* 检查物品是否为潜影盒O(1) 时间复杂度) writeInventoryBack(updatedShulker, inventory.getContents());
*/ restoreItemToPlayer(player, session, updatedShulker);
private boolean isShulkerBox(ItemStack item) {
return SHULKER_BOX_MATERIALS.contains(item.getType());
} }
/** private void openShulkerBox(Player player, EquipmentSlot hand, ItemStack sourceItem, ShulkerBox shulkerBox) {
* 打开潜影盒 removeItemFromHand(player, hand);
*/
private void openShulkerBox(Player player, ItemStack shulkerBox) { ShulkerBoxHolder holder = new ShulkerBoxHolder(resolveTitle(sourceItem));
// 获取潜影盒的 BlockStateMeta holder.getInventory().setContents(cloneContents(shulkerBox.getInventory().getContents()));
if (!(shulkerBox.getItemMeta() instanceof BlockStateMeta blockStateMeta)) {
int preferredSlot = hand == EquipmentSlot.HAND ? player.getInventory().getHeldItemSlot() : -1;
openShulkerBoxes.put(player.getUniqueId(), new OpenShulkerSession(sourceItem, hand, preferredSlot));
player.openInventory(holder.getInventory());
}
private void writeInventoryBack(ItemStack shulkerItem, ItemStack[] contents) {
if (!(shulkerItem.getItemMeta() instanceof BlockStateMeta blockStateMeta)) {
plugin.getLogger().warning("Failed to save shulker box contents: missing BlockStateMeta.");
return; return;
} }
// 获取潜影盒的方块状态 if (!(blockStateMeta.getBlockState() instanceof ShulkerBox shulkerBox)) {
if (!(blockStateMeta.getBlockState() instanceof ShulkerBox shulkerBoxBlock)) { plugin.getLogger().warning("Failed to save shulker box contents: block state is not a ShulkerBox.");
return; return;
} }
// 创建物品快照(用于后续验证) shulkerBox.getInventory().setContents(cloneContents(contents));
ItemStack snapshot = shulkerBox.clone(); blockStateMeta.setBlockState(shulkerBox);
shulkerItem.setItemMeta(blockStateMeta);
}
// 计算当前物品总数(用于防刷检查) private void restoreItemToPlayer(Player player, OpenShulkerSession session, ItemStack shulkerItem) {
int totalItems = 0; PlayerInventory inventory = player.getInventory();
for (ItemStack item : shulkerBoxBlock.getInventory().getContents()) {
if (item != null && !item.getType().isAir()) { if (session.sourceHand == EquipmentSlot.OFF_HAND) {
totalItems += item.getAmount(); if (isEmpty(inventory.getItemInOffHand())) {
inventory.setItemInOffHand(shulkerItem);
return;
} }
} else if (session.preferredSlot >= 0 && isEmpty(inventory.getItem(session.preferredSlot))) {
inventory.setItem(session.preferredSlot, shulkerItem);
return;
} }
// 获取潜影盒的自定义名称,如果没有则使用配置中的默认标题 Map<Integer, ItemStack> leftovers = inventory.addItem(shulkerItem);
String title; for (ItemStack leftover : leftovers.values()) {
if (shulkerBox.hasItemMeta() && shulkerBox.getItemMeta().hasDisplayName()) { player.getWorld().dropItemNaturally(player.getLocation(), leftover);
// 使用潜影盒的自定义名称 }
title = shulkerBox.getItemMeta().getDisplayName(); }
private ItemStack[] cloneContents(ItemStack[] contents) {
ItemStack[] copied = new ItemStack[SHULKER_SIZE];
for (int i = 0; i < SHULKER_SIZE && i < contents.length; i++) {
copied[i] = contents[i] == null ? null : contents[i].clone();
}
return copied;
}
private ItemStack getItemFromHand(Player player, EquipmentSlot hand) {
return hand == EquipmentSlot.OFF_HAND
? player.getInventory().getItemInOffHand()
: player.getInventory().getItemInMainHand();
}
private void removeItemFromHand(Player player, EquipmentSlot hand) {
if (hand == EquipmentSlot.OFF_HAND) {
player.getInventory().setItemInOffHand(null);
} else { } else {
// 使用配置文件中的默认标题 player.getInventory().setItem(player.getInventory().getHeldItemSlot(), null);
String defaultTitle = plugin.getConfig().getString("shulkerbox.default-title", ""); }
if (defaultTitle != null && !defaultTitle.isEmpty()) { }
// 转换颜色代码 & -> §
title = defaultTitle.replace('&', '§'); private String resolveTitle(ItemStack shulkerBox) {
} else { if (shulkerBox.hasItemMeta() && shulkerBox.getItemMeta().hasDisplayName()) {
// 如果配置为空,使用 "Shulker Box"(客户端会自动翻译) return shulkerBox.getItemMeta().getDisplayName();
title = "Shulker Box";
}
} }
// 创建一个新的 inventory基于潜影盒的内容 String defaultTitle = plugin.getConfig().getString("shulkerbox.default-title", "");
Inventory inventory = Bukkit.createInventory(null, 27, title); if (defaultTitle != null && !defaultTitle.isEmpty()) {
return ChatColor.translateAlternateColorCodes('&', defaultTitle);
// 复制潜影盒的内容到新 inventory
ItemStack[] contents = shulkerBoxBlock.getInventory().getContents();
for (int i = 0; i < 27 && i < contents.length; i++) {
inventory.setItem(i, contents[i]);
} }
return "Shulker Box";
}
// 记录玩家打开的潜影盒(包含快照和当前引用) private void sendNestedMessage(Player player) {
openShulkerBoxes.put(player.getUniqueId(), new ShulkerBoxData(snapshot, shulkerBox, totalItems)); player.sendMessage(EssentialsC.getLangManager().getString("prefix")
+ EssentialsC.getLangManager().getString("messages.shulkerbox-nested"));
}
// 打开 inventory private boolean isShulkerBox(ItemStack item) {
player.openInventory(inventory); return item != null && !item.getType().isAir() && SHULKER_BOX_MATERIALS.contains(item.getType());
}
private boolean isEmpty(ItemStack item) {
return item == null || item.getType().isAir();
} }
} }

View File

@@ -85,3 +85,20 @@ shulkerbox:
# 支持颜色代码(使用 & 符号) # 支持颜色代码(使用 & 符号)
# 留空则使用 "Shulker Box"(客户端语言) # 留空则使用 "Shulker Box"(客户端语言)
default-title: "&e潜影盒" default-title: "&e潜影盒"
# JEI/REI 配方同步设置MC 1.21.2+
# 解决 Fabric/NeoForge 客户端配方不同步问题
jei-sync:
# 是否启用 JEI 配方同步功能
enabled: true
# 是否在控制台显示同步日志
debug: true
# 是否向玩家发送同步提示消息
send-player-message: true
# 生物掉落物控制
mob-drops:
# 末影人掉落物控制
enderman:
# 是否允许末影人死亡后掉落物品和经验
enabled: true

View File

@@ -2,7 +2,7 @@
# 中文语言文件 # 中文语言文件
# 插件前缀 # 插件前缀
prefix: "&6[EssentialsC] &r" prefix: "&7[&6EssentialsC&7]&f:"
# 命令消息 # 命令消息
messages: messages:
@@ -33,6 +33,14 @@ messages:
no-permission-repair-all: "&c你没有权限修复所有物品" no-permission-repair-all: "&c你没有权限修复所有物品"
player-not-found: "&c未找到玩家: {player}" player-not-found: "&c未找到玩家: {player}"
no-permission-others: "&c你没有权限治疗其他玩家" no-permission-others: "&c你没有权限治疗其他玩家"
seen-usage-console: "&c用法: /seen <玩家名>"
unknown-subcommand: "&c未知子命令: {command}"
help-usage: "&7使用 §f/essc help &7查看所有可用命令"
mobdrop-save-failed: "&c保存配置失败: {error}"
mobdrop-toggled: "&a末影人掉落已{status}"
shulkerbox-nested: "&c不能在潜影盒中放入另一个潜影盒"
jei-sync-fabric: "&6JEI-FIX&8(&bFabric&8):&e正在同步合成配方..."
jei-sync-neoforge: "&6JEI-FIX&8(&bNeoForge&8):&e正在同步合成配方..."
# 帮助命令 # 帮助命令
help: help:

View File

@@ -1,10 +1,11 @@
name: EssentialsC name: EssentialsC
description: 精简版基础插件 description: 精简版基础插件
version: '${version}' version: ${version}
main: cn.infstar.essentialsC.EssentialsC main: cn.infstar.essentialsC.EssentialsC
api-version: '1.21' api-version: '1.21'
load: POSTWORLD load: POSTWORLD
folia-supported: false
authors: [ Coldsmiles_7 ] authors: [ Coldsmiles_7 ]
website: www.infstar.cn website: www.infstar.cn
@@ -61,6 +62,9 @@ permissions:
essentialsc.command.repair: essentialsc.command.repair:
description: Allows use of /repair command description: Allows use of /repair command
default: op default: op
essentialsc.command.repair.all:
description: Allows use of /repair all
default: op
essentialsc.command.blocks: essentialsc.command.blocks:
description: Allows use of /essc blocks command description: Allows use of /essc blocks command
default: true default: true
@@ -73,6 +77,9 @@ permissions:
essentialsc.shulkerbox.open: essentialsc.shulkerbox.open:
description: Allows right-click to open shulker boxes without placing them description: Allows right-click to open shulker boxes without placing them
default: op default: op
essentialsc.mobdrops.enderman:
description: Allows control of enderman drops
default: op
essentialsc.*: essentialsc.*:
description: All EssentialsC permissions description: All EssentialsC permissions
default: false default: false
@@ -95,5 +102,7 @@ permissions:
essentialsc.command.reload: true essentialsc.command.reload: true
essentialsc.command.feed: true essentialsc.command.feed: true
essentialsc.command.repair: true essentialsc.command.repair: true
essentialsc.command.repair.all: true
essentialsc.command.help: true essentialsc.command.help: true
essentialsc.shulkerbox.open: true essentialsc.shulkerbox.open: true
essentialsc.mobdrops.enderman: true