BigDoors v1

BigDoors 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, amongst other things, big (animated) doors.

This is the repository for v1 of the BigDoors plugin for SpigotMC. A new version named AnimatedArchitecture is in development here.

If you have a problem with this plugin, please create an issue or join our Discord.

This plugin is available for download on the Spigot page.

Previews:

Regular doors:

Drawbridges:

YouTube

Get the latest dev-build:

Download the latest dev-build here. If you decide to use it, there are a few things you'll have to keep in mind:

• Dev builds will automatically update to the latest stable release as soon as it's available regardless of your settings.
• The dev-builds get updated rather frequently, so check back often (URL stays the same, though).
• These builds might not be tested as thoroughly as the release builds.
• Dev builds may not always be backward compatible with the latest release build. This can occur if the database schema is changed in a dev-build for example (then the old version can no longer read the data). So be sure to make backups!

An updated changelog list can be found here.

List of features:

• Big, animated doors of the following types:
  • Big Door
  • Drawbridge
  • Portcullis
  • Sliding Door
• GUI for door management.
• Redstone support.
• Door creator to guide you through the door creation process.
• Translation support.
• Active developer support.
• Support for various protection plugins such as:
  • GriefDefender
  • GriefPrevention
  • Konquest
  • Lands
  • Medieval Factions
  • PlotSquared
  • RedProtect
  • Towny Advanced
  • WorldGuard
    • Any protection plugin that uses WorldGuard under the hood, such as LandLord
  • More will be added when needed! Just create an issue (or PR!) or post a message on our Discord!

Add-ons

• Big Doors Opener (Created by Eldoria). It allows you to automatically open doors based on conditions such as player proximity, player permissions, or time of day!
• Big Doors Physics (Created by bonn2). It adds collisions to the animated blocks!

FAQ:

• Will you add support for version 1.8 of Minecraft?
  - No. Update your server!
• How can I control doors from the console/command blocks?
  - When issuing commands from the console/command blocks, you cannot use the door name. Instead, you'll have to use doorUIDs.

Resource pack:

The plugin comes with an optional resource pack that only contains sounds that are played during the animation of the doors. It is not used for the animations themselves.

If you don't want to use the resource pack, you can disable it in the config. Look for the resourcePackEnabled option. You should always disable it if you already have a resource pack installed on your server, as it may otherwise override your existing pack or cause other issues. Because the resource pack only contains sounds, disabling it only means that the sounds will not be played. Everything else will still work as intended.

The config also has a list of URLs to the resource packs there for each supported version of Minecraft. You can use these to download the resource pack manually if you want to either host it yourself or merge it with your existing pack.

Translations:

• (0.1.8.35+) German, provided by ZockerStation.
• (0.1.8.16) German, provided by Lord_Junes.
• (0.1.8.15) Spanish, provided by Link_1213.
• (0.1.8.18) Norwegian, provided by Themarwik.
• (0.1.8.27) Japanese, provided by keiichi.
• (0.1.8.30) Chinese, provided by sheip9.
• (0.1.8.32) Italian, provided by MiniMoro.

Got your own translation? Let me know! Note that translations created for older versions may still work. If there are any missing messages you'll be notified in the log.

Unsupported Environments:

If the plugin detects that it is in an unsupported environment during startup, it will abort its initialization to prevent issues. You can force the plugin to enable anyway by enabling unsafe mode in the config, but doing so is not supported!! The following servers are considered unsupported:

• CatServer
• Mohist
• Magma
• Glowstone
• Akarin

And using the following plugins together with BigDoors is also unsupported:

• GeyserMC
• ViaRewind

Video Tutorials:

• How to create big working animated doors in MineCraft - PirateCraft
• How to Use Big Doors!
• Big Doors Plugin Tutorial - Minecraft Moving Drawbridges, Portcullis, Sliding Doors

Some more examples:

Known Issues:

• Because every block in a door is transformed into an entity, larger doors can be taxing on the client.
• Due to their nature, anti-lag plugins tend to remove the entities used by this plugin. This will result in blocks temporarily disappearing and appearing at their opened position after a slight delay. To prevent this, add entities of type "FallingBlock" named "BigDoorsEntity" to their whitelist.

