Deprecated API
Contents
-
Terminally Deprecated ElementsElementDescriptionThis class is maintained for backward compatibility. Use
BaseCommandExecutorinstead, which provides better architecture with Chain of Responsibility pattern.此类仅为向后兼容而保留。 请使用
BaseCommandExecutor, 它提供了使用责任链模式的更好架构。UseAbstractCommandExecutorinstead.This class uses Object type for ID which is not type-safe. UseBaseDataEntityinstead, which provides generic ID type and lifecycle hooks.此类使用 Object 类型作为 ID,这不是类型安全的。 请使用
BaseDataEntity, 它提供泛型 ID 类型和生命周期钩子。UseBaseConfirmationPageinstead, which provides better template method pattern, builder support, and code organization.请使用
BaseConfirmationPage, 它提供了更好的模板方法模式、构建器支持和代码组织。UseBasePaginationPageinstead, which provides better template method pattern and code organization.请使用
BasePaginationPage, 它提供了更好的模板方法模式和代码组织。Use the seven-argument constructor and passresourceFolderPathexplicitly. This overload hard-codes it to<dataFolder>/pluginConfig/<pluginName>.请改用七参数构造函数并显式传入
resourceFolderPath。 此重载把它硬编码成了<dataFolder>/pluginConfig/<插件名>。UseXVersionUtilsinstead.Never implemented — no code reads this annotation, so applying it has no effect on command parsing. There is no replacement: declare a separate@CmdMappingformat for each accepted argument shape.从未实现——没有任何代码读取该注解,标注它对指令解析不产生任何影响。 没有替代品:请为每种可接受的参数形态各声明一个
@CmdMapping格式。UseXVersionUtilsinstead.UseXVersionUtilsdirectly instead.UseTempListener.common(Class)and filter by player instead.请改用
TempListener.common(Class)并按玩家过滤。UseTempListener.common(Class)instead. You can useTempListener.DefaultTempListenerBuilder.filter(Function)to filter player events.
使用TempListener.common(Class)代替。 你可以使用TempListener.DefaultTempListenerBuilder.filter(Function)来过滤玩家事件。UseTempListener.common(Class)instead, narrowing withTempListener.DefaultTempListenerBuilder.filter(Function).请改用
TempListener.common(Class),并用TempListener.DefaultTempListenerBuilder.filter(Function)收窄范围。UseXVersionUtilsstatic methods instead. This interface is kept for backward compatibility only. Will be removed in a future version.请改用
XVersionUtils静态方法。 此接口仅为向后兼容保留,将在未来版本中移除。UseXVersionUtils.getBed(Colors)instead.UseXVersionUtils.getBlockFace(Block)instead.UseXVersionUtils.getColoredPlaneGlass(Colors)instead.UseXVersionUtils.getEmailMaterial(boolean)instead.UseXVersionUtils.getEndEye()instead.UseXVersionUtils.getGrassBlock()instead.UseXVersionUtils.getHead(OfflinePlayer)instead.UseXVersionUtils.getItemDurability(ItemStack)instead.UseXVersionUtils.getItemInHand(Player, boolean)instead.UseXVersionUtils.getSign()instead.UseXVersionUtils.getSound(Sounds)instead.UseXVersionUtils.sendActionBar(Player, String)instead.UseXVersionUtils.sendPlayerList(Player, String, String)instead.This overload casts every scanned class toAbstractCommandExecutor, which is itself scheduled for removal in 6.3.0. A command class written against the currentBaseCommandExecutordoes not extend that type, so the cast throwsClassCastException— and the surrounding catch lists only the four reflective checked exceptions, so it escapes. UseCommandManager.registerAll(UltiToolsPlugin), which resolves command classes as beans from the plugin's container and performs no cast. See issue #272.这个重载把扫描到的每个类都强转为
AbstractCommandExecutor, 而后者本身已计划在 6.3.0 移除。按当前推荐写法继承BaseCommandExecutor的命令类不属于那个类型,强转必抛ClassCastException, 且外层 catch 只列了四个反射类受检异常,异常会逃出去。 请改用CommandManager.registerAll(UltiToolsPlugin)—— 它从模块容器里按 bean 解析命令类,不做强转。见 issue #272。UseListenerManager.register(UltiToolsPlugin, Class)instead; this overload takes an already-constructed instance and therefore performs no dependency injection.请改用
ListenerManager.register(UltiToolsPlugin, Class);此重载接收已经构造好的实例, 因此不会执行任何依赖注入。UseXVersionUtilsinstead.UseXVersionUtilsinstead.
-
Deprecated InterfacesInterfaceDescriptionUse
XVersionUtilsstatic methods instead. This interface is kept for backward compatibility only. Will be removed in a future version.请改用
XVersionUtils静态方法。 此接口仅为向后兼容保留,将在未来版本中移除。
-
Deprecated ClassesClassDescriptionThis class is maintained for backward compatibility. Use
BaseCommandExecutorinstead, which provides better architecture with Chain of Responsibility pattern.此类仅为向后兼容而保留。 请使用
BaseCommandExecutor, 它提供了使用责任链模式的更好架构。UseAbstractCommandExecutorinstead.This class uses Object type for ID which is not type-safe. UseBaseDataEntityinstead, which provides generic ID type and lifecycle hooks.此类使用 Object 类型作为 ID,这不是类型安全的。 请使用
BaseDataEntity, 它提供泛型 ID 类型和生命周期钩子。UseBaseConfirmationPageinstead, which provides better template method pattern, builder support, and code organization.请使用
BaseConfirmationPage, 它提供了更好的模板方法模式、构建器支持和代码组织。UseBasePaginationPageinstead, which provides better template method pattern and code organization.请使用
BasePaginationPage, 它提供了更好的模板方法模式和代码组织。UseXVersionUtilsdirectly instead.UseTempListener.common(Class)and filter by player instead.请改用
TempListener.common(Class)并按玩家过滤。UseTempListener.common(Class)instead, narrowing withTempListener.DefaultTempListenerBuilder.filter(Function).请改用
TempListener.common(Class),并用TempListener.DefaultTempListenerBuilder.filter(Function)收窄范围。
-
Deprecated Annotation InterfacesAnnotation InterfaceDescriptionNever implemented — no code reads this annotation, so applying it has no effect on command parsing. There is no replacement: declare a separate
@CmdMappingformat for each accepted argument shape.从未实现——没有任何代码读取该注解,标注它对指令解析不产生任何影响。 没有替代品:请为每种可接受的参数形态各声明一个
@CmdMapping格式。
-
Deprecated Fields
-
Deprecated MethodsMethodDescriptionUse
XVersionUtilsinstead.UseXVersionUtilsinstead.UseTempListener.common(Class)instead. You can useTempListener.DefaultTempListenerBuilder.filter(Function)to filter player events.
使用TempListener.common(Class)代替。 你可以使用TempListener.DefaultTempListenerBuilder.filter(Function)来过滤玩家事件。UseXVersionUtils.getBed(Colors)instead.UseXVersionUtils.getBlockFace(Block)instead.UseXVersionUtils.getColoredPlaneGlass(Colors)instead.UseXVersionUtils.getEmailMaterial(boolean)instead.UseXVersionUtils.getEndEye()instead.UseXVersionUtils.getGrassBlock()instead.UseXVersionUtils.getHead(OfflinePlayer)instead.UseXVersionUtils.getItemDurability(ItemStack)instead.UseXVersionUtils.getItemInHand(Player, boolean)instead.UseXVersionUtils.getSign()instead.UseXVersionUtils.getSound(Sounds)instead.UseXVersionUtils.sendActionBar(Player, String)instead.UseXVersionUtils.sendPlayerList(Player, String, String)instead.This overload casts every scanned class toAbstractCommandExecutor, which is itself scheduled for removal in 6.3.0. A command class written against the currentBaseCommandExecutordoes not extend that type, so the cast throwsClassCastException— and the surrounding catch lists only the four reflective checked exceptions, so it escapes. UseCommandManager.registerAll(UltiToolsPlugin), which resolves command classes as beans from the plugin's container and performs no cast. See issue #272.这个重载把扫描到的每个类都强转为
AbstractCommandExecutor, 而后者本身已计划在 6.3.0 移除。按当前推荐写法继承BaseCommandExecutor的命令类不属于那个类型,强转必抛ClassCastException, 且外层 catch 只列了四个反射类受检异常,异常会逃出去。 请改用CommandManager.registerAll(UltiToolsPlugin)—— 它从模块容器里按 bean 解析命令类,不做强转。见 issue #272。UseListenerManager.register(UltiToolsPlugin, Class)instead; this overload takes an already-constructed instance and therefore performs no dependency injection.请改用
ListenerManager.register(UltiToolsPlugin, Class);此重载接收已经构造好的实例, 因此不会执行任何依赖注入。UseXVersionUtilsinstead.
-
Deprecated ConstructorsConstructorDescriptionUse the seven-argument constructor and pass
resourceFolderPathexplicitly. This overload hard-codes it to<dataFolder>/pluginConfig/<pluginName>.请改用七参数构造函数并显式传入
resourceFolderPath。 此重载把它硬编码成了<dataFolder>/pluginConfig/<插件名>。