AnimatedArchitecture

BigDoors v2:创建大型、带动画效果的门、吊桥、栅栏、旗帜、风车等等!

资源图片
# 动画建筑 [![](https://jitpack.io/v/PimvanderLoos/AnimatedArchitecture.svg)](https://jitpack.io/#PimvanderLoos/AnimatedArchitecture) AnimatedArchitecture 是一个为 Minecraft 服务器模组 [Spigot](https://spigotmc.org) 提供的插件。 它的目标是使用可以创建各种各样动画建筑结构的动画方块来增强你的服务器。 AnimatedArchitecture 是旧的 BigDoors 插件的重写版本。 你可以在这里找到 BigDoors 遗留插件 [https://github.com/PimvanderLoos/BigDoors/](https://github.com/PimvanderLoos/BigDoors/)。 ## 预览 [![AnimatedArchitecture 展示](https://img.youtube.com/vi/45TwFLBv8yY/0.jpg)](https://www.youtube.com/watch?v=45TwFLBv8yY)
(点击图片前往 YouTube 观看视频) ## 支持的结构类型 目前支持以下结构类型: - 大门 - 显示游戏时间的挂钟 - 吊桥 - 旗帜 - 车库门 - 吊门 (Portcullis) - 旋转门 - 滑动门 - 风车 ## 使用 AnimatedArchitecture ### 要求: * Java 21+ * 一个运行 Spigot (或 Spigot 的分支) 的服务器,用于 Minecraft 1.20+ * Vault ### 安装: * 从最新的 [发布版](https://github.com/PimvanderLoos/AnimatedArchitecture/releases) 中获取文件。你需要 获取 `AnimatedArchitecture-Spigot.jar` 文件。 * 将 `AnimatedArchitecture-Spigot.jar` 放入你的服务器的 plugins 目录中。 * (重新) 启动你的服务器。 * 可选地,通过编辑 `AnimatedArchitecture` 文件夹中生成的配置文件来根据你的喜好配置插件。 ### 导入 BigDoors 的数据库 从 [发布版](https://github.com/PimvanderLoos/BigDoors/releases) Alpha 0.1.8.44 起,BigDoors 具有一个命令,允许 你将旧数据库导出为新格式。 新版本可能包含对导出过程的额外改进,因此建议使用 BigDoors 的最新版本来导出你的数据库。 运行支持版本时,你可以运行 `BigDoors PrepareDatabaseForV2` 命令 在控制台中 来导出数据库。 阅读控制台输出以查看是否已正确导出所有内容。 运行此命令不会影响 BigDoors 中现有的数据库。 数据库导出完成后,你可以将新的 `structures.db` 文件从 `BigDoors` 文件夹复制到 `AnimatedArchitecture` 文件夹。 你现在可以使用在 BigDoors 中创建的结构了! 请注意,导出过程可能并不总是产生完美的转换,可能导致一些次要的不一致性,例如在某些情况下开门方向不正确。 尽管存在这些偶尔的 差异,但大部分导出的结构应该可以正常工作。 任何错误都可以使用游戏中的可用命令或菜单轻松修复。 ## 翻译 ### 官方翻译 官方翻译通过 [Weblate](https://hosted.weblate.org/projects/AnimatedArchitecture/) 进行管理: Translation status ### 自定义翻译 默认情况下,插件将使用 `localization/translations.bundle` 中的消息。 此文件每次插件重启时都会被重新生成,因此请勿手动编辑此文件。 插件使用的所有翻译键也会写入 `localization/translations.properties` 文件。
当你提供一个或多个带有值的键时,插件将在下次重启时创建一个新的文件: `localization/translations_patched.properties`。 此文件包含与基本 bundle 相同的数据,但 任何你在 properties 文件中更改过的行除外。
简单来说,你可以使用 properties 文件覆盖任何官方翻译。 在尝试覆盖翻译时,需要记住的是它尊重区域设置条目。 这意味着 `translations.properties` 文件仅覆盖基本 localization 消息。 Localization 系统的运作方式是,它首先尝试从配置文件中定义的区域设置获取翻译后的消息, 如果不存在,则从基本 localization 文件中获取。 例如,如果你的区域设置配置为 `nl_NL`(荷兰语),插件将首先尝试从 `translations_nl_NL.properties` 文件中获取消息。 如果找不到插件正在查找的键的值,它将尝试 `translations.properties` 文件。 因此,如果你将区域设置设置为 `nl_NL` 并在配置中想要覆盖默认翻译, 请按照以下步骤操作: 1) 将 `translations.properties` 复制到 `translations_nl_NL.properties`。 2) 做出你想要做的更改。 * 你可以检查 `localization/translations.bundle` 文件中的文件以查看当前翻译。 3) 重新启动服务器或插件。 * 你可以使用 `/AnimatedArchitecture restart` 重新启动插件 ## 编译 AnimatedArchitecture 编译要求: * Java 21+ * Maven 然后,你可以在此目录中运行以下命令来编译项目: ```mvn package``` 要运行所有测试、静态分析工具等,你可以运行以下命令: ```mvn -P=errorprone test package checkstyle:checkstyle pmd:check``` `AnimatedArchitecture-Spigot.jar` 文件可以在 `animatedarchitecture-spigot/spigot-core/target/AnimatedArchitecture-Spigot.jar` 中找到。
每个结构类型的 jar 文件可以在 `structures/StructuresOutput/.jar` 中找到。 ## 开发人员 可以使用 [JitPack](https://jitpack.io/#PimvanderLoos/AnimatedArchitecture) 将此项目作为依赖项包含。 在 `artifactId` 字段中,你可以使用任何 `core` 模块。 对于以下示例,我们将 使用 `spigot-core` 模块。 此模块包含 Spigot 平台的实现,以及一些便于使用、实用方法和 类。 你也可以使用 `animatedarchitecture-core` 模块,如果希望只使用 API 而不是 Spigot 平台。 ### Maven ```xml jitpack.io https://jitpack.io ``` ```xml com.github.PimvanderLoos.AnimatedArchitecture spigot-core 0.7.2 provided ``` ### Gradle ```gradle repositories { maven { url "https://jitpack.io/" } } dependencies { compileOnly("com.github.PimvanderLoos.AnimatedArchitecture", "spigot-core", "0.7.2") } ``` ### 文档 此项目的 javadocs 可以在 [这里](https://pimvanderloos.github.io/AnimatedArchitecture/javadoc/) 找到。