AnimatedArchitecture

AnimatedArchitecture 是一款用于 Minecraft 服务器模组 Spigot 的插件。其旨在通过提供可动画化的方块来增强你的服务器,从而帮助你创建各种类型的动态建筑结构。
AnimatedArchitecture 是对旧版 BigDoors 插件的重写版本。你可以在这里找到遗留版的 BigDoors 插件。
预览
(点击图片前往 YouTube 观看视频)
支持的结构类型
目前支持以下结构类型:
- 大型门 (Big Doors)
- 显示游戏内时间的时钟
- 吊桥 (Drawbridges)
- 旗帜
- 车库门 (Garage Doors)
- 闸门 (Portcullises)
- 旋转门 (Revolving Doors)
- 滑动门 (Sliding Doors)
- 风车 (Windmills)
使用 AnimatedArchitecture
要求:
- Java 21+
- Minecraft 1.20+ 的 Spigot 服务器(或 Spigot 分支)
- Vault
安装:
- 获取最新的 release 文件。你需要下载
AnimatedArchitecture-Spigot.jar 文件。
- 将
AnimatedArchitecture-Spigot.jar 放入服务器的 plugins 目录中。
- (重新)启动你的服务器。
- 可选:通过编辑新生成的
AnimatedArchitecture 文件夹中的配置文件,按喜好配置插件。
导入 BigDoors 数据库
自 release Alpha 0.1.8.44 起,BigDoors 提供了一个命令,允许你将旧数据库导出为新格式。较新版本可能包含对导出流程的额外改进,因此建议使用最新版本的 BigDoors 来导出你的数据库。
在运行受支持的版本时,你可以在 控制台中运行 BigDoors PrepareDatabaseForV2 命令来导出数据库。阅读控制台的输出以确认所有内容是否已正确导出。运行此命令不会影响 BigDoors 现有的数据库。
导出过程完成后,你可以将新的 structures.db 文件从 BigDoors 文件夹复制到 AnimatedArchitecture 文件夹中。现在你就可以使用在 BigDoors 中创建的结构了!
请注意,导出过程并不总是能产生完美的转换,可能会导致一些轻微的不一致,例如在某些情况下开启方向不正确。尽管存在这些偶发的差异,但大多数导出的结构应能正常工作。任何错误都可以使用可用的命令或菜单在游戏中轻松修正。
附加组件
翻译
官方翻译
官方翻译通过 Weblate 进行管理:
自定义翻译
默认情况下,插件将使用 localization/translations.bundle 中的消息。
每次插件重启时都会重新生成此文件,因此请勿手动编辑此文件。
插件使用的所有翻译键也会写入 localization/translations.properties 文件中。
当你提供一个或多个带有值的键时,插件在下一次重启时会创建一个新文件:
localization/translations_patched.properties。该文件包含与“基础”包相同的数据,除了你在属性文件中更改的行之外。
简单来说,你可以使用属性文件覆盖任何官方翻译。
在尝试覆盖翻译时需要注意的一点是,它遵循区域设置条目。
这意味着 translations.properties 文件仅覆盖基础本地化消息。
本地化系统的工作方式是,它首先尝试从配置中定义的区域设置获取翻译消息,如果不存在,则从基础本地化文件获取。
例如,如果在配置中将区域设置设置为 nl_NL(荷兰语),插件将首先尝试从
translations_nl_NL.properties 检索消息。如果插件查找的键没有提供值,它将尝试
translations.properties 文件。
因此,如果你在配置中将区域设置设置为 nl_NL 并且想要覆盖默认翻译,
请按照以下步骤操作:
- 将
translations.properties 复制为 translations_nl_NL.properties。
- 应用你希望进行的更改。
- 你可以检查
localization/translations.bundle 中的文件以查看当前翻译。
- 重启服务器或插件。
- 你可以使用
/AnimatedArchitecture restart 重启插件
编译 AnimatedArchitecture
编译要求:
然后,你可以通过在此目录中运行以下命令来编译项目:
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/<StructureType>.jar。
开发者
本项目可以作为依赖项通过 JitPack 包含。
对于 artifactId 字段,你可以使用任何 core 模块。在下面的示例中,我们将
使用 spigot-core。该模块包含 Spigot 平台的实现,以及一些使工作更轻松的实用程序方法和
类。
如果只想使用 API 而不依赖 Spigot 平台,你也可以使用 animatedarchitecture-core。
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.PimvanderLoos.AnimatedArchitecture</groupId>
<artifactId>spigot-core</artifactId>
<version>0.7.2</version>
<scope>provided</scope>
</dependency>
</dependencies>
Gradle
repositories {
maven { url "https://jitpack.io/" }
}
dependencies {
compileOnly("com.github.PimvanderLoos.AnimatedArchitecture", "spigot-core", "0.7.2")
}
文档
本项目的 Javadoc 文档可在此处查看 here。
AnimatedArchitecture