Commands and Permissions:

When opening doors from the console/command block, NAMES DO NOT WORK! You need to use DoorUIDs there. Why? Because names are not unique, while DoorUIDs are. This constraint means that your command blocks won't break when someone creates a new door with the same name as the one you used.

The permissions are set up such that bigdoors.user.* will give a user access to all actions that a user should generally be allowed to do. Any admin-specific access is locked behind bigdoors.admin.*. This should provide a good starting point with setting up the plugin.

In all the following commands, any parameter between angled brackets is required (i.e. <RequiredArgument>) and parameters between square brackets are optional (i.e. [OptionalParameter]).

Whenever the instructions refer to a DoorID, this means that you can use either the door's name or its (numerical) UID.

User Permissions:

    <code>/bdm</code></td>
<td>Opens the BigDoors GUI.</td>

                             When not otherwise specified, this defaults to a big door.

                             All these can also be created from the GUI.



    <b>Permission Usage: </b>Replace <code>&lt;type&gt;</code> with one of the following types: 
                             <ul>
                                 <li><code>door</code>
                                 <li><code>drawbridge</code>
                                 <li><code>slidingdoor</code>
                                 <li><code>portcullis</code>
                             </ul>
                             For example: <code>bigdoors.user.createdoor.bigdoor</code></td>

    Example usage: <code>/setblockstomove MyDoor 12</code></td>

    Example usage: <code>/namedoor MyDoor</code></td>

    <code>/CloseDoor &lt;DoorID&gt; [DoorID2] ... [DoorID..]</code>


    <code>/ToggleDoor &lt;DoorID&gt; [DoorID2] ... [DoorID..]</code></td>
<td>Opens, closes, or toggles a door (of any type). More than one door can be provided in a single command.

    A door can be specified using either its name (only when executing the command as a player) 
    or its UID (both for players and the console/command blocks.)

    To "toggle" a door here means that it will be closed if currently open or opened if currently closed.</td>

    <b>Only works in the console!</b></td>

    <b>Only works for players!</b></td>

    <b>Only works for players!</b></td>

    Example usage: <code>/bigdoors addowner MyDoor pim16aap2</code></td>

    Example usage: <code>/bigdoors removeowner MyDoor pim16aap2</code></td>

    Example usage: <code>/setautoclosetime MyDoor 10</code>, 
    for it to automatically close 10 seconds after opening.</td>

Admin Permissions:

    Note that when accessing a door you're not an owner of, you'll have to use its UID!

    These are the valid attributes:
        <ul>
            <li><code>addowner</code></li>
            <li><code>blockstomove</code></li>
            <li><code>changetime</code></li>
            <li><code>delete</code></li>
            <li><code>direction</code></li>
            <li><code>info</code></li>
            <li><code>lock</code></li>
            <li><code>relocatepowerblock</code></li>
            <li><code>removeowner</code></li>
            <li><code>toggle</code></li>
        </ul>
</td>

Using BigDoors in your project

This project is hosted on EldoNexus.

There are 2 modules available:

• core: The core module containing the main API and functionality.
• hooks-api: The hooks API module containing interfaces for creating hooks for protection plugins.

As a Maven dependency

<repositories>
  <repository>
    <id>eldonexus</id>
    <url>https://eldonexus.de/repository/maven-public/</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>nl.pim16aap2.BigDoors</groupId>
    <artifactId>core</artifactId>
    <version>0.1.8.64</version>
    <scope>provided</scope>
  </dependency>
</dependencies>

As a Gradle dependency

maven {
  name = 'eldonexus'
  url = 'https://eldonexus.de/repository/maven-public/'
}

dependencies {
  compileOnly 'nl.pim16aap2.BigDoors:core:0.1.8.64'
}

Thanks

As a final note, I'd like to thank Captain_Chaos for making his PorteCoulissante plugin. I've used it a lot and it inspired me to make this plugin!