Configuration

When BetterChunkLoader starts for the first time, you will see two files generated within the /betterchunkloader folder in your plugin config folder.

These are the Core and Messages config files.

At the moment, This version of BetterChunkLoader uses only a flatfile style data storage so migration of data from different versions outside of ModdedMinecraft's BetterChunkLoader is not supported.

Core Configuration

ChunkLoader {
    AlwaysOn {
        BlockType="minecraft:diamond_block"
        DefaultAlwaysOn=0
        # Max amount in hours the owner can be offline before considering this loader 'Expired'
        Expiry=24
        MaxAlwaysOn=50
    }
    Online {
        BlockType="minecraft:iron_block"
        DefaultOnline=1
        MaxOnline=100
    }
    WandType="minecraft:blaze_rod"
}
Debug=false
Title="&8[&6Chunkloader&8]&r"

Messages Configuration

ChunkLoader {
    CreateFailure="&aFailed to create chunkloader, your balance was not modified."
    CreateSuccess="&aCreated chunkloader, your balance was modified."
    CreationHelp="&aIron and Diamond blocks can be converted into chunk loaders. Right click it with a blaze rod."
    Info {
        Items=[
            "&eInfo",
            "    &aOwner: &e{ownerName}",
            "    &aLocation: &e{location}",
            "    &aType: &e{type}",
            "    &aChunks: &e{chunks}"
        ]
        Padding="&8="
        Title="&8[&6Chunkloader&8]&r"
    }
    InvalidOption="&cThat is an invalid option."
    NoPermissionCreate="&cYou don't have the permission to create a chunkloader of that type."
    NoPermissionEdit="&cYou don't have the permission to edit this chunkloader."
    NotEnough="&cNot enough chunks Needed: &e{needed}&c Available: &e{available}&c."
    OwnerNotify="&cYour chunk loader at &e{location}&c has been removed by &e{player}&c, your balance has been modified."
    RemoveFailure="&cFailed to remove chunkloader, didn't update the balance of the owner."
    RemoveSuccess="&cRemoved chunkloader, updated the balance of the owner."
    UpdateFailure="&eFailed to update chunkloader, your balance was not modified."
    UpdateSuccess="&eUpdated chunkloader, your balance was modified."
}
Commands {
    Balance {
        Failure="&cUnable to get the balance."
        NoPermission="&cYou don't have permission to see the balance of other players."
        Success {
            Items=[
                "&7Total Used &8/ &7Total Available",
                "&3Online: &6{onlineused} &8/ &6 {online}",
                "&3Always On: &6{alwaysonused} &8/ &6 {alwayson}"
            ]
            Padding="&8="
            TitleOther="&8[&6{player}'s Chunkloader Balance&8]&r"
            TitleSelf="&8[&6Chunkloader Balance&8]&r"
        }
    }
    Chunks {
        Add {
            Failure="&cUnable to add &e{chunks}&c {type} chunks to &e{target}'s&c balance as it would become negative or would exceed the limit of &e{limit}&c."
            Success="&aAdded &e{chunks}&a {type} chunks to &e{target}'s&a balance!"
        }
        Remove {
            Failure="&cUnable to remove &e{chunks}&c {type} chunks from &e{target}'s&c balance as it would become negative or would exceed the limit of &e{limit}&c."
            Success="&aRemoved &e{chunks}&a {type} chunks from &e{target}'s&a balance!"
        }
        Set {
            Failure="&cUnable to set &e{target}'s&c {type} chunk balance to &e{chunks}&c as it would become negative or would exceed the limit of &e{limit}&c."
            Success="&aSet &e{target}'s&a {type} chunk balance to &e{chunks}&a."
        }
        Usage="&eUsage: /bcl chunks <add|set|remove> <player> <online|alwayson> <amount>"
    }
    Delete {
        ConsoleError="&cOnly players can remove their own chunkloaders, please specify a player name."
        InvalidType="&cInvalid chunkloader type: {type}, options are: (online|alwayson)."
        Others {
            Failure="&cPlayer &e{player}&c has no &e{type}&c chunkloaders."
            NoPermission="&cYou do not have permission to delete the chunkloaders of other players."
            Success="&aRemoved &e{type}&a chunk loaders from &e{player}&a."
        }
        Own {
            Failure="&cYou don't have any &e{type}&c chunkloaders."
            Success="&aRemoved all your &e{type}&a chunkloaders."
        }
        Usage="&eUsage: /bcl delete <type> ?<player>"
    }
    Info {
        Failure="&cNo statistics available!"
        Success {
            Items=[
                "&eChunkloading Statistics:",
                "    &e{onlineLoaders}&a &aOnline loaders loading &e{onlineChunks}&a chunks.",
                "    &e{alwaysOnLoaders} &aAlways On loaders loading &e{alwaysOnChunks}&a chunks.",
                "    &e{playerCount}&a player(s) loading chunks!"
            ]
            Padding="&8="
            Title="&8[&6Chunkloader&8]&r"
        }
    }
    List {
        NoChunkloadersFound="&eThere is currently no chunkloaders."
        NoPermission="&cYou don't have permission to see others chunkloaders."
        NoPlayer="&cPlayer was specified but no player was found."
        Success {
            Format {
                All=[
                    "&3Owner: &6{ownerabr}",
                    " &3Type: &6{type}",
                    " &3Loaded: &6{loaded}"
                ]
                Alwayson=[
                    "&3Owner: &6{ownerabr}",
                    " &3Type: &6{type}",
                    " &3Loaded: &6{loaded}"
                ]
                EditAction="&8[&6Edit&8]"
                Hover {
                    All="&3Owner: &6{owner}\n&3Type: &6{type}\n&3Loc: &6{location}\n&3Radius: &6{radius}\n&3Chunks: &6{chunks}"
                    AlwaysOn="&3Owner: &6{owner}\n&3Type: &6{type}\n&3Loc: &6{location}\n&3Radius: &6{radius}\n&3Chunks: &6{chunks}"
                    EditAction="&eClick here to edit this chunkloader"
                    Online="&3Owner: &6{owner}\n&3Type: &6{type}\n&3Loc: &6{location}\n&3Radius: &6{radius}\n&3Chunks: &6{chunks}"
                    Self="&3Owner: &6{owner}\n&3Type: &6{type}\n&3Loc: &6{location}\n&3Radius: &6{radius}\n&3Chunks: &6{chunks}"
                }
                Online=[
                    "&3Owner: &6{ownerabr}",
                    " &3Type: &6{type}",
                    " &3Loaded: &6{loaded}"
                ]
                Self=[
                    "&3Owner: &6{ownerabr}",
                    " &3Type: &6{type}",
                    " &3Loaded: &6{loaded}"
                ]
            }
            Padding="&8="
            Teleport="&eTeleported to chunkloader at &6{location}"
            Title {
                TitleAll="&8[&6All Chunkloaders&8]&r"
                TitleAlwaysOn="&8[&6Always On Chunkloaders&8]&r"
                TitleOnlineOnly="&8[&6Online Only Chunkloaders&8]&r"
                TitleSelf="&8[&6Your Chunkloaders&8]&r"
            }
        }
    }
    NoPlayerExists="&cThat player does not exist."
    Purge {
        Failure="&cUnable to remove invalid chunk loaders, none present."
        Success="&aAll invalid chunk loaders have been removed!"
    }
    Reload {
        Failure="&cReload failed for: &e{type}&c, check console for more information."
        Success="&aReload success for: &e{type}&a."
        Usage="&eUsage: /bcl reload <core|messages|datastore>"
    }
    Usage {
        Items=[
            "&eUsage:",
            "    &e/bcl balance ?<player>",
            "    &e/bcl chunks <add|set|remove> <player> <online|alwayson>",
            "    &e/bcl delete <type> ?<player>",
            "    &e/bcl info",
            "    &e/bcl list <type> ?<player>",
            "    &e/bcl purge",
            "    &e/bcl reload ?<core|messages|datastore>"
        ]
        Padding="&8="
        Title="&8[&6Chunkloader&8]&r"
    }
}
Prefix="&8[&6Chunkloader&8] &r"