AnimatedArchitecture is a plugin for the Minecraft server mod Spigot. Its aim is to enhance your
server with animated blocks that can be used to create many kinds of animated architectural structures.
AnimatedArchitecture is a rewrite of the old BigDoors plugin. You can find the legacy BigDoors plugin
here.
Preview
(Click the image to go to YouTube and watch the video)
Supported structure types
The following structure types are currently supported:
- Big Doors
- Clocks that display the in-game time
- Drawbridges
- Flags
- Garage Doors
- Portcullises
- Revolving Doors
- Sliding Doors
- Windmills
Using AnimatedArchitecture
Requirements:
- Java 21+
- A Spigot server (or a fork of Spigot) for Minecraft 1.20+
- Vault
Installation:
- Grab the files of the latest release. You will need
to grab the
AnimatedArchitecture-Spigot.jar file.
- Place the
AnimatedArchitecture-Spigot.jar in the plugins directory of your server.
- (Re)start your server.
- Optionally, configure the plugin to your liking by editing the config files in the newly generated
AnimatedArchitecture folder.
Importing BigDoors' Database
As of release Alpha 0.1.8.44, BigDoors has a command that allows
you to export the old database to the new format. Newer versions may contain additional improvements to the export
process, so it is recommended to use the latest version of BigDoors to export your database.
While running a supported version, you can run the BigDoors PrepareDatabaseForV2 command in
the console to export the database. Read the output in the console to see if everything was exported correctly.
Running this command does not affect the existing database for BigDoors.
After the export process has completed, you can copy the new structures.db file out of the BigDoors folder into
the AnimatedArchitecture folder. You will now be able to use the structures you created in BigDoors!
Please note that the export process may not always produce a perfect conversion, potentially leading to minor
inconsistencies, such as incorrect opening directions under certain circumstances. Despite these occasional
discrepancies, the majority of exported structures should function properly. Any errors can be easily rectified in-game
using available commands or the menu.
Add-ons
- AnimatedPhysics (Created by bonn2) It adds collisions to the animated blocks!
Translations
Official translations
Official translations are managed through Weblate:
Custom translations
By default, the plugin will use the messages from localization/translations.bundle.
This file is regenerated every time the plugin restart, so please do not edit this file manually.
All translation keys used by the plugin are also written to a localization/translations.properties file.
When you provide one or more keys with a value, the plugin will create a new file the next time it restarts:
localization/translations_patched.properties. This file contains the same data as the 'base' bundle, except for any
lines you changed in the properties file.
To put it simply, you can override any of the official translations using the properties file.
One thing to keep in mind when trying to override translations is that it respects the locale entry.
This means that the translations.properties file only overrides the base localization messages.
The way the localization system works, is that it first tries to get the translated message from the locale defined in
the config, and, if that does not exist, from the base localization file.
For example, if you set the locale to nl_NL (Dutch) in the config, the plugin will try to retrieve messages from
translations_nl_NL.properties first. If no value is provided for the key the plugin is looking for, it will try the
translations.properties file next.
So, if you have set your locale to nl_NL in the config and want to override the default translations,
follow these steps:
- Copy
translations.properties to translations_nl_NL.properties.
- Apply the changes you wish to make.
- You can check the files in
localization/translations.bundle to see the current translations.
- Restart either the server or the plugin.
- You can restart the plugin with
/AnimatedArchitecture restart
Compiling AnimatedArchitecture
Compilation requirements:
You can then compile the project by running the following command in this directory:
mvn package
To also run all the tests, static analysis tools etc., you can run the following command:
mvn -P=errorprone test package checkstyle:checkstyle pmd:check
The AnimatedArchitecture-Spigot.jar file can then be found
in animatedarchitecture-spigot/spigot-core/target/AnimatedArchitecture-Spigot.jar.
The jars for each structure type can be found in structures/StructuresOutput/<StructureType>.jar.
Developers
This project can be included as a dependency using JitPack.
For the artifactId field, you can use any of the core modules. For the following examples below, we will
use spigot-core. This module contains the implementations for the Spigot platform, as well as some utility methods and
classes that make it easier to work with.
You could also use animatedarchitecture-core if you wish to only use the API and not the Spigot platform.
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.PimvanderLoos.AnimatedArchitecture</groupId>
<artifactId>spigot-core</artifactId>
<version>0.7.2</version>
<scope>provided</scope>
</dependency>
</dependencies>
Gradle
repositories {
maven { url "https://jitpack.io/" }
}
dependencies {
compileOnly("com.github.PimvanderLoos.AnimatedArchitecture", "spigot-core", "0.7.2")
}
Documentation
The javadocs for this project can be found here.
评论 0
登录后参与评分
还没有评论,来抢沙发吧