Config.yml - RockinChaos/FakeCreative GitHub Wiki

Index:

General - These are typically general maintenance settings that do not affect functionality.
Database - This section will affect plugin functionality, setting where data is stored.
Permissions - Permissions if enabled, determine whether the permission(s) is/are applied.
Preferences - These are settings that will affect all players while they are in creative mode, only if they do not have any per-user preferences set.

config-Version: 0

This should NEVER be touched, modifying this will cause the config.yml file to break and regenerate.

Language: 'English'

This identifies the language that FakeCreative will use as well as the lang file that it will generate. Currently, the available languages are English. However, editing the en-lang.yml can allow you to modify the English language to what you prefer.

General

These are typically general maintenance settings that do not affect functionality.

CheckForUpdates: true

Setting this to false will stop FakeCreative from checking for updates and notifying you if an update has been found upon starting the server, or reloading the server.

Metrics-Logging: true

This should always be kept true, this simply allows FakeCreative to anonymously send data of your server version, most used dependencies, java version, etc. Think of this as a statistics page. If you wish to not be included set this to false. This tool will be really useful in allowing me to increase the quality of the FakeCreative updates as well as supported Minecraft Versions. You can see the FakeCreative stats page here; https://bstats.org/plugin/bukkit/FakeCreative

Debugging: false

Setting this to true may help identify a bug you found when reporting it to the developer, it creates more detailed logs and outputs in the console window for debugging later on. It is recommended to keep this false unless you are experiencing issues with FakeCreative and need help.

Database

These settings are optional as a database file is generated by default or you can set up MySQL database connections.

MySQL: false

When setting this to true, a MySQL database will be used (and required) for FakeCreative. When set to false, a local .db file which is located in the FakeCreative folder will be used.

database: 'database_name'

The name of the database (directory), that will be created. You can call database_name whatever you want, as long as it is a unique table name.

prefix: 'fc_'

The name of the prefix to set for each table that will be created. This can be anything you want, as long as it is unique. Do note, changing this does not transfer existing data.

host: '127.0.0.1'

The hostname of your MySQL database. Use the credentials provided by your MySQL provider.

port: 3306

The port of your MySQL database. Port 3306 is the standard port and is normally used. If you can't connect with this port, and you can't find any clues about the port the database is using, you should contact your service provider, to ask for the port.

user: 'root'

The username of the database. Use the credentials provided by your MySQL provider.

pass: 'password'

The password of your MySQL database. Use the credentials provided by your MySQL provider.

Permissions

These permissions if enabled, determine whether the permission(s) is/are applied to certain players.

Preferences: true

Setting this to false will allow all players to set their own custom creative preferences using the Preferences creative tab. Setting this to false requires the players to have the fakecreative.preferences permission in order to set their own custom preferences.

Preferences-OP: false

Setting this to false will allow all ops to set their own custom creative preferences using the Preferences creative tab. Setting this to false requires the op player to have the fakecreative.preferences permission in order to set their own custom preferences.

Commands-OP: false

Setting this to true will require ops to have each commands permissions or fakecreative.all or fakecreative.* in order to use each command. Ops will not get each command by default if this is set to true.

fakecreative.(reload, updates, upgrade, purge, preferences, mode.creative, mode.survival, mode.adventure, mode.spectator) are no longer given to Opped players by default, you will now have to set Commands-OP in the config.yml to false to allow ops to get these commands by default (however this is the default selected setting, setting it to true will require ops to be given these permissions).

Preferences

These preferences are limited to creative mode and will affect all players if they do not have any per-user preferences set.

Allow-Flight: true

Setting this to true will allow creative players to fly.

Fly-Speed: 1.0

This is the speed the creative players will fly at, the default (normal) speed is 1.0.

Break-Speed: 4.0

This is the speed creative players will break blocks at, the default (normal) speed is 4.0. Setting this to 1.0 would make it faster, setting it to 6.0 would make it slower. It is highly suggested not to touch this as it can make breaking blocks buggy/awkward.

Food-Level: 20

The desired level of food for the creative players.

Health: 20

The desired level of health for the creative players.

Heart-Scale: 1.0

The desired number of hearts for the creative players.

Allow-Hunger: false

Setting this to true will allow creative players to deplete their hunger by running or taking damage just like survival mode. Setting this to false disables hunger consumption.

Allow-Burn: false

Setting this to true will allow creative players to burn/take fire damage. Setting this to false disables the burning effect.

Unbreakable-Items: true

Setting this to true allows creative players to break and damage their durability items. Setting this to false prevents item damage.

Block-Drops: false

Setting this to true will allow blocks broken by creative players to drop. Setting this to false prevents items from dropping when breaking blocks.

Sword-Block: true

Setting this to true will prevent creative players from breaking blocks with a sword equipped. Setting this to false allows creative players with swords to break blocks.

Auto-Restore: true

Setting this to true will automatically restore all (previously), creative-enabled players, upon restarting, reloading, or re-logging back to creative mode upon completion.

Invulnerable: true

Setting this to true will prevent creative players from taking damage, essentially setting them to god mode. Setting this to false allows creative players to take damage just like survival.

Invulnerable-Delay: 5

Number of seconds to wait after players exit creative before allowing them to take damage.

Store-Inventory: true

Setting this to true will separate survival and creative inventories, so the prior gamemode inventory will not be lost when switching to creative. Upon exiting creative the prior inventory will be restored and the creative inventory will be lost. Setting this to false will allow inventory transfer. This is very similar to Per-World-Inventory plugins except it functions as a Per-Gamemode-Inventory.

Destroy-Pickups: true

Setting this to true will make it so when creative players attempt to pickup items with a FULL inventory, the items on the ground will be automatically deleted. Setting this to false will allow items on the ground to simply remain on the ground until free space is made in the creative players inventory.